@zooique/memora 2.0.0 → 2.0.3

package/dist/skill/skillManager.d.ts

@@ -1,18 +1,14 @@
-import type { IMemoryStorage } from '../memory/storageInterface.js';
+import { ConfigResourceManager } from '../utils/configResourceManager.js';
 import type { SkillEntry, SkillMatch } from '../skill/types.js';
+import type { ScannedMarkdownEntry } from '../utils/scanner.js';
 /**
  * 技能管理器
  */
-export declare class SkillManager {
-    private readonly configDir?;
-    private readonly index?;
-    /** 技能列表缓存（启动时扫描一次） */
-    private skills;
+export declare class SkillManager extends ConfigResourceManager<SkillEntry> {
     /**
      * @param configDir 配置目录（技能文件在 <configDir>/skills/ 下）
-     * @param index SQLite 索引（用于写入 skill 记忆）
      */
-    constructor(configDir?: string | undefined, index?: IMemoryStorage | undefined);
+    constructor(configDir?: string);
     /**
      * 启动时加载：扫描技能目录
      *
@@ -23,10 +19,9 @@ export declare class SkillManager {
      * 根据用户输入匹配最合适的技能
      *
      * 匹配流程：
-     *   1. 先检查所有 trigger 正则，命中直接返回（最高优先级）
-     *   2. 再检查关键词匹配（TF 计分，得分排序）
-     *   3. 若匹配多项但得分相同 → 取第一个
-     *   4. 无任何匹配 → 返回 null
+     *   1. 先检查所有 trigger 正则，命中直接返回（最高优先级，score=1.0）
+     *   2. 再检查关键词匹配（复用基类 findBestKeywordMatch）
+     *   3. 关键词得分 < SKILL_MATCH_MIN_SCORE 的匹配不激活
      *
      * @param userInput 用户输入文本
      * @returns 匹配结果，无匹配返回 null
@@ -34,64 +29,23 @@ export declare class SkillManager {
     match(userInput: string): SkillMatch | null;
     /**
      * 根据技能名获取技能
-     *
-     * @param name 技能名
-     * @returns 技能条目，不存在返回 null
      */
     get(name: string): SkillEntry | null;
     /**
-     * 获取所有技能列表
+     * 删除技能（向后兼容别名，委托基类 deleteItem）
      */
-    get list(): SkillEntry[];
+    deleteSkill(name: string): boolean;
     /**
      * 注册运行时注入的技能
      *
      * 供 Agent.addSkill() 调用：宿主程序可在 init() 之后动态注入技能。
-     * 重复注册同名技能会被拒绝（与文件加载的技能冲突时也按"先到先得"判断）。
-     *
-     * @param skill 技能条目
-     * @throws 技能名已存在时抛错
+     * 重复注册同名技能会被拒绝。
      */
     register(skill: SkillEntry): void;
-    /**
-     * 重载技能：清空内存缓存 + 重新扫描目录 + 同步 SQLite 索引
-     *
-     * 事件驱动重载：installSkill 写入文件后或用户手动编辑 skills/ 目录后，
-     * 调用此方法使当前会话立即生效，无需重启 Agent。
-     *
-     * 与 load() 的区别：
-     * - load() → 启动时首次加载（冷启动）
-     * - reload() → 运行时增量重载（热更新），保留运行时 register() 注入的技能会被覆盖
-     *
-     * @returns 重载后的技能数量
-     */
-    reload(): Promise<number>;
     /**
      * 构建 system prompt 中的技能段
-     *
-     * 格式：
-     *   【当前技能】技能名
-     *   技能 prompt 正文...
-     *
-     * @param name 技能名（可选，不传返回空）
      */
     buildSystemPrompt(name?: string): string;
-    /**
-     * 将所有技能写入 SQLite 索引
-     *
-     * 本函数循环体内无 await，作为同步函数实现（与 personaManager.writeAllToIndex 同模式）。
-     */
-    private writeAllToIndex;
-    /**
-     * 将单个技能写入 SQLite 索引
-     */
-    private writeSkillToIndex;
-    /**
-     * 扫描 configDir/skills/ 目录
-     *
-     * 宿主负责将全局+项目级技能汇总到 configDir，
-     * 内核只扫描一个目录，不做路径假设。
-     */
-    private scanSkills;
+    protected createEntry(entry: ScannedMarkdownEntry): SkillEntry;
 }
 //# sourceMappingURL=skillManager.d.ts.map

package/dist/skill/skillManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skillManager.d.ts","sourceRoot":"","sources":["../../src/skill/skillManager.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAMnE,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAI/D;;GAEG;AACH,qBAAa,YAAY;IASrB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IATzB,sBAAsB;IACtB,OAAO,CAAC,MAAM,CAAoB;IAElC;;;OAGG;gBAEgB,SAAS,CAAC,EAAE,MAAM,YAAA,EAClB,KAAK,CAAC,EAAE,cAAc,YAAA;IAGzC;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAa7B;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAgC3C;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAIpC;;OAEG;IACH,IAAI,IAAI,IAAI,UAAU,EAAE,CAEvB;IAED;;;;;;;;OAQG;IACH,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAYjC;;;;;;;;;;;OAWG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAW/B;;;;;;;;OAQG;IACH,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAUxC;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAQvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAezB;;;;;OAKG;YACW,UAAU;CAuBzB"}
+{"version":3,"file":"skillManager.d.ts","sourceRoot":"","sources":["../../src/skill/skillManager.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAU/D;;GAEG;AACH,qBAAa,YAAa,SAAQ,qBAAqB,CAAC,UAAU,CAAC;IACjE;;OAEG;gBACS,SAAS,CAAC,EAAE,MAAM;IAM9B;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAI7B;;;;;;;;;;OAUG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAoB3C;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAIpC;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIlC;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAYjC;;OAEG;IACH,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IASxC,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,oBAAoB,GAAG,UAAU;CAW/D"}

package/dist/skill/skillManager.js

@@ -1,155 +1,105 @@
 /**
- * 技能管理器 — 单层目录扫描 + 关键词匹配
+ * 技能管理器 — 继承 ConfigResourceManager，扩展 trigger 正则匹配 + 运行时注册
  *
  * 职责：
  *   - 启动时扫描 configDir/skills/ 目录
- *   - 通过关键词匹配选择技能（初期阶段一/二）
- *   - 写入 SQLite 索引（source: skill，遵循"万物皆记忆"）
- *   - 后期触发条件（≥15个技能 / 关键词命中率 <80%）→ 切换为 LLM 自主选择
+ *   - 通过关键词匹配 + trigger 正则选择技能
+ *   - 支持运行时 register() 注入技能
  *
- * 设计原则（ADR-004 万物皆记忆）：
- *   - 技能遵循"万物皆记忆"——存入 SQLite 作为 skill 来源记忆
+ * 设计原则：
  *   - 单层目录：<configDir>/skills/（宿主负责汇总全局+项目级技能到 configDir）
- *   - 与 PersonaManager 存储策略一致：文件加载 → 内存缓存 + SQLite 索引
+ *   - 与 PersonaManager 共享 ConfigResourceManager 基类（消除重复扫描/匹配/生命周期）
  *
  * 触发词说明：
  *   每个 skill 文件的 frontmatter 声明 keywords（逗号分隔）和 trigger（触发正则，可选）。
  *   skill 文件命名规范：`<技能名>.md`（如"去AI味.md""审视角.md""写代码.md"）。
  */
-import { scoreByKeywords } from '../utils/segmenter.js';
-import { SOURCE_LABELS } from '../memory/types.js';
 import { logger } from '../logging/logger.js';
-import { byScoreDesc } from '../utils/array.js';
 import { configError } from '../utils/errors.js';
-import { nowIso } from '../utils/time.js';
-import { scanMarkdownDir, parseKeywords, parseTrigger, resolveSubdir } from '../utils/scanner.js';
+import { ConfigResourceManager } from '../utils/configResourceManager.js';
+import { parseTrigger, parseKeywords } from '../utils/scanner.js';
+/**
+ * 技能匹配最低激活阈值
+ *
+ * score < 此阈值的匹配不激活技能（避免低匹配度噪音）。
+ * 与 PersonaManager 的 KEYWORD_HIGH_CONFIDENCE_THRESHOLD (0.3) 一致。
+ */
+const SKILL_MATCH_MIN_SCORE = 0.3;
 /**
  * 技能管理器
  */
-export class SkillManager {
-    configDir;
-    index;
-    /** 技能列表缓存（启动时扫描一次） */
-    skills = [];
+export class SkillManager extends ConfigResourceManager {
     /**
      * @param configDir 配置目录（技能文件在 <configDir>/skills/ 下）
-     * @param index SQLite 索引（用于写入 skill 记忆）
      */
-    constructor(configDir, index) {
-        this.configDir = configDir;
-        this.index = index;
+    constructor(configDir) {
+        super(configDir, 'skills');
     }
+    // ── 生命周期 ──────────────────────────────────────
     /**
      * 启动时加载：扫描技能目录
      *
      * @returns 加载的技能数量
      */
     async load() {
-        this.skills = await this.scanSkills();
-        logger.info({ count: this.skills.length, names: this.skills.map((s) => s.name) }, '技能加载完成');
-        // 写入 SQLite 索引（遵循"万物皆记忆"——与 PersonaManager 一致）
-        this.writeAllToIndex();
-        return this.skills.length;
+        return this.loadItems();
     }
     /**
      * 根据用户输入匹配最合适的技能
      *
      * 匹配流程：
-     *   1. 先检查所有 trigger 正则，命中直接返回（最高优先级）
-     *   2. 再检查关键词匹配（TF 计分，得分排序）
-     *   3. 若匹配多项但得分相同 → 取第一个
-     *   4. 无任何匹配 → 返回 null
+     *   1. 先检查所有 trigger 正则，命中直接返回（最高优先级，score=1.0）
+     *   2. 再检查关键词匹配（复用基类 findBestKeywordMatch）
+     *   3. 关键词得分 < SKILL_MATCH_MIN_SCORE 的匹配不激活
      *
      * @param userInput 用户输入文本
      * @returns 匹配结果，无匹配返回 null
      */
     match(userInput) {
-        if (this.skills.length === 0)
+        if (this.items.length === 0)
             return null;
         // 1. trigger 正则匹配（最高优先级）
-        for (const skill of this.skills) {
+        for (const skill of this.items) {
             if (skill.trigger?.test(userInput)) {
                 logger.debug({ skill: skill.name, trigger: skill.trigger.source }, '技能触发器匹配');
                 return { skill, score: 1.0 };
             }
         }
-        const matches = [];
-        for (const skill of this.skills) {
-            if (skill.keywords.length === 0)
-                continue;
-            const score = scoreByKeywords(userInput, skill.keywords);
-            if (score > 0) {
-                matches.push({ skill, score });
-            }
-        }
-        if (matches.length === 0)
-            return null;
-        // 得分从高到低排序，取第一个
-        matches.sort(byScoreDesc);
-        const best = matches[0];
+        // 2. 关键词匹配（委托基类）
+        const best = this.findBestKeywordMatch(userInput, SKILL_MATCH_MIN_SCORE);
         if (!best)
             return null;
-        logger.debug({ matched: best.skill.name, score: best.score }, '技能关键词匹配');
-        return best;
+        logger.debug({ matched: best.item.name, score: best.score }, '技能关键词匹配');
+        return { skill: best.item, score: best.score };
     }
+    // ── 公共方法 ──────────────────────────────────────
     /**
      * 根据技能名获取技能
-     *
-     * @param name 技能名
-     * @returns 技能条目，不存在返回 null
      */
     get(name) {
-        return this.skills.find((s) => s.name === name) ?? null;
+        return this.items.find((s) => s.name === name) ?? null;
     }
     /**
-     * 获取所有技能列表
+     * 删除技能（向后兼容别名，委托基类 deleteItem）
      */
-    get list() {
-        return this.skills;
+    deleteSkill(name) {
+        return this.deleteItem(name);
     }
     /**
      * 注册运行时注入的技能
      *
      * 供 Agent.addSkill() 调用：宿主程序可在 init() 之后动态注入技能。
-     * 重复注册同名技能会被拒绝（与文件加载的技能冲突时也按"先到先得"判断）。
-     *
-     * @param skill 技能条目
-     * @throws 技能名已存在时抛错
+     * 重复注册同名技能会被拒绝。
      */
     register(skill) {
-        if (this.skills.some((s) => s.name === skill.name)) {
+        if (this.items.some((s) => s.name === skill.name)) {
             throw configError(`技能 "${skill.name}" 已存在，不能重复注册`, undefined, ['请使用不同的技能名称']);
         }
-        this.skills.push(skill);
+        this.items.push(skill);
         logger.info({ name: skill.name, keywords: skill.keywords.length }, '技能已注册（运行时注入）');
     }
-    /**
-     * 重载技能：清空内存缓存 + 重新扫描目录 + 同步 SQLite 索引
-     *
-     * 事件驱动重载：installSkill 写入文件后或用户手动编辑 skills/ 目录后，
-     * 调用此方法使当前会话立即生效，无需重启 Agent。
-     *
-     * 与 load() 的区别：
-     * - load() → 启动时首次加载（冷启动）
-     * - reload() → 运行时增量重载（热更新），保留运行时 register() 注入的技能会被覆盖
-     *
-     * @returns 重载后的技能数量
-     */
-    async reload() {
-        const oldCount = this.skills.length;
-        this.skills = await this.scanSkills();
-        this.writeAllToIndex();
-        logger.info({ oldCount, newCount: this.skills.length, names: this.skills.map((s) => s.name) }, '技能已重载');
-        return this.skills.length;
-    }
     /**
      * 构建 system prompt 中的技能段
-     *
-     * 格式：
-     *   【当前技能】技能名
-     *   技能 prompt 正文...
-     *
-     * @param name 技能名（可选，不传返回空）
      */
     buildSystemPrompt(name) {
         if (!name)
@@ -159,63 +109,17 @@ export class SkillManager {
             return '';
         return `【当前技能】${skill.name}\n${skill.content}`;
     }
-    // ── 私有方法 ──────────────────────────────────────
-    /**
-     * 将所有技能写入 SQLite 索引
-     *
-     * 本函数循环体内无 await，作为同步函数实现（与 personaManager.writeAllToIndex 同模式）。
-     */
-    writeAllToIndex() {
-        if (!this.index)
-            return;
-        for (const skill of this.skills) {
-            this.writeSkillToIndex(skill);
-        }
-        logger.info({ count: this.skills.length }, '技能记忆已写入 SQLite');
-    }
-    /**
-     * 将单个技能写入 SQLite 索引
-     */
-    writeSkillToIndex(skill) {
-        if (!this.index)
-            return;
-        const now = nowIso();
-        const memory = {
-            id: `skill:${skill.name}`,
-            content: skill.content,
-            source: SOURCE_LABELS.SKILL,
-            name: skill.name,
-            createdAt: now,
-            accessedAt: now,
-            score: 0.7,
+    // ── 基类抽象方法实现 ──────────────────────────────
+    createEntry(entry) {
+        return {
+            name: entry.name,
+            keywords: parseKeywords(entry.frontmatter),
+            trigger: parseTrigger(entry.frontmatter),
+            description: entry.frontmatter['description'],
+            content: entry.body.trim(),
+            filePath: entry.filePath,
+            layer: 'project',
         };
-        this.index.upsert(memory);
-    }
-    /**
-     * 扫描 configDir/skills/ 目录
-     *
-     * 宿主负责将全局+项目级技能汇总到 configDir，
-     * 内核只扫描一个目录，不做路径假设。
-     */
-    async scanSkills() {
-        const map = new Map();
-        const skillsDir = resolveSubdir(this.configDir, 'skills');
-        if (skillsDir) {
-            const entries = await scanMarkdownDir(skillsDir);
-            for (const entry of entries) {
-                const skill = {
-                    name: entry.name,
-                    keywords: parseKeywords(entry.frontmatter),
-                    trigger: parseTrigger(entry.frontmatter),
-                    description: entry.frontmatter['description'],
-                    content: entry.body.trim(),
-                    filePath: entry.filePath,
-                    layer: 'project',
-                };
-                map.set(entry.name, skill);
-            }
-        }
-        return Array.from(map.values());
     }
 }
 //# sourceMappingURL=skillManager.js.map

package/dist/skill/skillManager.js.map

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

package/dist/skill/types.d.ts

@@ -18,9 +18,8 @@ export interface SkillEntry {
     /**
      * 来源层（agent / project）
      *
-     * 预留字段，当前仅写入无读取消费者（skillManager + configManager 标注来源层）。
-     * 保留用于未来"按层禁用"（如宿主临时屏蔽 project 层技能）或"UI 显示来源"场景。
-     * 保留在 SkillEntry 契约中以维持类型稳定。
+     * skillManager 写入（project 层扫描），精灵宿主通过 systemHandlers 读取
+     * 并在 settingsPanelManager 中渲染"全局/项目"标签。
      */
     layer: 'agent' | 'project';
 }

package/dist/skill/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/skill/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,6BAA6B;AAC7B,MAAM,WAAW,UAAU;IACzB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;CAC5B;AAED,aAAa;AACb,MAAM,WAAW,UAAU;IACzB,YAAY;IACZ,KAAK,EAAE,UAAU,CAAC;IAClB,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;CACf"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/skill/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,6BAA6B;AAC7B,MAAM,WAAW,UAAU;IACzB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;CAC5B;AAED,aAAa;AACb,MAAM,WAAW,UAAU;IACzB,YAAY;IACZ,KAAK,EAAE,UAAU,CAAC;IAClB,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/utils/configResourceManager.d.ts

@@ -0,0 +1,111 @@
+/**
+ * 配置资源管理器抽象基类 — 消除 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 TOptions load() 的可选参数类型
+ */
+export declare abstract class ConfigResourceManager<T extends ConfigResource, TOptions = undefined> {
+    protected readonly configDir: string | undefined;
+    protected readonly subdir: string;
+    /** 资源列表缓存 */
+    protected items: T[];
+    /**
+     * @param configDir 配置目录（资源文件在 <configDir>/<subdir>/ 下）
+     * @param subdir 资源子目录名（如 'skills'、'personas'）
+     */
+    constructor(configDir: string | undefined, subdir: string);
+    /** 获取资源列表 */
+    get list(): T[];
+    /**
+     * 加载资源到缓存（子类在各自的 load() 中调用）
+     *
+     * @param options 子类透传参数
+     * @returns 加载的资源数量
+     */
+    protected loadItems(options?: TOptions): Promise<number>;
+    /**
+     * 重载资源：重新扫描目录 → 更新缓存
+     *
+     * @returns 重载后的资源数量
+     */
+    reload(): Promise<number>;
+    /**
+     * 删除资源（从内存缓存中移除）
+     *
+     * @param name 资源名
+     * @returns true 删除成功；false 资源不存在
+     */
+    deleteItem(name: string): boolean;
+    /**
+     * 关键词匹配：遍历资源列表，返回得分最高的资源
+     *
+     * 子类可覆写此方法以添加额外匹配逻辑（如 trigger 正则匹配）。
+     *
+     * @param userInput 用户输入文本
+     * @param threshold 最低激活阈值（低于此值的匹配忽略）
+     * @returns 匹配结果（资源 + 得分），无匹配返回 null
+     */
+    protected findBestKeywordMatch(userInput: string, threshold: number): {
+        item: T;
+        score: number;
+    } | null;
+    /**
+     * 构建 system prompt 片段
+     *
+     * @param name 资源名（可选，不传使用当前激活资源）
+     */
+    abstract buildSystemPrompt(name?: string): string;
+    /**
+     * 从扫描条目构建资源对象（子类实现差异化字段解析）
+     *
+     * @param entry 扫描器返回的原始条目
+     * @returns 子类资源类型
+     */
+    protected abstract createEntry(entry: ScannedMarkdownEntry): T;
+    /**
+     * load() 完成后的回调 — 子类可在此做激活选择等逻辑
+     */
+    protected onAfterLoad(_items: T[], _options?: TOptions): void;
+    /**
+     * reload() 完成后的回调 — 子类可在此保持当前激活状态
+     */
+    protected onAfterReload(_items: T[]): void;
+    /**
+     * 扫描目录 + 构建条目列表
+     */
+    private scanAndBuild;
+}
+//# sourceMappingURL=configResourceManager.d.ts.map

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

@@ -0,0 +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"}