@zooique/memora 2.0.3 → 3.0.0

package/dist/utils/scanner.js

@@ -1,25 +1,52 @@
 /**
  * Markdown 目录扫描工具
  *
- * 从 PersonaManager / SkillManager 提取的公共目录扫描逻辑，
+ * 从 RolePackManager / SkillManager 提取的公共目录扫描逻辑，
  * 消除跨模块重复的"扫描 *.md → 解析 frontmatter → 提取字段"代码。
  *
- * 使用异步 I/O（与 FileStore / ToolExecutor 保持一致）。
+ * 使用异步 I/O（与 ToolExecutor 保持一致）。
  */
-import { readFile, readdir, access } from 'node:fs/promises';
-import { resolve, join, basename } from 'node:path';
+import { readFile, readdir, access, stat } from 'node:fs/promises';
+import { resolve, join, basename, sep } from 'node:path';
 import { parseFrontmatter } from '../utils/frontmatter.js';
 import { getLogger } from '../utils/loggerHolder.js';
 /** 排除的文件名（README / CHANGELOG / LICENSE 不纳入扫描） */
 const EXCLUDED_FILES = new Set(['README.md', 'CHANGELOG.md', 'LICENSE']);
+/** 技能主文件约定名（文件夹形态的唯一入口，SSOT：scanner 校验 + skillManager/rolePackManager 据此判定 L3 归属） */
+export const SKILL_MAIN_FILE = 'SKILL.md';
 /**
- * 扫描目录下的 *.md 文件，解析 frontmatter
+ * 判定技能是否「文件夹形态」（入口为 SKILL.md）——单一真理源（SSOT）。
  *
- * 排除规则：
+ * 主流（Agent Skills 开放标准）：技能 = 文件夹 + 强制 SKILL.md，L3（resources/ scripts/）
+ * 仅归属于文件夹形态；顶层裸 .md 是轻量单文件兼容形态（纯 L1/L2），不拥有 L3。
+ * skillManager（经 skillLayer3）与 rolePackManager 均复用此判定，杜绝重复硬编码主文件名判定。
+ *
+ * @param filePath 技能文件绝对路径（SKILL.md 或裸 .md）
+ * @returns true 表示文件夹形态（拥有 L3 资源/脚本归属权）
+ */
+export function isFolderFormSkill(filePath) {
+    // 大小写不敏感（本函数为唯一判定，skillLayer3 与 rolePackManager 共用）：
+    // Windows 文件系统大小写不敏感，技能复制可能落盘为 skill.md / SKILL.MD 等变体；
+    // 统一按主文件名判定，避免「skillLayer3 判非文件夹形态、rolePackManager 判文件夹形态」的分裂。
+    return basename(filePath).toLowerCase() === SKILL_MAIN_FILE.toLowerCase();
+}
+/**
+ * 扫描目录下的 Markdown 文件，解析 frontmatter
+ *
+ * 支持两种形式：
+ *   1. 单文件形式：直接子项下的 *.md 文件
+ *   2. 文件夹形式：子目录中的 SKILL.md（Claude Code 标准）
+ *
+ * 排除规则（单文件）：
  *   - 文件名以 `.` 开头的隐藏文件
  *   - 文件名以 `_` 前缀的私有文件
  *   - README.md / CHANGELOG.md / LICENSE
  *
+ * 排除规则（文件夹）：
+ *   - 目录名以 `.` 开头的隐藏目录
+ *   - 目录名以 `_` 开头的私有目录
+ *   - 子目录内无技能主文件（SKILL.md，大小写不敏感判定）则跳过
+ *
  * @param dir 目录路径
  * @returns 解析后的条目列表
  */
@@ -31,19 +58,18 @@ export async function scanMarkdownDir(dir) {
         getLogger().debug({ dir }, '扫描目录不存在，跳过');
         return [];
     }
-    let files;
+    let items;
     try {
-        files = (await readdir(dir)).filter((f) => f.endsWith('.md') &&
-            !f.startsWith('.') &&
-            !f.startsWith('_') &&
-            !EXCLUDED_FILES.has(f));
+        items = await readdir(dir);
     }
     catch {
         getLogger().warn({ dir }, '扫描目录失败');
         return [];
     }
     const entries = [];
-    for (const file of files) {
+    // 直接子项下的 .md 文件（兼容单文件形式）
+    const mdFiles = items.filter((f) => f.endsWith('.md') && !f.startsWith('.') && !f.startsWith('_') && !EXCLUDED_FILES.has(f));
+    for (const file of mdFiles) {
         try {
             const filePath = join(dir, file);
             const raw = await readFile(filePath, 'utf-8');
@@ -59,57 +85,253 @@ export async function scanMarkdownDir(dir) {
             getLogger().warn({ file, err }, '解析 Markdown 文件失败');
         }
     }
+    // 子目录中的 SKILL.md（文件夹形式，Claude Code 标准）
+    for (const item of items) {
+        // 跳过隐藏目录和私有目录
+        if (item.startsWith('.') || item.startsWith('_'))
+            continue;
+        const itemPath = join(dir, item);
+        // 检查是否为目录
+        let isDir;
+        try {
+            isDir = (await stat(itemPath)).isDirectory();
+        }
+        catch {
+            continue;
+        }
+        if (!isDir)
+            continue;
+        // 探测目录内技能主文件：复用 isFolderFormSkill 大小写不敏感判定（SSOT），
+        // 兼容 skill.md / SKILL.MD 变体落盘；filePath 取真实落盘文件名。
+        let skillMainName;
+        try {
+            for (const name of await readdir(itemPath)) {
+                if (isFolderFormSkill(join(itemPath, name))) {
+                    skillMainName = name;
+                    break;
+                }
+            }
+        }
+        catch {
+            continue;
+        }
+        if (!skillMainName)
+            continue;
+        const skillPath = join(itemPath, skillMainName);
+        try {
+            const raw = await readFile(skillPath, 'utf-8');
+            const { frontmatter: fm, body } = parseFrontmatter(raw);
+            entries.push({
+                // 文件夹形式：优先 frontmatter name，回退到目录名
+                name: fm['name'] ?? basename(item),
+                frontmatter: fm,
+                body,
+                filePath: skillPath,
+            });
+        }
+        catch (err) {
+            getLogger().warn({ dir: item, err }, '解析 SKILL.md 失败');
+        }
+    }
     return entries;
 }
 /**
- * 从 frontmatter 中解析逗号分隔的关键词列表
+ * 解析目录路径：如果 configDir 存在则 resolve 子目录，否则返回 undefined
+ */
+export function resolveSubdir(configDir, sub) {
+    if (!configDir)
+        return undefined;
+    return resolve(configDir, sub);
+}
+// ── L3 目录名约定（单一真理源）──
+// 扫描侧（本模块）与路径解析侧（`skill/skillLayer3`）需要同一份目录名。
+// 两侧各写一遍字面量 → 目录名一旦调整，解析侧不会同步，且失配是静默的。
+/** 资源主目录（memora 自有约定；条目未标 subdir 时路径解析的回退基目录） */
+export const DEFAULT_RESOURCE_SUBDIR = 'resources';
+/** 资源兼容目录（TRAE / Agent Skills 主流辅助文档目录，兼容主流） */
+export const REFERENCES_SUBDIR = 'references';
+/** 脚本目录 */
+export const SCRIPTS_SUBDIR = 'scripts';
+/**
+ * 可执行脚本扩展名 → runtime 映射（SSOT 单一真源，供 rolePackManager / toolExecutor 共用）。
  *
- * @param fm frontmatter 键值对
- * @param key 关键词字段名（默认 'keywords'）
- * @returns 关键词数组
+ * '.ts' 语义声明（唯一一处）：node 无法直接解析 TS——映射仅作兜底推断，实际可用性
+ * 取决于宿主执行器是否具备转译能力（如 vscode codeExecutor 仅别名 .js/.mjs/.cjs）。
+ *
+ * '.bat'/'.cmd' 语义声明：Windows 批处理——shell 档在 win32 派发
+ * `cmd /c <path>`（skillScriptRunner.resolveCommand），批处理是 cmd 的原生可执行类型
+ * （实测 status=0、stdout 正确）。**缺映射时会被 toolExecutor 兜底成 node 而必炸**
+ * （拿批处理语法喂 node），故必须显式归入 shell 档。POSIX 下 `sh <path>` 跑批处理无
+ * 意义，但**不额外加平台分支**——跨平台同表比按平台分叉简单，且 POSIX 侧不会产出 .bat。
  */
-export function parseKeywords(fm, key = 'keywords') {
-    const raw = fm[key];
-    if (!raw)
-        return [];
-    return String(raw)
-        .split(',')
-        .map((s) => s.trim())
-        .filter(Boolean);
+export const SCRIPT_RUNTIME_MAP = {
+    '.ts': 'node',
+    '.js': 'node',
+    '.mjs': 'node',
+    '.cjs': 'node',
+    '.py': 'python',
+    '.sh': 'shell',
+    '.bash': 'shell',
+    '.zsh': 'shell',
+    '.bat': 'shell',
+    '.cmd': 'shell',
+};
+/**
+ * 按脚本扩展名推断 runtime（未知扩展名返回 undefined，缺省策略由调用方自定：
+ * toolExecutor 兜底 node / rolePackManager 返回 null / 扫描跳过）。
+ *
+ * @param ext 小写扩展名（含点，如 '.py'）
+ */
+export function inferRuntimeFromExt(ext) {
+    return SCRIPT_RUNTIME_MAP[ext];
 }
+/** 资源文件扩展名（纳入 resources 索引） */
+const RESOURCE_EXTENSIONS = new Set([
+    '.md',
+    '.markdown',
+    '.json',
+    '.yaml',
+    '.yml',
+    '.txt',
+    '.csv',
+    '.xml',
+    '.html',
+    '.sql',
+    '.toml',
+    '.ini',
+    '.env',
+]);
 /**
- * 从 frontmatter 中解析正则触发器
+ * 发现技能目录下的 L3 资源（resources/ + references/）和脚本（scripts/）
  *
- * 支持格式：/pattern/flags 或纯 pattern（默认 'i' flag）
+ * 三级渐进披露 L3 层扫描：
+ *   - resources/ 目录下的文件 → 资源列表（memora 自有约定）
+ *   - references/ 目录下的文件 → 资源列表（TRAE / Agent Skills 主流辅助文档目录，兼容主流）
+ *   - scripts/ 目录下的可执行文件 → 脚本列表（按扩展名推断 runtime）
+ * 资源条目统一带 subdir 来源，read_resource 据此选择读取基目录。
  *
- * @param fm frontmatter 键值对
- * @param key 触发器字段名（默认 'trigger'）
- * @returns 正则表达式，解析失败返回 undefined
+ * @param skillDir 技能目录路径（如 configDir/skills/my-skill/）
+ * @returns 发现的资源和脚本列表
  */
-export function parseTrigger(fm, key = 'trigger') {
-    const raw = fm[key];
-    if (!raw)
-        return undefined;
+export async function discoverLayer3(skillDir) {
+    // resources/ 与 references/ 均纳入资源索引，条目标注来源子目录
+    const resources = [
+        ...(await scanResourceSubdir(skillDir, DEFAULT_RESOURCE_SUBDIR)),
+        ...(await scanResourceSubdir(skillDir, REFERENCES_SUBDIR)),
+    ];
+    // 扫描 scripts/ 目录
+    const scriptsDir = join(skillDir, SCRIPTS_SUBDIR);
+    let scripts = [];
     try {
-        const pattern = String(raw).trim();
-        const match = pattern.match(/^\/(.+)\/([gimsuy]*)$/);
-        // QC-17 移除非空断言：使用空值合并回退到 pattern（与 match 为 null 时逻辑一致）
-        const clean = match?.[1] ?? pattern;
-        // 修复 UTIL-02：使用捕获的 flags（默认 'i'），原实现硬编码 'i' 丢弃了声明的 flags
-        const flags = match?.[2] || 'i';
-        return new RegExp(clean, flags);
+        await access(scriptsDir);
+        scripts = await readScriptFiles(scriptsDir);
     }
     catch {
-        getLogger().warn({ trigger: raw }, '触发正则无效，已忽略');
-        return undefined;
+        // scripts/ 目录不存在，跳过
     }
+    return { resources, scripts };
 }
 /**
- * 解析目录路径：如果 configDir 存在则 resolve 子目录，否则返回 undefined
+ * 扫描单个资源子目录（resources/ 或 references/），目录不存在时返回空数组
+ *
+ * @param skillDir 技能目录路径
+ * @param subdir 资源来源子目录
+ * @returns 该子目录下的资源列表（条目带来源 subdir）
  */
-export function resolveSubdir(configDir, sub) {
-    if (!configDir)
-        return undefined;
-    return resolve(configDir, sub);
+async function scanResourceSubdir(skillDir, subdir) {
+    const dir = join(skillDir, subdir);
+    try {
+        await access(dir);
+        return await readResourceFiles(dir, '', subdir);
+    }
+    catch {
+        // 目录不存在，跳过
+        return [];
+    }
+}
+/**
+ * 递归扫描资源子目录下的资源文件
+ *
+ * @param dir 资源子目录路径（resources/ 或 references/）
+ * @param basePath 相对路径前缀（用于递归）
+ * @param subdir 资源来源子目录（透传给条目）
+ */
+async function readResourceFiles(dir, basePath = '', subdir) {
+    const results = [];
+    const entries = await readdir(dir);
+    for (const entry of entries) {
+        if (entry.startsWith('.') || entry.startsWith('_'))
+            continue;
+        const fullPath = join(dir, entry);
+        const relPath = basePath ? `${basePath}/${entry}` : entry;
+        const statInfo = await stat(fullPath);
+        if (statInfo.isDirectory()) {
+            const subResults = await readResourceFiles(fullPath, relPath, subdir);
+            results.push(...subResults);
+        }
+        else if (RESOURCE_EXTENSIONS.has(getExt(entry))) {
+            results.push({ path: relPath, size: statInfo.size, subdir });
+        }
+    }
+    return results;
+}
+/**
+ * 递归扫描 scripts/ 目录下的可执行脚本
+ *
+ * @param dir scripts 目录路径
+ * @param basePath 相对路径前缀（用于递归）
+ */
+async function readScriptFiles(dir, basePath = '') {
+    const results = [];
+    const entries = await readdir(dir);
+    for (const entry of entries) {
+        if (entry.startsWith('.') || entry.startsWith('_'))
+            continue;
+        const fullPath = join(dir, entry);
+        const relPath = basePath ? `${basePath}/${entry}` : entry;
+        const statInfo = await stat(fullPath);
+        if (statInfo.isDirectory()) {
+            const subResults = await readScriptFiles(fullPath, relPath);
+            results.push(...subResults);
+        }
+        else {
+            const ext = getExt(entry);
+            const runtime = inferRuntimeFromExt(ext);
+            if (runtime) {
+                results.push({ path: relPath, runtime, size: statInfo.size });
+            }
+        }
+    }
+    return results;
+}
+/**
+ * 获取文件扩展名（小写）
+ */
+function getExt(filename) {
+    const dotIndex = filename.lastIndexOf('.');
+    return dotIndex >= 0 ? filename.slice(dotIndex).toLowerCase() : '';
+}
+/**
+ * 路径穿越防护：检查子路径是否在基目录内
+ *
+ * 将 base + sub 拼接后 resolve 为绝对路径，检查其是否以 base 为边界前缀。
+ * 防止 LLM 通过 `../` 等手段读取/执行技能目录外的文件。
+ *
+ * 边界前缀（追加 sep）：防兄弟目录绕过——`base=/x/skills/myskill`，
+ * 若不追加 `sep`，`/x/skills/myskill-evil/f` 会以 `myskill` 为前缀误放行。
+ * 与 SecurityGuard.assertPathAllowed 的 `allowedRoot + sep` 同标准（防前缀绕过统一事实）。
+ *
+ * @param base 基目录绝对路径
+ * @param sub 相对子路径（可能含 `../`）
+ * @returns 安全的完整路径（已 resolve），穿越时返回 null
+ */
+export function resolveSafePath(base, sub) {
+    const resolvedBase = resolve(base);
+    const fullPath = resolve(base, sub);
+    // 基目录自身或其边界前缀（追加 sep）；resolve 会消去 ../ 并规范化路径
+    if (fullPath === resolvedBase || fullPath.startsWith(resolvedBase + sep)) {
+        return fullPath;
+    }
+    return null;
 }
 //# sourceMappingURL=scanner.js.map

package/dist/utils/scanner.js.map

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

package/dist/utils/segmenter.d.ts

@@ -1,25 +1,26 @@
-export declare function scoreByKeywords(userInput: string, keywordList: string[]): number;
-/**
- * 单行分词（用于 LLM 输出的精确切分）
- * @param text 原文
- * @returns 分词数组（去标点、去空白、保留中英文 + 数字）
- */
+/** 单行精确分词（用于 LLM 输出切分）：去标点空白，保留中英文 + 数字 */
 export declare function segmentText(text: string): string[];
+/** 分词后小写化（文本预处理快捷方法，用于关键词匹配/召回的大小写不敏感匹配） */
+export declare function segmentLower(text: string): string[];
+/** 中文停用词集合（用于关键词提取时过滤无意义词汇） */
+export declare const STOPWORDS: Set<string>;
 /**
- * 分词后小写化（文本预处理快捷方法）
- *
- * 组合 segmentText + toLowerCase，消除 6 处散落的 `.map((t) => t.toLowerCase())` 模式
- * （ADR-017 枝叶层 2 次提取原则）。
- * 用于关键词匹配/召回场景的文本预处理（大小写不敏感匹配）。
- *
- * @param text 原文
- * @returns 分词后的小写 token 数组
+ * 增强关键词提取（带权重）——用于取代检测等场景：
+ * 动作/意图词权重 2.0、实体（后缀命中）1.5、其他 1.0。
  */
-export declare function segmentLower(text: string): string[];
+export declare function extractEnhancedKeywords(input: string): {
+    word: string;
+    weight: number;
+}[];
 /**
- * 中文停用词集合
- * 用于关键词提取时过滤无意义词汇（从 memory/types.ts 迁入，
- * 因为停用词是分词/关键词提取的关注点，而非记忆类型定义）
+ * 加权 Jaccard 相似度：加权后核心动作/实体重叠在"多轮逐步细化"下
+ * 更能识别主题延续。加权 Jaccard = Σ(交集大权重) / Σ(并集大权重)。
  */
-export declare const STOPWORDS: Set<string>;
+export declare function calculateWeightedJaccard(keywordsA: {
+    word: string;
+    weight: number;
+}[], keywordsB: {
+    word: string;
+    weight: number;
+}[]): number;
 //# sourceMappingURL=segmenter.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"segmenter.d.ts","sourceRoot":"","sources":["../../src/utils/segmenter.ts"],"names":[],"mappings":"AA2DA,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CAgBhF;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAclD;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEnD;AAED;;;;GAIG;AACH,eAAO,MAAM,SAAS,aAOpB,CAAC"}
+{"version":3,"file":"segmenter.d.ts","sourceRoot":"","sources":["../../src/utils/segmenter.ts"],"names":[],"mappings":"AAOA,2CAA2C;AAC3C,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAYlD;AAED,4CAA4C;AAC5C,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEnD;AAED,+BAA+B;AAC/B,eAAO,MAAM,SAAS,aA6DpB,CAAC;AA8GH;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,CA0BzF;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,EAC7C,SAAS,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,GAC5C,MAAM,CA4BR"}