@zooique/memora 2.0.0 → 2.0.3

package/dist/agent/managers/autoConfigRefiner.js

@@ -1,5 +1,6 @@
 import { logger } from '../../logging/logger.js';
 import { parseLlmJson } from '../../utils/json.js';
+import { accumulateStream } from '../../agent/managers/streamAccumulator.js';
 const DEFAULT_OPTIONS = {
     minConfidence: 0.6,
     maxSuggestions: 3,
@@ -82,15 +83,10 @@ export class AutoConfigRefiner {
             },
         ];
         try {
-            // 收集流式输出
-            let fullContent = '';
-            for await (const chunk of this.backgroundProvider.chat(messages, {
+            // 收集流式输出（复用 accumulateStream 工具函数）
+            const fullContent = await accumulateStream(this.backgroundProvider, 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');

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

@@ -1 +1 @@
-{"version":3,"file":"autoConfigRefiner.js","sourceRoot":"","sources":["../../../src/agent/managers/autoConfigRefiner.ts"],"names":[],"mappings":"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"}
+{"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,14 +1,18 @@
 /**
- * 配置管理器 — 规则/技能注入 + 配置建议持久化
+ * 配置管理器 — 规则/技能注入 + 配置建议持久化 + 设定 CRUD
  *
  * 从 Agent 拆分出来，负责：
  *   - addRule / addSimpleRule：运行时规则注入（SQLite + System Prompt）
  *   - addSkill / addSimpleSkill：运行时技能注入（仅 SkillManager，session-only）
  *   - onConfigSuggestion / confirmConfigSuggestion：模式 3 配置建议回调 + 持久化
+ *   - deleteRule / updateRule / listRules：规则单条 CRUD（SQLite + System Prompt 同步）
+ *   - deleteSkill / listSkills：技能单条删除与列表（SQLite + SkillManager 内存同步）
+ *   - getBootstrapMemories：获取 rule + skill 记忆（供 AgentLoop 刷新 system prompt）
  *
  * 设计原则：
- *   - 独立于 Agent 生命周期，仅依赖 Storage / SkillManager / Loop
+ *   - 独立于 Agent 生命周期，仅依赖 Storage / SkillManager / 回调
  *   - 不持有 LLM Provider（纯配置操作）
+ *   - 不直接操作文件（文件 CRUD 由宿主层 configFileManager 处理，本类只管 SQLite + system prompt 同步）
  */
 import type { Memory } from '../../memory/types.js';
 import type { IMemoryStorage } from '../../memory/storageInterface.js';
@@ -46,6 +50,14 @@ export interface ConfigSuggestion {
      * 当 type 不在约定值内时，必须提供此字段，否则 confirmConfigSuggestion 抛 configError。
      */
     memorySource?: string;
+    /**
+     * 可选：写入配置文件 frontmatter 的额外元数据
+     *
+     * 键值对会合并到 frontmatter 中（如 `keywords`、`description`），
+     * 供 PersonaManager.parseKeywords / SkillManager 等加载时解析。
+     * 不传时 frontmatter 仅含标准字段（id/source/score/createdAt/accessedAt）。
+     */
+    metadata?: Record<string, string>;
 }
 /** 配置建议回调函数类型 */
 export type ConfigSuggestionHandler = (suggestion: ConfigSuggestion) => void;
@@ -54,6 +66,7 @@ export declare class ConfigManager {
     private readonly skillManager;
     private readonly injectSystemMessage;
     private readonly writeConfigFile?;
+    private readonly refreshBootstrapMemories?;
     /** 配置建议回调（模式 3） */
     private suggestionHandler;
     /**
@@ -61,8 +74,11 @@ export declare class ConfigManager {
      * @param skillManager - 技能管理器（运行时注入技能）
      * @param injectSystemMessage - 注入 system 消息的回调（来自 AgentLoop）
      * @param writeConfigFile - 写入配置文件的回调（来自 Agent，解耦 FileStore 依赖）
+     * @param refreshBootstrapMemories - 刷新 AgentLoop system prompt 中 bootstrap 段的回调
+     *   设定 CRUD（deleteRule/updateRule/deleteSkill）后调用，使 system prompt 中的
+     *   rule/skill 段立即同步。由 Agent 在装配时注入（assembler.ts）。
      */
-    constructor(index: IMemoryStorage, skillManager: SkillManager, injectSystemMessage: (message: string) => void, writeConfigFile?: ((memory: Memory) => Promise<void>) | undefined);
+    constructor(index: IMemoryStorage, skillManager: SkillManager, injectSystemMessage: (message: string) => void, writeConfigFile?: ((memory: Memory) => Promise<void>) | undefined, refreshBootstrapMemories?: (() => void) | undefined);
     /**
      * 注册配置建议回调（模式 3）
      *
@@ -121,5 +137,73 @@ export declare class ConfigManager {
      * 注入后仅在当前会话生效，持久化需调用 config.confirmConfigSuggestion()。
      */
     addSimpleSkill(name: string, content: string, keywords?: string[]): Promise<void>;
+    /**
+     * 删除规则（设定面板调用）
+     *
+     * 软删除 SQLite 中 source='rule' name=name 的记忆，
+     * 并刷新 AgentLoop system prompt 中的 bootstrap 段。
+     *
+     * 文件层删除由宿主层 configFileManager 处理（本方法不操作文件）。
+     * 删除后调用 refreshBootstrapMemories 回调，使 system prompt 立即同步。
+     *
+     * @param name 规则名（与 frontmatter name 字段一致）
+     * @returns true 删除成功；false 规则不存在
+     */
+    deleteRule(name: string): boolean;
+    /**
+     * 更新规则内容（设定面板调用）
+     *
+     * upsert SQLite 中 source='rule' name=name 的记忆，
+     * 并刷新 AgentLoop system prompt 中的 bootstrap 段。
+     *
+     * 文件层更新由宿主层 configFileManager 处理（本方法不操作文件）。
+     * 与 addRule 的区别：addRule 是新增（追加 system 消息），
+     * updateRule 是覆盖更新（刷新 bootstrap 段，不追加 system 消息）。
+     *
+     * content 处理：调用方传入的是完整文件内容（含 frontmatter + body），
+     * 本方法用 parseFrontmatter 解析后只存 body.trim()，
+     * 与 FileStore.parseMemory（store.ts）保持一致——避免 system prompt bootstrap 段
+     * 含 frontmatter 噪音，且重启后 MemoryLoader 重新加载时内容一致。
+     *
+     * @param name 规则名
+     * @param content 新的规则文件内容（含 frontmatter + body）
+     */
+    updateRule(name: string, content: string): void;
+    /**
+     * 列出所有规则（设定面板调用）
+     *
+     * @returns 所有 source='rule' 的活跃记忆（按 score 降序）
+     */
+    listRules(): Memory[];
+    /**
+     * 删除技能（设定面板调用）
+     *
+     * 软删除 SQLite 中 source='skill' name=name 的记忆，
+     * 同步清理 SkillManager 内存缓存，
+     * 并刷新 AgentLoop system prompt 中的 bootstrap 段。
+     *
+     * 文件层删除由宿主层 configFileManager 处理（本方法不操作文件）。
+     *
+     * @param name 技能名
+     * @returns true 删除成功；false 技能不存在
+     */
+    deleteSkill(name: string): boolean;
+    /**
+     * 列出所有技能（设定面板调用）
+     *
+     * @returns 所有 source='skill' 的活跃记忆（按 score 降序）
+     */
+    listSkills(): Memory[];
+    /**
+     * 获取 bootstrap 记忆（仅 Rule，供 AgentLoop 刷新 system prompt）
+     *
+     * AgentLoop 的 system prompt 中包含 bootstrap 段（rule 记忆）。
+     * Skill 已迁移到 per-round matchAndInjectSkill 动态注入，不再放入 bootstrap。
+     * 设定 CRUD 后调用 refreshBootstrapMemories 回调，回调内部调用此方法
+     * 获取最新的 rule 记忆，传给 AgentLoop.refreshBootstrapMemories()。
+     *
+     * @returns rule 活跃记忆数组
+     */
+    getBootstrapMemories(): Memory[];
 }
 //# sourceMappingURL=configManager.d.ts.map

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

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"configManager.d.ts","sourceRoot":"","sources":["../../../src/agent/managers/configManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;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;AAS5D;;;;;;;;;;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;IACtB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,iBAAiB;AACjB,MAAM,MAAM,uBAAuB,GAAG,CAAC,UAAU,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAI7E,qBAAa,aAAa;IActB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IACpC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IAjB5C,mBAAmB;IACnB,OAAO,CAAC,iBAAiB,CAAwC;IAEjE;;;;;;;;OAQG;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,EACnD,wBAAwB,CAAC,GAAE,MAAM,IAAI,aAAA;IAKxD;;;;;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;IA6E1E;;;;;;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;IAiB3F;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAajC;;;;;;;;;;;;;;;;;OAiBG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAwB/C;;;;OAIG;IACH,SAAS,IAAI,MAAM,EAAE;IAIrB;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAelC;;;;OAIG;IACH,UAAU,IAAI,MAAM,EAAE;IAItB;;;;;;;;;OASG;IACH,oBAAoB,IAAI,MAAM,EAAE;CAKjC"}

package/dist/agent/managers/configManager.js

@@ -2,12 +2,15 @@ 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';
+// parseFrontmatter：与 FileStore.parseMemory 保持一致的 content 处理（只存 body，去掉 frontmatter）
+import { parseFrontmatter } from '../../utils/frontmatter.js';
 // ─── 类 ──────────────────────────────────────────────────
 export class ConfigManager {
     index;
     skillManager;
     injectSystemMessage;
     writeConfigFile;
+    refreshBootstrapMemories;
     /** 配置建议回调（模式 3） */
     suggestionHandler = null;
     /**
@@ -15,12 +18,16 @@ export class ConfigManager {
      * @param skillManager - 技能管理器（运行时注入技能）
      * @param injectSystemMessage - 注入 system 消息的回调（来自 AgentLoop）
      * @param writeConfigFile - 写入配置文件的回调（来自 Agent，解耦 FileStore 依赖）
+     * @param refreshBootstrapMemories - 刷新 AgentLoop system prompt 中 bootstrap 段的回调
+     *   设定 CRUD（deleteRule/updateRule/deleteSkill）后调用，使 system prompt 中的
+     *   rule/skill 段立即同步。由 Agent 在装配时注入（assembler.ts）。
      */
-    constructor(index, skillManager, injectSystemMessage, writeConfigFile) {
+    constructor(index, skillManager, injectSystemMessage, writeConfigFile, refreshBootstrapMemories) {
         this.index = index;
         this.skillManager = skillManager;
         this.injectSystemMessage = injectSystemMessage;
         this.writeConfigFile = writeConfigFile;
+        this.refreshBootstrapMemories = refreshBootstrapMemories;
     }
     // ─── 配置建议 ─────────────────────────────────────────
     /**
@@ -67,7 +74,8 @@ export class ConfigManager {
             ]);
         }
         // 构造记忆对象并写入配置文件（真理源）
-        // 不写入 SQLite——遵守"配置文件是真理源"约束
+        // 写入 SQLite index（运行时索引）：配置文件是真理源，SQLite 是运行时检索索引
+        // 两层写入语义：配置文件保证重启后自动加载；SQLite 保证当前会话 search_memories 可检索
         const now = nowIso();
         const memory = {
             id: `${source}:${suggestion.name}`,
@@ -77,6 +85,8 @@ export class ConfigManager {
             createdAt: now,
             accessedAt: now,
             score: suggestion.confidence,
+            // metadata 透传到 FileStore.write，合并到 frontmatter（如 keywords/description）
+            metadata: suggestion.metadata,
         };
         // 包裹错误处理：磁盘满/权限不足/路径越界等异常转为友好的 configError
         try {
@@ -90,6 +100,10 @@ export class ConfigManager {
                 '确认进程对配置目录有写权限',
             ], e);
         }
+        // 同步写入 SQLite index：当前会话的 search_memories / recall 可立即检索到新创建的配置
+        // persona/skill 后续由 reloadConfig → SkillManager.reload / PersonaManager.reload 重新扫描覆盖，
+        // 但 rule 的 reloadConfig 是 no-op（agent.ts 内跳过），必须在此显式同步
+        this.index.upsert(memory);
         // 如果是规则，立即注入到 AgentLoop（当前会话生效，重启后由配置文件自动加载）
         if (suggestion.type === 'rule') {
             const rulePrompt = `【项目规则】${suggestion.name}\n${suggestion.content}`;
@@ -190,5 +204,128 @@ export class ConfigManager {
         };
         await this.addSkill(memory);
     }
+    // ─── 设定 CRUD（设定面板专用） ───────────────────────
+    /**
+     * 删除规则（设定面板调用）
+     *
+     * 软删除 SQLite 中 source='rule' name=name 的记忆，
+     * 并刷新 AgentLoop system prompt 中的 bootstrap 段。
+     *
+     * 文件层删除由宿主层 configFileManager 处理（本方法不操作文件）。
+     * 删除后调用 refreshBootstrapMemories 回调，使 system prompt 立即同步。
+     *
+     * @param name 规则名（与 frontmatter name 字段一致）
+     * @returns true 删除成功；false 规则不存在
+     */
+    deleteRule(name) {
+        const id = `rule:${name}`;
+        const existing = this.index.getById(id);
+        if (!existing) {
+            logger.warn({ name, id }, '删除规则失败：规则不存在');
+            return false;
+        }
+        this.index.delete(id);
+        this.refreshBootstrapMemories?.();
+        logger.info({ name, id }, '规则已删除');
+        return true;
+    }
+    /**
+     * 更新规则内容（设定面板调用）
+     *
+     * upsert SQLite 中 source='rule' name=name 的记忆，
+     * 并刷新 AgentLoop system prompt 中的 bootstrap 段。
+     *
+     * 文件层更新由宿主层 configFileManager 处理（本方法不操作文件）。
+     * 与 addRule 的区别：addRule 是新增（追加 system 消息），
+     * updateRule 是覆盖更新（刷新 bootstrap 段，不追加 system 消息）。
+     *
+     * content 处理：调用方传入的是完整文件内容（含 frontmatter + body），
+     * 本方法用 parseFrontmatter 解析后只存 body.trim()，
+     * 与 FileStore.parseMemory（store.ts）保持一致——避免 system prompt bootstrap 段
+     * 含 frontmatter 噪音，且重启后 MemoryLoader 重新加载时内容一致。
+     *
+     * @param name 规则名
+     * @param content 新的规则文件内容（含 frontmatter + body）
+     */
+    updateRule(name, content) {
+        const id = `rule:${name}`;
+        const existing = this.index.getById(id);
+        const now = nowIso();
+        // 与 FileStore.parseMemory 保持一致：只存 body（去掉 frontmatter），避免 system prompt 含噪音
+        const { body } = parseFrontmatter(content);
+        const memory = {
+            id,
+            content: body.trim(),
+            source: SOURCE_LABELS.RULE,
+            name,
+            createdAt: existing?.createdAt ?? now,
+            accessedAt: now,
+            score: existing?.score ?? 0.8,
+        };
+        // 若 existing 已软删除，需先 restore 再 upsert（避免"通过 upsert 复活软删除记忆"校验失败）
+        if (existing?.deletedAt) {
+            this.index.restore(id);
+        }
+        this.index.upsert(memory);
+        this.refreshBootstrapMemories?.();
+        logger.info({ name, id }, '规则已更新');
+    }
+    /**
+     * 列出所有规则（设定面板调用）
+     *
+     * @returns 所有 source='rule' 的活跃记忆（按 score 降序）
+     */
+    listRules() {
+        return this.index.getBySource(SOURCE_LABELS.RULE);
+    }
+    /**
+     * 删除技能（设定面板调用）
+     *
+     * 软删除 SQLite 中 source='skill' name=name 的记忆，
+     * 同步清理 SkillManager 内存缓存，
+     * 并刷新 AgentLoop system prompt 中的 bootstrap 段。
+     *
+     * 文件层删除由宿主层 configFileManager 处理（本方法不操作文件）。
+     *
+     * @param name 技能名
+     * @returns true 删除成功；false 技能不存在
+     */
+    deleteSkill(name) {
+        const id = `skill:${name}`;
+        const existing = this.index.getById(id);
+        if (!existing) {
+            logger.warn({ name, id }, '删除技能失败：技能不存在');
+            return false;
+        }
+        this.index.delete(id);
+        // 同步清理 SkillManager 内存缓存（deleteSkill 内部处理 name 不存在的情况）
+        this.skillManager.deleteSkill(name);
+        this.refreshBootstrapMemories?.();
+        logger.info({ name, id }, '技能已删除');
+        return true;
+    }
+    /**
+     * 列出所有技能（设定面板调用）
+     *
+     * @returns 所有 source='skill' 的活跃记忆（按 score 降序）
+     */
+    listSkills() {
+        return this.index.getBySource(SOURCE_LABELS.SKILL);
+    }
+    /**
+     * 获取 bootstrap 记忆（仅 Rule，供 AgentLoop 刷新 system prompt）
+     *
+     * AgentLoop 的 system prompt 中包含 bootstrap 段（rule 记忆）。
+     * Skill 已迁移到 per-round matchAndInjectSkill 动态注入，不再放入 bootstrap。
+     * 设定 CRUD 后调用 refreshBootstrapMemories 回调，回调内部调用此方法
+     * 获取最新的 rule 记忆，传给 AgentLoop.refreshBootstrapMemories()。
+     *
+     * @returns rule 活跃记忆数组
+     */
+    getBootstrapMemories() {
+        return [
+            ...this.index.getBySource(SOURCE_LABELS.RULE),
+        ];
+    }
 }
 //# sourceMappingURL=configManager.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"configManager.js","sourceRoot":"","sources":["../../../src/agent/managers/configManager.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGlD,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AA0CzC,2DAA2D;AAE3D,MAAM,OAAO,aAAa;IAWL;IACA;IACA;IACA;IAbnB,mBAAmB;IACX,iBAAiB,GAAmC,IAAI,CAAC;IAEjE;;;;;OAKG;IACH,YACmB,KAAqB,EACrB,YAA0B,EAC1B,mBAA8C,EAC9C,eAAmD;QAHnD,UAAK,GAAL,KAAK,CAAgB;QACrB,iBAAY,GAAZ,YAAY,CAAc;QAC1B,wBAAmB,GAAnB,mBAAmB,CAA2B;QAC9C,oBAAe,GAAf,eAAe,CAAoC;IACnE,CAAC;IAEJ,qDAAqD;IAErD;;;;;OAKG;IACH,kBAAkB,CAAC,OAAgC;QACjD,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC;IACnC,CAAC;IAED,oBAAoB;IACpB,IAAI,kBAAkB;QACpB,OAAO,IAAI,CAAC,iBAAiB,CAAC;IAChC,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,uBAAuB,CAAC,UAA4B;QACxD,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1B,MAAM,WAAW,CAAC,qBAAqB,EAAE,wBAAwB,EAAE;gBACjE,yDAAyD;aAC1D,CAAC,CAAC;QACL,CAAC;QAED,sEAAsE;QACtE,MAAM,SAAS,GAA2B;YACxC,IAAI,EAAE,aAAa,CAAC,IAAI;YACxB,OAAO,EAAE,aAAa,CAAC,OAAO;YAC9B,KAAK,EAAE,aAAa,CAAC,KAAK;SAC3B,CAAC;QACF,8CAA8C;QAC9C,MAAM,MAAM,GAAG,UAAU,CAAC,YAAY,IAAI,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACrE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,WAAW,CACf,qBAAqB,EACrB,SAAS,UAAU,CAAC,IAAI,mDAAmD,EAC3E;gBACE,iCAAiC;gBACjC,oCAAoC;aACrC,CACF,CAAC;QACJ,CAAC;QAED,qBAAqB;QACrB,6BAA6B;QAC7B,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;QACrB,MAAM,MAAM,GAAW;YACrB,EAAE,EAAE,GAAG,MAAM,IAAI,UAAU,CAAC,IAAI,EAAE;YAClC,OAAO,EAAE,UAAU,CAAC,OAAO;YAC3B,MAAM;YACN,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,SAAS,EAAE,GAAG;YACd,UAAU,EAAE,GAAG;YACf,KAAK,EAAE,UAAU,CAAC,UAAU;SAC7B,CAAC;QACF,2CAA2C;QAC3C,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;YACvB,MAAM,WAAW,CACf,UAAU,EACV,UAAU,MAAM,SAAS,UAAU,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAC1D;gBACE,wBAAwB;gBACxB,UAAU;gBACV,eAAe;aAChB,EACD,CAAC,CACF,CAAC;QACJ,CAAC;QAED,6CAA6C;QAC7C,IAAI,UAAU,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC/B,MAAM,UAAU,GAAG,SAAS,UAAU,CAAC,IAAI,KAAK,UAAU,CAAC,OAAO,EAAE,CAAC;YACrE,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC;QACvC,CAAC;QAED,MAAM,CAAC,IAAI,CACT,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,CAAC,UAAU,EAAE,EACnF,gBAAgB,CACjB,CAAC;IACJ,CAAC;IAED,qDAAqD;IAErD;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,CAAC,MAAc;QAC1B,IAAI,MAAM,CAAC,MAAM,KAAK,aAAa,CAAC,IAAI,EAAE,CAAC;YACzC,MAAM,WAAW,CAAC,MAAM,EAAE,iCAAiC,MAAM,CAAC,MAAM,GAAG,EAAE;gBAC3E,oCAAoC;aACrC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAE1B,MAAM,UAAU,GAAG,SAAS,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC;QAC7D,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC;QAErC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,CAAC,CAAC;IACvE,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,aAAa,CAAC,IAAY,EAAE,OAAe;QAC/C,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;QACrB,MAAM,MAAM,GAAW;YACrB,EAAE,EAAE,QAAQ,IAAI,EAAE;YAClB,OAAO;YACP,MAAM,EAAE,aAAa,CAAC,IAAI;YAC1B,IAAI;YACJ,SAAS,EAAE,GAAG;YACd,UAAU,EAAE,GAAG;YACf,KAAK,EAAE,GAAG;SACX,CAAC;QACF,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAED,qDAAqD;IAErD;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,QAAQ,CAAC,MAAc;QAC3B,IAAI,MAAM,CAAC,MAAM,KAAK,aAAa,CAAC,KAAK,EAAE,CAAC;YAC1C,MAAM,WAAW,CAAC,MAAM,EAAE,mCAAmC,MAAM,CAAC,MAAM,GAAG,EAAE;gBAC7E,qCAAqC;aACtC,CAAC,CAAC;QACL,CAAC;QAED,+CAA+C;QAC/C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAE1B,mCAAmC;QACnC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC;YACzB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,QAAQ,EAAE,EAAE;YACZ,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;YACxC,QAAQ,EAAE,EAAE;YACZ,KAAK,EAAE,OAAO;SACf,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,cAAc,CAAC,IAAY,EAAE,OAAe,EAAE,WAAqB,EAAE;QACzE,KAAK,QAAQ,CAAC,CAAC,2CAA2C;QAC1D,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;QACrB,MAAM,MAAM,GAAW;YACrB,EAAE,EAAE,SAAS,IAAI,EAAE;YACnB,OAAO;YACP,MAAM,EAAE,aAAa,CAAC,KAAK;YAC3B,IAAI;YACJ,SAAS,EAAE,GAAG;YACd,UAAU,EAAE,GAAG;YACf,KAAK,EAAE,GAAG;SACX,CAAC;QACF,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;CACF"}
+{"version":3,"file":"configManager.js","sourceRoot":"","sources":["../../../src/agent/managers/configManager.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,169 @@
+/**
+ * 语义去重管理器 — L1 记忆治理子系统
+ *
+ * 从 MemoryInspector 拆分出来，专责异步 LLM 语义去重。
+ * 与 MemoryInspector 的分工：
+ *   - MemoryInspector：同步读写入口（snapshot/search/stats/writeXxx/relations）
+ *   - DedupManager：异步 LLM 治理（deduplicateMemories）
+ *
+ * 拆分理由（SPLIT-3，2026-07-21）：
+ *   - 职责分离——同步读写 vs 异步 LLM 治理是两个独立关注点
+ *   - 依赖清晰——MemoryInspector 不再依赖 LLM Provider，纯存储读写
+ *   - 可测试性——去重逻辑独立测试，无需 mock loop/history/advisor
+ *   - 自包含——去重逻辑（配对 + LLM 判断 + 降级 + prompt）形成自闭合子系统
+ *
+ * 设计原则：
+ *   - 静默降级——backgroundProvider 未注入时返回 skippedReason 报告，不抛错
+ *   - 不物理删除——仅降级 score（→ 0.1），保留可恢复性
+ *   - 异步执行——不阻塞主对话热路径（由宿主定时任务或用户手动触发）
+ *
+ * @module agent/managers/dedupManager
+ */
+import type { Memory } from '../../memory/types.js';
+import type { IMemoryStorage } from '../../memory/storageInterface.js';
+import type { LlmProvider } from '../../llm/provider.js';
+/** 名称高度相似的候选记忆对（待 LLM 判断语义等价性） */
+export interface DedupPair {
+    /** 记忆 A（score 较高，作为保留候选） */
+    a: Memory;
+    /** 记忆 B（score 较低，作为降级候选） */
+    b: Memory;
+    /** 名称归一化相似度（0-1，越小越相似） */
+    nameSimilarity: number;
+}
+/** LLM 对单对记忆的语义等价判断结果 */
+export interface DedupVerdict {
+    /** 是否语义等价（true → 降级低分记忆） */
+    isDuplicate: boolean;
+    /** 合并后的内容（isDuplicate=true 时提供，保留更完整的信息） */
+    mergedContent?: string;
+    /** LLM 判断理由（便于审计和调试） */
+    reason: string;
+}
+/** 降级记忆的审计详情（DedupReport.verdicts 元素，供 UI 展示"为什么降级"） */
+export interface DedupVerdictSummary {
+    /** 被降级的记忆 ID（与 demotedIds 元素一一对应） */
+    demotedId: string;
+    /** LLM 判断理由（便于用户审计降级是否合理） */
+    reason: string;
+    /** 合并后的完整内容（便于用户验证合并质量；未提供 mergedContent 时省略，渲染器负责截断展示） */
+    mergedContent?: string;
+}
+/** 语义去重报告（deduplicateMemories 返回值） */
+export interface DedupReport {
+    /** 扫描的候选记忆总数 */
+    scannedCount: number;
+    /** 发现的名称相似对数 */
+    pairCount: number;
+    /** LLM 判定为语义等价并执行降级的对数 */
+    deduplicatedCount: number;
+    /** 被降级的记忆 ID 列表（score 降至 DEDUP_LOW_SCORE，未物理删除） */
+    demotedIds: string[];
+    /** 降级审计详情（与 demotedIds 一一对应，供 UI 展示 reason + mergedContentPreview） */
+    verdicts?: DedupVerdictSummary[];
+    /** 跳过原因（LLM 不可用 / 无候选对 / LLM 失败降级） */
+    skippedReason?: string;
+}
+/**
+ * 语义去重管理器
+ *
+ * 扫描名称高度相似的记忆对，调用 LLM 判断语义等价性，降级低分记忆。
+ *
+ * 装配：由 assembler.ts 在组合根创建，backgroundProvider 可选注入。
+ * 调用：Agent.deduplicateMemories() 透传至本类。
+ */
+export declare class DedupManager {
+    private readonly index;
+    /** 去重完成回调（宿主可据此发射事件通知用户） */
+    private readonly onCompleted?;
+    /** 后台 LLM Provider（可选，用于语义去重等异步治理任务，未注入时降级跳过） */
+    private readonly backgroundProvider;
+    /**
+     * @param index - 记忆存储（用于读写候选记忆）
+     * @param backgroundProvider - 后台 LLM Provider（可选，用于语义去重，未注入时降级跳过）
+     */
+    constructor(index: IMemoryStorage, backgroundProvider?: LlmProvider | null, 
+    /** 去重完成回调（宿主可据此发射事件通知用户） */
+    onCompleted?: ((report: DedupReport) => void) | undefined);
+    /**
+     * 语义去重：扫描名称高度相似的记忆对，调用 LLM 判断语义等价性
+     *
+     * 流程：
+     *   1. 从 insight/profile/work-projection 加载候选记忆（上限 50 条）
+     *   2. 按名称归一化 Levenshtein 距离筛选相似对（上限 10 对）
+     *   3. 对每对调用 LLM 判断语义等价性（结构化 JSON 输出）
+     *   4. 等价则降级低分记忆（score → 0.1，不物理删除，保留可恢复性）
+     *   5. 返回去重报告
+     *
+     * 安全设计：
+     *   - 不物理删除——仅降级 score，用户可通过宿主 UI 手动恢复
+     *   - LLM 失败降级——返回已处理的报告，不阻塞调用方
+     *   - 异步执行——不阻塞主对话热路径（由宿主定时任务或用户手动触发）
+     *   - backgroundProvider 未注入时静默跳过（返回 skippedReason）
+     *
+     * @param signal 可选的 AbortSignal（取消正在进行的 LLM 判断）
+     * @returns 去重报告
+     */
+    deduplicateMemories(signal?: AbortSignal): Promise<DedupReport>;
+    /**
+     * 筛选名称高度相似的候选记忆对
+     *
+     * 判定规则（满足任一即视为名称相似）：
+     *   1. 归一化 Levenshtein 距离 ≤ 0.3（如 "用户偏好" vs "用户偏爱"）
+     *   2. 一个名称包含另一个（如 "用户偏好" vs "用户偏好设置"）
+     *
+     * 去重设计：
+     *   - 已配对的记忆不再参与后续配对（避免 A-B-C 三元组产生 A-B + A-C + B-C 三对）
+     *   - 候选对按相似度升序排列（越相似越优先），取前 10 对
+     *
+     * @param candidates 候选记忆列表（已按 score 降序）
+     * @returns 名称相似的记忆对列表（a.score ≥ b.score）
+     */
+    private findNameOverlapPairs;
+    /**
+     * 计算两个名称的归一化相似度（0-1，越小越相似）
+     *
+     * 综合两种规则取较小值：
+     *   1. 归一化 Levenshtein 距离 = distance / max(len_a, len_b)
+     *   2. 包含关系：若一个名称包含另一个，相似度 = 0（完全相似）
+     *
+     * @param nameA 名称 A
+     * @param nameB 名称 B
+     * @returns 相似度（0=完全相似，1=完全不同）
+     */
+    private static computeNameSimilarity;
+    /**
+     * 调用 LLM 判断单对记忆的语义等价性
+     *
+     * 使用结构化 JSON 输出（isDuplicate + mergedContent + reason），
+     * 流式累积 + parseLlmJson + 异常封装委托给 llmJudgeHelper.judgeWithLlm。
+     *
+     * LLM 失败时抛出 MemoraError（由 deduplicateMemories 捕获并降级跳过此对）。
+     *
+     * @param pair 候选记忆对
+     * @param signal 可选的 AbortSignal
+     * @returns LLM 判断结果
+     */
+    private judgeDuplicate;
+    /**
+     * 降级重复记忆（score → DEDUP_LOW_SCORE）
+     *
+     * 安全设计：
+     *   - 不物理删除，仅降低 score，保留可恢复性
+     *   - 合并内容由 keepMerged() 单独写回保留方 a（职责清晰：本方法只降级低分方）
+     *
+     * @param memory 待降级的记忆（低分方）
+     */
+    private demoteMemory;
+    /**
+     * 将合并内容写回保留方（高分记忆 a）
+     *
+     * 保持 a 的 id/source/name/score/createdAt 不变，仅更新 content 为合并后内容并刷新
+     * accessedAt，使"两条重复记忆合并为一条更完整记忆"的语义真正落库（M6 修复）。
+     *
+     * @param memory 保留方记忆（高分方）
+     * @param mergedContent LLM 生成的合并后完整内容
+     */
+    private keepMerged;
+}
+//# sourceMappingURL=dedupManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dedupManager.d.ts","sourceRoot":"","sources":["../../../src/agent/managers/dedupManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,OAAO,KAAK,EAAE,WAAW,EAAW,MAAM,mBAAmB,CAAC;AAgC9D,kCAAkC;AAClC,MAAM,WAAW,SAAS;IACxB,4BAA4B;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,4BAA4B;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,0BAA0B;IAC1B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,yBAAyB;AACzB,MAAM,WAAW,YAAY;IAC3B,4BAA4B;IAC5B,WAAW,EAAE,OAAO,CAAC;IACrB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wDAAwD;AACxD,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,sCAAsC;AACtC,MAAM,WAAW,WAAW;IAC1B,gBAAgB;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mDAAmD;IACnD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACjC,sCAAsC;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAID;;;;;;;GAOG;AACH,qBAAa,YAAY;IASrB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAEtB,4BAA4B;IAC5B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;IAX/B,iDAAiD;IACjD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IAExD;;;OAGG;gBAEgB,KAAK,EAAE,cAAc,EACtC,kBAAkB,GAAE,WAAW,GAAG,IAAW;IAC7C,4BAA4B;IACX,WAAW,CAAC,GAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,aAAA;IAK9D;;;;;;;;;;;;;;;;;;OAkBG;IACG,mBAAmB,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAiFrE;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,oBAAoB;IAgC5B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAqBpC;;;;;;;;;;;OAWG;YACW,cAAc;IAoB5B;;;;;;;;OAQG;IACH,OAAO,CAAC,YAAY;IAMpB;;;;;;;;OAQG;IACH,OAAO,CAAC,UAAU;CASnB"}