@morningljn/mnemo 0.1.3 → 0.1.4

package/README.md

@@ -15,6 +15,8 @@ AI coding assistants forget everything between sessions. `CLAUDE.md` stores stat
 mnemo gives your AI assistant a **searchable, structured memory layer** that persists across sessions:
 
 - **Search by meaning** — FTS5 full-text search + Jaccard reranking + bilingual expansion
+- **Session warmup** — MCP Resources auto-inject top facts at session start, zero tool calls
+- **Query refinement** — strips action words and noise tokens before memory search
 - **Trust scoring** — facts gain or lose trust over time based on feedback and decay
 - **Entity graph** — automatic entity extraction with multi-hop relationship queries
 - **Contradiction detection** — finds conflicting facts and demotes the older one
@@ -49,15 +51,26 @@ claude mcp add mnemo -- mnemo
 
 You have mnemo memory tools (fact_store / fact_feedback). Rules:
 
-## Rule 1: Search before answering
-After receiving a user message, call `fact_store(action="search", query="<keywords from user message>")`.
-Extract keywords from the user's actual message — do NOT use a fixed template.
+## Rule 1: Session warmup (automatic)
+mnemo MCP Resources auto-inject global memory into system context at session start.
+You do NOT need to call fact_store(search) for high-frequency memories.
 
-## Rule 2: Write on request
+## Rule 2: On-demand search
+Only call fact_store(action="search") when:
+- User message involves personal preferences/habits/tool choices not covered by warmup
+- User explicitly queries memory ("what did I say before", "per my habits")
+- Technical decisions need user preference confirmation
+
+Do NOT trigger search for:
+- Pure operations ("run tests", "git commit")
+- General tech questions ("how to use Promise")
+- Code review/explanation requests
+
+## Rule 3: Write on request
 When user says "remember", call `fact_store(action="add", content="...", category="...")`.
 Search first to avoid duplicates. Categories: identity / coding_style / tool_pref / workflow / general.
 
-## Rule 3: Feedback
+## Rule 4: Feedback
 When a memory was useful, call `fact_feedback(action="helpful", fact_id=...)`.
 ```
 
@@ -115,21 +128,37 @@ Rate a fact after use. Good facts rise, bad facts decay.
 | `helpful` | +0.05 trust |
 | `unhelpful` | -0.10 trust |
 
+## MCP Resources
+
+mnemo exposes 5 global category resources for **zero-cost session warmup**:
+
+| Resource URI | Description |
+|-------------|-------------|
+| `mnemo://global/identity` | Identity facts (top 10 by trust) |
+| `mnemo://global/coding_style` | Coding style preferences |
+| `mnemo://global/tool_pref` | Tool preferences |
+| `mnemo://global/workflow` | Workflow preferences |
+| `mnemo://global/general` | General facts |
+
+MCP clients (Claude Code, Codex) automatically fetch these resources at session start, injecting memory into system context without any tool calls. This eliminates the need for "search every message" patterns.
+
 ## Architecture
 
 ```
 ┌───────────────────┐   stdio    ┌────────────┐   SQLite    ┌─────────────────────┐
 │   MCP Client      │◄─────────►│  mnemo     │◄───────────►│ ~/.mnemo/facts.db   │
 │ (Claude / Codex)  │   JSON    │  server    │             │                     │
-└───────────────────┘           └─────┬──────┘             │ Tables:             │
-                                      │                    │   facts             │
-                               ┌──────┴──────┐             │   entities          │
-                               │             │             │   fact_entities     │
-                               │  Retriever  │  Security   │ Indexes:            │
-                               │  (search,   │  (PII scan, │   facts_fts (FTS5)  │
-                               │   probe,    │   injection │   idx_facts_trust   │
-                               │   reason)   │   detection)│   idx_facts_category│
-                               └─────────────┘             └─────────────────────┘
+│                   │           └─────┬──────┘             │ Tables:             │
+│  Auto-fetch:      │                 │                    │   facts             │
+│  mnemo://global/* │      ┌──────────┼──────────┐         │   entities          │
+│  (session warmup) │      │          │          │         │   fact_entities     │
+└───────────────────┘      │          │          │         │ Indexes:            │
+                           │          │          │         │   facts_fts (FTS5)  │
+                     Resources   Retriever   Security       │   idx_facts_trust   │
+                     (warmup,   (search,    (PII scan,     │   idx_facts_category│
+                      cache)     probe,     injection      └─────────────────────┘
+                                 reason)    detection)
+                                └──────────────────┘
 ```
 
 ## Categories

package/dist/init.js

@@ -19,19 +19,27 @@ const MEMORY_RULES = `
 
 你有 mnemo 记忆工具（fact_store / fact_feedback），必须按以下规则使用：
 
-## 规则 1：搜索记忆（每次回复前）
-收到用户消息后，你必须先调用 \`fact_store(action="search", query="<用户消息的关键词>")\` 检索相关记忆。
-query 必须从用户消息中提取关键词，不要用固定模板。例如：
-- 用户说"我叫什么" → query="姓名 名字 叫什么"
-- 用户说"我喜欢什么语言" → query="编程语言 偏好 喜欢"
-搜索后根据结果自然回复，不要说"根据记忆"。
+## 规则 1：会话预热（自动）
+会话启动时，mnemo-mcp 的 MCP Resource 会自动注入全局记忆到 system context。
+你不需要主动调用 fact_store(search) 来获取高频记忆。
 
-## 规则 2：写入记忆
+## 规则 2：按需补充查询
+仅在以下情况调用 \`fact_store(action="search")\`：
+- 用户消息涉及个人偏好/习惯/工具选择且预热中未覆盖
+- 用户明确查询记忆（"我之前说过什么""按我的习惯"）
+- 技术选型时需要确认用户偏好
+
+不触发查询的情况：
+- 纯操作指令（"运行测试""git commit"）
+- 通用技术问题（"Promise 怎么用"）
+- 代码审查/解释请求
+
+## 规则 3：写入记忆
 用户说"记住"、"记下来"时，调用 \`fact_store(action="add", content="...", category="...")\`。
 - 先 search 检查是否已有相似事实，有则 update
 - category：identity / coding_style / tool_pref / workflow / general
 
-## 规则 3：反馈强化
+## 规则 4：反馈强化
 成功使用某条记忆时，调用 \`fact_feedback(action="helpful", fact_id=...)\`。
 `;
 const MCP_TOOLS = [

package/dist/init.js.map

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

package/dist/refine.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Query refinement: strip noise tokens from user messages before memory search.
+ * Pure function — no side effects, no DB access.
+ */
+export interface RefineResult {
+    query: string | null;
+    tokens: string[];
+    entityTokens: string[];
+}
+/**
+ * Refine a raw user message into memory-searchable keywords.
+ * Returns null if the message is a pure operation command with no memory relevance.
+ */
+export declare function refineQuery(raw: string): RefineResult | null;

package/dist/refine.js

@@ -0,0 +1,115 @@
+/**
+ * Query refinement: strip noise tokens from user messages before memory search.
+ * Pure function — no side effects, no DB access.
+ */
+// Action words / helper phrases to strip (Chinese)
+const ACTION_WORDS = [
+    '帮我看看', '能不能帮我', '给我看看',
+    '帮我', '看看', '看一下', '做一下', '能不能', '为什么', '怎么',
+    '是什么', '如何', '请', '麻烦', '可以', '给我',
+    '给我做', '给我写', '给我查', '给我找', '给我说', '给我讲',
+    '告诉我', '跟我说', '跟我讲', '给我解释', '给我说明', '给我介绍',
+    '运行', '执行', '启动', '停止', '创建', '删除', '修改', '更新', '查看',
+    '检查', '测试', '提交', '推送', '拉取', '合并', '切换', '重置', '重构',
+    '运行测试', '创建文件',
+];
+// Common CLI commands / low-signal English tokens to filter
+const NOISE_WORDS = new Set([
+    'git', 'npm', 'npx', 'yarn', 'pnpm', 'status', 'log', 'diff', 'add',
+    'commit', 'push', 'pull', 'merge', 'checkout', 'branch', 'stash',
+    'install', 'build', 'run', 'start', 'stop', 'test', 'lint', 'format',
+]);
+// Sort by length descending so longer phrases match first during replacement
+const ACTION_WORDS_SORTED = [...ACTION_WORDS].sort((a, b) => b.length - a.length);
+const ACTION_WORDS_SET = new Set(ACTION_WORDS);
+// Reuse existing stop words from retriever
+const CN_STOP_WORDS = new Set([
+    '的', '了', '是', '在', '有', '和', '就', '不', '人', '都',
+    '一', '个', '上', '也', '很', '到', '说', '要', '去', '你',
+    '会', '着', '没', '看', '好', '自', '这', '他', '她', '它',
+    '那', '些', '用', '对', '下', '为', '从', '被', '把', '能',
+    '可', '以', '所', '而', '又', '与', '但', '或', '等', '中',
+    '大', '小', '多', '少', '其', '之', '做', '让', '给', '已',
+    '还', '来', '地', '得', '过', '时', '里', '后', '前', '当',
+]);
+/**
+ * Refine a raw user message into memory-searchable keywords.
+ * Returns null if the message is a pure operation command with no memory relevance.
+ */
+export function refineQuery(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return null;
+    // Extract high-signal tokens first: quoted content, book titles, capitalized phrases
+    const entityTokens = [];
+    // Chinese quotes: 「深色主题」 or "深色主题" or '深色主题'
+    for (const m of trimmed.matchAll(/[「""'']([^「""''」]{2,20})[」""'']/g)) {
+        entityTokens.push(m[1]);
+    }
+    // Book titles: 《记忆系统》
+    for (const m of trimmed.matchAll(/《([^》]+)》/g)) {
+        entityTokens.push(m[1]);
+    }
+    // Capitalized English phrases: "TypeScript", "Visual Studio Code"
+    for (const m of trimmed.matchAll(/\b([A-Z][a-zA-Z]*(?:\s+[A-Z][a-zA-Z]*)+)\b/g)) {
+        entityTokens.push(m[1]);
+    }
+    // Tokenize: split by spaces and Chinese character boundaries
+    const tokens = [];
+    const parts = trimmed.split(/\s+/);
+    for (const part of parts) {
+        // English words
+        for (const word of part.match(/[a-zA-Z0-9_\-.]+/g) ?? []) {
+            if (word.length >= 2)
+                tokens.push(word);
+        }
+        // For Chinese: strip action words first, then extract remaining chars
+        let cnText = part.replace(/[\u4e00-\u9fff]+/g, (seg) => {
+            let result = seg;
+            for (const aw of ACTION_WORDS_SORTED) {
+                result = result.replaceAll(aw, '');
+            }
+            return result;
+        });
+        const cnChars = cnText.match(/[\u4e00-\u9fff]/g) ?? [];
+        for (const c of cnChars) {
+            if (!CN_STOP_WORDS.has(c))
+                tokens.push(c);
+        }
+        // Chinese 2-grams for better matching
+        for (let i = 0; i < cnChars.length - 1; i++) {
+            const bigram = cnChars[i] + cnChars[i + 1];
+            tokens.push(bigram);
+        }
+    }
+    // Filter stop words, noise, and short tokens
+    const filtered = tokens.filter(t => {
+        if (ACTION_WORDS_SET.has(t))
+            return false;
+        if (CN_STOP_WORDS.has(t))
+            return false;
+        if (NOISE_WORDS.has(t.toLowerCase()))
+            return false;
+        if (t.length < 2)
+            return false;
+        return true;
+    });
+    // Deduplicate while preserving order
+    const seen = new Set();
+    const deduped = [];
+    for (const t of filtered) {
+        if (!seen.has(t)) {
+            seen.add(t);
+            deduped.push(t);
+        }
+    }
+    // If nothing left after filtering, check if we have entity tokens
+    if (deduped.length === 0 && entityTokens.length === 0) {
+        return null;
+    }
+    // Combine: entity tokens first (higher signal), then deduped tokens
+    const allTokens = [...entityTokens, ...deduped.filter(t => !entityTokens.includes(t))];
+    const query = allTokens.join(' ');
+    return { query, tokens: deduped, entityTokens };
+}
+//# sourceMappingURL=refine.js.map

package/dist/refine.js.map

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

package/dist/resources.d.ts

@@ -0,0 +1,27 @@
+/**
+ * MCP Resource manager for mnemo-mcp.
+ * Exposes per-category memory summaries as MCP Resources for session warmup injection.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { MemoryStore } from './store.js';
+import type { FactCategory } from './types.js';
+export interface ResourceFact {
+    fact_id: number;
+    content: string;
+    trust_score: number;
+}
+export declare class ResourceManager {
+    private store;
+    private cache;
+    constructor(store: MemoryStore);
+    /** Register all category resources with the MCP server */
+    registerResources(server: McpServer): void;
+    /** Read handler for a specific category */
+    private readCategory;
+    /** Get facts for a category — with caching */
+    getFacts(category: FactCategory): ResourceFact[];
+    /** Invalidate all caches — call after any write operation */
+    invalidate(): void;
+    /** Get cache entry count for debugging */
+    cacheSize(): number;
+}

package/dist/resources.js

@@ -0,0 +1,56 @@
+/**
+ * MCP Resource manager for mnemo-mcp.
+ * Exposes per-category memory summaries as MCP Resources for session warmup injection.
+ */
+const CATEGORIES = ['identity', 'coding_style', 'tool_pref', 'workflow', 'general'];
+const RESOURCE_LIMIT = 10;
+export class ResourceManager {
+    store;
+    cache = new Map();
+    constructor(store) {
+        this.store = store;
+    }
+    /** Register all category resources with the MCP server */
+    registerResources(server) {
+        for (const category of CATEGORIES) {
+            const uri = `mnemo://global/${category}`;
+            server.registerResource(`mnemo-global-${category}`, uri, {
+                description: `${category} category global facts (top ${RESOURCE_LIMIT} by trust)`,
+                mimeType: 'application/json',
+            }, async () => this.readCategory(category));
+        }
+    }
+    /** Read handler for a specific category */
+    readCategory(category) {
+        const facts = this.getFacts(category);
+        return {
+            contents: [{
+                    uri: `mnemo://global/${category}`,
+                    mimeType: 'application/json',
+                    text: JSON.stringify(facts, null, 2),
+                }],
+        };
+    }
+    /** Get facts for a category — with caching */
+    getFacts(category) {
+        const cached = this.cache.get(category);
+        if (cached)
+            return cached;
+        const facts = this.store.listFacts(category, 0.0, RESOURCE_LIMIT).map(f => ({
+            fact_id: f.factId,
+            content: f.content,
+            trust_score: f.trustScore,
+        }));
+        this.cache.set(category, facts);
+        return facts;
+    }
+    /** Invalidate all caches — call after any write operation */
+    invalidate() {
+        this.cache.clear();
+    }
+    /** Get cache entry count for debugging */
+    cacheSize() {
+        return this.cache.size;
+    }
+}
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,UAAU,GAAmB,CAAC,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,CAAC,CAAA;AACnG,MAAM,cAAc,GAAG,EAAE,CAAA;AAQzB,MAAM,OAAO,eAAe;IAIhB;IAHF,KAAK,GAAG,IAAI,GAAG,EAAgC,CAAA;IAEvD,YACU,KAAkB;QAAlB,UAAK,GAAL,KAAK,CAAa;IACzB,CAAC;IAEJ,0DAA0D;IAC1D,iBAAiB,CAAC,MAAiB;QACjC,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;YAClC,MAAM,GAAG,GAAG,kBAAkB,QAAQ,EAAE,CAAA;YACxC,MAAM,CAAC,gBAAgB,CACrB,gBAAgB,QAAQ,EAAE,EAC1B,GAAG,EACH;gBACE,WAAW,EAAE,GAAG,QAAQ,+BAA+B,cAAc,YAAY;gBACjF,QAAQ,EAAE,kBAAkB;aAC7B,EACD,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CACxC,CAAA;QACH,CAAC;IACH,CAAC;IAED,2CAA2C;IACnC,YAAY,CAAC,QAAsB;QACzC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;QACrC,OAAO;YACL,QAAQ,EAAE,CAAC;oBACT,GAAG,EAAE,kBAAkB,QAAQ,EAAE;oBACjC,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;iBACrC,CAAC;SACH,CAAA;IACH,CAAC;IAED,8CAA8C;IAC9C,QAAQ,CAAC,QAAsB;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QACvC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAA;QAEzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC1E,OAAO,EAAE,CAAC,CAAC,MAAM;YACjB,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,WAAW,EAAE,CAAC,CAAC,UAAU;SAC1B,CAAC,CAAC,CAAA;QAEH,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;QAC/B,OAAO,KAAK,CAAA;IACd,CAAC;IAED,6DAA6D;IAC7D,UAAU;QACR,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;IACpB,CAAC;IAED,0CAA0C;IAC1C,SAAS;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAA;IACxB,CAAC;CACF"}

package/dist/retriever.d.ts

@@ -30,7 +30,9 @@ export declare class FactRetriever {
     /** 获取性能指标实例（供调试接口使用） */
     getMetrics(): PerfMetrics;
     /** 主搜索：FTS5 → LIKE → 字符交叉 → 分类推断 → Jaccard → 信任评分 → 时间衰减 */
-    search(query: string, options?: SearchOptions): ScoredFact[];
+    search(query: string, options?: SearchOptions & {
+        skipRefine?: boolean;
+    }): ScoredFact[];
     /** 实体探测：查询某实体关联的所有事实 */
     probe(entity: string, options?: SearchOptions): ScoredFact[];
     /** 实体关联：查找与某实体共享上下文的其他事实 */

package/dist/retriever.js

@@ -8,6 +8,7 @@
  */
 import { QueryCache } from './cache.js';
 import { PerfMetrics } from './metrics.js';
+import { refineQuery } from './refine.js';
 // 中文字符级匹配的虚词集合（这些单字太常见，不参与字符交叉匹配）
 const CN_OVERLAP_STOP = new Set([
     '的', '了', '是', '在', '有', '和', '就', '不', '人', '都',
@@ -55,15 +56,23 @@ export class FactRetriever {
         const minTrust = options?.minTrust ?? 0.3;
         const limit = options?.limit ?? 10;
         const category = options?.category;
+        // 查询提炼（除非显式跳过）
+        let searchQuery = query;
+        if (!options?.skipRefine) {
+            const refined = refineQuery(query);
+            if (refined?.query) {
+                searchQuery = refined.query;
+            }
+        }
         // 缓存检查
-        const cacheKey = this.cache.makeKey({ action: 'search', query, category, minTrust, limit });
+        const cacheKey = this.cache.makeKey({ action: 'search', query: searchQuery, category, minTrust, limit });
         const cached = this.cache.get(cacheKey);
         if (cached) {
             this.metrics.record({ action: 'search', durationMs: performance.now() - startTime, resultCount: cached.length, cacheHit: true });
             return cached;
         }
         // 查询双语扩展：中文术语追加英文，英文术语追加中文
-        const expandedQuery = this.expandQueryBilingually(query);
+        const expandedQuery = this.expandQueryBilingually(searchQuery);
         // Stage 1: FTS5 候选集，空时逐级 fallback（使用双语扩展后的查询）
         let candidates = this.ftsCandidates(expandedQuery, category, minTrust, limit * 3);
         if (candidates.length === 0) {
@@ -75,18 +84,22 @@ export class FactRetriever {
         if (candidates.length === 0) {
             // 分类推断 fallback（仅无 category 过滤时生效）
             if (!category) {
-                const inferred = this.categoryInferFallback(query, minTrust, limit);
+                const inferred = this.categoryInferFallback(searchQuery, minTrust, limit);
                 if (inferred.length > 0)
                     return inferred;
             }
             // 个人/身份相关的短查询触发 trust fallback
-            if (this.isPersonalQuery(query)) {
+            if (this.isPersonalQuery(searchQuery)) {
                 return this.trustFallback(category, minTrust, limit);
             }
             return [];
         }
         // Stage 2-4: Jaccard 重排序 + 信任评分 + 时间衰减
-        const queryTokens = this.tokenize(query);
+        // 动态权重：短查询偏 FTS，长查询偏 Jaccard
+        const queryTokens = this.tokenize(searchQuery);
+        const tokenCount = queryTokens.size;
+        const ftsWeight = tokenCount <= 3 ? 0.7 : 0.3;
+        const jaccardWeight = tokenCount <= 3 ? 0.3 : 0.7;
         const scored = [];
         for (const fact of candidates) {
             const contentTokens = this.tokenize(fact.content);
@@ -99,7 +112,7 @@ export class FactRetriever {
             const similarity = 0.3 * jaccard + 0.7 * qInF;
             const ftsScore = fact.ftsRank;
             // 综合评分
-            const relevance = this.ftsWeight * ftsScore + this.jaccardWeight * similarity;
+            const relevance = ftsWeight * ftsScore + jaccardWeight * similarity;
             let score = relevance * fact.trustScore;
             // 时间衰减
             if (this.halfLifeDays > 0) {
@@ -108,29 +121,28 @@ export class FactRetriever {
             scored.push({ ...fact, score });
         }
         scored.sort((a, b) => b.score - a.score);
-        // Category 多样性：同类事实只保留评分最高的，避免 general 黑洞效应
-        const seenCategories = new Set();
-        const diverse = [];
-        for (const s of scored) {
-            if (!seenCategories.has(s.category)) {
-                seenCategories.add(s.category);
-                diverse.push(s);
-            }
-            if (diverse.length >= limit)
-                break;
-        }
-        // 补位：如果去重后不足 limit，从原排序列表中补（允许同类多次出现）
-        if (diverse.length < limit) {
-            const diverseIds = new Set(diverse.map(f => f.factId));
-            for (const s of scored) {
-                if (!diverseIds.has(s.factId)) {
-                    diverse.push(s);
-                    if (diverse.length >= limit)
-                        break;
+        // 相关性门控：过滤低相关性结果
+        const RELEVANCE_THRESHOLD = 0.15;
+        const gated = scored.filter(s => s.score >= RELEVANCE_THRESHOLD);
+        const pool = gated.length > 0 ? gated : scored;
+        // 内容去重：Jaccard > 0.7 的只保留高分
+        const results = [];
+        for (const candidate of pool) {
+            let isDuplicate = false;
+            const candidateTokens = this.tokenize(candidate.content);
+            for (const kept of results) {
+                const keptTokens = this.tokenize(kept.content);
+                if (this.jaccardSimilarity(candidateTokens, keptTokens) > 0.7) {
+                    isDuplicate = true;
+                    break;
                 }
             }
+            if (!isDuplicate) {
+                results.push(candidate);
+                if (results.length >= limit)
+                    break;
+            }
         }
-        const results = diverse;
         // 检索追踪：递增 retrieval_count + top3 信任刷新
         if (results.length > 0) {
             this.trackRetrieval(results);