dsh-shared-kb 1.0.0 → 1.0.1

package/lib/store/docs.js

@@ -376,12 +376,20 @@ export async function writeDoc(params) {
 
   // 清单 CAS 写入：rev 对不上会把上面写好的正文留在磁盘上（幂等，下次重跑会覆盖），
   // 但绝不更新清单，读者看不到半成品。
+  //
+  // 关键：去重必须在锁内再判一次。锁外那次 findDoc 只是"快速路径"，
+  // 两个进程同时导入同一份文件时会双双落空，然后都进锁写入 —— 数据不会错
+  // （内容相同），但会白白推高 rev、重复触发索引。锁内命中就直接报 unchanged，
+  // 且不递增 rev。
   const result = await withManifest(
     dir,
     kb,
     (manifest) => {
       const list = manifest.docs ?? (manifest.docs = []);
       const at = list.findIndex((doc) => doc.id === docId);
+      if (at >= 0 && list[at].contentHash === contentHash && !params.force) {
+        return { __skip: true, result: { status: "unchanged", version: list[at].version } };
+      }
       if (at >= 0) list[at] = entry;
       else list.push(entry);
       return entry;
@@ -400,6 +408,19 @@ export async function writeDoc(params) {
     chars: entry.chars,
   });
 
+  // 锁内判重命中：这一轮什么都没改，如实报 unchanged
+  if (result.skipped === true) {
+    return {
+      docId,
+      status: "unchanged",
+      rev: null,
+      version: result.result?.version ?? entry.version,
+      title: entry.title,
+      parts: entry.parts,
+      chars: entry.chars,
+    };
+  }
+
   return {
     docId,
     status: existing ? "updated" : "created",

package/lib/store/manifest.js

@@ -164,11 +164,17 @@ export async function withManifest(dir, name, mutate, options = {}) {
       }
       const by = options.by ?? { machine: machineId(), pid: process.pid };
       const now = new Date().toISOString();
-      const result = await mutate(manifest, { now, by });
+      const outcome = await mutate(manifest, { now, by });
+      // mutate 可以返回 { __skip: true, result } 表示"读完发现不需要改"。
+      // 这种轮次绝不能递增 rev：rev 是"清单内容变了几次"的计数，
+      // 空轮递增会让所有人都以为有人在改，也会白白触发索引重建。
+      if (outcome && outcome.__skip === true) {
+        return { rev: manifest.rev, result: outcome.result ?? null, manifest, skipped: true };
+      }
       manifest.rev = manifest.rev + 1;
       touch(manifest, by);
       await writeManifestAtomic(dir, manifest);
-      return { rev: manifest.rev, result, manifest };
+      return { rev: manifest.rev, result: outcome, manifest, skipped: false };
     },
     { timeoutMs: options.timeoutMs }
   );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-shared-kb",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "DSH 知识库中枢：指定物理地址后每库独立子文件夹落地原始资料与派生分块，自带 SQLite FTS5 全文索引 + 向量语义检索，用租约与 revision CAS 支持多人多机同时读、写入与索引重建",
   "keywords": [
     "dsh",