autosnippet 3.2.9 → 3.2.11

package/dist/lib/service/agent/ConversationStore.js

@@ -0,0 +1,373 @@
+/**
+ * ConversationStore — 对话持久化 + 上下文窗口管理
+ *
+ * 设计:
+ * - 每个对话一个 JSONL 文件: .autosnippet/conversations/{id}.jsonl
+ * - 索引文件: .autosnippet/conversations/index.json
+ * - 按 category 隔离: 'user'(Dashboard) / 'system'(SignalCollector)
+ * - Token 预算: 超限时自动生成摘要压缩旧轮次
+ * - 静默降级: 持久化失败不影响核心功能
+ *
+ * Token 计算策略:
+ *   采用字符数近似估算 (1 token ≈ 3.5 字符中文 / ≈ 4 字符英文)
+ *   简单高效，无需额外依赖
+ *
+ * 文件结构:
+ *   .autosnippet/conversations/
+ *     index.json   — 对话元数据索引
+ *     {id}.jsonl   — 每行一条消息 {role, content, ts}
+ */
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+import Logger from '../../infrastructure/logging/Logger.js';
+import pathGuard from '../../shared/PathGuard.js';
+import { estimateTokens as _estimateTokens } from '../../shared/token-utils.js';
+const DEFAULT_TOKEN_BUDGET = 12000; // ~12K tokens 留给历史, 其余给系统提示词和当前消息
+const MAX_CONVERSATIONS = 100; // 索引最多保留 100 个对话
+const _SUMMARY_TARGET_TOKENS = 500; // 压缩后的摘要目标 token 数
+export class ConversationStore {
+    #dir;
+    #indexPath;
+    #logger;
+    /**
+     * @param {string} projectRoot 用户项目根目录
+     */
+    constructor(projectRoot) {
+        this.#dir = path.join(projectRoot, '.autosnippet', 'conversations');
+        this.#indexPath = path.join(this.#dir, 'index.json');
+        this.#logger = Logger.getInstance();
+        // 路径安全检查
+        pathGuard.assertProjectWriteSafe(this.#dir);
+    }
+    // ═══════════════════════════════════════════════════════
+    //  公共 API
+    // ═══════════════════════════════════════════════════════
+    /**
+     * 创建新对话
+     * @param {object} opts
+     * @param {'user'|'system'|'lark'} opts.category 对话类别
+     * @param {string} [opts.title] 对话标题
+     * @returns {string} conversationId
+     */
+    create({ category = 'user', title = '' } = {}) {
+        const id = crypto.randomUUID();
+        const entry = {
+            id,
+            category,
+            title,
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+            messageCount: 0,
+            hasSummary: false,
+        };
+        const index = this.#loadIndex();
+        index.unshift(entry);
+        // 限制索引大小
+        if (index.length > MAX_CONVERSATIONS) {
+            const removed = index.splice(MAX_CONVERSATIONS);
+            // 清理旧对话文件
+            for (const old of removed) {
+                this.#deleteConversationFile(old.id);
+            }
+        }
+        this.#saveIndex(index);
+        return id;
+    }
+    /**
+     * 追加消息到对话
+     * @param {string} conversationId
+     * @param {{ role: string, content: string }} message
+     */
+    append(conversationId, message) {
+        try {
+            fs.mkdirSync(this.#dir, { recursive: true });
+            const filePath = this.#conversationPath(conversationId);
+            const line = JSON.stringify({
+                role: message.role,
+                content: message.content,
+                ts: new Date().toISOString(),
+            });
+            fs.appendFileSync(filePath, `${line}\n`, 'utf-8');
+            // 更新索引
+            const index = this.#loadIndex();
+            const entry = index.find((e) => e.id === conversationId);
+            if (entry) {
+                entry.updatedAt = new Date().toISOString();
+                entry.messageCount = (entry.messageCount || 0) + 1;
+                // 用首条用户消息作为标题
+                if (!entry.title && message.role === 'user') {
+                    entry.title = message.content.substring(0, 60);
+                }
+                this.#saveIndex(index);
+            }
+        }
+        catch (err) {
+            this.#logger.warn(`[ConversationStore] append failed: ${err.message}`);
+        }
+    }
+    /**
+     * 加载对话历史（带 token 预算控制）
+     *
+     * 如果历史超出 tokenBudget:
+     *   - 保留开头的摘要（如有）
+     *   - 截断中间的旧消息
+     *   - 保留最新的消息
+     *
+     * @param {string} conversationId
+     * @param {object} [opts]
+     * @param {number} [opts.tokenBudget] - token 预算
+     * @returns {{ role: string, content: string }[]}
+     */
+    load(conversationId, { tokenBudget = DEFAULT_TOKEN_BUDGET } = {}) {
+        try {
+            const filePath = this.#conversationPath(conversationId);
+            if (!fs.existsSync(filePath)) {
+                return [];
+            }
+            const raw = fs.readFileSync(filePath, 'utf-8').trim();
+            if (!raw) {
+                return [];
+            }
+            const messages = raw
+                .split('\n')
+                .filter(Boolean)
+                .map((line) => {
+                try {
+                    const parsed = JSON.parse(line);
+                    return { role: parsed.role, content: parsed.content };
+                }
+                catch {
+                    return null;
+                }
+            })
+                .filter((m) => m !== null);
+            return this.#fitWithinBudget(messages, tokenBudget);
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * 对话列表
+     * @param {object} [opts]
+     * @param {'user'|'system'|'lark'} [opts.category] 按类别过滤
+     * @param {number} [opts.limit=20]
+     * @returns {Array}
+     */
+    list({ category, limit = 20 } = {}) {
+        const index = this.#loadIndex();
+        let results = index;
+        if (category) {
+            results = results.filter((e) => e.category === category);
+        }
+        return results.slice(0, limit);
+    }
+    /**
+     * 删除对话
+     * @param {string} conversationId
+     */
+    delete(conversationId) {
+        this.#deleteConversationFile(conversationId);
+        const index = this.#loadIndex();
+        const filtered = index.filter((e) => e.id !== conversationId);
+        this.#saveIndex(filtered);
+    }
+    /**
+     * 为对话生成压缩摘要（需要 AI）
+     * 将旧消息替换为一条 system 摘要消息
+     *
+     * @param {string} conversationId
+     * @param {object} opts
+     * @param {object} opts.aiProvider - AI Provider 实例
+     * @returns {Promise<boolean>} 是否成功压缩
+     */
+    async summarize(conversationId, { aiProvider }) {
+        if (!aiProvider) {
+            return false;
+        }
+        try {
+            const filePath = this.#conversationPath(conversationId);
+            if (!fs.existsSync(filePath)) {
+                return false;
+            }
+            const raw = fs.readFileSync(filePath, 'utf-8').trim();
+            if (!raw) {
+                return false;
+            }
+            const messages = raw
+                .split('\n')
+                .filter(Boolean)
+                .map((line) => {
+                try {
+                    return JSON.parse(line);
+                }
+                catch {
+                    return null;
+                }
+            })
+                .filter(Boolean);
+            if (messages.length < 6) {
+                return false; // 太短不需要压缩
+            }
+            // 保留最近 4 条消息，压缩其余
+            const toSummarize = messages.slice(0, -4);
+            const toKeep = messages.slice(-4);
+            const summaryPrompt = `请用 2-3 句话总结以下对话的要点（保留关键决策、用户偏好、操作结果）：\n\n${toSummarize
+                .map((m) => `[${m.role}] ${m.content}`)
+                .join('\n')
+                .substring(0, 4000)}`;
+            const summary = await aiProvider.chat(summaryPrompt, {
+                temperature: 0.3,
+                maxTokens: 300,
+            });
+            if (!summary) {
+                return false;
+            }
+            // 重写对话文件: 摘要 + 最近消息
+            const newMessages = [
+                { role: 'system', content: `[对话摘要] ${summary.trim()}`, ts: new Date().toISOString() },
+                ...toKeep,
+            ];
+            fs.writeFileSync(filePath, `${newMessages.map((m) => JSON.stringify(m)).join('\n')}\n`, 'utf-8');
+            // 更新索引
+            const index = this.#loadIndex();
+            const entry = index.find((e) => e.id === conversationId);
+            if (entry) {
+                entry.hasSummary = true;
+                entry.messageCount = newMessages.length;
+                this.#saveIndex(index);
+            }
+            this.#logger.info(`[ConversationStore] summarized conversation ${conversationId}: ${messages.length} → ${newMessages.length} messages`);
+            return true;
+        }
+        catch (err) {
+            this.#logger.warn(`[ConversationStore] summarize failed: ${err.message}`);
+            return false;
+        }
+    }
+    /**
+     * 清理过期对话
+     * @param {object} [opts]
+     * @param {number} [opts.maxAgeDays=30] 超过此天数的对话将被删除
+     * @param {'user'|'system'} [opts.category] 只清理特定类别
+     * @returns {{ deleted: number }}
+     */
+    cleanup({ maxAgeDays = 30, category, } = {}) {
+        const index = this.#loadIndex();
+        const cutoff = Date.now() - maxAgeDays * 86400000;
+        let deleted = 0;
+        const kept = index.filter((entry) => {
+            if (category && entry.category !== category) {
+                return true;
+            }
+            const updatedAt = new Date(entry.updatedAt).getTime();
+            if (updatedAt < cutoff) {
+                this.#deleteConversationFile(entry.id);
+                deleted++;
+                return false;
+            }
+            return true;
+        });
+        if (deleted > 0) {
+            this.#saveIndex(kept);
+            this.#logger.info(`[ConversationStore] cleaned up ${deleted} old conversations`);
+        }
+        return { deleted };
+    }
+    /**
+     * 估算 token 数 — 委托给共享 token-utils（CJK 感知）
+     * @param {string} text
+     * @returns {number}
+     */
+    estimateTokens(text) {
+        return _estimateTokens(text);
+    }
+    // ═══════════════════════════════════════════════════════
+    //  内部方法
+    // ═══════════════════════════════════════════════════════
+    /**
+     * 将消息列表裁剪到 token 预算内
+     * 策略: 保留首条摘要(如有) + 最新消息，丢弃中间旧消息
+     */
+    #fitWithinBudget(messages, tokenBudget) {
+        if (messages.length === 0) {
+            return [];
+        }
+        // 计算总 token
+        let totalTokens = 0;
+        const tokenCounts = messages.map((m) => {
+            const tokens = this.estimateTokens(m.content);
+            totalTokens += tokens;
+            return tokens;
+        });
+        if (totalTokens <= tokenBudget) {
+            return messages;
+        }
+        // 超预算 — 保留首条(摘要) + 从末尾往前取
+        const result = [];
+        let used = 0;
+        // 如果首条是 system 摘要，优先保留
+        if (messages[0].role === 'system' && messages[0].content.startsWith('[对话摘要]')) {
+            result.push(messages[0]);
+            used += tokenCounts[0];
+        }
+        // 从末尾往前填充
+        const tail = [];
+        for (let i = messages.length - 1; i >= (result.length > 0 ? 1 : 0); i--) {
+            if (used + tokenCounts[i] > tokenBudget) {
+                break;
+            }
+            tail.unshift(messages[i]);
+            used += tokenCounts[i];
+        }
+        // 如果丢弃了消息，插入提示
+        const keptFromStart = result.length;
+        const keptFromEnd = tail.length;
+        const dropped = messages.length - keptFromStart - keptFromEnd;
+        if (dropped > 0) {
+            result.push({
+                role: 'system',
+                content: `[上下文截断] 省略了 ${dropped} 条较早的消息以适应上下文窗口。`,
+            });
+        }
+        result.push(...tail);
+        return result;
+    }
+    #conversationPath(id) {
+        return path.join(this.#dir, `${id}.jsonl`);
+    }
+    #deleteConversationFile(id) {
+        try {
+            const filePath = this.#conversationPath(id);
+            if (fs.existsSync(filePath)) {
+                fs.unlinkSync(filePath);
+            }
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    #loadIndex() {
+        try {
+            if (fs.existsSync(this.#indexPath)) {
+                return JSON.parse(fs.readFileSync(this.#indexPath, 'utf-8'));
+            }
+        }
+        catch {
+            /* corrupt — reset */
+        }
+        return [];
+    }
+    #saveIndex(index) {
+        try {
+            fs.mkdirSync(this.#dir, { recursive: true });
+            fs.writeFileSync(this.#indexPath, JSON.stringify(index, null, 2), 'utf-8');
+        }
+        catch (err) {
+            this.#logger.warn(`[ConversationStore] index save failed: ${err.message}`);
+        }
+    }
+}
+export default ConversationStore;
+//# sourceMappingURL=ConversationStore.js.map

package/dist/lib/service/agent/ConversationStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationStore.js","sourceRoot":"","sources":["../../../../lib/service/agent/ConversationStore.ts"],"names":[],"mappings":"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"}

package/dist/lib/service/agent/IntentClassifier.d.ts

@@ -0,0 +1,64 @@
+/**
+ * IntentClassifier — 自然语言意图分类器
+ *
+ * 核心问题: 用户通过飞书发了一句自然语言，应该交给谁处理？
+ *
+ *   ┌──────────────────────────────────────────────────────────┐
+ *   │  "帮我搜索一下项目里关于用户认证的知识"                 │
+ *   │   → bot_agent (知识管理任务，服务端 AgentRuntime 处理)    │
+ *   │                                                          │
+ *   │  "把 src/auth.ts 里的 JWT 验证改成 OAuth2"              │
+ *   │   → ide_agent (编程任务，转发到 VSCode Copilot)          │
+ *   │                                                          │
+ *   │  "现在服务状态怎么样"                                    │
+ *   │   → system (系统状态查询，本地直接处理)                   │
+ *   └──────────────────────────────────────────────────────────┘
+ *
+ * 三层分类策略 (延迟递增):
+ *   1. 规则匹配 — 零延迟关键词/模式 (~0ms)
+ *   2. 嵌入相似度 — 轻量向量匹配 (~50ms) [可选]
+ *   3. LLM 分类 — 精确但需 AI 调用 (~500ms)
+ *
+ * 设计原则:
+ *   - 宁可多走 LLM 也不要误分类 — 用户体验优先
+ *   - bot_agent 是默认，除非明确检测到编程意图
+ *   - 系统查询是硬编码模式，不走 AI
+ *
+ * @module IntentClassifier
+ */
+/**
+ * 意图类型
+ */
+export declare const Intent: Readonly<{
+    /** 知识管理任务 — 搜索/创建/分析知识，由服务端 AgentRuntime 处理 */
+    BOT_AGENT: "bot_agent";
+    /** IDE 编程任务 — 代码编写/修改/调试/重构，转发到 VSCode Copilot */
+    IDE_AGENT: "ide_agent";
+    /** 系统操作 — 状态查询/截图/连接管理，本地直接处理 */
+    SYSTEM: "system";
+}>;
+export declare class IntentClassifier {
+    #private;
+    /**
+     * @param {Object} opts
+     * @param {import('../../external/ai/AiProvider.js').AiProvider} [opts.aiProvider]
+     */
+    constructor({ aiProvider }?: {
+        aiProvider?: null | undefined;
+    });
+    /**
+     * 分类用户消息意图
+     *
+     * @param {string} text 用户原始消息文本
+     * @param {Object} [context] 额外上下文 (如对话历史、最近操作)
+     * @returns {Promise<ClassificationResult>}
+     */
+    classify(text: string, context?: Record<string, unknown>): Promise<{
+        intent: string;
+        confidence: number;
+        reasoning: string;
+        method: string;
+    }>;
+}
+export default IntentClassifier;
+//# sourceMappingURL=IntentClassifier.d.ts.map

package/dist/lib/service/agent/IntentClassifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntentClassifier.d.ts","sourceRoot":"","sources":["../../../../lib/service/agent/IntentClassifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAKH;;GAEG;AACH,eAAO,MAAM,MAAM;IACjB,+CAA+C;;IAE/C,kDAAkD;;IAElD,iCAAiC;;EAEjC,CAAC;AA2HH,qBAAa,gBAAgB;;IAK3B;;;OAGG;gBACS,EAAE,UAAiB,EAAE;;KAAK;IAKtC;;;;;;OAMG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;gBAiJnC,MAAM;;;;;CAatC;AAED,eAAe,gBAAgB,CAAC"}