@zooique/memora 2.0.3 → 3.0.0

package/dist/utils/backgroundTask.js

@@ -0,0 +1,117 @@
+/**
+ * 后台任务统一收口门面 —— 一个「后台副作用」的单一启动/观测入口。
+ *
+ * 收敛散落的 `fire-and-forget`（摘要生成 round-summary / 命中刷新 search_memories.touch / 会话命名 session-title）：
+ * - 统一启动：不阻塞调用方，业务 Promise 交给门面兜底；
+ * - 统一观测：按 label 累计 pending/completed/failed，宿主可读后台健康度；
+ * - 统一兜底：失败统一记日志，业务侧补救经 onFailure 挂载（如宿主事件 emit）；
+ * 统一限流：最大并发槽位防止上述三类任务无界并发耗尽资源。
+ *
+ * 与模块级 logger 同模式（全局单例，组件直接 import，零注入成本）。
+ */
+import { logger } from '../logging/logger.js';
+/** 后台任务累计统计（模块级单例状态） */
+const stats = { pending: 0, completed: 0, failed: 0 };
+/** 后台任务最大并发数（生产安全性：防止无界并发耗尽资源） */
+const MAX_CONCURRENT_BACKGROUND_TASKS = 5;
+/** 当前正在执行的任务数（不含排队中的） */
+let activeCount = 0;
+const pendingQueue = [];
+/**
+ * 启动一个后台任务（不阻塞调用方）。统一计数 + 兜底失败日志 + 并发槽位控制。
+ * 保留「调用即纳入在途计数」的契约——无论立即执行还是排队等待。
+ *
+ * @param label 任务标签（日志/观测区分用途）
+ * @param factory 返回业务 Promise 的工厂；内部不要自行 `catch`，交给本门面统一兜底计数
+ * @param onFailure 失败时的业务侧补救（如宿主事件 emit）；缺省仅记日志
+ */
+export function backgroundTask(label, factory, onFailure) {
+    stats.pending++;
+    if (activeCount < MAX_CONCURRENT_BACKGROUND_TASKS) {
+        // 有空闲槽位 → 立即执行
+        executeTask(label, factory, onFailure);
+    }
+    else {
+        // 槽位已满 → 排队等待
+        logger.debug({ label }, '后台任务排队等待执行');
+        pendingQueue.push({ label, factory, onFailure });
+    }
+}
+/**
+ * 执行一个任务（内部方法）。在有空闲槽位时调用。
+ * 任务完成后自动释放槽位并消费排队中的下一个任务。
+ */
+function executeTask(label, factory, onFailure) {
+    activeCount++;
+    const task = factory();
+    task.then(() => {
+        stats.pending--;
+        stats.completed++;
+        activeCount--;
+        logger.debug({ label }, '后台任务完成');
+        drainQueue();
+    }, (err) => {
+        stats.pending--;
+        stats.failed++;
+        activeCount--;
+        logger.warn({ err, label }, '后台任务失败');
+        onFailure?.(err);
+        drainQueue();
+    });
+}
+/**
+ * 从排队队列中消费一个任务执行（并发槽位释放时调用）。
+ * 保证不超过 MAX_CONCURRENT_BACKGROUND_TASKS 上限。
+ */
+function drainQueue() {
+    if (activeCount >= MAX_CONCURRENT_BACKGROUND_TASKS)
+        return;
+    const next = pendingQueue.shift();
+    if (!next)
+        return;
+    // 排队任务启动时仍计入 pending（已在入队时计数），这里仅消费槽位
+    executeTask(next.label, next.factory, next.onFailure);
+}
+/** 读取后台任务累计统计快照（只读副本，宿主可观测后台健康度） */
+export function getBackgroundTaskStats() {
+    return { ...stats };
+}
+/**
+ * 等待所有在途后台任务完成（带超时保护，防止任务永不返回阻塞 close）。
+ * Agent.close() 必须调用此函数——否则后台命中刷新/摘要生成等任务可能在 storage 关闭后 upsert 失效。
+ *
+ * @param timeoutMs 超时时间（毫秒），默认 5000ms
+ * @returns **等待开始时**的在途任务数（0 = 进入本函数时无在途任务）。
+ *   ⚠️ 该值是「曾经在途」而非「已等到完成」：超时放弃剩余任务时返回值仍为初始在途数，
+ *   不代表实际完成数。调用方据此判断「是否有在途任务」是正确的（如 `Agent.close()` 的
+ *   `awaited > 0`），但**不可当作已完成计数**使用。
+ */
+export async function awaitBackgroundTasks(timeoutMs = 5000) {
+    const initialPending = stats.pending;
+    if (initialPending === 0)
+        return 0;
+    logger.debug({ pending: initialPending }, '等待后台任务完成...');
+    const startTime = Date.now();
+    while (stats.pending > 0) {
+        if (Date.now() - startTime > timeoutMs) {
+            logger.warn({ pending: stats.pending, timeoutMs }, '等待后台任务超时，放弃剩余任务');
+            break;
+        }
+        // 等待下一个微任务周期，让 pending 计数有机会被更新
+        await new Promise((resolve) => setTimeout(resolve, 50));
+    }
+    return initialPending;
+}
+/**
+ * 重置模块级状态（仅测试使用，生产代码禁止调用）。
+ * 清理 activeCount、pendingQueue、stats，确保测试用例间状态隔离。
+ * @internal
+ */
+export function _resetBackgroundTaskState() {
+    stats.pending = 0;
+    stats.completed = 0;
+    stats.failed = 0;
+    activeCount = 0;
+    pendingQueue.length = 0;
+}
+//# sourceMappingURL=backgroundTask.js.map

package/dist/utils/backgroundTask.js.map

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

package/dist/utils/configResourceManager.d.ts

@@ -1,40 +1,13 @@
-/**
- * 配置资源管理器抽象基类 — 消除 SkillManager 与 PersonaManager 的重复结构
- *
- * 共同模式（DRY）：
- *   - 扫描 configDir/<subdir>/ 中的 .md 文件
- *   - 解析 frontmatter keywords
- *   - scoreByKeywords 关键词匹配
- *   - load → reload → deleteItem 生命周期
- *
- * 分叉点（子类差异化）：
- *   - createEntry() → 条目构造（Persona 需要 traits 解析，Skill 需要 layer/trigger）
- *   - buildSystemPrompt() → 系统提示格式
- *   - PersonaManager 额外状态：activePersona / mode / 切换缓冲 → 保留在子类
- *   - SkillManager 额外能力：trigger 正则匹配 / register() → 保留在子类
- *
- * 抽象收益验证（§2.2 技术债务的阈值判断）：
- *   - 2 个使用场景，领域规则大概率会变 → 抽象收益 > 复制成本
- *   - 扫描 + 匹配 + 生命周期共 ~60 行重复 → 消除后的维护成本显著降低
- *
- * 复杂度控制（§1.3）：
- *   - 泛型参数 T 由子类具体化，基类不假设 T 的具体形状
- *   - 基类只提供公共基础设施，不引入新概念
- */
 import type { ScannedMarkdownEntry } from '../utils/scanner.js';
-/**
- * 配置资源的最小约束：必须有 name、keywords、content、filePath
- */
+/** 配置资源最小约束 */
 export interface ConfigResource {
     name: string;
-    keywords: string[];
     content: string;
     filePath: string;
 }
 /**
  * 配置资源管理器 — 抽象基类
- *
- * @typeParam T 子类资源类型（如 Persona / SkillEntry）
+ * @typeParam T 子类资源类型
  * @typeParam TOptions load() 的可选参数类型
  */
 export declare abstract class ConfigResourceManager<T extends ConfigResource, TOptions = undefined> {
@@ -43,69 +16,64 @@ export declare abstract class ConfigResourceManager<T extends ConfigResource, TO
     /** 资源列表缓存 */
     protected items: T[];
     /**
-     * @param configDir 配置目录（资源文件在 <configDir>/<subdir>/ 下）
+     * 运行时注入项的名字集合——「是否有磁盘真理源」必须显式记账，不能从 filePath 反推
+     * （注入方 filePath 是约定，可填 '<runtime>'）。registerRuntimeItem() 登记，deleteItem/loadItems 注销。
+     */
+    private readonly runtimeNames;
+    /**
+     * @param configDir 配置目录（资源在 <configDir>/<subdir>/ 下）
      * @param subdir 资源子目录名（如 'skills'、'personas'）
      */
     constructor(configDir: string | undefined, subdir: string);
-    /** 获取资源列表 */
-    get list(): T[];
     /**
-     * 加载资源到缓存（子类在各自的 load() 中调用）
-     *
-     * @param options 子类透传参数
-     * @returns 加载的资源数量
+     * 资源列表快照——返回浅拷贝而非内部数组引用，
+     * 防止外部 push/splice 绕过 register() 的重名校验与 deleteItem() 记账。
      */
+    get list(): T[];
+    /** 加载资源到缓存，items 整体替换、运行时记账作废（子类 load() 中调用） */
     protected loadItems(options?: TOptions): Promise<number>;
     /**
-     * 重载资源：重新扫描目录 → 更新缓存
-     *
-     * @returns 重载后的资源数量
+     * 重载资源——不能整体覆盖 items：那会抹除无磁盘真理源的运行时注入项
+     * （如 SkillManager.register 注入的运行时技能，纯内存态、不进记忆库），两侧就此分叉。
+     * 判据取 runtimeNames 显式记账；同名冲突以磁盘（更强真理源）为准并注销登记。
      */
     reload(): Promise<number>;
     /**
-     * 删除资源（从内存缓存中移除）
+     * 子类声明「用户版本覆盖磁盘同名」的条目（默认无）
      *
-     * @param name 资源名
-     * @returns true 删除成功；false 资源不存在
+     * 默认语义 = 磁盘（更强真理源）赢：运行时注入项撞磁盘扫描同名时，磁盘版胜出、
+     * 运行时记账注销。SkillManager 的用户技能目录（loadExtraDir）则声明为覆盖——
+     * reload 时用户版胜出、记账保留、扫描到的内置版被剔除（见 retainRuntimeItems）。
+     * RolePackManager 不覆写，保持默认「磁盘赢」。
      */
-    deleteItem(name: string): boolean;
+    protected isUserOverride(_name: string): boolean;
     /**
-     * 关键词匹配：遍历资源列表，返回得分最高的资源
-     *
-     * 子类可覆写此方法以添加额外匹配逻辑（如 trigger 正则匹配）。
+     * 将磁盘扫描结果与运行时注入项合并（子类自定义扫描的 reload 也应复用本方法）：
+     * 重新扫描磁盘后，保留无磁盘真理源的运行时注入项（如 loadExtraDir 注入的用户资源），
+     * 同名冲突以磁盘（更强真理源）为准并注销运行时记账——除非子类将同名声明为
+     * isUserOverride（用户覆盖内置）：此时用户版保留、记账保留、磁盘版被剔除。
      *
-     * @param userInput 用户输入文本
-     * @param threshold 最低激活阈值（低于此值的匹配忽略）
-     * @returns 匹配结果（资源 + 得分），无匹配返回 null
+     * @param scanned 本次磁盘扫描得到的资源列表
+     * @returns 合并后的完整资源列表（磁盘在前、运行时注入在后）
      */
-    protected findBestKeywordMatch(userInput: string, threshold: number): {
-        item: T;
-        score: number;
-    } | null;
+    protected retainRuntimeItems(scanned: T[]): T[];
+    /** 从内存缓存删除资源（含注销运行时记账） */
+    deleteItem(name: string): boolean;
     /**
-     * 构建 system prompt 片段
-     *
-     * @param name 资源名（可选，不传使用当前激活资源）
+     * 登记运行时注入的资源（子类 register() 唯一落点）——必须记账，
+     * 否则 reload() 会把无磁盘真理源的注入项当成"磁盘上已删除"而抹掉。
+     * 重名校验由子类调用前完成（各自语义不同）。
      */
+    protected registerRuntimeItem(item: T): void;
+    /** 构建 system prompt 片段（name 不传则用当前激活资源） */
     abstract buildSystemPrompt(name?: string): string;
-    /**
-     * 从扫描条目构建资源对象（子类实现差异化字段解析）
-     *
-     * @param entry 扫描器返回的原始条目
-     * @returns 子类资源类型
-     */
-    protected abstract createEntry(entry: ScannedMarkdownEntry): T;
-    /**
-     * load() 完成后的回调 — 子类可在此做激活选择等逻辑
-     */
+    /** 从扫描条目构建资源对象（子类实现差异化字段解析；返回 null 跳过该条目） */
+    protected createEntry(_entry: ScannedMarkdownEntry): Promise<T | null>;
+    /** load() 完成后的回调（子类可做激活选择） */
     protected onAfterLoad(_items: T[], _options?: TOptions): void;
-    /**
-     * reload() 完成后的回调 — 子类可在此保持当前激活状态
-     */
+    /** reload() 完成后的回调（子类可保持当前激活状态） */
     protected onAfterReload(_items: T[]): void;
-    /**
-     * 扫描目录 + 构建条目列表
-     */
+    /** 扫描目录 + 构建条目列表（按 name 去重） */
     private scanAndBuild;
 }
 //# sourceMappingURL=configResourceManager.d.ts.map

package/dist/utils/configResourceManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configResourceManager.d.ts","sourceRoot":"","sources":["../../src/utils/configResourceManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,8BAAsB,qBAAqB,CACzC,CAAC,SAAS,cAAc,EACxB,QAAQ,GAAG,SAAS;IAUlB,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS;IAChD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM;IATnC,aAAa;IACb,SAAS,CAAC,KAAK,EAAE,CAAC,EAAE,CAAM;IAE1B;;;OAGG;gBAEkB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,MAAM,EAAE,MAAM;IAKnC,aAAa;IACb,IAAI,IAAI,IAAI,CAAC,EAAE,CAEd;IAID;;;;;OAKG;cACa,SAAS,CAAC,OAAO,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;IAU9D;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAW/B;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAajC;;;;;;;;OAQG;IACH,SAAS,CAAC,oBAAoB,CAC5B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAoBpC;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAEjD;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,EAAE,oBAAoB,GAAG,CAAC;IAI9D;;OAEG;IACH,SAAS,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI;IAI7D;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,IAAI;IAM1C;;OAEG;YACW,YAAY;CAY3B"}
+{"version":3,"file":"configResourceManager.d.ts","sourceRoot":"","sources":["../../src/utils/configResourceManager.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,eAAe;AACf,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,8BAAsB,qBAAqB,CAAC,CAAC,SAAS,cAAc,EAAE,QAAQ,GAAG,SAAS;IAetF,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS;IAChD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM;IAfnC,aAAa;IACb,SAAS,CAAC,KAAK,EAAE,CAAC,EAAE,CAAM;IAE1B;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAElD;;;OAGG;gBAEkB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,MAAM,EAAE,MAAM;IAKnC;;;OAGG;IACH,IAAI,IAAI,IAAI,CAAC,EAAE,CAEd;IAID,gDAAgD;cAChC,SAAS,CAAC,OAAO,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;IAW9D;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAiB/B;;;;;;;OAOG;IACH,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIhD;;;;;;;;OAQG;IACH,SAAS,CAAC,kBAAkB,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE;IAe/C,0BAA0B;IAC1B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAejC;;;;OAIG;IACH,SAAS,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAO5C,2CAA2C;IAC3C,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAEjD,6CAA6C;cAC7B,WAAW,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAO5E,8BAA8B;IAC9B,SAAS,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI;IAI7D,mCAAmC;IACnC,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,IAAI;IAM1C,+BAA+B;YACjB,YAAY;CAc3B"}

package/dist/utils/configResourceManager.js

@@ -1,33 +1,13 @@
 /**
- * 配置资源管理器抽象基类 — 消除 SkillManager 与 PersonaManager 的重复结构
- *
- * 共同模式（DRY）：
- *   - 扫描 configDir/<subdir>/ 中的 .md 文件
- *   - 解析 frontmatter keywords
- *   - scoreByKeywords 关键词匹配
- *   - load → reload → deleteItem 生命周期
- *
- * 分叉点（子类差异化）：
- *   - createEntry() → 条目构造（Persona 需要 traits 解析，Skill 需要 layer/trigger）
- *   - buildSystemPrompt() → 系统提示格式
- *   - PersonaManager 额外状态：activePersona / mode / 切换缓冲 → 保留在子类
- *   - SkillManager 额外能力：trigger 正则匹配 / register() → 保留在子类
- *
- * 抽象收益验证（§2.2 技术债务的阈值判断）：
- *   - 2 个使用场景，领域规则大概率会变 → 抽象收益 > 复制成本
- *   - 扫描 + 匹配 + 生命周期共 ~60 行重复 → 消除后的维护成本显著降低
- *
- * 复杂度控制（§1.3）：
- *   - 泛型参数 T 由子类具体化，基类不假设 T 的具体形状
- *   - 基类只提供公共基础设施，不引入新概念
+ * 配置资源管理器抽象基类 — 消除 SkillManager / RolePackManager 的重复结构：
+ * 扫描 <configDir>/<subdir>/ 的 .md、load/reload/deleteItem 生命周期。
+ * 差异化保留在子类（createEntry 条目构造、buildSystemPrompt、各自额外状态/能力）。
  */
-import { scoreByKeywords } from '../utils/segmenter.js';
 import { logger } from '../logging/logger.js';
 import { resolveSubdir, scanMarkdownDir } from '../utils/scanner.js';
 /**
  * 配置资源管理器 — 抽象基类
- *
- * @typeParam T 子类资源类型（如 Persona / SkillEntry）
+ * @typeParam T 子类资源类型
  * @typeParam TOptions load() 的可选参数类型
  */
 export class ConfigResourceManager {
@@ -36,7 +16,12 @@ export class ConfigResourceManager {
     /** 资源列表缓存 */
     items = [];
     /**
-     * @param configDir 配置目录（资源文件在 <configDir>/<subdir>/ 下）
+     * 运行时注入项的名字集合——「是否有磁盘真理源」必须显式记账，不能从 filePath 反推
+     * （注入方 filePath 是约定，可填 '<runtime>'）。registerRuntimeItem() 登记，deleteItem/loadItems 注销。
+     */
+    runtimeNames = new Set();
+    /**
+     * @param configDir 配置目录（资源在 <configDir>/<subdir>/ 下）
      * @param subdir 资源子目录名（如 'skills'、'personas'）
      */
     constructor(configDir, subdir) {
@@ -44,41 +29,73 @@ export class ConfigResourceManager {
         this.subdir = subdir;
     }
     // ── 公共 API ──────────────────────────────────────────
-    /** 获取资源列表 */
-    get list() {
-        return this.items;
-    }
-    // ── 受保护的基础设施（子类调用） ─────────────────────────
     /**
-     * 加载资源到缓存（子类在各自的 load() 中调用）
-     *
-     * @param options 子类透传参数
-     * @returns 加载的资源数量
+     * 资源列表快照——返回浅拷贝而非内部数组引用，
+     * 防止外部 push/splice 绕过 register() 的重名校验与 deleteItem() 记账。
      */
+    get list() {
+        return [...this.items];
+    }
+    // ── 受保护的基础设施 ──────────────────────────────────
+    /** 加载资源到缓存，items 整体替换、运行时记账作废（子类 load() 中调用） */
     async loadItems(options) {
         this.items = await this.scanAndBuild();
+        this.runtimeNames.clear();
         this.onAfterLoad(this.items, options);
         logger.info({ count: this.items.length, names: this.items.map((i) => i.name), subdir: this.subdir }, `${this.subdir} 资源加载完成`);
         return this.items.length;
     }
     /**
-     * 重载资源：重新扫描目录 → 更新缓存
-     *
-     * @returns 重载后的资源数量
+     * 重载资源——不能整体覆盖 items：那会抹除无磁盘真理源的运行时注入项
+     * （如 SkillManager.register 注入的运行时技能，纯内存态、不进记忆库），两侧就此分叉。
+     * 判据取 runtimeNames 显式记账；同名冲突以磁盘（更强真理源）为准并注销登记。
      */
     async reload() {
         const oldCount = this.items.length;
-        this.items = await this.scanAndBuild();
+        const scanned = await this.scanAndBuild();
+        this.items = this.retainRuntimeItems(scanned);
         this.onAfterReload(this.items);
-        logger.info({ oldCount, newCount: this.items.length, subdir: this.subdir }, `${this.subdir} 资源已重载`);
+        logger.info({
+            oldCount,
+            newCount: this.items.length,
+            retainedRuntime: this.items.length - scanned.length,
+            subdir: this.subdir,
+        }, `${this.subdir} 资源已重载`);
         return this.items.length;
     }
     /**
-     * 删除资源（从内存缓存中移除）
+     * 子类声明「用户版本覆盖磁盘同名」的条目（默认无）
      *
-     * @param name 资源名
-     * @returns true 删除成功；false 资源不存在
+     * 默认语义 = 磁盘（更强真理源）赢：运行时注入项撞磁盘扫描同名时，磁盘版胜出、
+     * 运行时记账注销。SkillManager 的用户技能目录（loadExtraDir）则声明为覆盖——
+     * reload 时用户版胜出、记账保留、扫描到的内置版被剔除（见 retainRuntimeItems）。
+     * RolePackManager 不覆写，保持默认「磁盘赢」。
      */
+    isUserOverride(_name) {
+        return false;
+    }
+    /**
+     * 将磁盘扫描结果与运行时注入项合并（子类自定义扫描的 reload 也应复用本方法）：
+     * 重新扫描磁盘后，保留无磁盘真理源的运行时注入项（如 loadExtraDir 注入的用户资源），
+     * 同名冲突以磁盘（更强真理源）为准并注销运行时记账——除非子类将同名声明为
+     * isUserOverride（用户覆盖内置）：此时用户版保留、记账保留、磁盘版被剔除。
+     *
+     * @param scanned 本次磁盘扫描得到的资源列表
+     * @returns 合并后的完整资源列表（磁盘在前、运行时注入在后）
+     */
+    retainRuntimeItems(scanned) {
+        const scannedNames = new Set(scanned.map((i) => i.name));
+        const runtimeInjected = this.items.filter((i) => this.runtimeNames.has(i.name) && (!scannedNames.has(i.name) || this.isUserOverride(i.name)));
+        for (const name of this.runtimeNames) {
+            // 磁盘同名赢（覆盖项已被保留，见上过滤）→ 注销记账；覆盖项保留记账（下次 reload 仍保留）
+            if (scannedNames.has(name) && !this.isUserOverride(name))
+                this.runtimeNames.delete(name);
+        }
+        // 覆盖项：剔除本次扫描到的磁盘同名版（用户版保留在后），避免同名双存
+        const effectiveScanned = scanned.filter((i) => !this.isUserOverride(i.name));
+        return [...effectiveScanned, ...runtimeInjected];
+    }
+    /** 从内存缓存删除资源（含注销运行时记账） */
     deleteItem(name) {
         const idx = this.items.findIndex((i) => i.name === name);
         if (idx < 0) {
@@ -86,52 +103,35 @@ export class ConfigResourceManager {
             return false;
         }
         this.items.splice(idx, 1);
+        this.runtimeNames.delete(name);
         logger.info({ name, remaining: this.items.length, subdir: this.subdir }, '资源已从内存缓存删除');
         return true;
     }
-    // ── 关键词匹配（共享实现） ──────────────────────────────
     /**
-     * 关键词匹配：遍历资源列表，返回得分最高的资源
-     *
-     * 子类可覆写此方法以添加额外匹配逻辑（如 trigger 正则匹配）。
-     *
-     * @param userInput 用户输入文本
-     * @param threshold 最低激活阈值（低于此值的匹配忽略）
-     * @returns 匹配结果（资源 + 得分），无匹配返回 null
+     * 登记运行时注入的资源（子类 register() 唯一落点）——必须记账，
+     * 否则 reload() 会把无磁盘真理源的注入项当成"磁盘上已删除"而抹掉。
+     * 重名校验由子类调用前完成（各自语义不同）。
      */
-    findBestKeywordMatch(userInput, threshold) {
-        const matches = [];
-        for (const item of this.items) {
-            if (item.keywords.length === 0)
-                continue;
-            const score = scoreByKeywords(userInput, item.keywords);
-            if (score >= threshold) {
-                matches.push({ item, score });
-            }
-        }
-        if (matches.length === 0)
-            return null;
-        // 主排序：得分降序；次排序：name 字母序（保证同分时确定性）
-        matches.sort((a, b) => b.score - a.score || a.item.name.localeCompare(b.item.name));
-        return matches[0] ?? null;
+    registerRuntimeItem(item) {
+        this.items.push(item);
+        this.runtimeNames.add(item.name);
+    }
+    /** 从扫描条目构建资源对象（子类实现差异化字段解析；返回 null 跳过该条目） */
+    async createEntry(_entry) {
+        // 默认空实现：不解析任何条目，子类可覆写
+        return null;
     }
     // ── 生命周期钩子（子类可选覆写） ──────────────────────────
-    /**
-     * load() 完成后的回调 — 子类可在此做激活选择等逻辑
-     */
+    /** load() 完成后的回调（子类可做激活选择） */
     onAfterLoad(_items, _options) {
         // 默认空实现
     }
-    /**
-     * reload() 完成后的回调 — 子类可在此保持当前激活状态
-     */
+    /** reload() 完成后的回调（子类可保持当前激活状态） */
     onAfterReload(_items) {
         // 默认空实现
     }
     // ── 私有方法 ──────────────────────────────────────────
-    /**
-     * 扫描目录 + 构建条目列表
-     */
+    /** 扫描目录 + 构建条目列表（按 name 去重） */
     async scanAndBuild() {
         const map = new Map();
         const dir = resolveSubdir(this.configDir, this.subdir);
@@ -139,8 +139,10 @@ export class ConfigResourceManager {
             return [];
         const entries = await scanMarkdownDir(dir);
         for (const entry of entries) {
-            const item = this.createEntry(entry);
-            map.set(entry.name, item);
+            const item = await this.createEntry(entry);
+            if (item !== null) {
+                map.set(entry.name, item);
+            }
         }
         return Array.from(map.values());
     }

package/dist/utils/configResourceManager.js.map

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