dsh-session-index-lau 2.5.1 → 2.5.2

package/README.md

@@ -5,7 +5,7 @@
 
 | 项目 | 值 |
 |---|---|
-| 版本 | **v2.5.1** |
+| 版本 | **v2.5.2** |
 | 运行要求 | Node **≥ 22.15**（需要 `zlib.zstdDecompressSync`） |
 | MCP 能力 | **14 个工具** / 4 个提示词 / 8 个资源 |
 | 第三方依赖 | **0**（只用 Node 标准库） |
@@ -270,6 +270,7 @@ node tools/push-doc.mjs --from-workbuddy --send           # 全部投递到待
 node tools/push-doc.mjs --from-workbuddy --no-exclude     # 连临时/备份目录一起
 node tools/push-doc.mjs --from-workbuddy --include-txt    # 连 .txt 一起
 node tools/push-doc.mjs --from-workbuddy --source PresentFiles --limit 10 --send
+node tools/push-doc.mjs --from-workbuddy --seed         # 只记状态基线，不投递任何文档
 ```
 
 数据源是 `~/.workbuddy/artifact-index/<会话id>.json` 里 `contentType: document` 的条目
@@ -278,13 +279,22 @@ node tools/push-doc.mjs --from-workbuddy --source PresentFiles --limit 10 --send
 避免同一份 README 被推十几遍。每篇标题带相对路径、备注带来源会话，落点统一可在界面改。
 
 实测（2026-11-14）：70 条文档命中 → 排除 26 条临时/依赖 → 文件已不存在 4 →
-路径或内容重复 18 → **唯一 22 篇全部投递成功**，队列 23 篇（含此前单推的手册），
-重复执行 22 篇全部被同名去重拦截。可用 `--limit`（默认 60）与 `--since` 收窄。
+路径或内容重复 18 → **唯一 22 篇全部投递成功**，队列 23 篇（含此前单推的手册）。
+可用 `--limit`（默认 60）与 `--since` 收窄。
+
+**判重：对齐思源桥 `autoStage` 的 `.auto-staged.json`，但丢弃后不重新获取。**
+
+状态文件 `~/.dsh/session-index/push-doc-state.json`（`PUSH_DOC_STATE` 可改）按
+「文档路径 + 内容 sha256」记录已推送过的文档，**判重不看队列里还在不在**：
+
+- 在思源桥里「丢弃」某篇 → 下次自动化**不会**把它重新推送回来
+- 队列被清空、服务重启、定时任务重跑 → 同样不会重复入队
+- 内容真的改了 → 作为新版本投递一次，之后又不再重复
+- `--force` 可强制绕过；`--seed` 只写状态基线、不投递（首次启用或迁移时用）
 
 - **默认只预览**，加 `--send` 才入队；预览写到 `dist/push-doc-preview.md`
 - HTML 会先裁掉侧栏导航、复制按钮、脚本、样式与统计卡，再用思源桥自带的
   `/api/paste/html`（只读）转成 Markdown，不会把界面文字塞进笔记
-- 队列里已有同名稿时**默认不重复投递**；手册更新后要再投一份需显式 `--force`
 - 同样**只入队、不 commit**，写入仍由你在思源桥界面确认
 
 ### 插件怎么更新（DSH 插件页有没有「更新」按钮）
@@ -298,19 +308,26 @@ node tools/push-doc.mjs --from-workbuddy --source PresentFiles --limit 10 --send
 | 官方按需插件 | 有显式**更新**（版本或开发链接来源不同时） |
 | **本地路径 / `link:` / 压缩包安装的** | **不显示版本区块**，文档写明「通过卸载后重新安装升级」 |
 
-本仓库插件在本机是 **`link:` 挂载**（`node_modules/dsh-session-index` 是指向仓库目录的
-junction），所以插件页**不会有更新按钮**——但也不需要：
+**本机当前是 npm registry 来源**：profile 依赖 `dsh-session-index-lau: ^2.5.2`，
+属于上表第一行，所以插件页**有「版本」区块与「更新」按钮**——以后发新版后
+**点更新即可，不需要卸载重装**。命令行 `pnpm update <包名>` 与点按钮是同一条路径。
+
+发布侧走 `dist/publish/` 下的标准流程（`插件发布标准流程.md`）：
 
 ```bash
-git -C <仓库目录> pull     # 代码就在 junction 指向的目录里，pull 完即更新
-# 然后完全退出 DSH 再打开（MCP 子进程在启动时加载）
+node sync-publish.mjs session-index                       # 生成改名后的发布副本并自检
+cd dsh-session-index-lau && npm publish --access public
+# 等 npm staged publishing 生效（实测约 1 分钟）
+cd ~/.dsh/profiles/desktop && npx -y pnpm@11.28.5 update dsh-session-index-lau@<新版本>
 ```
 
-不需要卸载、不需要重新安装、不需要发布 npm 包。若你以后改成从插件页输入
-`github:Lau-Jin/DSH` 安装，才会变成 Git 来源、出现「更新」入口，但那样就不再跟随本地
-开发目录，且每次更新要走一遍 GitHub 下载（本机实测 80–100 秒）。
+注意 `pnpm-workspace.yaml` 的 `minimumReleaseAgeExclude` 要同步登记新版本，
+否则供应链冷却期会让 pnpm 静默回退旧版。更新后**完全退出 DSH 再打开**，
+运行中的 MCP 子进程才会换成新版。
 
-> 发布给别人用只需要 `git push`；本机生效只需要 `git pull` + 重启 DSH。
+> 只有从本地路径 / `link:` / 压缩包安装的才没有更新按钮（需卸载重装）；
+> 这类挂载因为直接指向仓库目录，`git pull` + 重启即生效，同样不用重装。
+> 发布给别人用需要 `git push` + `npm publish`；本机开发目录则 `git pull` 即可。
 
 ---
 
@@ -341,8 +358,8 @@ node smoke.mjs                   # 80 项端到端自测
 
 | 文件 | 内容 | 用途 |
 |---|---|---|
-| `dist/dsh-session-index-v2.5.1.zip` | 全部源码 + 清单 + 文档 + 手册 + 脚本 + `MANIFEST.json` + `INSTALL.md` | 完整分发，解压后双击 `install.cmd` |
-| `dist/session-index-skill-v2.5.1.zip` | 根 `SKILL.md` + 说明 | 直接导入 DSH「MCP 与技能」 |
+| `dist/dsh-session-index-v2.5.2.zip` | 全部源码 + 清单 + 文档 + 手册 + 脚本 + `MANIFEST.json` + `INSTALL.md` | 完整分发，解压后双击 `install.cmd` |
+| `dist/session-index-skill-v2.5.2.zip` | 根 `SKILL.md` + 说明 | 直接导入 DSH「MCP 与技能」 |
 
 包内**排除**：索引分片 `*.jsonl.gz`、`meta/cards/notes/vectors.json`、备份与临时文件、已有 zip。
 已验证包内无任何会话数据与密钥，可安全分发。也可随时 `node pack.mjs` 重打，或调 MCP 工具 `session_index_package`。
@@ -433,6 +450,7 @@ dsh-session-index/                  # 仓库根 = 插件根
 
 | 版本 | 变更 |
 |---|---|
+| **v2.5.2** | 发布流程标准化：新增发布前/后核验门禁（`dist/publish/check-release.mjs`），把「检查并核验 → 确认版本可用 → 才推进标准流程」固化为强制步骤；标准流程文档同步新机制（批量推送、持久化判重、定时自动化）与版本统一矩阵。把源仓库已生效的持久化判重脚本同步进发布包与 DSH 安装，消除「同版本号、内容不同」的分叉。 |
 | **v2.5.1** | `tools/push-doc.mjs` 增加 **`--from-workbuddy` 批量模式**：扫描 WorkBuddy 全部会话产出的文档，按内容哈希去重、排除临时/依赖目录、逐篇查重后一次性投递到思源桥待入库；默认只读预览，`--send` 才入队，`--no-exclude` / `--include-txt` / `--source` / `--limit` / `--since` / `--force` 可控。修掉按 `chars` 判重不稳的问题（思源桥会规整正文）。README 补「插件怎么更新」章节。 |
 | **v2.5.0** | 新增第 14 个工具 `session_index_stage`：**会话整理文档 → 思源桥「待入库」队列**。两步确认（预览返回令牌，原样回传 `confirmWith` 才投递）、按标题+字数去重、支持主题/指定会话/三种模板/落点配置，**绝不自动写入思源笔记库**。读取状态与队列可传 `status: true`。 |
 | **v2.4.1** | 新增 `install.mjs --doctor` **环境体检**（7 项，只读），覆盖插件页安装失败的四个真实成因：git URL 重写镜像、pnpm `fetch-timeout` 超上限、远端大 tarball、lockfile 残留 `git+ssh`。README 增加「插件页装不上」排障章节。 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-session-index-lau",
-  "version": "2.5.1",
+  "version": "2.5.2",
   "type": "module",
   "description": "完全化的 DSH + WorkBuddy 全会话 MCP 插件：装到 DSH 里即用（bundle 自动挂载，无需手工改配置）、自动建索引、文件事件驱动识别新会话、MCP 变更通知、自动打包插件与技能。零第三方依赖，源会话只读。",
   "engines": {

package/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-session-index-lau",
-  "version": "2.5.1",
+  "version": "2.5.2",
   "icon": "icon.svg",
   "displayName": {
     "zh": "全会话索引与跨会话记忆",
@@ -84,8 +84,8 @@
   },
   "packages": {
     "directory": "dist",
-    "plugin": "dsh-session-index-lau-v2.5.1.zip",
-    "skill": "session-index-skill-v2.5.1.zip",
+    "plugin": "dsh-session-index-lau-v2.5.2.zip",
+    "skill": "session-index-skill-v2.5.2.zip",
     "generator": "lib/pack.mjs (zero dependency ZIP writer)",
     "contents": ["MANIFEST.json", "INSTALL.md"],
     "excludes": ["会话索引分片 *.jsonl.gz", "meta/cards/notes/vectors.json", "备份与临时文件", "已有 zip"]

package/server.mjs

@@ -29,7 +29,7 @@ import { pack, packAll, listPacks } from './lib/pack.mjs';
 import { stageConfig, buildStageDocument, stageToken, bridgeOverview, findDuplicate, postStage, StageError } from './lib/stage.mjs';
 
 const { sessionsRoot, indexDir, workbuddyProjectsDir } = defaultPaths();
-const VERSION = '2.5.1';
+const VERSION = '2.5.2';
 const SUPPORTED_PROTOCOLS = new Set(['2024-11-05', '2025-03-26', '2025-06-18']);
 const log = (...parts) => process.stderr.write(`[dsh-session-index-lau] ${parts.join(' ')}\n`);
 

package/smoke.mjs

@@ -128,9 +128,9 @@ try {
   const init = await request('initialize', {
     protocolVersion: '2024-11-05',
     capabilities: {},
-    clientInfo: { name: 'smoke-test', version: '2.5.1' },
+    clientInfo: { name: 'smoke-test', version: '2.5.2' },
   });
-  check('initialize 握手与能力声明', init.result?.serverInfo?.version === '2.5.1' && Boolean(init.result?.capabilities?.prompts) && Boolean(init.result?.capabilities?.resources), init.result?.serverInfo?.version);
+  check('initialize 握手与能力声明', init.result?.serverInfo?.version === '2.5.2' && Boolean(init.result?.capabilities?.prompts) && Boolean(init.result?.capabilities?.resources), init.result?.serverInfo?.version);
   check('initialize 返回自描述 instructions', (init.result?.instructions || '').includes('session_index_brief'));
   check('声明 listChanged 通知能力', init.result?.capabilities?.resources?.listChanged === true && init.result?.capabilities?.prompts?.listChanged === true);
   notify('notifications/initialized');

package/tools/push-doc.mjs

@@ -6,13 +6,19 @@
  *   node tools/push-doc.mjs --file README.md --send     推送任意单个文档
  *   node tools/push-doc.mjs --from-workbuddy            批量：列出 WorkBuddy 会话文档（只读）
  *   node tools/push-doc.mjs --from-workbuddy --send     批量：全部投递到待入库
+ *   node tools/push-doc.mjs --from-workbuddy --seed     批量：把当前文档记为「已推送」（不投递）
  *
  * 批量数据源：~/.workbuddy/artifact-index/<会话id>.json 的 contentType=document 条目。
  * 默认排除临时验证目录/依赖目录/旧开发副本，按内容哈希去重，避免把同一份 README
  * 推十几遍。用 --no-exclude 关闭排除，--source 按生成方式收窄，--limit 设上限。
  *
- * 可控点：默认 dry-run；--send 才入队；投递前逐篇查重；
- *         **永远不调用 /api/stage/commit**，写入思源笔记库由人在界面确认。
+ * 判重（对齐思源桥 autoStage 的 .auto-staged.json）：状态文件按「文档路径 + 内容哈希」
+ * 持久化记录已推送过的文档，**不依赖队列当前状态**。所以在思源桥里「丢弃」某篇后，
+ * 下次自动化不会把它重新推送回来；只有内容真的变了才会作为新版本再投一次。
+ * --force 可绕过状态与队列检查；--seed 用于首次启用时把历史文档补进状态基线。
+ *
+ * 可控点：默认 dry-run；--send 才入队；**永远不调用 /api/stage/commit**，
+ *         写入思源笔记库由人在界面确认。
  */
 import fs from 'node:fs';
 import path from 'node:path';
@@ -28,6 +34,7 @@ const arg = (name, fallback) => {
 };
 const has = (...names) => names.some((n) => argv.includes(n));
 const SEND = has('--send');
+const SEED = has('--seed');
 const BATCH = has('--from-workbuddy');
 const NO_EXCLUDE = has('--no-exclude');
 const FORCE = has('--force');
@@ -41,6 +48,44 @@ const HPATH = arg('--hpath', process.env.SESSION_INDEX_STAGE_HPATH || '/会话
 const NOTEBOOK = arg('--notebook', '思源桥');
 const TITLE_OVERRIDE = arg('--title', '');
 const OUT_DIR = path.join(ROOT, 'dist');
+// 和思源桥 .auto-staged.json 同类的持久化状态：判重只看这里，不看队列里还在不在
+const STATE_FILE = process.env.PUSH_DOC_STATE
+  || path.join(process.env.SESSION_INDEX_DIR || path.join(os.homedir(), '.dsh', 'session-index'), 'push-doc-state.json');
+
+function loadState() {
+  try {
+    const j = JSON.parse(fs.readFileSync(STATE_FILE, 'utf8'));
+    if (j && typeof j.pushed === 'object' && j.pushed) return j;
+  } catch {
+    // 首次运行或文件损坏，按空状态处理
+  }
+  return { version: 1, pushed: {} };
+}
+
+function saveState(state) {
+  state.version = 1;
+  state.updatedAt = new Date().toISOString();
+  fs.mkdirSync(path.dirname(STATE_FILE), { recursive: true });
+  const tmp = `${STATE_FILE}.tmp-${process.pid}`;
+  fs.writeFileSync(tmp, JSON.stringify(state, null, 2), 'utf8');
+  // Windows 上目标被另一进程短暂占用时 rename 会 EPERM，做短退避
+  let last;
+  for (const delay of [0, 40, 120, 300]) {
+    if (delay) Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, delay);
+    try {
+      fs.renameSync(tmp, STATE_FILE);
+      return;
+    } catch (err) {
+      last = err;
+      if (!['EPERM', 'EACCES', 'EBUSY'].includes(err.code)) break;
+    }
+  }
+  try { fs.unlinkSync(tmp); } catch { /* ignore */ }
+  throw last;
+}
+
+/** 稳定键：文档相对路径；内容哈希单独比较，内容变了才算新版本。 */
+const stateKey = (relShort) => String(relShort).replace(/\\/g, '/').toLowerCase();
 
 /** 默认排除：临时验证副本、依赖目录、旧开发副本、UI 源码。 */
 const EXCLUDE = [
@@ -158,6 +203,8 @@ function collectWorkbuddyDocs() {
       docs.push({
         abs, raw, conv,
         relShort,
+        contentHash: h,
+        stateKey: stateKey(relShort),
         title: cleanTitle(TITLE_OVERRIDE || `${label.replace(/\.[^.]+$/, '')} · ${relShort}`),
         origin: relShort,
       });
@@ -166,27 +213,40 @@ function collectWorkbuddyDocs() {
   return { docs, stats: { dir, rawCount, excluded, missing, dup, unique: docs.length } };
 }
 
-async function deliver(doc, queue) {
+async function deliver(doc, queue, state) {
   if (doc.problems.length) return { skipped: true, why: '含杂质：' + doc.problems.join(', ') };
   if (doc.chars > 256 * 1024) return { skipped: true, why: '超过 256 KiB' };
   if (!SEND) return { skipped: true, why: 'dry-run（未写入）' };
+
+  // 第一道：持久化状态。丢弃 / 清空队列 / 服务重启都不会让已推过的文档再出现。
+  const prev = state && doc.stateKey ? state.pushed[doc.stateKey] : null;
+  if (prev && prev.hash === doc.contentHash && !FORCE) {
+    return { skipped: true, why: '已推送过（丢弃也不重推）' };
+  }
+
+  // 第二道：队列同名（状态文件丢失时的兜底，不影响「丢弃后不重推」）
   const same = queue.filter((it) => String(it.title).trim() === doc.title);
   if (same.length && !FORCE) {
     // 思源桥会规整 Markdown，队列里的 chars 与发送时未必相等，所以按标题判重更可靠
     return { skipped: true, why: '队列中已有同名稿（--force 可再投）' };
   }
-  if (!SEND) return { skipped: true, why: 'dry-run' };
   const r = await post('/api/stage', {
     title: doc.title, markdown: doc.markdown, notebook: NOTEBOOK, hpath: HPATH,
     note: `WorkBuddy 会话产物 · ${doc.conv.slice(0, 8)} · v${VERSION} · 待人工确认`,
   });
   queue.push({ title: doc.title, chars: doc.chars });
+  if (state && doc.stateKey) {
+    state.pushed[doc.stateKey] = {
+      hash: doc.contentHash, title: doc.title, id: r.id || null, at: new Date().toISOString(),
+    };
+  }
   return { staged: true, id: r.id, chars: r.chars };
 }
 
 // ------------------------------------------------------------------ 主流程
 
-const queue = (await api('/api/stage')).items || [];
+const state = BATCH ? loadState() : null;
+const queue = (SEND && !SEED) ? ((await api('/api/stage')).items || []) : [];
 let jobs;
 
 if (BATCH) {
@@ -203,6 +263,25 @@ if (BATCH) {
   console.log('\n清单：');
   jobs.forEach((d, i) => console.log(`  ${String(i + 1).padStart(2)}. [${d.conv.slice(0, 8)}] ${d.title}`));
   fs.mkdirSync(OUT_DIR, { recursive: true });
+
+  // --seed：纯本地建立状态基线，不碰思源桥、不投递任何文档。
+  if (SEED) {
+    let added = 0;
+    let same = 0;
+    for (const j of jobs) {
+      const prev = state.pushed[j.stateKey];
+      if (prev && prev.hash === j.contentHash && !FORCE) { same++; continue; }
+      state.pushed[j.stateKey] = {
+        hash: j.contentHash, title: j.title, id: prev?.id || 'seeded', at: new Date().toISOString(),
+      };
+      added++;
+    }
+    saveState(state);
+    console.log(`\n状态基线：新增 ${added} 条 / 已存在 ${same} 条 / 共 ${Object.keys(state.pushed).length} 条`);
+    console.log(`状态文件：${STATE_FILE}`);
+    console.log('未投递任何文档，未写入思源笔记库。');
+    process.exit(0);
+  }
 } else {
   if (!fs.existsSync(FILE)) throw new Error(`找不到文件：${FILE}`);
   const raw = fs.readFileSync(FILE, 'utf8');
@@ -226,9 +305,16 @@ for (const j of jobs) {
     console.log(`预览：${path.join(OUT_DIR, 'push-doc-preview.md')}`);
     console.log(`\n--- 前 12 行 ---\n${doc.markdown.split('\n').slice(0, 12).join('\n')}`);
   }
-  results.push({ title: doc.title, ...(await deliver({ ...doc, conv: j.conv || '' }, queue)) });
+  results.push({
+    title: doc.title,
+    ...(await deliver({
+      ...doc, conv: j.conv || '', stateKey: j.stateKey, contentHash: j.contentHash,
+    }, queue, state)),
+  });
 }
 
+if (BATCH && SEND && state && results.some((r) => r.staged)) saveState(state);
+
 if (BATCH) {
   const staged = results.filter((r) => r.staged);
   const skipped = results.filter((r) => r.skipped);
@@ -238,6 +324,7 @@ if (BATCH) {
   console.log(`投递成功 ${staged.length} 篇 / 跳过 ${skipped.length} 篇 / 队列现有 ${queue.length} 篇`);
   for (const [why, n] of reasons) console.log(`  ${why}: ${n}`);
   if (staged.length) console.log(`  首篇 id=${staged[0].id} · 落点=${HPATH}`);
+  console.log(`  状态基线 ${Object.keys(state.pushed).length} 篇 · ${STATE_FILE}`);
   if (!SEND) console.log('\n[只读预览] 未产生任何写入。确认清单后加 --send 才批量投递。');
   else console.log('\n未调用 commit；请在思源桥「待入库」界面逐篇或批量勾选写入。');
 } else {

package//346/223/215/344/275/234/344/275/277/347/224/250/346/211/213/345/206/214.html

@@ -3,7 +3,7 @@
 <head>
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>dsh-session-index 操作使用手册 v2.5.1</title>
+<title>dsh-session-index 操作使用手册 v2.5.2</title>
 <style>
   :root{
     --bg:#f7f9fc; --panel:#ffffff; --panel-2:#f1f5fb; --line:#e2e8f2;
@@ -74,7 +74,7 @@
 <body>
 <div class="layout">
 <aside>
-  <div class="brand">dsh-session-index<small>操作使用手册 · v2.5.1</small></div>
+  <div class="brand">dsh-session-index<small>操作使用手册 · v2.5.2</small></div>
   <input id="q" type="search" placeholder="筛选章节 / 关键词…" autocomplete="off">
   <nav id="nav">
     <div class="grp">开始</div>
@@ -102,7 +102,7 @@
   <h1>dsh-session-index 操作使用手册</h1>
   <p>完全化的 MCP 插件：一条命令安装，之后自动配置、自动建索引、<b>新会话由文件事件自动识别（无需重启 DSH）</b>、索引变更主动通知客户端，并自动生成可分发插件包与技能包。零第三方依赖，源会话只读。</p>
   <div class="badges">
-    <span class="badge">版本 <b>v2.5.1</b></span>
+    <span class="badge">版本 <b>v2.5.2</b></span>
     <span class="badge">安装命令 <b>1 条</b></span>
     <span class="badge">会话 <b>32</b>（自动增长）</span>
     <span class="badge">工具 <b>14</b> / 提示词 <b>4</b> / 资源 <b>7+1</b></span>
@@ -237,8 +237,8 @@ node pack.mjs verify         # 校验 zip 结构
 session_index_package { "mode": "all" }   # MCP 工具，Agent 也能触发</code></pre>
   <table>
     <tr><th>包</th><th>内容</th><th>用途</th></tr>
-    <tr><td><code>dsh-session-index-v2.5.1.zip</code></td><td>全部源码 + plugin.json + README + 手册 + SKILL.md + 一键脚本 + MANIFEST.json + INSTALL.md</td><td>完整分发 / 迁移到另一台机器</td></tr>
-    <tr><td><code>session-index-skill-v2.5.1.zip</code></td><td>根 <code>SKILL.md</code> + README + MANIFEST（3 文件）</td><td>直接导入 DSH「MCP 与技能」→ Skills</td></tr>
+    <tr><td><code>dsh-session-index-v2.5.2.zip</code></td><td>全部源码 + plugin.json + README + 手册 + SKILL.md + 一键脚本 + MANIFEST.json + INSTALL.md</td><td>完整分发 / 迁移到另一台机器</td></tr>
+    <tr><td><code>session-index-skill-v2.5.2.zip</code></td><td>根 <code>SKILL.md</code> + README + MANIFEST（3 文件）</td><td>直接导入 DSH「MCP 与技能」→ Skills</td></tr>
   </table>
   <div class="warn">打包器<b>自动排除</b>所有会话索引分片、<code>meta/cards/notes/vectors.json</code>、备份、临时文件与已有 zip，并用系统解压工具验证过：包内 0 个敏感文件，可安全分发。接收方解压后运行 <code>node install.mjs</code> 即完成安装。</div>
 </section>
@@ -406,7 +406,14 @@ session_index_refresh                       // 仅改规则或需即时生效时
     <tr><td><code>node smoke.mjs</code> / <code>npm run check</code></td><td>80 项自测 / 语法检查</td></tr>
     <tr><td><code>node tools/push-doc.mjs [--send]</code></td><td>把手册 / 任意 md·html 推到思源桥待入库（默认只读预览，<code>--send</code> 才入队，绝不写库）</td></tr>
     <tr><td><code>node tools/push-doc.mjs --from-workbuddy [--send]</code></td><td><b>批量</b>：扫描 WorkBuddy 全部会话生成的文档，去排除/去重后一次性投递；<code>--no-exclude</code> 含临时目录、<code>--include-txt</code> 含 txt、<code>--source</code> 按生成方式、<code>--limit</code> 设上限</td></tr>
+    <tr><td><code>node tools/push-doc.mjs --from-workbuddy --seed</code></td><td>只写「已推送」状态基线，<b>不投递任何文档</b>；首次启用或迁移状态文件时用</td></tr>
   </table>
+  <div class="note"><b>判重对齐思源桥 autoStage，但丢弃后不重新获取。</b>状态文件
+  <code>~/.dsh/session-index/push-doc-state.json</code>（<code>PUSH_DOC_STATE</code> 可改）按
+  「文档路径 + 内容 sha256」记录已推送过的文档，判重<b>不依赖队列当前状态</b>：在思源桥里丢弃某篇、
+  清空队列、服务重启或定时任务重跑，都不会把它重新推回来；只有内容真的改了才作为新版本投一次。
+  <code>--force</code> 可强制绕过。实测：模拟「22 篇全部被丢弃」时 POST 次数为 0；内容更新后投 1 次、
+  再跑 0 次。</div>
 
   <h3>会话整理 → 思源桥待入库（v2.5.0 起）</h3>
   <p>DSH 插件之间<b>不共享会话数据</b>：会话本体只有一份磁盘文件，各插件各自解析、各存各的目录。会话卡与结论已在 session-index 手里，思源桥又是独立的 HTTP 服务（<code>127.0.0.1:5599</code>），所以一次接口调用即可对接，<b>不必新建第三个插件</b>，也不用再解一遍 zstd。</p>
@@ -502,7 +509,7 @@ pnpm install --offline --frozen-lockfile --config.autoInstallPeers=false</code><
 ├── smoke.mjs               80 项端到端自测
 ├── icon.svg                插件页图标（卡片 + 放大镜，64×64 SVG，938 字节）
 ├── plugin.json             机器可读插件能力清单（含安装方式与仓库信息）
-├── package.json            v2.5.1 / icon / dsh.bundle.patch / dsh.plugin / 脚本
+├── package.json            v2.5.2 / icon / dsh.bundle.patch / dsh.plugin / 脚本
 ├── 操作使用手册.html       本文档
 ├── README.md               仓库首页 = 安装与使用说明
 ├── skill/SKILL.md          自动接入技能
@@ -541,7 +548,8 @@ pnpm install --offline --frozen-lockfile --config.autoInstallPeers=false</code><
     <tr><td>stage 两步确认（v2.5.0）</td><td>本地起假思源桥（<code>node:http</code>，不碰真实 5599 队列）：只读探测零写入 → 默认预览不投递 → 错误令牌 <code>TOKEN_MISMATCH</code> 拒绝 → 回传 <code>confirmWith</code> 成功入队 → 重复投递被去重 → 全程<b>零次 commit</b>，投递正文含「未写入笔记库」声明</td></tr>
     <tr><td>stage 真实服务只读</td><td><code>GET /api/status</code> / <code>/api/stage</code> / <code>/api/autostage</code> 实测可达：内核 3.8.9、待入库 0 篇、<code>autoStage=true</code>；本轮未产生任何写入</td></tr>
     <tr><td>索引并发写加固</td><td>多进程同时写索引时 Windows <code>rename</code> 偶发 <code>EPERM</code> → 原子写加 0/40/120/300ms 退避重试；<b>80/80 冒烟全绿</b></td></tr>
-    <tr><td>WorkBuddy 文档批量投递（v2.5.1）</td><td>70 条文档命中 → 排除临时/依赖 26 → 文件缺失 4 → 内容/路径重复 18 → <b>22 篇全部投递成功</b>，队列 23 篇 / 16.6 万字；标题唯一、全部带 note 与预览、落点一致；重复执行 22 篇全被同名去重拦截；全程零 commit</td></tr>
+    <tr><td>WorkBuddy 文档批量投递（v2.5.1）</td><td>70 条文档命中 → 排除临时/依赖 26 → 文件缺失 4 → 内容/路径重复 18 → <b>22 篇全部投递成功</b>，队列 23 篇 / 16.6 万字；标题唯一、全部带 note 与预览、落点一致；全程零 commit</td></tr>
+    <tr><td>丢弃后不重推（v2.5.1 修订）</td><td><code>--seed</code> 建立 22 条状态基线；用假思源桥模拟「队列被全部丢弃」（返回空队列 + discarded=22）→ <b>POST 次数 0</b>、22 篇全部因「已推送过」跳过；隔离环境验证内容未变 0 次、内容更新 1 次、再跑 0 次；真实队列下重跑 0 新增、仍 23 篇</td></tr>
   </table>
   <h3>版本演进</h3>
   <ul>
@@ -552,11 +560,12 @@ pnpm install --offline --frozen-lockfile --config.autoInstallPeers=false</code><
     <li><b>v2.4.0</b> <b>插件页直接安装</b>：声明 <code>dsh.bundle.patch</code> + 新增 <code>cordis.patch.yml</code>（<code>!!js</code> 自解析命令与路径）+ 新增宿主半身 <code>lib/index.mjs</code>；装到哪都不用改配置，一次重启生效。仓库转公开。<code>install.mjs</code> 自动识别 bundle 模式，避免重复注册。</li>
     <li><b>v2.4.1</b> 新增 <code>install.mjs --doctor</code> <b>环境体检</b>（7 项，只读），把「插件页装不上」的四个真实成因变成可自动定位的检查项：git URL 重写镜像、pnpm <code>fetch-timeout</code> 超上限、远端大 tarball、lockfile 残留 <code>git+ssh</code>。手册第 13 章补充三条实测坑与修法。</li>
     <li><b>v2.5.0</b> 新增第 14 个工具 <code>session_index_stage</code>：<b>会话整理文档 → 思源桥待入库</b>。两步确认（预览给令牌，回传 <code>confirmWith</code> 才投递）、标题+字数去重、三种模板与落点可配；只入队，<b>绝不自动写库</b>。第 12 章补完整用法。</li>
-    <li><b>v2.5.1</b> <code>tools/push-doc.mjs</code> 新增 <code>--from-workbuddy</code> <b>批量模式</b>：扫描 WorkBuddy 全部会话生成的文档，内容哈希去重 + 排除临时目录 + 同名查重后一次投递；默认只读预览。实测 22 篇全部入队、重复执行全被拦截。README 补「插件怎么更新」：本机为 <code>link:</code> 挂载，<code>git pull</code> + 重启即生效，<b>无需卸载重装</b>。</li>
+    <li><b>v2.5.1</b> <code>tools/push-doc.mjs</code> 新增 <code>--from-workbuddy</code> <b>批量模式</b>：扫描 WorkBuddy 全部会话生成的文档，内容哈希去重 + 排除临时目录 + 同名查重后一次投递；默认只读预览。实测 22 篇全部入队、重复执行全被拦截。README 补「插件怎么更新」：本机为 npm registry 来源（<code>dsh-session-index-lau</code>），插件页<b>有「更新」按钮、无需卸载重装</b>。<b>同版修订</b>：批量判重改为持久化状态文件（<code>push-doc-state.json</code>），丢弃后不重新推送、内容更新才投新版；新增 <code>--seed</code>。</li>
+    <li><b>v2.5.2</b> <b>发布流程标准化</b>：新增发布前 / 安装后核验门禁 <code>dist/publish/check-release.mjs</code>（语法、80 项冒烟、功能核验、四处版本统一、MCP 握手），核验未全绿禁止推进；标准流程文档同步批量推送 / 持久化判重 / 定时自动化机制与版本统一矩阵；把源仓库的判重脚本同步进发布包与 DSH 安装，消除「同号不同内容」分叉。</li>
   </ul>
 </section>
 
-<footer>dsh-session-index v2.5.1 · 操作使用手册 · 生成于 2026-11-14 · 零第三方依赖</footer>
+<footer>dsh-session-index v2.5.2 · 操作使用手册 · 生成于 2026-11-14 · 零第三方依赖</footer>
 </main>
 </div>
 <script>