@zooique/memora 2.0.0 → 3.0.0

package/dist/agent/managers/autoConfigRefiner.d.ts

@@ -1,39 +0,0 @@
-/**
- * AutoConfigRefiner — Agent 智能总结接口（模式 3）
- *
- * 从对话中提取配置建议（规则/角色/技能），通过 ConfigManager.onConfigSuggestion 通知宿主。
- *
- * 设计原则：
- *   - 使用后台 Provider（setBackgroundProvider 注入），不占用前台对话资源
- *   - 无后台 Provider 时降级为启发式规则提取
- *   - 每次对话后异步执行，不阻塞主流程
- *   - 置信度低于阈值时静默跳过
- */
-import type { LlmProvider } from '../../llm/provider.js';
-import type { ConfigSuggestion } from '../../agent/managers/configManager.js';
-/** AutoConfigRefiner 配置 */
-export interface AutoConfigRefinerOptions {
-    /** 最低置信度阈值（0-1），低于此值的建议被丢弃 */
-    minConfidence?: number;
-    /** 单次对话最大建议数 */
-    maxSuggestions?: number;
-}
-export declare class AutoConfigRefiner {
-    private readonly onConfigSuggestion;
-    private readonly options;
-    private backgroundProvider;
-    constructor(onConfigSuggestion: (suggestion: ConfigSuggestion) => void, options?: AutoConfigRefinerOptions);
-    /** 注入后台 Provider（由 Agent.setBackgroundProvider 调用） */
-    setBackgroundProvider(provider: LlmProvider | null): void;
-    /**
-     * 分析对话，提取配置建议
-     *
-     * 在 Agent.postProcess 中异步调用，不阻塞主流程。
-     */
-    analyze(userInput: string, assistantContent: string): Promise<void>;
-    /** 使用后台 LLM 分析对话 */
-    private analyzeWithLlm;
-    /** 启发式规则提取（无 LLM 时的降级方案） */
-    private analyzeWithHeuristics;
-}
-//# sourceMappingURL=autoConfigRefiner.d.ts.map

package/dist/agent/managers/autoConfigRefiner.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"autoConfigRefiner.d.ts","sourceRoot":"","sources":["../../../src/agent/managers/autoConfigRefiner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,WAAW,EAAW,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAI1E,2BAA2B;AAC3B,MAAM,WAAW,wBAAwB;IACvC,8BAA8B;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAiBD,qBAAa,iBAAiB;IAK1B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IAJrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,kBAAkB,CAA4B;gBAGnC,kBAAkB,EAAE,CAAC,UAAU,EAAE,gBAAgB,KAAK,IAAI,EAC3E,OAAO,CAAC,EAAE,wBAAwB;IAKpC,sDAAsD;IACtD,qBAAqB,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI;IAIzD;;;;OAIG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA6CzE,oBAAoB;YACN,cAAc;IAqD5B,4BAA4B;IAC5B,OAAO,CAAC,qBAAqB;CAiD9B"}

package/dist/agent/managers/autoConfigRefiner.js

@@ -1,150 +0,0 @@
-import { logger } from '../../logging/logger.js';
-import { parseLlmJson } from '../../utils/json.js';
-const DEFAULT_OPTIONS = {
-    minConfidence: 0.6,
-    maxSuggestions: 3,
-};
-export class AutoConfigRefiner {
-    onConfigSuggestion;
-    options;
-    backgroundProvider = null;
-    constructor(onConfigSuggestion, options) {
-        this.onConfigSuggestion = onConfigSuggestion;
-        this.options = { ...DEFAULT_OPTIONS, ...options };
-    }
-    /** 注入后台 Provider（由 Agent.setBackgroundProvider 调用） */
-    setBackgroundProvider(provider) {
-        this.backgroundProvider = provider;
-    }
-    /**
-     * 分析对话，提取配置建议
-     *
-     * 在 Agent.postProcess 中异步调用，不阻塞主流程。
-     */
-    async analyze(userInput, assistantContent) {
-        // 短对话跳过（信息量不足）
-        if (userInput.length < 20 || assistantContent.length < 20) {
-            return;
-        }
-        let suggestions;
-        if (this.backgroundProvider) {
-            suggestions = await this.analyzeWithLlm(userInput, assistantContent);
-        }
-        else {
-            suggestions = this.analyzeWithHeuristics(userInput);
-        }
-        // 过滤低置信度 + 限制数量
-        const filtered = suggestions
-            .filter((s) => s.confidence >= this.options.minConfidence)
-            .slice(0, this.options.maxSuggestions);
-        for (const raw of filtered) {
-            const suggestion = {
-                type: raw.type,
-                name: raw.name,
-                content: raw.content,
-                confidence: raw.confidence,
-                source: 'auto-config-refiner',
-            };
-            logger.info({ type: raw.type, name: raw.name, confidence: raw.confidence, reason: raw.reason }, 'AutoConfigRefiner: 提取到配置建议');
-            // 单条建议回调失败时记日志并继续处理下一条，避免一条失败导致后续全部丢失
-            try {
-                this.onConfigSuggestion(suggestion);
-            }
-            catch (err) {
-                logger.warn({ err, suggestionName: raw.name, suggestionType: raw.type }, 'AutoConfigRefiner: 单条建议回调失败，跳过该条继续处理');
-            }
-        }
-    }
-    /** 使用后台 LLM 分析对话 */
-    async analyzeWithLlm(userInput, assistantContent) {
-        if (!this.backgroundProvider)
-            return [];
-        const systemPrompt = `你是一个配置分析助手。分析用户和助手的对话，提取可能的配置建议。
-
-规则（rule）：用户反复提到的偏好、约束或工作方式
-角色（persona）：用户的工作角色或专业领域
-技能（skill）：用户经常需要的能力或工具
-
-返回 JSON 数组，每个元素包含：
-- type: "rule" | "persona" | "skill"
-- name: 简短名称（2-6字）
-- content: Markdown 格式的详细内容
-- confidence: 0-1 置信度
-- reason: 为什么提出此建议
-
-如果没有有价值的建议，返回空数组 []。
-只返回 JSON，不要其他内容。`;
-        const messages = [
-            { role: 'system', content: systemPrompt },
-            {
-                role: 'user',
-                content: `用户输入：${userInput.slice(0, 500)}\n\n助手回复：${assistantContent.slice(0, 500)}`,
-            },
-        ];
-        try {
-            // 收集流式输出
-            let fullContent = '';
-            for await (const chunk of this.backgroundProvider.chat(messages, {
-                temperature: 0.3,
-            })) {
-                if (chunk.content) {
-                    fullContent += chunk.content;
-                }
-            }
-            const parsed = parseLlmJson(fullContent || '[]');
-            const items = Array.isArray(parsed) ? parsed : parsed?.suggestions ?? [];
-            return items.filter((s) => s.type && s.name && s.content && typeof s.confidence === 'number');
-        }
-        catch (err) {
-            logger.warn({ err }, 'AutoConfigRefiner: LLM 分析失败，跳过');
-            return [];
-        }
-    }
-    /** 启发式规则提取（无 LLM 时的降级方案） */
-    analyzeWithHeuristics(userInput) {
-        const suggestions = [];
-        const input = userInput.toLowerCase();
-        // 检测明确的偏好声明（"我喜欢..."、"我习惯..."、"我偏好..."）
-        const preferencePatterns = [
-            /我(?:喜欢|偏好|习惯|常用|一般用)\s*(.{2,20})/gu,
-            /(?:always|prefer|usually|typically)\s+(?:use|work with)\s+(.{2,20})/giu,
-        ];
-        for (const pattern of preferencePatterns) {
-            const matches = input.matchAll(pattern);
-            for (const match of matches) {
-                const captured = match[1]?.trim() ?? '';
-                const original = match[0] ?? '';
-                if (!captured)
-                    continue;
-                suggestions.push({
-                    type: 'rule',
-                    name: `偏好-${captured.slice(0, 10)}`,
-                    content: `用户偏好：${captured}`,
-                    confidence: 0.65,
-                    reason: `检测到明确的偏好声明：${original}`,
-                });
-            }
-        }
-        // 检测专业领域关键词
-        const domainKeywords = {
-            '代码|编程|bug|debug|重构|函数|接口': '程序员助手',
-            '设计|UI|UX|原型|交互|视觉': '设计师助手',
-            '写作|文案|编辑|文章|内容': '写作助手',
-            '数据|分析|报表|统计|指标': '数据分析师',
-        };
-        for (const [keywordPattern, personaName] of Object.entries(domainKeywords)) {
-            const regex = new RegExp(keywordPattern, 'iu');
-            if (regex.test(input)) {
-                suggestions.push({
-                    type: 'persona',
-                    name: personaName,
-                    content: `专业领域：${personaName}。用户对话中频繁出现相关术语。`,
-                    confidence: 0.6,
-                    reason: `检测到${personaName}领域关键词`,
-                });
-            }
-        }
-        return suggestions;
-    }
-}
-//# sourceMappingURL=autoConfigRefiner.js.map

package/dist/agent/managers/autoConfigRefiner.js.map

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

package/dist/agent/managers/configManager.d.ts

@@ -1,125 +0,0 @@
-/**
- * 配置管理器 — 规则/技能注入 + 配置建议持久化
- *
- * 从 Agent 拆分出来，负责：
- *   - addRule / addSimpleRule：运行时规则注入（SQLite + System Prompt）
- *   - addSkill / addSimpleSkill：运行时技能注入（仅 SkillManager，session-only）
- *   - onConfigSuggestion / confirmConfigSuggestion：模式 3 配置建议回调 + 持久化
- *
- * 设计原则：
- *   - 独立于 Agent 生命周期，仅依赖 Storage / SkillManager / Loop
- *   - 不持有 LLM Provider（纯配置操作）
- */
-import type { Memory } from '../../memory/types.js';
-import type { IMemoryStorage } from '../../memory/storageInterface.js';
-import type { SkillManager } from '../../skill/skillManager.js';
-/**
- * 配置建议（模式 3 · Agent 智能总结）
- *
- * AutoConfigRefiner 从对话中提取的配置建议，通过 onConfigSuggestion 回调通知宿主。
- * 宿主决定展示方式（桌宠气泡 / CLI 打印 / WebUI 弹窗），
- * 用户确认后调用 confirmConfigSuggestion() 写入配置文件。
- *
- * 与 addRule() 的区别：
- * - addRule() 写入 SQLite（运行时注入，会话级）
- * - confirmConfigSuggestion() 写入配置文件（持久化，重启后依然生效）
- */
-export interface ConfigSuggestion {
-    /**
-     * 建议类型（开放字符串，对齐 ADR-004 基元驱动模型）
-     *
-     * 约定值：'rule' | 'persona' | 'skill'（由 sourceMap 映射到 SOURCE_LABELS）
-     * 扩展值：任意字符串，需配合 `memorySource` 字段直接指定记忆 source 标签
-     */
-    type: string;
-    /** 建议名称（如"代码风格"、"TypeScript 偏好"） */
-    name: string;
-    /** 建议内容（Markdown 格式） */
-    content: string;
-    /** 置信度 0-1，低于阈值时宿主可选择性忽略 */
-    confidence: number;
-    /** 建议来源（如对话摘要、用户画像分析） */
-    source?: string;
-    /**
-     * 可选：直接指定记忆 source 标签（绕过 sourceMap）
-     *
-     * 当 type 不在约定值内时，必须提供此字段，否则 confirmConfigSuggestion 抛 configError。
-     */
-    memorySource?: string;
-}
-/** 配置建议回调函数类型 */
-export type ConfigSuggestionHandler = (suggestion: ConfigSuggestion) => void;
-export declare class ConfigManager {
-    private readonly index;
-    private readonly skillManager;
-    private readonly injectSystemMessage;
-    private readonly writeConfigFile?;
-    /** 配置建议回调（模式 3） */
-    private suggestionHandler;
-    /**
-     * @param index - 记忆存储（规则写入 SQLite）
-     * @param skillManager - 技能管理器（运行时注入技能）
-     * @param injectSystemMessage - 注入 system 消息的回调（来自 AgentLoop）
-     * @param writeConfigFile - 写入配置文件的回调（来自 Agent，解耦 FileStore 依赖）
-     */
-    constructor(index: IMemoryStorage, skillManager: SkillManager, injectSystemMessage: (message: string) => void, writeConfigFile?: ((memory: Memory) => Promise<void>) | undefined);
-    /**
-     * 注册配置建议回调（模式 3）
-     *
-     * 宿主项目通过此方法注册回调，当 AutoConfigRefiner 从对话中
-     * 提取到配置建议时，通过此回调通知宿主。
-     */
-    onConfigSuggestion(handler: ConfigSuggestionHandler): void;
-    /** 获取当前注册的配置建议回调 */
-    get suggestionCallback(): ConfigSuggestionHandler | null;
-    /**
-     * 确认配置建议并写入配置文件（模式 3）
-     *
-     * 用户确认配置建议后，宿主调用此方法将建议持久化到 configDir/ 目录。
-     * 写入的是配置文件（真理源），下次启动时 MemoryLoader 自动扫描加载到 SQLite。
-     *
-     * 与 addRule() 的关键区别：
-     * - addRule() → 写入 SQLite（运行时注入，会话级，重启后需重新注入）
-     * - confirmConfigSuggestion() → 写入配置文件（持久化，重启后自动加载）
-     */
-    confirmConfigSuggestion(suggestion: ConfigSuggestion): Promise<void>;
-    /**
-     * 新增项目规则记忆（Q-701 · v1.1）
-     *
-     * 宿主项目可通过此 API 在运行时动态注入规则记忆。
-     * 规则写入 SQLite 索引后，重启时由 bootstrap 自动召回。
-     * 当前轮次以 system 消息注入 AgentLoop。
-     */
-    addRule(memory: Memory): Promise<void>;
-    /**
-     * 新增项目规则的便捷方法
-     *
-     * 宿主程序只需提供 name + content 两个业务字段，
-     * 内部自动填充 id / source / createdAt / accessedAt / score 等字段。
-     */
-    addSimpleRule(name: string, content: string): Promise<void>;
-    /**
-     * 运行时动态注入技能（session-only）
-     *
-     * 技能在 Skill 的设计中属于"配置型记忆"——
-     * 由 SkillManager 在内存中管理，通过关键词匹配触发，
-     * 同时写入 SQLite 索引（source: skill）以支持 recall() 检索。
-     *
-     * 路径一（文件加载）：SkillManager.load() 扫描 configDir/skills/*.md → 内存 + SQLite
-     * 路径二（运行时注入）：addSkill() → SkillManager.register() → 内存 + SQLite
-     * 路径三（持久化新增）：config.confirmConfigSuggestion({type:'skill',...}) → 写配置文件 → 下次 load() 自动加载
-     *
-     * 注意：运行时注入的技能仅在当前会话内生效，重启后需重新注入。
-     * 如需跨会话持久化，宿主应调用 config.confirmConfigSuggestion() 写入配置文件。
-     */
-    addSkill(memory: Memory): Promise<void>;
-    /**
-     * 运行时注入技能的便捷方法（session-only）
-     *
-     * 宿主程序只需提供 name + content 两个业务字段，
-     * 内部自动填充 id / source / createdAt / accessedAt / score。
-     * 注入后仅在当前会话生效，持久化需调用 config.confirmConfigSuggestion()。
-     */
-    addSimpleSkill(name: string, content: string, keywords?: string[]): Promise<void>;
-}
-//# sourceMappingURL=configManager.d.ts.map

package/dist/agent/managers/configManager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"configManager.d.ts","sourceRoot":"","sources":["../../../src/agent/managers/configManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAO5D;;;;;;;;;;GAUG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,iBAAiB;AACjB,MAAM,MAAM,uBAAuB,GAAG,CAAC,UAAU,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAI7E,qBAAa,aAAa;IAWtB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IACpC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;IAbnC,mBAAmB;IACnB,OAAO,CAAC,iBAAiB,CAAwC;IAEjE;;;;;OAKG;gBAEgB,KAAK,EAAE,cAAc,EACrB,YAAY,EAAE,YAAY,EAC1B,mBAAmB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,EAC9C,eAAe,CAAC,GAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,aAAA;IAKtE;;;;;OAKG;IACH,kBAAkB,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI;IAI1D,oBAAoB;IACpB,IAAI,kBAAkB,IAAI,uBAAuB,GAAG,IAAI,CAEvD;IAED;;;;;;;;;OASG;IACG,uBAAuB,CAAC,UAAU,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqE1E;;;;;;OAMG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe5C;;;;;OAKG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBjE;;;;;;;;;;;;;OAaG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB7C;;;;;;OAMG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAc5F"}

package/dist/agent/managers/configManager.js

@@ -1,194 +0,0 @@
-import { SOURCE_LABELS } from '../../memory/types.js';
-import { configError, toError } from '../../utils/errors.js';
-import { logger } from '../../logging/logger.js';
-import { nowIso } from '../../utils/time.js';
-// ─── 类 ──────────────────────────────────────────────────
-export class ConfigManager {
-    index;
-    skillManager;
-    injectSystemMessage;
-    writeConfigFile;
-    /** 配置建议回调（模式 3） */
-    suggestionHandler = null;
-    /**
-     * @param index - 记忆存储（规则写入 SQLite）
-     * @param skillManager - 技能管理器（运行时注入技能）
-     * @param injectSystemMessage - 注入 system 消息的回调（来自 AgentLoop）
-     * @param writeConfigFile - 写入配置文件的回调（来自 Agent，解耦 FileStore 依赖）
-     */
-    constructor(index, skillManager, injectSystemMessage, writeConfigFile) {
-        this.index = index;
-        this.skillManager = skillManager;
-        this.injectSystemMessage = injectSystemMessage;
-        this.writeConfigFile = writeConfigFile;
-    }
-    // ─── 配置建议 ─────────────────────────────────────────
-    /**
-     * 注册配置建议回调（模式 3）
-     *
-     * 宿主项目通过此方法注册回调，当 AutoConfigRefiner 从对话中
-     * 提取到配置建议时，通过此回调通知宿主。
-     */
-    onConfigSuggestion(handler) {
-        this.suggestionHandler = handler;
-    }
-    /** 获取当前注册的配置建议回调 */
-    get suggestionCallback() {
-        return this.suggestionHandler;
-    }
-    /**
-     * 确认配置建议并写入配置文件（模式 3）
-     *
-     * 用户确认配置建议后，宿主调用此方法将建议持久化到 configDir/ 目录。
-     * 写入的是配置文件（真理源），下次启动时 MemoryLoader 自动扫描加载到 SQLite。
-     *
-     * 与 addRule() 的关键区别：
-     * - addRule() → 写入 SQLite（运行时注入，会话级，重启后需重新注入）
-     * - confirmConfigSuggestion() → 写入配置文件（持久化，重启后自动加载）
-     */
-    async confirmConfigSuggestion(suggestion) {
-        if (!this.writeConfigFile) {
-            throw configError('writeConfigFile 未设置', '模式 3 需要注入配置文件写入回调才能持久化', [
-                '在 Agent 构造时传入 configDir 参数（Agent 会自动创建 FileStore 并注入回调）',
-            ]);
-        }
-        // 根据建议类型映射到 source 标签（ADR-004：开放字符串，约定值走 sourceMap，扩展值走 memorySource）
-        const sourceMap = {
-            rule: SOURCE_LABELS.RULE,
-            persona: SOURCE_LABELS.PERSONA,
-            skill: SOURCE_LABELS.SKILL,
-        };
-        // 优先级：memorySource（扩展值）> sourceMap[type]（约定值）
-        const source = suggestion.memorySource ?? sourceMap[suggestion.type];
-        if (!source) {
-            throw configError('无法确定配置建议的 source 标签', `type='${suggestion.type}' 不在约定值（rule/persona/skill）内，且未提供 memorySource 字段`, [
-                '使用约定 type 值（rule/persona/skill）',
-                '或提供 memorySource 字段指定自定义 source 标签',
-            ]);
-        }
-        // 构造记忆对象并写入配置文件（真理源）
-        // 不写入 SQLite——遵守"配置文件是真理源"约束
-        const now = nowIso();
-        const memory = {
-            id: `${source}:${suggestion.name}`,
-            content: suggestion.content,
-            source,
-            name: suggestion.name,
-            createdAt: now,
-            accessedAt: now,
-            score: suggestion.confidence,
-        };
-        // 包裹错误处理：磁盘满/权限不足/路径越界等异常转为友好的 configError
-        try {
-            await this.writeConfigFile(memory);
-        }
-        catch (err) {
-            const e = toError(err);
-            throw configError('配置文件写入失败', `source=${source} name=${suggestion.name} 错误：${e.message}`, [
-                '检查 configDir 路径是否存在且可写',
-                '确认磁盘空间充足',
-                '确认进程对配置目录有写权限',
-            ], e);
-        }
-        // 如果是规则，立即注入到 AgentLoop（当前会话生效，重启后由配置文件自动加载）
-        if (suggestion.type === 'rule') {
-            const rulePrompt = `【项目规则】${suggestion.name}\n${suggestion.content}`;
-            this.injectSystemMessage(rulePrompt);
-        }
-        logger.info({ type: suggestion.type, name: suggestion.name, confidence: suggestion.confidence }, '配置建议已确认并写入配置文件');
-    }
-    // ─── 规则注入 ─────────────────────────────────────────
-    /**
-     * 新增项目规则记忆（Q-701 · v1.1）
-     *
-     * 宿主项目可通过此 API 在运行时动态注入规则记忆。
-     * 规则写入 SQLite 索引后，重启时由 bootstrap 自动召回。
-     * 当前轮次以 system 消息注入 AgentLoop。
-     */
-    async addRule(memory) {
-        if (memory.source !== SOURCE_LABELS.RULE) {
-            throw configError('无效来源', `addRule 只接受 source='rule'，收到 '${memory.source}'`, [
-                '使用 SOURCE_LABELS.RULE 作为 source 字段',
-            ]);
-        }
-        this.index.upsert(memory);
-        const rulePrompt = `【项目规则】${memory.name}\n${memory.content}`;
-        this.injectSystemMessage(rulePrompt);
-        logger.info({ name: memory.name, source: memory.source }, '项目规则已注入');
-    }
-    /**
-     * 新增项目规则的便捷方法
-     *
-     * 宿主程序只需提供 name + content 两个业务字段，
-     * 内部自动填充 id / source / createdAt / accessedAt / score 等字段。
-     */
-    async addSimpleRule(name, content) {
-        const now = nowIso();
-        const memory = {
-            id: `rule:${name}`,
-            content,
-            source: SOURCE_LABELS.RULE,
-            name,
-            createdAt: now,
-            accessedAt: now,
-            score: 0.8,
-        };
-        await this.addRule(memory);
-    }
-    // ─── 技能注入 ─────────────────────────────────────────
-    /**
-     * 运行时动态注入技能（session-only）
-     *
-     * 技能在 Skill 的设计中属于"配置型记忆"——
-     * 由 SkillManager 在内存中管理，通过关键词匹配触发，
-     * 同时写入 SQLite 索引（source: skill）以支持 recall() 检索。
-     *
-     * 路径一（文件加载）：SkillManager.load() 扫描 configDir/skills/*.md → 内存 + SQLite
-     * 路径二（运行时注入）：addSkill() → SkillManager.register() → 内存 + SQLite
-     * 路径三（持久化新增）：config.confirmConfigSuggestion({type:'skill',...}) → 写配置文件 → 下次 load() 自动加载
-     *
-     * 注意：运行时注入的技能仅在当前会话内生效，重启后需重新注入。
-     * 如需跨会话持久化，宿主应调用 config.confirmConfigSuggestion() 写入配置文件。
-     */
-    async addSkill(memory) {
-        if (memory.source !== SOURCE_LABELS.SKILL) {
-            throw configError('无效来源', `addSkill 只接受 source='skill'，收到 '${memory.source}'`, [
-                '使用 SOURCE_LABELS.SKILL 作为 source 字段',
-            ]);
-        }
-        // 写入 SQLite 索引（遵循"万物皆记忆"——与 PersonaManager 一致）
-        this.index.upsert(memory);
-        // 同时注册到 SkillManager（内存缓存，用于关键词匹配）
-        this.skillManager.register({
-            name: memory.name,
-            keywords: [],
-            content: memory.content,
-            description: memory.content.slice(0, 80),
-            filePath: '',
-            layer: 'agent',
-        });
-        logger.info({ name: memory.name }, '技能已注入');
-    }
-    /**
-     * 运行时注入技能的便捷方法（session-only）
-     *
-     * 宿主程序只需提供 name + content 两个业务字段，
-     * 内部自动填充 id / source / createdAt / accessedAt / score。
-     * 注入后仅在当前会话生效，持久化需调用 config.confirmConfigSuggestion()。
-     */
-    async addSimpleSkill(name, content, keywords = []) {
-        void keywords; // 基元驱动模型下关键词暂不存储到 Memory，由 SkillManager 管理
-        const now = nowIso();
-        const memory = {
-            id: `skill:${name}`,
-            content,
-            source: SOURCE_LABELS.SKILL,
-            name,
-            createdAt: now,
-            accessedAt: now,
-            score: 0.7,
-        };
-        await this.addSkill(memory);
-    }
-}
-//# sourceMappingURL=configManager.js.map

package/dist/agent/managers/configManager.js.map

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