@zooique/memora 2.0.0 → 2.0.3

package/dist/persona/personaManager.d.ts

@@ -1,57 +1,59 @@
-import type { IMemoryStorage } from '../memory/storageInterface.js';
+import { ConfigResourceManager } from '../utils/configResourceManager.js';
 import type { Persona, PersonaMode } from '../persona/types.js';
+import type { ScannedMarkdownEntry } from '../utils/scanner.js';
 /**
- * 角色管理器（personas/ + SQLite + 关键词匹配）
+ * 角色管理器
  */
-export declare class PersonaManager {
-    private readonly configDir?;
-    private readonly index?;
+export declare class PersonaManager extends ConfigResourceManager<Persona, string> {
     /** 当前激活的角色 */
     private activePersona;
-    /** 角色列表缓存（启动时扫描一次） */
-    private personaList;
     /** 激活模式 */
     private mode;
     /** 角色切换时间戳列表（用于时间窗口缓冲） */
     private switchTimestamps;
-    /** 缓冲区开关（60s 内 3 次切换后锁定） */
+    /** 缓冲区开关（30s 内 5 次切换后锁定） */
     private switchLocked;
     /** 锁定恢复计时器 */
     private unlockTimer;
-    /** 时间窗口：60 秒 */
+    /** 锁定自动恢复时间戳（ms epoch） */
+    private unlockAt;
+    /** 时间窗口：30 秒 */
     private static readonly SWITCH_WINDOW_MS;
-    /** 窗口内最大切换次数 */
+    /** 窗口内最大切换次数：5 次 */
     private static readonly MAX_SWITCHES_IN_WINDOW;
-    /** 锁定后自动恢复时间：5 分钟 */
+    /** 锁定后自动恢复时间：2 分钟 */
     private static readonly AUTO_UNLOCK_MS;
     /**
      * @param configDir 配置目录（角色文件在 <configDir>/personas/ 下）
-     * @param index SQLite 索引（用于写入 persona 记忆）
      */
-    constructor(configDir?: string | undefined, index?: IMemoryStorage | undefined);
+    constructor(configDir?: string);
     /**
-     * 启动时加载：扫描目录 + 激活指定角色 + 写入 SQLite
+     * 启动时加载：扫描目录 + 激活指定角色
      *
      * @param activePersona 要激活的角色名（可选，不传则使用第一个找到的角色）
      * @returns 激活角色的 system prompt 段
      */
     load(activePersona?: string): Promise<string>;
     /**
-     * 获取当前激活的角色名（用于 bootstrap 过滤）
+     * 重载角色：清空内存缓存 + 重新扫描 + 保持当前激活角色
      */
-    get activeName(): string;
+    reload(): Promise<number>;
     /**
-     * 获取当前激活角色对象（Phase 2.1：AffectController 需要 traits 字段）
+     * load() 完成后选择激活角色
      *
-     * 返回 null 时表示未加载任何角色（使用默认行为）。
+     * @param _items 已加载的角色列表
+     * @param activeName 指定的激活角色名（options 参数）
      */
+    protected onAfterLoad(_items: Persona[], activeName?: string): void;
+    /** 当前激活的角色名 */
+    get activeName(): string;
+    /** 获取当前激活角色对象 */
     getActive(): Persona | null;
+    /** 获取角色列表（委托基类） */
+    get list(): Persona[];
     /**
      * 切换角色（带时间窗口缓冲）
      *
-     * 错误策略统一（IX-03）：角色不存在时抛 MemoraError，与 switchProject 一致。
-     * 交换锁定时仍返回当前 prompt（非错误，是限流保护）。
-     *
      * @param name 角色名
      * @returns 新角色的 system prompt 段
      * @throws MemoraError 如果角色不存在
@@ -60,98 +62,45 @@ export declare class PersonaManager {
     /**
      * 根据用户输入自动匹配最合适的角色（关键词高置信度匹配）
      *
-     * 匹配策略：
-     *   - 关键词匹配高置信度（≥ KEYWORD_HIGH_CONFIDENCE_THRESHOLD）→ 直接返回
-     *   - 关键词低置信度/无匹配 → 返回 null（由 agent 层决定是否调用 LLM 辅助）
-     *
-     * LLM 辅助语义匹配已迁移到 agent 层（agent/personaMatcher.ts），
-     * 遵循 backend_layers_rules §分层职责：persona/ 不直接调 LLM。
-     *
-     * 匹配前置条件：
-     *   - 当前模式为 'auto'（非手动锁定）
-     *   - 缓冲区未锁定
-     *   - 角色列表非空
-     *   - 匹配的角色与当前角色不同
-     *
      * @param userInput 用户输入文本
      * @returns 匹配的角色名，无匹配返回 null
      */
-    autoMatch(userInput: string): Promise<string | null>;
+    autoMatch(userInput: string): string | null;
     /**
      * 检查是否满足自动匹配的前置条件
-     *
-     * 供 agent 层在调用 matchPersonaByLlm 前判断是否值得尝试 LLM 辅助匹配。
-     * 前置条件与 autoMatch 内部检查一致：
-     *   - 当前模式为 'auto'（非手动锁定）
-     *   - 缓冲区未锁定
-     *   - 角色列表非空
-     *
-     * @returns 是否满足自动匹配前置条件
      */
     canAutoMatch(): boolean;
-    /**
-     * 关键词匹配：遍历角色列表，返回得分最高的角色
-     *
-     * @param userInput 用户输入文本
-     * @returns 得分最高的角色和得分，无命中返回 null
-     */
-    private findBestKeywordMatch;
-    /**
-     * 设置激活模式
-     *
-     * @param mode 'auto'（自动匹配）| 'manual'（手动固定）
-     */
+    /** 设置激活模式 */
     setMode(mode: PersonaMode): void;
+    /** 获取角色切换锁定状态 */
+    getSwitchLockStatus(): {
+        locked: boolean;
+        unlockAt: number | null;
+    };
     /** 获取当前激活模式 */
     get currentMode(): PersonaMode;
-    /**
-     * 获取角色列表
-     */
-    get list(): Persona[];
     /**
      * 清理定时器资源（Agent.close() 时调用）
-     *
-     * PersonaManager 持有 unlockTimer（角色切换防抖锁的自动恢复计时器），
-     * 若不清理，Agent 关闭后定时器仍会触发回调，在已关闭的实例上执行引发异常。
      */
     close(): void;
     /**
-     * 重载角色：清空内存缓存 + 重新扫描目录 + 同步 SQLite 索引 + 保持当前激活角色
-     *
-     * 事件驱动重载：confirmConfigSuggestion 写入 persona 文件后或用户手动编辑
-     * personas/ 目录后，调用此方法使当前会话立即生效，无需重启 Agent。
+     * 删除角色
      *
-     * 激活角色保持策略：
-     * - 若当前激活角色在重载后仍存在 → 更新为重载后的版本（内容可能已变更）
-     * - 若当前激活角色已被删除 → 回退到列表第一个角色（与 load() 默认行为一致）
+     * 若删除的是激活角色，自动回退到列表第一个或默认角色。
      *
-     * @returns 重载后的角色数量
+     * @param name 角色名
+     * @returns true 删除成功；false 角色不存在
      */
-    reload(): Promise<number>;
+    deletePersona(name: string): boolean;
     /**
      * 构建 system prompt 中的角色段
      */
     buildSystemPrompt(name?: string): string;
+    protected createEntry(entry: ScannedMarkdownEntry): Persona;
     /**
      * 记录一次角色切换（时间窗口缓冲）
      */
     private recordSwitch;
-    /**
-     * 扫描单层目录，加载角色列表
-     */
-    private scanPersonas;
-    /**
-     * 将所有角色写入 SQLite 索引
-     *
-     * 本函数循环体内无 await，作为同步函数实现。
-     */
-    private writeAllToIndex;
-    /**
-     * 将单个角色写入 SQLite 索引
-     *
-     * 函数体无 await，作为同步函数实现。index.upsert 是同步方法。
-     */
-    private writePersonaToIndex;
     /**
      * 创建默认角色
      */

package/dist/persona/personaManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"personaManager.d.ts","sourceRoot":"","sources":["../../src/persona/personaManager.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAMnE,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAgC/D;;GAEG;AACH,qBAAa,cAAc;IA0BvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IA1BzB,cAAc;IACd,OAAO,CAAC,aAAa,CAAwB;IAC7C,sBAAsB;IACtB,OAAO,CAAC,WAAW,CAAiB;IACpC,WAAW;IACX,OAAO,CAAC,IAAI,CAAuB;IACnC,0BAA0B;IAC1B,OAAO,CAAC,gBAAgB,CAAgB;IACxC,4BAA4B;IAC5B,OAAO,CAAC,YAAY,CAAS;IAC7B,cAAc;IACd,OAAO,CAAC,WAAW,CAA8C;IAEjE,gBAAgB;IAChB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAU;IAClD,gBAAgB;IAChB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAK;IACnD,qBAAqB;IACrB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAW;IAEjD;;;OAGG;gBAEgB,SAAS,CAAC,EAAE,MAAM,YAAA,EAClB,KAAK,CAAC,EAAE,cAAc,YAAA;IAGzC;;;;;OAKG;IACG,IAAI,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqCnD;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;;;OAIG;IACH,SAAS,IAAI,OAAO,GAAG,IAAI;IAI3B;;;;;;;;;OASG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAyBnC;;;;;;;;;;;;;;;;;;OAkBG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAiB1D;;;;;;;;;;OAUG;IACH,YAAY,IAAI,OAAO;IAIvB;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IAoB5B;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAUhC,eAAe;IACf,IAAI,WAAW,IAAI,WAAW,CAE7B;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,OAAO,EAAE,CAEpB;IAED;;;;;OAKG;IACH,KAAK,IAAI,IAAI;IAOb;;;;;;;;;;;OAWG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IA4B/B;;OAEG;IACH,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAUxC;;OAEG;IACH,OAAO,CAAC,YAAY;IAqBpB;;OAEG;YACW,YAAY;IAyB1B;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAQvB;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAe3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAU7B"}
+{"version":3,"file":"personaManager.d.ts","sourceRoot":"","sources":["../../src/persona/personaManager.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAyB/D;;GAEG;AACH,qBAAa,cAAe,SAAQ,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC;IACxE,cAAc;IACd,OAAO,CAAC,aAAa,CAAwB;IAC7C,WAAW;IACX,OAAO,CAAC,IAAI,CAAuB;IACnC,0BAA0B;IAC1B,OAAO,CAAC,gBAAgB,CAAgB;IACxC,4BAA4B;IAC5B,OAAO,CAAC,YAAY,CAAS;IAC7B,cAAc;IACd,OAAO,CAAC,WAAW,CAA8C;IACjE,0BAA0B;IAC1B,OAAO,CAAC,QAAQ,CAAuB;IAEvC,gBAAgB;IAChB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAU;IAClD,oBAAoB;IACpB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAK;IACnD,qBAAqB;IACrB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAW;IAEjD;;OAEG;gBACS,SAAS,CAAC,EAAE,MAAM;IAM9B;;;;;OAKG;IACG,IAAI,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMnD;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IA6B/B;;;;;OAKG;IACH,SAAS,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAwBnE,eAAe;IACf,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,iBAAiB;IACjB,SAAS,IAAI,OAAO,GAAG,IAAI;IAI3B,mBAAmB;IACnB,IAAI,IAAI,IAAI,OAAO,EAAE,CAEpB;IAED;;;;;;OAMG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAwBnC;;;;;OAKG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAe3C;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB,aAAa;IACb,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAUhC,iBAAiB;IACjB,mBAAmB,IAAI;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;IAInE,eAAe;IACf,IAAI,WAAW,IAAI,WAAW,CAE7B;IAED;;OAEG;IACH,KAAK,IAAI,IAAI;IAUb;;;;;;;OAOG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAqBpC;;OAEG;IACH,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAUxC,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO;IAe3D;;OAEG;IACH,OAAO,CAAC,YAAY;IAqBpB;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAU7B"}