@zhin.js/core 1.0.25 → 1.0.26

package/lib/ai/user-profile.d.ts

@@ -0,0 +1,56 @@
+/**
+ * UserProfileStore — 用户画像存储
+ *
+ * 持久化存储用户偏好和特征，让 AI 跨会话记住用户的个性化信息。
+ *
+ *   ai_user_profiles 表：
+ *   ┌──────────────────────────────────────────────────────────┐
+ *   │ user_id  | key          | value         | updated_at     │
+ *   │ u1       | name         | 小明          | 1700000000     │
+ *   │ u1       | style        | 简洁正式      | 1700000001     │
+ *   │ u1       | interests    | 编程,天气     | 1700000010     │
+ *   └──────────────────────────────────────────────────────────┘
+ */
+export declare const AI_USER_PROFILE_MODEL: {
+    user_id: {
+        type: "text";
+        nullable: boolean;
+    };
+    key: {
+        type: "text";
+        nullable: boolean;
+    };
+    value: {
+        type: "text";
+        nullable: boolean;
+    };
+    updated_at: {
+        type: "integer";
+        default: number;
+    };
+};
+/**
+ * 数据库模型接口（与 RelatedModel 的链式查询 API 对齐）
+ */
+interface DbModel {
+    select(...fields: string[]): any;
+    create(data: Record<string, any>): Promise<any>;
+    update(data: Partial<any>): any;
+    delete(condition: Record<string, any>): any;
+}
+export declare class UserProfileStore {
+    private store;
+    constructor();
+    upgradeToDatabase(model: DbModel): void;
+    get(userId: string, key: string): Promise<string | null>;
+    getAll(userId: string): Promise<Record<string, string>>;
+    set(userId: string, key: string, value: string): Promise<void>;
+    delete(userId: string, key: string): Promise<boolean>;
+    /**
+     * 构建用户画像摘要，注入 system prompt
+     */
+    buildProfileSummary(userId: string): Promise<string>;
+    dispose(): void;
+}
+export {};
+//# sourceMappingURL=user-profile.d.ts.map

package/lib/ai/user-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-profile.d.ts","sourceRoot":"","sources":["../../src/ai/user-profile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAUH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;CAKjC,CAAC;AAcF;;GAEG;AACH,UAAU,OAAO;IACf,MAAM,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IACjC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAChD,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IAChC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC;CAC7C;AAsFD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAgB;;IAM7B,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAOjC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIxD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAIvD,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9D,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI3D;;OAEG;IACG,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAS1D,OAAO,IAAI,IAAI;CAGhB"}

package/lib/ai/user-profile.js

@@ -0,0 +1,130 @@
+/**
+ * UserProfileStore — 用户画像存储
+ *
+ * 持久化存储用户偏好和特征，让 AI 跨会话记住用户的个性化信息。
+ *
+ *   ai_user_profiles 表：
+ *   ┌──────────────────────────────────────────────────────────┐
+ *   │ user_id  | key          | value         | updated_at     │
+ *   │ u1       | name         | 小明          | 1700000000     │
+ *   │ u1       | style        | 简洁正式      | 1700000001     │
+ *   │ u1       | interests    | 编程,天气     | 1700000010     │
+ *   └──────────────────────────────────────────────────────────┘
+ */
+import { Logger } from '@zhin.js/logger';
+const logger = new Logger(null, 'UserProfile');
+// ============================================================================
+// 数据库模型
+// ============================================================================
+export const AI_USER_PROFILE_MODEL = {
+    user_id: { type: 'text', nullable: false },
+    key: { type: 'text', nullable: false },
+    value: { type: 'text', nullable: false },
+    updated_at: { type: 'integer', default: 0 },
+};
+// ============================================================================
+// 内存实现
+// ============================================================================
+class MemoryProfileStore {
+    data = new Map();
+    async get(userId, key) {
+        return this.data.get(userId)?.get(key) ?? null;
+    }
+    async getAll(userId) {
+        const map = this.data.get(userId);
+        if (!map)
+            return {};
+        return Object.fromEntries(map);
+    }
+    async set(userId, key, value) {
+        let map = this.data.get(userId);
+        if (!map) {
+            map = new Map();
+            this.data.set(userId, map);
+        }
+        map.set(key, value);
+    }
+    async delete(userId, key) {
+        return this.data.get(userId)?.delete(key) ?? false;
+    }
+    dispose() { this.data.clear(); }
+}
+// ============================================================================
+// 数据库实现
+// ============================================================================
+class DatabaseProfileStore {
+    model;
+    constructor(model) {
+        this.model = model;
+    }
+    async get(userId, key) {
+        const records = await this.model.select().where({ user_id: userId, key });
+        return records.length > 0 ? records[0].value : null;
+    }
+    async getAll(userId) {
+        const records = await this.model.select().where({ user_id: userId });
+        const result = {};
+        for (const r of records)
+            result[r.key] = r.value;
+        return result;
+    }
+    async set(userId, key, value) {
+        const existing = await this.model.select().where({ user_id: userId, key });
+        if (existing.length > 0) {
+            await this.model.update({ value, updated_at: Date.now() }).where({ user_id: userId, key });
+        }
+        else {
+            await this.model.create({ user_id: userId, key, value, updated_at: Date.now() });
+        }
+    }
+    async delete(userId, key) {
+        const existing = await this.model.select().where({ user_id: userId, key });
+        if (existing.length === 0)
+            return false;
+        await this.model.delete({ user_id: userId, key });
+        return true;
+    }
+    dispose() { }
+}
+// ============================================================================
+// UserProfileStore
+// ============================================================================
+export class UserProfileStore {
+    store;
+    constructor() {
+        this.store = new MemoryProfileStore();
+    }
+    upgradeToDatabase(model) {
+        const old = this.store;
+        this.store = new DatabaseProfileStore(model);
+        old.dispose();
+        logger.debug('UserProfileStore: upgraded to database storage');
+    }
+    async get(userId, key) {
+        return this.store.get(userId, key);
+    }
+    async getAll(userId) {
+        return this.store.getAll(userId);
+    }
+    async set(userId, key, value) {
+        return this.store.set(userId, key, value);
+    }
+    async delete(userId, key) {
+        return this.store.delete(userId, key);
+    }
+    /**
+     * 构建用户画像摘要，注入 system prompt
+     */
+    async buildProfileSummary(userId) {
+        const profile = await this.store.getAll(userId);
+        const entries = Object.entries(profile);
+        if (entries.length === 0)
+            return '';
+        const lines = entries.map(([k, v]) => `- ${k}: ${v}`).join('\n');
+        return `[用户画像]\n${lines}`;
+    }
+    dispose() {
+        this.store.dispose();
+    }
+}
+//# sourceMappingURL=user-profile.js.map

package/lib/ai/user-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-profile.js","sourceRoot":"","sources":["../../src/ai/user-profile.ts"],"names":[],"mappings":"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"}

package/lib/ai/zhin-agent.d.ts

@@ -0,0 +1,165 @@
+/**
+ * ZhinAgent — 全局持久 AI 大脑
+ *
+ * 取代旧的 AIService.process() 临时创建 Agent 的方式。
+ *
+ * 核心能力：
+ *   1. 全局单例，应用生命周期内常驻
+ *   2. Skill 感知：两级过滤 Skill → Tool
+ *   3. 双层记忆：per-scene（对话上下文）+ per-user（长期偏好）
+ *   4. 任务规划：复杂请求自动分解为子步骤
+ *   5. 多模态输出：结构化 OutputElement[]
+ *   6. 智能路径选择：纯闲聊走轻量路径，工具请求走完整路径
+ *   7. 用户画像：跨会话个性化记忆
+ *   8. 速率限制：防止单用户过度消耗资源
+ *   9. 流式输出：onChunk 回调实时推送部分文本
+ *  10. 情绪感知：根据用户语气调整回复风格
+ *  11. 主动跟进：schedule_followup 定时回查
+ *  12. 多模态输入：图片/音频直接传给视觉模型
+ */
+import type { Tool, ToolContext } from '../types.js';
+import type { SkillFeature } from '../built/skill.js';
+import type { AIProvider, AgentTool, ContentPart } from './types.js';
+import { SessionManager } from './session.js';
+import type { ContextManager } from './context-manager.js';
+import type { OutputElement } from './output.js';
+import { UserProfileStore } from './user-profile.js';
+import { type RateLimitConfig } from './rate-limiter.js';
+import { type FollowUpSender } from './follow-up.js';
+export interface ZhinAgentConfig {
+    /** 默认系统人格 */
+    persona?: string;
+    /** 最大工具调用轮数 */
+    maxIterations?: number;
+    /** 单次请求超时 (ms) */
+    timeout?: number;
+    /** 预执行超时 (ms) */
+    preExecTimeout?: number;
+    /** Skill 选择最大数量 */
+    maxSkills?: number;
+    /** Tool 选择最大数量 */
+    maxTools?: number;
+    /** 一个话题至少持续多少轮才触发摘要（默认 5） */
+    minTopicRounds?: number;
+    /** 滑动窗口大小：最近 N 轮消息（默认 5） */
+    slidingWindowSize?: number;
+    /** 话题切换检测阈值（0-1，值越低越敏感，默认 0.15） */
+    topicChangeThreshold?: number;
+    /** 速率限制配置 */
+    rateLimit?: RateLimitConfig;
+    /** 是否启用情绪感知（默认 true） */
+    toneAwareness?: boolean;
+    /** 视觉模型名称（如 llava, bakllava），留空则不启用视觉 */
+    visionModel?: string;
+}
+/**
+ * 流式输出回调 — 适配器可通过此回调实时更新消息
+ *
+ * @param chunk  增量文本片段
+ * @param full   到目前为止的完整文本
+ */
+export type OnChunkCallback = (chunk: string, full: string) => void;
+export declare class ZhinAgent {
+    private provider;
+    private config;
+    private skillRegistry;
+    private sessions;
+    private contextManager;
+    private memory;
+    private externalTools;
+    private userProfiles;
+    private rateLimiter;
+    private followUps;
+    constructor(provider: AIProvider, config?: ZhinAgentConfig);
+    setSkillRegistry(registry: SkillFeature): void;
+    setSessionManager(manager: SessionManager): void;
+    setContextManager(manager: ContextManager): void;
+    /** 将 ConversationMemory 升级为数据库存储 */
+    upgradeMemoryToDatabase(msgModel: any, sumModel: any): void;
+    /** 将 UserProfileStore 升级为数据库存储 */
+    upgradeProfilesToDatabase(model: any): void;
+    /** 将 FollowUpManager 升级为数据库存储 */
+    upgradeFollowUpsToDatabase(model: any): void;
+    /** 注入提醒消息发送回调（由 init.ts 在适配器就绪后调用） */
+    setFollowUpSender(sender: FollowUpSender): void;
+    /**
+     * 从数据库恢复未完成的跟进任务（启动时调用）
+     * @returns 恢复的任务数量
+     */
+    restoreFollowUps(): Promise<number>;
+    /** 获取 UserProfileStore（用于外部注册） */
+    getUserProfiles(): UserProfileStore;
+    registerTool(tool: AgentTool): () => void;
+    /**
+     * 处理用户消息 — 唯一的公开入口
+     *
+     * @param content       用户消息文本
+     * @param context       工具上下文（平台、发送者、权限等）
+     * @param externalTools 外部传入的工具列表
+     * @param onChunk       流式输出回调（可选，适配器支持时传入）
+     *
+     * 路径选择策略（按开销从低到高）：
+     *
+     *   ┌─ 闲聊路径（最快）────────────────────────────────────────────┐
+     *   │  工具过滤 = 0 → 仅 persona prompt → 流式 1 次 LLM 调用      │
+     *   └──────────────────────────────────────────────────────────────┘
+     *   ┌─ 快速路径（1 轮 LLM）───────────────────────────────────────┐
+     *   │  全部命中无参数工具 → 预执行 → 数据注入 prompt → 1 次 LLM    │
+     *   └──────────────────────────────────────────────────────────────┘
+     *   ┌─ Agent 路径（多轮 LLM）─────────────────────────────────────┐
+     *   │  存在需参数工具 → Agent tool-calling → 多轮 LLM              │
+     *   └──────────────────────────────────────────────────────────────┘
+     */
+    process(content: string, context: ToolContext, externalTools?: Tool[], onChunk?: OnChunkCallback): Promise<OutputElement[]>;
+    /**
+     * 处理多模态消息（图片+文字）
+     *
+     * 当用户发送图片时，走视觉模型路径。
+     */
+    processMultimodal(parts: ContentPart[], context: ToolContext, onChunk?: OnChunkCallback): Promise<OutputElement[]>;
+    private buildEnhancedPersona;
+    /**
+     * 构建上下文提示 — 告诉 AI 当前身份和场景，帮助工具参数填充
+     */
+    private buildContextHint;
+    private collectTools;
+    /**
+     * 将 Tool 转为 AgentTool，注入 ToolContext 以确保执行时鉴权生效
+     */
+    private toAgentTool;
+    /**
+     * 构建 Skill 增强的 system prompt（仅在工具路径使用，闲聊不走这里）
+     */
+    private buildRichSystemPrompt;
+    /**
+     * 创建 chat_history 工具 — 让 AI 能主动搜索历史聊天记录
+     */
+    private createChatHistoryTool;
+    /**
+     * 创建 user_profile 工具 — 让 AI 读写用户画像
+     */
+    private createUserProfileTool;
+    /**
+     * 创建 schedule_followup 工具 — 让 AI 主动安排跟进
+     *
+     * 任务持久化到数据库，机器人重启后自动恢复。
+     * 同一会话创建新提醒时，旧的 pending 提醒会被自动取消。
+     */
+    private createScheduleFollowUpTool;
+    /**
+     * 从 ConversationMemory 构建上下文
+     */
+    private buildHistoryMessages;
+    /**
+     * 流式聊天（带历史记忆） — 利用 chatStream 减少 TTFT
+     *
+     * 新增 onChunk 回调：每收到一个 token 立即通知调用方，
+     * 支持适配器（Telegram/Discord/Kook）实时编辑消息。
+     */
+    private streamChatWithHistory;
+    private saveToSession;
+    private fallbackFormat;
+    isReady(): boolean;
+    dispose(): void;
+}
+//# sourceMappingURL=zhin-agent.d.ts.map

package/lib/ai/zhin-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zhin-agent.d.ts","sourceRoot":"","sources":["../../src/ai/zhin-agent.ts"],"names":[],"mappings":"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"}