openfeel 1.0.0

package/dist/core/workspace/knowledge.js

@@ -0,0 +1,230 @@
+/**
+ * 知识库核心模块
+ * 管理 .openfeel/kb/ 目录，包含知识条目的增删查改、索引维护和解析。
+ */
+import { readFileSync, writeFileSync, appendFileSync, existsSync, mkdirSync } from 'node:fs';
+import { resolve } from 'node:path';
+// ---------------------------------------------------------------------------
+// 常量
+// ---------------------------------------------------------------------------
+/** 4 个标准分类 */
+const CATEGORIES = ['architecture', 'patterns', 'troubleshooting', 'setup'];
+/** 分类中文标题映射 */
+const CATEGORY_TITLES = {
+    architecture: '架构决策',
+    patterns: '代码模式',
+    troubleshooting: '常见问题',
+    setup: '环境搭建',
+};
+/** index.md 模板 */
+const INDEX_TEMPLATE = `# 知识库索引
+> 项目知识库总索引
+
+## 分类概览
+
+| 分类 | 描述 |
+|------|------|
+| architecture | 架构决策、设计理由、技术选型 |
+| patterns | 代码模式、项目约定、最佳实践 |
+| troubleshooting | 常见问题、调试流程、已知坑位 |
+| setup | 环境搭建、构建流程、依赖管理 |
+
+## 最近更新
+
+| 日期 | 分类 | 标题 |
+|------|------|------|
+`;
+// ---------------------------------------------------------------------------
+// 公开 API
+// ---------------------------------------------------------------------------
+/**
+ * 初始化知识库目录结构
+ * 在 .openfeel/kb/ 下创建 index.md 和 4 个分类文件。
+ * 已存在的文件不覆盖（幂等）。
+ * @returns 创建的文件路径列表
+ */
+export function initKnowledgeBase(projectPath) {
+    const kbDir = resolve(projectPath, '.openfeel', 'kb');
+    const created = [];
+    // 确保 kb 目录存在
+    if (!existsSync(kbDir)) {
+        mkdirSync(kbDir, { recursive: true });
+        created.push('.openfeel/kb/');
+    }
+    // 创建 index.md（不覆盖已有）
+    const indexPath = resolve(kbDir, 'index.md');
+    if (!existsSync(indexPath)) {
+        writeFileSync(indexPath, INDEX_TEMPLATE, 'utf-8');
+        created.push('.openfeel/kb/index.md');
+    }
+    // 创建分类文件（不覆盖已有）
+    for (const cat of CATEGORIES) {
+        const filePath = resolve(kbDir, `${cat}.md`);
+        if (!existsSync(filePath)) {
+            writeFileSync(filePath, `# ${CATEGORY_TITLES[cat]} (${cat})\n`, 'utf-8');
+            created.push(`.openfeel/kb/${cat}.md`);
+        }
+    }
+    return created;
+}
+/**
+ * 添加知识条目
+ * 向分类文件追加条目，并同步更新 index.md 的"最近更新"表格。
+ * 若 kb 目录不存在则自动初始化。
+ * @throws {Error} 传入无效分类时抛出
+ */
+export function addKnowledgeEntry(projectPath, category, title, content) {
+    // 校验分类有效性
+    if (!CATEGORIES.includes(category)) {
+        throw new Error(`无效分类 "${category}"，有效值：${CATEGORIES.join(', ')}`);
+    }
+    const kbDir = resolve(projectPath, '.openfeel', 'kb');
+    // 自动初始化
+    if (!existsSync(kbDir)) {
+        initKnowledgeBase(projectPath);
+    }
+    const today = new Date().toISOString().slice(0, 10); // YYYY-MM-DD
+    // 追加条目到分类文件
+    const catPath = resolve(kbDir, `${category}.md`);
+    const entryText = `\n## [+] ${title} (${today})\n\n${content}\n`;
+    appendFileSync(catPath, entryText, 'utf-8');
+    // 更新 index.md 的"最近更新"表格（在表头分隔行后插入新行）
+    const indexPath = resolve(kbDir, 'index.md');
+    let indexContent = readFileSync(indexPath, 'utf-8');
+    const sepLine = '|------|------|------|';
+    const sepIdx = indexContent.indexOf(sepLine);
+    if (sepIdx !== -1) {
+        const insertPos = sepIdx + sepLine.length;
+        const newRow = `| ${today} | ${category} | ${title} |`;
+        indexContent = indexContent.slice(0, insertPos) + '\n' + newRow + indexContent.slice(insertPos);
+        writeFileSync(indexPath, indexContent, 'utf-8');
+    }
+}
+/**
+ * 列出知识条目
+ * @param category 可选分类过滤；不传则返回所有分类的条目
+ */
+export function listKnowledge(projectPath, category) {
+    const kbDir = resolve(projectPath, '.openfeel', 'kb');
+    if (!existsSync(kbDir)) {
+        return [];
+    }
+    const targetCategories = category ? [category] : [...CATEGORIES];
+    const entries = [];
+    for (const cat of targetCategories) {
+        const filePath = resolve(kbDir, `${cat}.md`);
+        if (!existsSync(filePath)) {
+            continue;
+        }
+        const fileContent = readFileSync(filePath, 'utf-8');
+        const parsed = parseEntryFile(fileContent, cat);
+        entries.push(...parsed);
+    }
+    return entries;
+}
+/**
+ * 全文搜索知识条目
+ * 在 title 和 content 中进行不区分大小写的关键词搜索，并对匹配关键词用 ** 包裹高亮。
+ * @param projectPath 项目路径
+ * @param query 搜索关键词
+ * @param limit 返回结果数量上限（默认 10）
+ * @param offset 结果偏移量（默认 0）
+ */
+export function searchKnowledge(projectPath, query, limit = 10, offset = 0) {
+    const entries = listKnowledge(projectPath);
+    const q = query.toLowerCase();
+    const matched = entries.filter((entry) => entry.title.toLowerCase().includes(q) || entry.content.toLowerCase().includes(q));
+    // 对匹配结果高亮关键词（标题和内容摘要中用 ** 包裹）
+    const highlighted = matched.map((entry) => highlightEntry(entry, q));
+    // 分页截取
+    return highlighted.slice(offset, offset + limit);
+}
+/**
+ * 获取知识库索引
+ * 从 index.md 解析分类概览和最近更新信息。
+ * 若 kb 目录或 index.md 不存在，返回默认值（空结构）。
+ */
+export function getKnowledgeIndex(projectPath) {
+    const kbDir = resolve(projectPath, '.openfeel', 'kb');
+    const indexPath = resolve(kbDir, 'index.md');
+    // kb 目录或 index.md 不存在 → 返回默认值
+    if (!existsSync(indexPath)) {
+        return {
+            categories: CATEGORIES.map((name) => ({
+                name,
+                description: CATEGORY_TITLES[name],
+            })),
+            recentUpdates: [],
+        };
+    }
+    const content = readFileSync(indexPath, 'utf-8');
+    return {
+        categories: parseCategoriesTable(content),
+        recentUpdates: parseRecentUpdatesTable(content),
+    };
+}
+// ---------------------------------------------------------------------------
+// 内部解析函数
+// ---------------------------------------------------------------------------
+/**
+ * 高亮条目中的匹配关键词（不区分大小写）
+ * 在标题和内容摘要中用 ** 包裹匹配词
+ */
+function highlightEntry(entry, query) {
+    const escapedQuery = query.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const regex = new RegExp(`(${escapedQuery})`, 'gi');
+    return {
+        ...entry,
+        title: entry.title.replace(regex, '**$1**'),
+        content: entry.content.replace(regex, '**$1**'),
+    };
+}
+/**
+ * 解析分类文件的条目
+ * 条目头格式：## [+/-] Title (YYYY-MM-DD)
+ * 条目内容为标题行之后到下一个 ## 或文件末尾之间的文本。
+ */
+function parseEntryFile(fileContent, category) {
+    const entries = [];
+    const headerRegex = /^## (\[[+-]\]) (.+?) \((\d{4}-\d{2}-\d{2})\)$/gm;
+    // 记录所有 ## 行的位置，用于判断条目内容的结束边界
+    const headingStarts = [...fileContent.matchAll(/^## /gm)].map((m) => m.index);
+    for (const match of fileContent.matchAll(headerRegex)) {
+        const contentStart = match.index + match[0].length + 1; // +1 跳过标题行末尾的换行
+        // 查找下一个 ## 标题行（跳过自身的标题）
+        const nextHeading = headingStarts.find((idx) => idx > match.index);
+        const contentEnd = nextHeading !== undefined ? nextHeading : fileContent.length;
+        const content = fileContent.slice(contentStart, contentEnd).trim();
+        entries.push({
+            title: match[2].trim(),
+            category,
+            date: match[3],
+            content,
+            enabled: match[1] === '[+]',
+        });
+    }
+    return entries;
+}
+/**
+ * 从 index.md 中解析分类概览表格
+ */
+function parseCategoriesTable(content) {
+    const section = content.match(/## 分类概览\n\n([\s\S]*?)(?=\n## |$)/);
+    if (!section) {
+        return [];
+    }
+    const rows = [...section[1].matchAll(/\| ([a-z_]+) \| ([^|]+) \|/g)];
+    return rows.map((r) => ({ name: r[1].trim(), description: r[2].trim() }));
+}
+/**
+ * 从 index.md 中解析最近更新表格
+ */
+function parseRecentUpdatesTable(content) {
+    const section = content.match(/## 最近更新\n\n([\s\S]*?)(?=\n## |$)/);
+    if (!section) {
+        return [];
+    }
+    const rows = [...section[1].matchAll(/\| (\d{4}-\d{2}-\d{2}) \| ([a-z_]+) \| ([^|]+) \|/g)];
+    return rows.map((r) => ({ date: r[1], category: r[2].trim(), title: r[3].trim() }));
+}
+//# sourceMappingURL=knowledge.js.map

package/dist/core/workspace/knowledge.js.map

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

package/dist/core/workspace/structure.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 递归创建目录（若不存在）
+ */
+export declare function ensureDir(path: string): void;
+/**
+ * 创建 .openfeel/ 完整目录结构
+ */
+export declare function createWorkspace(projectPath: string): string[];
+//# sourceMappingURL=structure.d.ts.map

package/dist/core/workspace/structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure.d.ts","sourceRoot":"","sources":["../../../src/core/workspace/structure.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAI5C;AAkBD;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CA8B7D"}

package/dist/core/workspace/structure.js

@@ -0,0 +1,59 @@
+/**
+ * 工作区目录创建
+ * 负责创建项目下的 .openfeel/ 完整目录结构。
+ */
+import { mkdirSync, existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+/**
+ * 递归创建目录（若不存在）
+ */
+export function ensureDir(path) {
+    if (!existsSync(path)) {
+        mkdirSync(path, { recursive: true });
+    }
+}
+/** .openfeel/ 下的子目录清单 */
+const WORKSPACE_DIRS = [
+    'plan',
+    'kb',
+    'dev',
+    'log',
+    'code_review',
+    'bugs',
+    'users',
+    'tmp',
+    'manual',
+];
+/** dev/ 下的子目录清单 */
+const DEV_SUB_DIRS = ['note'];
+/**
+ * 创建 .openfeel/ 完整目录结构
+ */
+export function createWorkspace(projectPath) {
+    const base = resolve(projectPath, '.openfeel');
+    const created = [];
+    // 确保根目录存在
+    if (!existsSync(base)) {
+        mkdirSync(base, { recursive: true });
+        created.push('.openfeel/');
+    }
+    // 创建子目录
+    for (const dir of WORKSPACE_DIRS) {
+        const fullPath = resolve(base, dir);
+        if (!existsSync(fullPath)) {
+            mkdirSync(fullPath, { recursive: true });
+            created.push(`.openfeel/${dir}/`);
+        }
+    }
+    // 创建 dev 下的子目录
+    const devBase = resolve(base, 'dev');
+    for (const subDir of DEV_SUB_DIRS) {
+        const fullPath = resolve(devBase, subDir);
+        if (!existsSync(fullPath)) {
+            mkdirSync(fullPath, { recursive: true });
+            created.push(`.openfeel/dev/${subDir}/`);
+        }
+    }
+    return created;
+}
+//# sourceMappingURL=structure.js.map

package/dist/core/workspace/structure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure.js","sourceRoot":"","sources":["../../../src/core/workspace/structure.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;AACH,CAAC;AAED,yBAAyB;AACzB,MAAM,cAAc,GAAG;IACrB,MAAM;IACN,IAAI;IACJ,KAAK;IACL,KAAK;IACL,aAAa;IACb,MAAM;IACN,OAAO;IACP,KAAK;IACL,QAAQ;CACT,CAAC;AAEF,mBAAmB;AACnB,MAAM,YAAY,GAAG,CAAC,MAAM,CAAC,CAAC;AAE9B;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB;IACjD,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,UAAU;IACV,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC7B,CAAC;IAED,QAAQ;IACR,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACpC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,aAAa,GAAG,GAAG,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,eAAe;IACf,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACrC,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,iBAAiB,MAAM,GAAG,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * OpenFeel 包主入口
+ * 公共 API 导出点（后续阶段逐步填充）
+ */
+export {};
+export declare const VERSION = "0.1.0";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,CAAC;AAGV,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+/**
+ * OpenFeel 包主入口
+ * 公共 API 导出点（后续阶段逐步填充）
+ */
+// 版本号标识
+export const VERSION = '0.1.0';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,QAAQ;AACR,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/dist/utils/kb-dedup.d.ts

@@ -0,0 +1,46 @@
+/** 知识库单条条目 */
+export interface KbEntry {
+    /** 标题（不含 [+] / [-] 前缀和日期） */
+    title: string;
+    /** 日期字符串，如 "2026-06-27" */
+    date: string;
+    /** 启禁标记：+ 表示启用，- 表示禁用 */
+    status: '+' | '-';
+    /** 条目的正文内容（不含标题行和状态标记，含代码块和空行） */
+    content: string;
+    /** 原始标题行（如 "## [+] 标题 (日期)"），用于重建条目 */
+    rawLine: string;
+}
+/** 相似度计算结果 */
+export interface SimilarityResult {
+    /** 匹配到的现有条目 */
+    entry: KbEntry;
+    /** Jaccard 相似度（0.0 ~ 1.0） */
+    similarity: number;
+}
+/**
+ * 在指定分类中查找与新内容相似的现有条目。
+ * 遍历分类文件中的所有条目，对每条条目计算 Jaccard 相似度。
+ *
+ * @param target - 新待归档的内容文本
+ * @param category - 知识库分类名（architecture | patterns | troubleshooting | setup）
+ * @returns 相似度 > 0 的条目列表，按相似度降序排列
+ */
+export declare function findSimilarEntries(target: string, category: string): SimilarityResult[];
+/**
+ * 判断相似度是否达到更新阈值（> 0.8）。
+ *
+ * @param similarity - Jaccard 相似度值
+ * @returns 相似度 > 0.8 时返回 true，否则返回 false
+ */
+export declare function shouldUpdate(similarity: number): boolean;
+/**
+ * 合并新旧条目内容。
+ * 保留原有 `[+]` / `[-]` 标记和日期信息，新内容以「更新于」块追加到条目末尾。
+ *
+ * @param existing - 已有的知识库条目
+ * @param newContent - 新的待合并内容
+ * @returns 合并后的条目（日期和标记来自原条目，内容为原文 + 更新块）
+ */
+export declare function mergeEntry(existing: KbEntry, newContent: string): KbEntry;
+//# sourceMappingURL=kb-dedup.d.ts.map

package/dist/utils/kb-dedup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kb-dedup.d.ts","sourceRoot":"","sources":["../../src/utils/kb-dedup.ts"],"names":[],"mappings":"AAOA,cAAc;AACd,MAAM,WAAW,OAAO;IACtB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,MAAM,EAAE,GAAG,GAAG,GAAG,CAAC;IAClB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,cAAc;AACd,MAAM,WAAW,gBAAgB;IAC/B,eAAe;IACf,KAAK,EAAE,OAAO,CAAC;IACf,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;CACpB;AAyHD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,EAAE,CA2BvF;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAezE"}

package/dist/utils/kb-dedup.js

@@ -0,0 +1,169 @@
+/**
+ * 知识库去重模块
+ * 归档前检索现有条目，相似度 > 80% 时执行更新而非新增，避免 kb/ 中产生重复条目。
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+/** 相似度阈值，超过此值视为重复 */
+const SIMILARITY_THRESHOLD = 0.8;
+/** 知识库分类文件所在的基础目录 */
+const KB_BASE_DIR = resolve('.openfeel/kb');
+/** 分类名 → 文件名映射 */
+const CATEGORY_FILES = {
+    architecture: 'architecture.md',
+    patterns: 'patterns.md',
+    troubleshooting: 'troubleshooting.md',
+    setup: 'setup.md',
+};
+/**
+ * 读取知识库分类文件并解析为 KbEntry 列表。
+ * 分类文件按 `## ` 开头的标题行分割条目，每条目以 `## [+/-] 标题 (日期)` 格式开头。
+ *
+ * @param filePath - 分类文件的绝对路径
+ * @returns 解析出的条目列表，文件不存在时返回空数组
+ */
+function parseKbFile(filePath) {
+    if (!existsSync(filePath)) {
+        return [];
+    }
+    const content = readFileSync(filePath, 'utf-8');
+    const lines = content.split('\n');
+    const entries = [];
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        // 匹配 ## [+] / ## [-] 开头的标题行
+        const headerMatch = line.match(/^##\s+\[([+-])\]\s+(.+?)\s+\((\d{4}-\d{2}-\d{2})\)$/);
+        if (headerMatch === null) {
+            i++;
+            continue;
+        }
+        const status = headerMatch[1];
+        const title = headerMatch[2];
+        const date = headerMatch[3];
+        // 收集条目正文（从下一行到下一个 ## 或文件末尾）
+        const bodyLines = [];
+        let j = i + 1;
+        while (j < lines.length && !lines[j].startsWith('## ')) {
+            bodyLines.push(lines[j]);
+            j++;
+        }
+        const entry = {
+            title,
+            date,
+            status,
+            content: bodyLines.join('\n').trim(),
+            rawLine: line,
+        };
+        entries.push(entry);
+        i = j; // 跳到下一个条目起始行
+    }
+    return entries;
+}
+/**
+ * 对文本做词袋分词，用于 Jaccard 相似度计算。
+ * 分词策略：按空白字符和常见标点切分，过滤空 token 和纯标点 token。
+ * [+] / [-] 标记不参与相似度计算（避免禁用标记变化影响匹配）。
+ *
+ * @param text - 待分词的文本
+ * @returns 去重后的 token 集合
+ */
+function tokenize(text) {
+    // 去除行首的 [+] / [-] 标记（如 "## [+]" 中的状态标记）
+    const cleaned = text.replace(/^\[[+-]\](?!\s*\()/gm, '');
+    // 按空白和标点切分，保留中英文词汇
+    const tokens = cleaned
+        .toLowerCase()
+        .split(/[\s,，。.、；;：:！!？?（）()【】\[\]{}""''""\/\\|@#$%^&*+=~`<>]+/)
+        .filter(t => t.length > 0 && /[\w\u4e00-\u9fff]/.test(t));
+    return new Set(tokens);
+}
+/**
+ * 计算两个词袋之间的 Jaccard 相似度。
+ * 公式：|A∩B| / |A∪B|
+ *
+ * @param tokensA - 文本 A 的词袋
+ * @param tokensB - 文本 B 的词袋
+ * @returns 0.0 到 1.0 之间的相似度值
+ */
+function jaccardSimilarity(tokensA, tokensB) {
+    // 两个空文本时视为完全相同
+    if (tokensA.size === 0 && tokensB.size === 0) {
+        return 1.0;
+    }
+    // 计算交集大小
+    let intersection = 0;
+    for (const token of tokensA) {
+        if (tokensB.has(token)) {
+            intersection++;
+        }
+    }
+    // 计算并集大小
+    const union = tokensA.size + tokensB.size - intersection;
+    if (union === 0) {
+        return 0.0;
+    }
+    return intersection / union;
+}
+/**
+ * 在指定分类中查找与新内容相似的现有条目。
+ * 遍历分类文件中的所有条目，对每条条目计算 Jaccard 相似度。
+ *
+ * @param target - 新待归档的内容文本
+ * @param category - 知识库分类名（architecture | patterns | troubleshooting | setup）
+ * @returns 相似度 > 0 的条目列表，按相似度降序排列
+ */
+export function findSimilarEntries(target, category) {
+    const fileName = CATEGORY_FILES[category];
+    if (fileName === undefined) {
+        return [];
+    }
+    const filePath = resolve(KB_BASE_DIR, fileName);
+    const existingEntries = parseKbFile(filePath);
+    if (existingEntries.length === 0) {
+        return [];
+    }
+    const targetTokens = tokenize(target);
+    const results = [];
+    for (const entry of existingEntries) {
+        const entryTokens = tokenize(entry.content);
+        const similarity = jaccardSimilarity(targetTokens, entryTokens);
+        if (similarity > 0) {
+            results.push({ entry, similarity });
+        }
+    }
+    // 按相似度降序排列
+    results.sort((a, b) => b.similarity - a.similarity);
+    return results;
+}
+/**
+ * 判断相似度是否达到更新阈值（> 0.8）。
+ *
+ * @param similarity - Jaccard 相似度值
+ * @returns 相似度 > 0.8 时返回 true，否则返回 false
+ */
+export function shouldUpdate(similarity) {
+    return similarity > SIMILARITY_THRESHOLD;
+}
+/**
+ * 合并新旧条目内容。
+ * 保留原有 `[+]` / `[-]` 标记和日期信息，新内容以「更新于」块追加到条目末尾。
+ *
+ * @param existing - 已有的知识库条目
+ * @param newContent - 新的待合并内容
+ * @returns 合并后的条目（日期和标记来自原条目，内容为原文 + 更新块）
+ */
+export function mergeEntry(existing, newContent) {
+    const today = new Date().toISOString().slice(0, 10);
+    const trimmedNew = newContent.trim();
+    // 如果新内容与原内容完全一致，不做无意义追加
+    if (trimmedNew === existing.content.trim()) {
+        return { ...existing };
+    }
+    const updateNote = `\n\n> **更新于 ${today}**：${trimmedNew}`;
+    return {
+        ...existing,
+        content: existing.content + updateNote,
+    };
+}
+//# sourceMappingURL=kb-dedup.js.map

package/dist/utils/kb-dedup.js.map

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

package/dist/utils/path.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 将 file:// URL 或普通路径解析为规范化文件系统路径。
+ * Windows 兼容：处理 file:///C:/... 格式。
+ *
+ * @param urlOrPath - file:// URL 或文件系统路径
+ * @returns 规范化后的绝对路径
+ *
+ * @example
+ * resolveFileUrl('file:///C:/project/src/index.ts') // Windows → 'C:\\project\\src\\index.ts'
+ * resolveFileUrl('file:///home/user/project/src/index.ts') // Linux → '/home/user/project/src/index.ts'
+ * resolveFileUrl('./src/index.ts') // 相对路径 → 相对于 cwd 的绝对路径
+ */
+export declare function resolveFileUrl(urlOrPath: string): string;
+/**
+ * 将文件系统路径转换为 file:// URL。
+ * Windows 兼容：C:\project\src → file:///C:/project/src
+ *
+ * @param filePath - 文件系统路径（绝对或相对）
+ * @returns file:// URL 字符串
+ */
+export declare function toFileUrl(filePath: string): string;
+//# sourceMappingURL=path.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/utils/path.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAMxD;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGlD"}

package/dist/utils/path.js

@@ -0,0 +1,37 @@
+/**
+ * 跨平台路径工具
+ * 处理 file:// URL 与本地文件系统路径的相互转换
+ */
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { resolve } from 'node:path';
+/**
+ * 将 file:// URL 或普通路径解析为规范化文件系统路径。
+ * Windows 兼容：处理 file:///C:/... 格式。
+ *
+ * @param urlOrPath - file:// URL 或文件系统路径
+ * @returns 规范化后的绝对路径
+ *
+ * @example
+ * resolveFileUrl('file:///C:/project/src/index.ts') // Windows → 'C:\\project\\src\\index.ts'
+ * resolveFileUrl('file:///home/user/project/src/index.ts') // Linux → '/home/user/project/src/index.ts'
+ * resolveFileUrl('./src/index.ts') // 相对路径 → 相对于 cwd 的绝对路径
+ */
+export function resolveFileUrl(urlOrPath) {
+    if (urlOrPath.startsWith('file://')) {
+        // 处理 Windows 路径：file:///C:/... → C:/...
+        return fileURLToPath(urlOrPath);
+    }
+    return resolve(urlOrPath);
+}
+/**
+ * 将文件系统路径转换为 file:// URL。
+ * Windows 兼容：C:\project\src → file:///C:/project/src
+ *
+ * @param filePath - 文件系统路径（绝对或相对）
+ * @returns file:// URL 字符串
+ */
+export function toFileUrl(filePath) {
+    const absolutePath = resolve(filePath);
+    return pathToFileURL(absolutePath).href;
+}
+//# sourceMappingURL=path.js.map

package/dist/utils/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../src/utils/path.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,IAAI,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACpC,wCAAwC;QACxC,OAAO,aAAa,CAAC,SAA+B,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,OAAO,CAAC,SAAS,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvC,OAAO,aAAa,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC;AAC1C,CAAC"}