memory-eternal 0.10.0 → 0.10.2

package/lib/sse.js

@@ -1,51 +1,51 @@
-// SSE 推送中心：把「配置/卡片变更」即时推给所有已打开的页面（不必手动刷新）。
-// 两个宿主（DSH 内嵌 + 独立 web）共用同一套实现；纯逻辑，便于单测（注入假 res）。
-export function createHub({ heartbeatMs = 25000 } = {}) {
-  const clients = new Set()
-  let timer = null
-  const send = (res, chunk) => {
-    try { res.write(chunk); return true } catch { return false }
-  }
-  const drop = (res) => {
-    clients.delete(res)
-    try { res.end() } catch { /* 已断开 */ }
-  }
-  const ensureTimer = () => {
-    if (timer || !(heartbeatMs > 0)) return
-    timer = setInterval(() => {
-      for (const res of [...clients]) if (!send(res, ': ping\n\n')) drop(res)
-    }, heartbeatMs)
-    if (typeof timer.unref === 'function') timer.unref()
-  }
-  return {
-    /** 接入一个连接（保持长连接，不要 end）。 */
-    add(res) {
-      try {
-        res.writeHead(200, {
-          'Content-Type': 'text/event-stream; charset=utf-8',
-          'Cache-Control': 'no-store',
-          Connection: 'keep-alive',
-          'X-Accel-Buffering': 'no',
-        })
-      } catch { return false }
-      if (!send(res, 'retry: 3000\n\n')) return false
-      clients.add(res)
-      ensureTimer()
-      const onClose = () => drop(res)
-      try { res.on('close', onClose); res.on('error', onClose) } catch { /* 某些响应对象没有 on */ }
-      return true
-    },
-    /** 广播事件（event: <name>，data: JSON）。返回当前连接数。 */
-    broadcast(event, data) {
-      const chunk = 'event: ' + event + '\ndata: ' + JSON.stringify(data === undefined ? {} : data) + '\n\n'
-      for (const res of [...clients]) if (!send(res, chunk)) drop(res)
-      return clients.size
-    },
-    get size() { return clients.size },
-    close() {
-      if (timer) clearInterval(timer)
-      timer = null
-      for (const res of [...clients]) drop(res)
-    },
-  }
-}
+// SSE 推送中心：把「配置/卡片变更」即时推给所有已打开的页面（不必手动刷新）。
+// 两个宿主（DSH 内嵌 + 独立 web）共用同一套实现；纯逻辑，便于单测（注入假 res）。
+export function createHub({ heartbeatMs = 25000 } = {}) {
+  const clients = new Set()
+  let timer = null
+  const send = (res, chunk) => {
+    try { res.write(chunk); return true } catch { return false }
+  }
+  const drop = (res) => {
+    clients.delete(res)
+    try { res.end() } catch { /* 已断开 */ }
+  }
+  const ensureTimer = () => {
+    if (timer || !(heartbeatMs > 0)) return
+    timer = setInterval(() => {
+      for (const res of [...clients]) if (!send(res, ': ping\n\n')) drop(res)
+    }, heartbeatMs)
+    if (typeof timer.unref === 'function') timer.unref()
+  }
+  return {
+    /** 接入一个连接（保持长连接，不要 end）。 */
+    add(res) {
+      try {
+        res.writeHead(200, {
+          'Content-Type': 'text/event-stream; charset=utf-8',
+          'Cache-Control': 'no-store',
+          Connection: 'keep-alive',
+          'X-Accel-Buffering': 'no',
+        })
+      } catch { return false }
+      if (!send(res, 'retry: 3000\n\n')) return false
+      clients.add(res)
+      ensureTimer()
+      const onClose = () => drop(res)
+      try { res.on('close', onClose); res.on('error', onClose) } catch { /* 某些响应对象没有 on */ }
+      return true
+    },
+    /** 广播事件（event: <name>，data: JSON）。返回当前连接数。 */
+    broadcast(event, data) {
+      const chunk = 'event: ' + event + '\ndata: ' + JSON.stringify(data === undefined ? {} : data) + '\n\n'
+      for (const res of [...clients]) if (!send(res, chunk)) drop(res)
+      return clients.size
+    },
+    get size() { return clients.size },
+    close() {
+      if (timer) clearInterval(timer)
+      timer = null
+      for (const res of [...clients]) drop(res)
+    },
+  }
+}

package/lib/stall.js

@@ -1,30 +1,30 @@
-// 记忆核心 · 「轮次收尾事件是否真的没来」判定
-//
-// 旧判据：turnsStarted > turnsStopped && claimIdleMs > 15min && idleMs > 15min。两个毛病：
-//   1) 两个计数**累积且永不归零**，而被取消/被拒的轮次不发 turn-stopping（子代理轮次同样不计）
-//      → 差额一旦出现就永久为真，判据退化成「只要空闲 15 分钟就报一次」（issue #4 的
-//      「已开始 16 / 已收尾 12，且 15 分钟无任何沉淀活动」就是这么来的）；
-//   2) 真故障的特征恰好相反：轮次**持续开始**、只是没有收尾 —— 此时 claimed 一直新鲜，
-//      claimIdleMs 条件不满足 → 真故障反而不报。
-//
-// 现在改成滑动窗口：只看「窗口内开始了几个、收尾了几个」。
-//   持续开始 + 零收尾 → 判停滞；用户离开（窗口内 0 开始）→ 不报。
-
-/**
- * @param {object} input
- * @param {number[]} input.claimedAt 轮次开始时间戳（ms）
- * @param {number[]} input.stoppedAt 轮次收尾时间戳（ms）
- * @param {number} [input.now] 当前时间
- * @param {number} [input.windowMs] 观察窗口，默认 20 分钟
- * @param {number} [input.minStarted] 窗口内至少开始几个轮次才判停滞，默认 3
- * @returns {{alert:boolean, started:number, stopped:number, windowMs:number}}
- */
-export function evaluateStall({ claimedAt = [], stoppedAt = [], now = Date.now(), windowMs = 20 * 60 * 1000, minStarted = 3 } = {}) {
-  const from = now - windowMs
-  const started = claimedAt.filter((t) => t >= from).length
-  const stopped = stoppedAt.filter((t) => t >= from).length
-  return { alert: started >= minStarted && stopped === 0, started, stopped, windowMs }
-}
-
-/** 时间戳数组的裁剪上限：只保留窗口相关的近邻，避免长跑无界增长。 */
-export const MAX_STAMPS = 200
+// 记忆核心 · 「轮次收尾事件是否真的没来」判定
+//
+// 旧判据：turnsStarted > turnsStopped && claimIdleMs > 15min && idleMs > 15min。两个毛病：
+//   1) 两个计数**累积且永不归零**，而被取消/被拒的轮次不发 turn-stopping（子代理轮次同样不计）
+//      → 差额一旦出现就永久为真，判据退化成「只要空闲 15 分钟就报一次」（issue #4 的
+//      「已开始 16 / 已收尾 12，且 15 分钟无任何沉淀活动」就是这么来的）；
+//   2) 真故障的特征恰好相反：轮次**持续开始**、只是没有收尾 —— 此时 claimed 一直新鲜，
+//      claimIdleMs 条件不满足 → 真故障反而不报。
+//
+// 现在改成滑动窗口：只看「窗口内开始了几个、收尾了几个」。
+//   持续开始 + 零收尾 → 判停滞；用户离开（窗口内 0 开始）→ 不报。
+
+/**
+ * @param {object} input
+ * @param {number[]} input.claimedAt 轮次开始时间戳（ms）
+ * @param {number[]} input.stoppedAt 轮次收尾时间戳（ms）
+ * @param {number} [input.now] 当前时间
+ * @param {number} [input.windowMs] 观察窗口，默认 20 分钟
+ * @param {number} [input.minStarted] 窗口内至少开始几个轮次才判停滞，默认 3
+ * @returns {{alert:boolean, started:number, stopped:number, windowMs:number}}
+ */
+export function evaluateStall({ claimedAt = [], stoppedAt = [], now = Date.now(), windowMs = 20 * 60 * 1000, minStarted = 3 } = {}) {
+  const from = now - windowMs
+  const started = claimedAt.filter((t) => t >= from).length
+  const stopped = stoppedAt.filter((t) => t >= from).length
+  return { alert: started >= minStarted && stopped === 0, started, stopped, windowMs }
+}
+
+/** 时间戳数组的裁剪上限：只保留窗口相关的近邻，避免长跑无界增长。 */
+export const MAX_STAMPS = 200

package/lib/sweep.js

@@ -1,56 +1,56 @@
-// 记忆核心 · 会话记录挖掘（简版 sweep）。
-//
-// 扫描目录下的 Claude Code 会话 JSONL（*.jsonl），每文件提取对话文本，
-// 按文件粒度蒸馏入库（source 带 sweep 标记；重复跑幂等靠 vault 词法去重）。
-// 适用：Codex sessions 目录 / Claude Code projects 目录 / 任意兼容 JSONL。
-
-import { promises as fs } from 'node:fs'
-import path from 'node:path'
-import { runStandaloneCapture, defaultVaultDir } from './capture-run.js'
-
-async function* walk(dir) {
-  let entries
-  try { entries = await fs.readdir(dir, { withFileTypes: true }) } catch { return }
-  for (const e of entries) {
-    const p = path.join(dir, e.name)
-    if (e.isDirectory()) yield* walk(p)
-    else if (e.name.endsWith('.jsonl')) yield p
-  }
-}
-
-function extractConversation(jsonlText) {
-  const texts = []
-  for (const line of jsonlText.split('\n')) {
-    if (!line.trim()) continue
-    let rec
-    try { rec = JSON.parse(line) } catch { continue }
-    const msg = rec?.message
-    if (!msg || !msg.role) continue
-    let text = ''
-    if (typeof msg.content === 'string') text = msg.content
-    else if (Array.isArray(msg.content)) {
-      text = msg.content.filter((c) => c?.type === 'text').map((c) => c.text).join('\n')
-    }
-    if (text && text.trim().length > 4) texts.push(`${msg.role}: ${text.trim()}`)
-  }
-  return texts.slice(-60).join('\n\n')
-}
-
-export async function sweepSessions(dir, { vaultRoot = defaultVaultDir(), limit = 50 } = {}) {
-  const root = path.resolve(dir)
-  let scanned = 0
-  let captured = 0
-  let skipped = 0
-  for await (const file of walk(root)) {
-    if (scanned >= limit) break
-    scanned++
-    try {
-      const text = extractConversation(await fs.readFile(file, 'utf8'))
-      if (text.trim().length < 200) { skipped++; continue }
-      const out = await runStandaloneCapture(vaultRoot, text, { source: `sweep:${path.basename(file)}` })
-      if (out.ok && out.action !== 'skipped') captured++
-      else skipped++
-    } catch { skipped++ }
-  }
-  return { ok: true, dir: root, scanned, captured, skipped }
-}
+// 记忆核心 · 会话记录挖掘（简版 sweep）。
+//
+// 扫描目录下的 Claude Code 会话 JSONL（*.jsonl），每文件提取对话文本，
+// 按文件粒度蒸馏入库（source 带 sweep 标记；重复跑幂等靠 vault 词法去重）。
+// 适用：Codex sessions 目录 / Claude Code projects 目录 / 任意兼容 JSONL。
+
+import { promises as fs } from 'node:fs'
+import path from 'node:path'
+import { runStandaloneCapture, defaultVaultDir } from './capture-run.js'
+
+async function* walk(dir) {
+  let entries
+  try { entries = await fs.readdir(dir, { withFileTypes: true }) } catch { return }
+  for (const e of entries) {
+    const p = path.join(dir, e.name)
+    if (e.isDirectory()) yield* walk(p)
+    else if (e.name.endsWith('.jsonl')) yield p
+  }
+}
+
+function extractConversation(jsonlText) {
+  const texts = []
+  for (const line of jsonlText.split('\n')) {
+    if (!line.trim()) continue
+    let rec
+    try { rec = JSON.parse(line) } catch { continue }
+    const msg = rec?.message
+    if (!msg || !msg.role) continue
+    let text = ''
+    if (typeof msg.content === 'string') text = msg.content
+    else if (Array.isArray(msg.content)) {
+      text = msg.content.filter((c) => c?.type === 'text').map((c) => c.text).join('\n')
+    }
+    if (text && text.trim().length > 4) texts.push(`${msg.role}: ${text.trim()}`)
+  }
+  return texts.slice(-60).join('\n\n')
+}
+
+export async function sweepSessions(dir, { vaultRoot = defaultVaultDir(), limit = 50 } = {}) {
+  const root = path.resolve(dir)
+  let scanned = 0
+  let captured = 0
+  let skipped = 0
+  for await (const file of walk(root)) {
+    if (scanned >= limit) break
+    scanned++
+    try {
+      const text = extractConversation(await fs.readFile(file, 'utf8'))
+      if (text.trim().length < 200) { skipped++; continue }
+      const out = await runStandaloneCapture(vaultRoot, text, { source: `sweep:${path.basename(file)}` })
+      if (out.ok && out.action !== 'skipped') captured++
+      else skipped++
+    } catch { skipped++ }
+  }
+  return { ok: true, dir: root, scanned, captured, skipped }
+}

package/lib/vault-resolve.js

@@ -1,84 +1,84 @@
-// 记忆核心 · vault 目录解析（宿主与所有独立进程共用同一套优先级）
-//
-// 为什么单独成模块：以前宿主 index.js 认 activeVault，而 CLI / MCP / hooks /
-// 独立 web / sweep 只认 MEMORY_VAULT_DIR 与默认库 —— 用户切库后终端与 hooks 仍写
-// 默认库，同一台机器上的记忆被劈成两份（dsh-memory-eternal#5）。解析逻辑必须只有一份。
-//
-// 优先级：
-//   1. MEMORY_VAULT_DIR              （临时切库 / 宿主 spawn 子进程时显式传入）
-//   2. activeVault 命中 vaultProfiles[].name
-//   3. vaultProfiles[].match.workspace 命中当前 workspace（最长前缀优先，opt-in）
-//   4. vaultDir（单库配置）
-//   5. 默认 ~/.dsh/memory-vault
-
-import path from 'node:path'
-import os from 'node:os'
-
-/** 取当前 workspace（用于 match.workspace 的按项目选库）：MEMORY_WORKSPACE 优先，其次进程 cwd。 */
-export function currentWorkspace(env = process.env) {
-  const explicit = String((env && env.MEMORY_WORKSPACE) || '').trim()
-  if (explicit) return explicit
-  try { return process.cwd() } catch { return '' }
-}
-
-/** 默认库目录。 */
-export function defaultVaultRoot(env = process.env) {
-  const home = (env && env.DSH_HOME) || path.join(os.homedir(), '.dsh')
-  return path.join(home, 'memory-vault')
-}
-
-/** 归一化：反斜杠转正斜杠、去尾斜杠、统一小写（Windows 路径大小写不敏感）。 */
-const norm = (p) => String(p || '').replace(/\\/g, '/').replace(/\/+$/, '').toLowerCase()
-
-/**
- * 找出 match.workspace 命中当前 workspace 的 profile。
- * 双向前缀匹配（workspace 落在规则目录下，或规则目录落在 workspace 下），最长规则优先。
- * @returns {object|null}
- */
-export function matchWorkspaceProfile(profiles, workspace) {
-  const ws = norm(workspace)
-  if (!ws) return null
-  let best = null
-  let bestLen = -1
-  for (const p of Array.isArray(profiles) ? profiles : []) {
-    const rule = p && p.match && p.match.workspace
-    const target = norm(rule)
-    if (!target) continue
-    // 规则没配可用目录 → 不能作为记忆库，直接跳过（与 resolveVaultDir 的判定保持一致）
-    if (!p.path || !String(p.path).trim()) continue
-    if (!(ws === target || ws.startsWith(target + '/') || target.startsWith(ws + '/'))) continue
-    if (target.length > bestLen) { best = p; bestLen = target.length }
-  }
-  return best
-}
-
-/**
- * 解析当前 vault 目录。
- * @param {object} input
- * @param {NodeJS.ProcessEnv} [input.env]
- * @param {Array<{name?:string,path?:string,match?:{workspace?:string}}>} [input.profiles]
- * @param {string} [input.activeVault]
- * @param {string} [input.configured] vaultDir 单库配置
- * @param {string} [input.workspace] 显式指定 workspace（默认 currentWorkspace）
- * @returns {{root:string, source:'env'|'profile'|'workspace'|'vaultDir'|'default', name:string, workspace:string}}
- */
-export function resolveVaultDir({ env = process.env, profiles = [], activeVault = '', configured = '', workspace } = {}) {
-  const ws = workspace === undefined ? currentWorkspace(env) : String(workspace || '')
-  const envDir = String((env && env.MEMORY_VAULT_DIR) || '').trim()
-  if (envDir) return { root: path.resolve(envDir), source: 'env', name: '', workspace: ws }
-
-  const list = Array.isArray(profiles) ? profiles : []
-  const active = String(activeVault || '').trim()
-  if (active) {
-    const hit = list.find((p) => p && String(p.name || '') === active && p.path && String(p.path).trim())
-    if (hit) return { root: path.resolve(String(hit.path).trim()), source: 'profile', name: active, workspace: ws }
-  }
-  const byWs = matchWorkspaceProfile(list, ws)
-  if (byWs && byWs.path && String(byWs.path).trim()) {
-    return { root: path.resolve(String(byWs.path).trim()), source: 'workspace', name: String(byWs.name || ''), workspace: ws }
-  }
-  if (configured && String(configured).trim()) {
-    return { root: path.resolve(String(configured).trim()), source: 'vaultDir', name: '', workspace: ws }
-  }
-  return { root: defaultVaultRoot(env), source: 'default', name: '', workspace: ws }
-}
+// 记忆核心 · vault 目录解析（宿主与所有独立进程共用同一套优先级）
+//
+// 为什么单独成模块：以前宿主 index.js 认 activeVault，而 CLI / MCP / hooks /
+// 独立 web / sweep 只认 MEMORY_VAULT_DIR 与默认库 —— 用户切库后终端与 hooks 仍写
+// 默认库，同一台机器上的记忆被劈成两份（dsh-memory-eternal#5）。解析逻辑必须只有一份。
+//
+// 优先级：
+//   1. MEMORY_VAULT_DIR              （临时切库 / 宿主 spawn 子进程时显式传入）
+//   2. activeVault 命中 vaultProfiles[].name
+//   3. vaultProfiles[].match.workspace 命中当前 workspace（最长前缀优先，opt-in）
+//   4. vaultDir（单库配置）
+//   5. 默认 ~/.dsh/memory-vault
+
+import path from 'node:path'
+import os from 'node:os'
+
+/** 取当前 workspace（用于 match.workspace 的按项目选库）：MEMORY_WORKSPACE 优先，其次进程 cwd。 */
+export function currentWorkspace(env = process.env) {
+  const explicit = String((env && env.MEMORY_WORKSPACE) || '').trim()
+  if (explicit) return explicit
+  try { return process.cwd() } catch { return '' }
+}
+
+/** 默认库目录。 */
+export function defaultVaultRoot(env = process.env) {
+  const home = (env && env.DSH_HOME) || path.join(os.homedir(), '.dsh')
+  return path.join(home, 'memory-vault')
+}
+
+/** 归一化：反斜杠转正斜杠、去尾斜杠、统一小写（Windows 路径大小写不敏感）。 */
+const norm = (p) => String(p || '').replace(/\\/g, '/').replace(/\/+$/, '').toLowerCase()
+
+/**
+ * 找出 match.workspace 命中当前 workspace 的 profile。
+ * 双向前缀匹配（workspace 落在规则目录下，或规则目录落在 workspace 下），最长规则优先。
+ * @returns {object|null}
+ */
+export function matchWorkspaceProfile(profiles, workspace) {
+  const ws = norm(workspace)
+  if (!ws) return null
+  let best = null
+  let bestLen = -1
+  for (const p of Array.isArray(profiles) ? profiles : []) {
+    const rule = p && p.match && p.match.workspace
+    const target = norm(rule)
+    if (!target) continue
+    // 规则没配可用目录 → 不能作为记忆库，直接跳过（与 resolveVaultDir 的判定保持一致）
+    if (!p.path || !String(p.path).trim()) continue
+    if (!(ws === target || ws.startsWith(target + '/') || target.startsWith(ws + '/'))) continue
+    if (target.length > bestLen) { best = p; bestLen = target.length }
+  }
+  return best
+}
+
+/**
+ * 解析当前 vault 目录。
+ * @param {object} input
+ * @param {NodeJS.ProcessEnv} [input.env]
+ * @param {Array<{name?:string,path?:string,match?:{workspace?:string}}>} [input.profiles]
+ * @param {string} [input.activeVault]
+ * @param {string} [input.configured] vaultDir 单库配置
+ * @param {string} [input.workspace] 显式指定 workspace（默认 currentWorkspace）
+ * @returns {{root:string, source:'env'|'profile'|'workspace'|'vaultDir'|'default', name:string, workspace:string}}
+ */
+export function resolveVaultDir({ env = process.env, profiles = [], activeVault = '', configured = '', workspace } = {}) {
+  const ws = workspace === undefined ? currentWorkspace(env) : String(workspace || '')
+  const envDir = String((env && env.MEMORY_VAULT_DIR) || '').trim()
+  if (envDir) return { root: path.resolve(envDir), source: 'env', name: '', workspace: ws }
+
+  const list = Array.isArray(profiles) ? profiles : []
+  const active = String(activeVault || '').trim()
+  if (active) {
+    const hit = list.find((p) => p && String(p.name || '') === active && p.path && String(p.path).trim())
+    if (hit) return { root: path.resolve(String(hit.path).trim()), source: 'profile', name: active, workspace: ws }
+  }
+  const byWs = matchWorkspaceProfile(list, ws)
+  if (byWs && byWs.path && String(byWs.path).trim()) {
+    return { root: path.resolve(String(byWs.path).trim()), source: 'workspace', name: String(byWs.name || ''), workspace: ws }
+  }
+  if (configured && String(configured).trim()) {
+    return { root: path.resolve(String(configured).trim()), source: 'vaultDir', name: '', workspace: ws }
+  }
+  return { root: defaultVaultRoot(env), source: 'default', name: '', workspace: ws }
+}

package/lib/vault.js

@@ -142,12 +142,26 @@ export function queryTerms(query) {
  * 会把新知识追加进待审垃圾卡或已被驳回的卡，等于绕过审核往废弃卡里灌数据。
  */
 export async function dedupCheck(root, text, threshold = 0.62) {
+  return bestDuplicate(await mainStoreBodies(root), text, threshold)
+}
+
+/**
+ * 主库已审核卡的 `(path, body)` 快照。
+ *
+ * 批量写入（导入备份）必须用它做**导入前**基线：否则同一份备份里互相近似的卡会在写入
+ * 过程中互相判重，把备份当成「重复」丢掉一批（备份是真相源，不能被自己人吞）。
+ */
+export async function mainStoreBodies(root) {
   const db = getDb(root)
-  const rows = db.prepare("SELECT path, body FROM cards WHERE status = 'approved' AND deleted_at IS NULL").all()
+  return db.prepare("SELECT path, body FROM cards WHERE status = 'approved' AND deleted_at IS NULL").all()
+}
+
+/** 在一组候选里找与给定文本最相似的一张（≥ 阈值）。候选集合由调用方提供，供快照比对复用。 */
+export function bestDuplicate(candidates, text, threshold = 0.62) {
   let best = null
-  for (const row of rows) {
-    const score = textSimilarity(text, row.body || '')
-    if (score >= threshold && (!best || score > best.score)) best = { path: row.path, score }
+  for (const row of Array.isArray(candidates) ? candidates : []) {
+    const score = textSimilarity(text, row?.body || '')
+    if (score >= threshold && (!best || score > best.score)) best = { path: row?.path, score }
   }
   return best
 }
@@ -540,8 +554,11 @@ export async function setCardStatus(root, rel, status, { changedBy = 'system', r
  *
  * 两套存储：enforceAudit 判定出的 status 决定**写进哪张表** ——
  * approved → 主库（可被召回）；pending/rejected/deleted → 隔离区（只有审核中心能看）。
+ *
+ * `dedupAgainst` 传入候选集合时，去重只跟**这些**卡比（导入备份用：基线取导入前的快照，
+ * 让同一批里互相近似的卡不会互吞）。
  */
-export async function writeCard(root, { kind, title, tags = [], body, source = '', status = 'pending', submittedBy = '', severity = 'info', reason = '', deletedAt = '' }, { threshold = 0.62, dedup = true } = {}) {
+export async function writeCard(root, { kind, title, tags = [], body, source = '', status = 'pending', submittedBy = '', severity = 'info', reason = '', deletedAt = '' }, { threshold = 0.62, dedup = true, dedupAgainst = null } = {}) {
   const db = getDb(root)
   const kindRoot = KIND_ROOTS[kind] || KIND_ROOTS.knowledge
 
@@ -551,7 +568,7 @@ export async function writeCard(root, { kind, title, tags = [], body, source = '
 
   // 去重只在主库（approved）里找 —— 把新知识追加进隔离区里的待审/驳回卡是绕过审核
   if (dedup) {
-    const hit = await dedupCheck(root, body, threshold)
+    const hit = dedupAgainst ? bestDuplicate(dedupAgainst, body, threshold) : await dedupCheck(root, body, threshold)
     if (hit) return { ok: false, duplicate: { ...hit, path: hit.path } }
   }