@a9i5k4/dsh-auto-memory 3.0.0 → 3.1.0

package/lib/tier0-catalog.js

@@ -46,6 +46,19 @@ import { readFileSync, statSync } from 'node:fs'
 
 export const TIER0_CATALOG_VERSION = 'tier0_catalog_v1'
 
+/**
+ * ★M1（2026-09-18）：白板锚点 id 的**形态判据**（契约 §2）。
+ *
+ * 与 `wb-sidecar.js:466 WB_ANCHOR_LINE_RE_V1`、契约 §2 的
+ * `^mem_[0-9a-f]{32}$` **同源同形**。此处**本地定义而非 import**：
+ *   - tier0-catalog 是本仓最底层的目录渲染模块，不应反向依赖 wb-sidecar（避免耦合/循环）；
+ *   - 两处形态由**同一份契约文档**约束，套件断言两者**逐字相同**（防双源漂移）。
+ *
+ * 用途：**只在匹配时才走契约 §3 的链接形态**；id 形态非法则退回纯文本
+ *   —— fail-closed：宁可输出纯文本，也不产出**指向不存在锚点的坏链接**。
+ */
+export const TIER0_ANCHOR_ID_RE = /^mem_[0-9a-f]{32}$/
+
 export const TIER0_DEFAULTS = Object.freeze({
   maxTokens: 800,
   oneLineChars: 80,
@@ -312,17 +325,46 @@ function extractSourcePre(text, layer, ctx, cfg) {
   return { items, units: groups.length, dropped }
 }
 
-/** 一条目录项 → 一行文本。**导出**：渲染口径的唯一实现。 */
+/**
+ * 一条目录项 → 一行文本。**导出**：渲染口径的唯一实现。
+ *
+ * ★M1 契约行渲染（2026-09-18）：**同一次派生、两种渲染**。
+ *   - 无 `path`/`id` ⇒ 纯文本（**逐字节同旧实现**，老调用方与老套件零影响）
+ *   - 有 `path`+`id`  ⇒ 契约 §3 链接形态：
+ *       `- [标题](<页面路径>#mem_<32hex>) — 一句话摘要 · layer=whiteboard · status=current · 日期`
+ *
+ * 为什么是"两种渲染"而不是"新文件"：契约 §8 要求
+ *   「由页面派生出的 index 与 Tier-0 目录条目**一致**」——
+ *   两者出自**同一份 items**、同一个渲染函数，一致性**天然成立**，不需要额外同步机制。
+ *  （新建独立文件会新增状态源，违反 S10.4「不建状态机」。）
+ */
 export function renderCatalogLinePre(item) {
   const it = item && typeof item === 'object' ? item : {}
   const title = clean(it.title)
   const oneLine = clean(it.oneLine)
   const date = clean(it.date)
+  const layer = clean(it.layer) || 'log'
+  const status = clean(it.status) || 'current'
+
+  // ── 契约 §3 链接形态（仅当 path + id 齐备时启用）──
+  const p = clean(it.path)
+  const id = clean(it.id)
+  if (p && id && TIER0_ANCHOR_ID_RE.test(id)) {
+    const head = title || oneLine
+    const link = '[' + head + '](' + p + '#' + id + ')'
+    const segs = [link]
+    // 摘要：与标题不同才追加（同旧实现口径：title===oneLine 时不重复）
+    if (oneLine && oneLine !== title) segs.push(oneLine)
+    const line = segs.join(' — ')
+    return '- ' + line + ' · layer=' + layer + ' · status=' + status + (date ? ' · ' + date : '')
+  }
+
+  // ── 纯文本形态（逐字节同旧实现）──
   const segs = []
   if (title && title !== oneLine) segs.push(title)
   if (oneLine) segs.push(oneLine)
-  segs.push(clean(it.layer) || 'log')
-  segs.push(clean(it.status) || 'current')
+  segs.push(layer)
+  segs.push(status)
   if (date) segs.push(date)
   return segs.join(' · ')
 }

package/lib/wb-contract.js

@@ -42,7 +42,12 @@ export const WB_MARKERS_V1 = Object.freeze({
   userClose: '<!-- /user -->',
 })
 
-/** 卡片状态（与记忆条目状态同域；缺 `status` 视为 `current`，与 `isCurrentPre` 口径一致）。 */
+/** 卡片状态（与记忆条目状态同域；缺 `status` 视为 `current`，与 `isCurrentPre` 口径一致）。
+ *  ⚠️ 2026-09-17 L7 存活标注: 本常量**当前无仓内消费者**(全仓引用计数 = 1, 仅此定义)。
+ *  判定 = **对外契约保留**, 不删 —— 理由是它是 WB-FORMAT-CONVENTION 的**状态值域声明**
+ *  (`current`/`superseded`/`retracted`), 属已发布插件 (@a9i5k4/dsh-auto-memory 3.0.0, 有真实用户)
+ *  的公开导出面; 第三方按契约读取状态时需要它作为**单一真源**, 删掉等于把值域契约降级成散落字面量。
+ *  ⇒ 保留 + 显式标注, 不做"沉默留着"。 */
 export const WB_STATUSES_V1 = Object.freeze(['current', 'superseded', 'retracted'])
 
 /** 解析/校验的原因码 → 可读中文。 */
@@ -59,7 +64,11 @@ export const WB_REASONS_V1 = Object.freeze({
   'user-region-interleaved': '人机分区标记交错（user 段里又开 model 段）',
 })
 
-/** 原因码 → 可读中文（未知码原样返回，排障不吞信息）。 */
+/** 原因码 → 可读中文（未知码原样返回，排障不吞信息）。
+ *  ⚠️ 2026-09-17 L7 存活标注: 本函数**当前无仓内调用者**(全仓引用计数 = 1, 仅此定义)。
+ *  判定 = **对外契约保留**, 不删 —— 它是 `WB_REASONS_V1`(上文, **有消费者**) 的唯一
+ *  取值入口; 删掉函数会让那份码表的"怎么读"离开公开面, 而码表本身是契约的一部分
+ *  (发布版已有真实用户)。⇒ 保留 + 显式标注。 */
 export function describeWbReasonPre(code) {
   const k = String(code == null ? '' : code)
   return WB_REASONS_V1[k] || k || '未知原因'
@@ -254,6 +263,193 @@ function emptyResult(kind, issues) {
   }
 }
 
+// ─────────────────────────────────────────────────────────────────────────────
+// ★M2（2026-09-18）白板 lint —— 契约 §6「零 token 可判的四类」
+//
+// **硬约束（契约 §6 尾注，不可越）**：lint **只报告，不自动改**。
+//   「任何自动修正都会把白板变成状态机（违反边界）」
+// ⇒ 本模块是**纯函数**：不读文件、不写文件、不 import fs。
+//   输入什么就判什么，输出问题清单。任何写盘能力都不得塞进这里（报告与写入分离）。
+//
+// 四类判据（§6 原文）与**本实现的口径**（判据纪律：宁可漏判，不可误伤）：
+//   ① 孤立条目：无入站引用            → 全部卡正文里都找不到它的 id/标题
+//   ② 陈旧：status≠current 或超期 current → 状态直读 + 与 now 比日期
+//   ③ 被提及却无独立卡               → ★ 只判**客观可证**的一种：正文引用了
+//      `mem_<32hex>` 但该 id 没有对应卡片（"什么算概念"无法零 token 判定，不猜）
+//   ④ 缺交叉引用                    → ★ 只判**客观可证**的一种：两卡共享 ≥N 个 tag
+//      却互不引用（"什么算相关"由 tag 交集代言，不猜语义）
+//   ⑤ 矛盾检测 → 需 LLM，**不在本模块**（契约 §6：必须手动触发，不进自动路径）
+// ─────────────────────────────────────────────────────────────────────────────
+
+export const WB_LINT_VERSION = 'wb_lint_v1'
+
+/** lint 问题码（§6 四类；⑤ 矛盾检测需 LLM，不在此列）。 */
+export const WB_LINT_CODES_V1 = Object.freeze({
+  ORPHAN: 'orphan',                   // ① 孤立条目
+  INACTIVE: 'inactive',               // ② 陈旧（已标 superseded/retracted）
+  EXPIRED: 'expired',                 // ② 陈旧（仍标 current 但超阈值）
+  DANGLING_REF: 'dangling-ref',       // ③ 被引用却无卡（悬空锚点引用）
+  NO_CROSS_REF: 'no-cross-ref',       // ④ 缺交叉引用（共享 tag 却互不引用）
+})
+
+/** 默认口径。 */
+export const WB_LINT_DEFAULTS_V1 = Object.freeze({
+  staleDays: 90,      // ② 仍标 current 但日期早于 now-90d ⇒ 报 expired
+  minSharedTags: 2,   // ④ 共享 tag 数 ≥ 2 才算"应互链"
+})
+
+const LINT_ANCHOR_RE = /mem_[0-9a-f]{32}/g
+
+const asDateMs = (v) => {
+  const s = String(v == null ? '' : v)
+  const m = s.match(/^(\d{4})-(\d{2})-(\d{2})/)
+  if (!m) return NaN
+  const t = Date.UTC(Number(m[1]), Number(m[2]) - 1, Number(m[3]))
+  return Number.isFinite(t) ? t : NaN
+}
+
+/**
+ * 白板 lint（**只读纯函数**，契约 §6）。
+ *
+ * @param {Array<object>|{entries?:Array<object>}} entries 条目数组；每项可含
+ *   `{id, title, status, date, ts, tags, body}`。`body` 为该卡正文（用于扫描引用）；
+ *   缺 `body` 时退化为用 `title+id` 判引用（**不报错**——信息少就少判，不猜）。
+ * @param {{now?:Date|string|number, staleDays?:number, minSharedTags?:number, corpus?:string}} [opts]
+ *   `corpus` 为白板之外的**额外文本**（如项目笔记/账本全文），一并参与"入站引用"扫描。
+ * @returns {{version:string, ok:boolean, findings:Array<object>, counts:object}}
+ */
+export function lintWhiteboardPre(entries, opts = {}) {
+  const o = opts && typeof opts === 'object' ? opts : {}
+  const list = Array.isArray(entries) ? entries
+    : (entries && Array.isArray(entries.entries) ? entries.entries : [])
+  const staleDays = Number.isFinite(Number(o.staleDays)) ? Number(o.staleDays) : WB_LINT_DEFAULTS_V1.staleDays
+  const minSharedTags = Number.isFinite(Number(o.minSharedTags)) ? Number(o.minSharedTags) : WB_LINT_DEFAULTS_V1.minSharedTags
+
+  const nowMs0 = o.now instanceof Date ? o.now.getTime()
+    : (typeof o.now === 'number' ? o.now : asDateMs(o.now))
+  const nowMs = Number.isFinite(nowMs0) ? nowMs0 : Date.now()
+
+  // ── 归一化（**永不抛**：坏条目降级为跳过，不打断整轮 lint）──
+  const cards = []
+  let skipped = 0
+  for (const e of list) {
+    if (!e || typeof e !== 'object') { skipped++; continue }
+    const id = String(e.id || '')
+    const title = String(e.title || '').trim()
+    if (!id && !title) { skipped++; continue }
+    const status = String(e.status || 'current').trim() || 'current'
+    const dateSrc = e.date || e.ts || ''
+    const tags = Array.isArray(e.tags) ? e.tags.map((t) => String(t)).filter(Boolean) : []
+    cards.push({ id, title, status, tags, dateMs: asDateMs(dateSrc), dateRaw: String(dateSrc || '') })
+  }
+
+  // ── 引用语料：所有卡正文 + 外部 corpus ──
+  const parts = []
+  for (const e of list) {
+    if (e && typeof e === 'object') {
+      if (e.body != null) parts.push(String(e.body))
+      if (e.preview != null) parts.push(String(e.preview))
+    }
+  }
+  if (o.corpus != null) parts.push(String(o.corpus))
+  const haystack = parts.join('\n')
+
+  const findings = []
+  const push = (code, card, detail) => {
+    findings.push({ code, id: card ? card.id : '', title: card ? card.title : '', detail })
+  }
+
+  // ── ① 孤立条目：无入站引用 ──
+  // 判据：除自己以外，任何卡正文/外部语料都未出现它的 id，也未出现它的标题。
+  // 纪律：**只报"全无提及"**；标题过短（<2 字符）时跳过，避免单字误命中（宁可漏判）。
+  for (const c of cards) {
+    let referenced = false
+    if (c.id) {
+      const re = new RegExp(c.id.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'g')
+      const hits = haystack.match(re)
+      // 自己正文里出现自己的 id 不算入站引用
+      const selfBody = String((list.find((x) => x && x.id === c.id) || {}).body || '')
+      const selfHits = selfBody.match(re)
+      const inHits = (hits ? hits.length : 0) - (selfHits ? selfHits.length : 0)
+      if (inHits > 0) referenced = true
+    }
+    if (!referenced && c.title && c.title.length >= 2) {
+      if (haystack.includes(c.title)) {
+        // 标题出现次数 > 自身正文里的次数 ⇒ 有外部提及
+        const selfBody = String((list.find((x) => x && x.id === c.id) || {}).body || '')
+        const total = haystack.split(c.title).length - 1
+        const selfN = selfBody.split(c.title).length - 1
+        if (total - selfN > 0) referenced = true
+      }
+    }
+    if (!referenced) push(WB_LINT_CODES_V1.ORPHAN, c, '无任何其他卡片或语料引用它的 id/标题')
+  }
+
+  // ── ② 陈旧 ──
+  const cutoff = nowMs - staleDays * 86400000
+  for (const c of cards) {
+    if (c.status !== 'current') {
+      push(WB_LINT_CODES_V1.INACTIVE, c, 'status=' + c.status + '（已作废，仍在白板内）')
+      continue
+    }
+    if (Number.isFinite(c.dateMs) && c.dateMs < cutoff) {
+      const ageDays = Math.floor((nowMs - c.dateMs) / 86400000)
+      push(WB_LINT_CODES_V1.EXPIRED, c, '仍标 current 但日期为 ' + c.dateRaw + '（' + ageDays + ' 天前，超阈值 ' + staleDays + ' 天）')
+    }
+  }
+
+  // ── ③ 悬空锚点引用：正文引用了 mem_id 但没有对应卡片 ──
+  // 契约 §2 的 id 是"内容寻址、可复算"的 ⇒ 引用了不存在的 id 是**客观可证**的断裂。
+  const knownIds = new Set(cards.map((c) => c.id).filter(Boolean))
+  const allIds = new Set()
+  for (const m of haystack.match(LINT_ANCHOR_RE) || []) allIds.add(m)
+  for (const id of allIds) {
+    if (!knownIds.has(id)) {
+      findings.push({
+        code: WB_LINT_CODES_V1.DANGLING_REF, id, title: '',
+        detail: '正文引用了 ' + id + '，但白板内没有该 id 的卡片（悬空引用）',
+      })
+    }
+  }
+
+  // ── ④ 缺交叉引用：共享 ≥minSharedTags 个 tag 却互不引用 ──
+  for (let i = 0; i < cards.length; i++) {
+    for (let j = i + 1; j < cards.length; j++) {
+      const a = cards[i], b = cards[j]
+      if (!a.tags.length || !b.tags.length) continue
+      const shared = a.tags.filter((t) => b.tags.includes(t))
+      if (shared.length < minSharedTags) continue
+      const aRefB = (a.id && b.id && String((list.find((x) => x && x.id === a.id) || {}).body || '').includes(b.id)) ||
+        (b.title && String((list.find((x) => x && x.id === a.id) || {}).body || '').includes(b.title))
+      const bRefA = (a.id && b.id && String((list.find((x) => x && x.id === b.id) || {}).body || '').includes(a.id)) ||
+        (a.title && String((list.find((x) => x && x.id === b.id) || {}).body || '').includes(a.title))
+      if (!aRefB && !bRefA) {
+        findings.push({
+          code: WB_LINT_CODES_V1.NO_CROSS_REF, id: a.id, title: a.title,
+          detail: '与「' + (b.title || b.id) + '」共享 ' + shared.length + ' 个 tag（' + shared.join(', ') + '）但互不引用',
+        })
+      }
+    }
+  }
+
+  const byCode = {}
+  for (const f of findings) byCode[f.code] = (byCode[f.code] || 0) + 1
+
+  return {
+    version: WB_LINT_VERSION,
+    ok: findings.length === 0,
+    findings,
+    counts: {
+      cards: cards.length,
+      skipped,
+      findings: findings.length,
+      byCode,
+      // ⑤ 明确声明"未判" —— 不许静默省略（契约 §6：需 LLM，必须手动触发）
+      notChecked: ['contradiction'],
+    },
+  }
+}
+
 /**
  * 从投影里抽出"**必须逐字节保留**的用户区"（供写入门做前后比对）。
  *

package/lib/wb-sidecar.js

@@ -287,8 +287,17 @@ export function buildSectionCardsPre(workspaceKey, docs, opts = {}) {
  * 契约对齐 WB-GRAPH-INTEGRATION-PLAN §4.1(条目级): id/kind/source/section/tags/cues/preview/mtime/criteria。
  * 兼容旧字段: title/cue/chars/ts 保留(既有套件与工具描述在用)。
  *
+ * ★M1（2026-09-18）新增 `layer`/`status`：契约 §3 的索引派生行要求两者
+ *   （`… · layer=whiteboard · status=current · 日期`）。此前 entry 只有 `id`（已是
+ *   `mem_<32hex>` 形态），缺这两个字段 ⇒ 渲染侧拿不到值，一直退化成纯文本行。
+ *   - `layer` 恒为 `'whiteboard'`：本模块**只服务于白板/账本**这一层，
+ *     不是从调用方传入的自由值（避免调用方各传各的、导致层级语义漂移）。
+ *   - `status` 取 `o.status`，缺省 `'current'`（与契约 §3 尾注
+ *     「缺 status 视为 current」、与 `isCurrentPre` 口径一致）。
+ *   两个字段**只增不改**：既有字段顺序与语义逐字节不变。
+ *
  * @param {{workspaceKey:string, relPath:string, text:string, title:string, ts?:string,
- *          kind?:string, mtime?:number, criteria?:string}} o
+ *          kind?:string, mtime?:number, criteria?:string, status?:string}} o
  */
 export function buildSidecarEntryPre(o = {}) {
   const src = String(o.text || '')
@@ -308,6 +317,9 @@ export function buildSidecarEntryPre(o = {}) {
     preview: src.replace(/\s+/g, ' ').trim().slice(0, 120),
     mtime: Number(o.mtime) || 0,
     criteria: String(o.criteria || 'unknown'),
+    // ── ★M1：契约 §3 索引派生行所需（只增不改）──
+    layer: 'whiteboard',
+    status: String(o.status || 'current'),
     // ── 兼容旧套件/工具描述的字段 ──
     title,
     cue: cueLine.trim().slice(0, 120),
@@ -316,6 +328,45 @@ export function buildSidecarEntryPre(o = {}) {
   }
 }
 
+/**
+ * ★M1（2026-09-18）：sidecar 条目 → Tier-0 目录项（**契约 §8 的桥**）。
+ *
+ * 契约 §8 要求：「由页面派生出的 index 与 Tier-0 目录条目**一致**」。
+ * 实现方式 = **同一次派生、两种渲染** —— 本函数**只做字段映射，不复制任何逻辑**：
+ *   entries 与 Tier-0 条目本就是同一份数据，映射后交给
+ *   `renderCatalogLinePre` 渲染，一致性天然成立（无需额外同步机制）。
+ *
+ * 为什么不在此处直接渲染成字符串：渲染口径必须**只有一处实现**
+ *   （`renderCatalogLinePre`），否则「两种渲染」会退化成「两个渲染器」，
+ *   长期必然漂移 —— 这正是 §8 想防的。
+ *
+ * 字段映射（只映射，不发明）：
+ *   - title   ← entry.title
+ *   - oneLine ← entry.preview（已是单行化 + 120 字截断，即「一句话摘要」）
+ *   - layer   ← entry.layer（本模块恒为 'whiteboard'）
+ *   - status  ← entry.status（缺省 'current'）
+ *   - date    ← entry.ts 的日期部分（无则空；不编造）
+ *   - path    ← entry.source（相对路径，渲染时拼锚点）
+ *   - id      ← entry.id（已是 mem_<32hex>）
+ *
+ * @param {object} entry buildSidecarEntryPre 的产物
+ * @returns {{title:string,oneLine:string,layer:string,status:string,date:string,path:string,id:string}}
+ */
+export function sidecarEntryToCatalogItemPre(entry) {
+  const e = entry && typeof entry === 'object' ? entry : {}
+  const ts = String(e.ts || '')
+  const dateOnly = (ts.match(/^\d{4}-\d{2}-\d{2}/) || [''])[0]
+  return {
+    title: String(e.title || ''),
+    oneLine: String(e.preview || ''),
+    layer: String(e.layer || 'whiteboard'),
+    status: String(e.status || 'current'),
+    date: dateOnly,
+    path: String(e.source || ''),
+    id: String(e.id || ''),
+  }
+}
+
 /** tag → 条目 id 倒排(§3.3 by_tag)。 */
 export function buildByTagPre(entries) {
   const byTag = {}
@@ -389,10 +440,10 @@ export function rebuildSidecarIndexPre(workspaceKey, docs) {
 
 /** 生成 §4.1 的 hint 文案(工具返回值里引导模型向下走)。 */
 function hintForExpand() {
-  return '可用 memory_trace_pre(id) 回溯该条目的 cue/tag/邻居与归档版本'
+  return '可用 memory_trace(id) 回溯该条目的 cue/tag/邻居与归档版本'
 }
 function hintForTrace() {
-  return '可用 memory_expand_pre(tag) 按 tag 展开同主题条目; neighbors 为同 tag/同 cue 的相邻条目'
+  return '可用 memory_expand(tag) 按 tag 展开同主题条目; neighbors 为同 tag/同 cue 的相邻条目'
 }
 
 /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@a9i5k4/dsh-auto-memory",
   "description": "Proactive associative memory for DSH: zero-prompt recall injected before the model speaks, three-layer auto-consolidation, skill crystallization, and Astra-style context management - handoff ledgers, PLAN whiteboard, water-level sensing. Local-first, model-agnostic, zero deps. 主动联想记忆+Astra 式上下文管理:自动唤回/自动沉淀/技能固化/交接账本与白板跨窗口续命/水位感知。",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "type": "module",
   "main": "lib/index.js",
   "exports": {
@@ -15,7 +15,11 @@
     "docs",
     "cordis.patch.yml",
     "!python/bench",
-    "!python/__pycache__"
+    "!python/__pycache__",
+    "!docs/internal",
+    "!docs/**/*.bak",
+    "!docs/**/*.bak-*",
+    "!**/*.mjs.bak-*"
   ],
   "dsh": {
     "bundle": {

package/docs/internal/ACCEPT-35-LIVE.md

@@ -1,143 +0,0 @@
-# #35 真机验收方案（停旧回合 → 仪式 → 真判据 → 新窗口）
-
-> 目标：把 #35 的修复从**夹具级**（`smoke-test-autocont-host-pre.mjs` 95 断言）升级为**真机级**。
-> 本文件给**新会话**执行；执行者不需要读原对话。改配置前先备份（用户级硬规则）。
-
-## 0. 为什么必须换一个会话做
-
-- 验收的**核心那一档**要求在「回合正在运行时点同意」——那会**终止当前回合**。
-  拿重要对话当靶子会打断它，所以：**另开一个新会话当"旧会话"被接续**，本对话不受影响。
-- 新会话要够长、有实质内容（交接材料才有东西可带）；空会话测不出材料质量。
-
-## 1. 前置条件（**2026-09-14 解耦后已更新：只需开一个开关**）
-
-> 历史注记：解耦前 `handoffEnabled=false` 会让 `checkWaterLevel` 提前返回 → `waterLevelModelKnown` 不写 → fail-closed 闸永不 arm，所以当时**必须同时开两个开关**。那处耦合已切除（`lib/index.js` 的 `checkWaterLevel` 早退、`armAutoContinue` 早退、`autoContinueState.enabled` 二次与运算、`buildContinueCarry` 的 `handoff disabled` 早退，共 4 处）。
-
-这台机器的现行配置（`~/.dsh/dsh-auto-memory-pre.json`）：
-
-| 键 | 现值 | 现在的要求 |
-|---|---|---|
-| `autoContinueEnabled` | **false** | **必须临时改 true**——它是接续的唯一资格开关 |
-| `handoffEnabled` | false | **可保持 false**，此时走「最小转写载体」；也可改 true 走完整两层载体（见步骤 1 的 A/B 跑法） |
-| `autoContinueThreshold` | 0.75 | 正常会话很难自然达阈值，验收要临时降 |
-
-**结论：只开 `autoContinueEnabled` 即可跑验收。** 而且**建议第一轮就保持白板关闭**——那条路径是这次解耦才第一次可用的（此前直接 hard-fail），顺带把解耦也验了。
-
-## 2. 步骤
-
-### 步骤 0 · 备份（必做）
-```pwsh
-Copy-Item "$env:USERPROFILE\.dsh\dsh-auto-memory-pre.json" "$env:USERPROFILE\.dsh\dsh-auto-memory-pre.json.bak-accept35" -Force
-```
-
-### 步骤 1 · 临时开开关 + 降阈值（**A/B 两轮**）
-
-**A 轮（先跑，白板关闭 —— 验解耦后的最小载体）**：
-```json
-"autoContinueEnabled": true,
-"autoContinueThreshold": 0.05
-```
-保持 `handoffEnabled: false` 不动。此轮新会话应拿到**转写包 + 近期线程**，且材料里带一句自述「未启用白板/账本」；仪式步骤会被**跳过**（日志 `reason:'handoff-disabled'`），这是**预期**，不是失败。
-
-**B 轮（A 通过后再跑，白板打开 —— 验完整两层载体）**：
-再把 `"handoffEnabled": true` 打开，重跑一次，观察步骤 ②③ 的仪式链路。
-
-> 为什么降的是 `autoContinueThreshold` 而不是 `waterLevelWindowTokens`：改窗口会让**水位测量本身**失真，连带 advisory 与自动账本写入都变形；降阈值只动"什么时候弹卡"。
-> 每轮改完**重启 dsh web**（注入面与开关在启动时读）。**注意冷却**：`autoContinueCooldownMinutes=30`，触发过一次后 30 分钟内不再弹——两轮之间要么等，要么把冷却临时调小。
-
-### 步骤 2 · 造场景
-在**新会话**里正常跑一两轮（有工具调用、有实质产出）。
-- 注意：**首轮 pre-step 拿不到模型信息**（`request/header` 还没写），按 #33 的 fail-closed 设计，首轮的按比例 arm 会被拦，**推迟到该轮 turn-stopping**。所以卡片应在**第一轮结束后**出现，而不是开局。
-- 若 10 分钟不弹卡：先查日志有没有 `auto-continue armed`，没有就回头查开关与 `modelKnown`（见 §4 排查）。
-
-### 步骤 3 · 点「同意接续」并采日志
-两种点法，验证深度不同——**建议先 A 后 B**：
-
-- **A 档（先做，安全）**：**空闲时点**。验通 ①→④ 全链路与节拍；`cancel` 对空转回合是空操作。
-- **B 档（核心，代价已知）**：**让一个回合跑着（多步工具调用/长输出），在运行中点同意**。这才是 issue 原现场，也是唯一能验「回合活跃时不再并行」的做法。**代价：该回合会被终止，未完成的回答落 `interrupted`。**
-
-采集（改完配置重启后）：
-```pwsh
-Get-Content "$env:USERPROFILE\.dsh\dsh-auto-memory-pre-diagnose.log" -Tail 200 |
-  Select-String 'auto-continue|ritual|prev-session|stopped|waited'
-```
-
-## 3. 判据（缺一不算过；第 3 条仅 B 轮适用，A 轮看 3′）
-
-| # | 期望日志 | 含义 |
-|---|---|---|
-| 1 | `auto-continue armed: … awaitIdle=true …` | 闸放行了（能验到这条本身就说明 #33 的 fail-closed 没误杀） |
-| 2 | **`auto-continue: stopped old turn sid=…`** | **① 新链路真的执行了**；若旧回合在跑，旧窗口应显示被打断 |
-| 3 | **`host refresh ritual: … waited=updated`**（**仅 B 轮／白板开时适用**） | **②③ 因果闭合判据通过**（若显示 `waited=stamp-fallback` → 说明 `sc.inspect` 不可用、退到弱判据，**要当作半通过并单独记**） |
-| 3′ | **A 轮（白板关）替代判据**：日志出现仪式的 `reason:'handoff-disabled'`（仪式按设计被跳过），**且**新会话交接材料里出现「未启用白板/账本」自述、**不含**磁盘上真实存在的 PLAN/账本正文 | 解耦生效：白板关 ≠ 不能接续；且降级是**显式**的，不是静默丢弃 |
-| 4 | `prev-session pack built` → `auto-continue host-executed: … stopped=ok` | ④ 新会话建立；`stopped=ok` 与判据 2 互相印证 |
-
-**反向断言（同样重要）**：
-- 若 ④ 出现但**没有** 2 → 停旧回合没生效（或旧会话无 id，`stopped=no-old-session`），必须记下来；
-- 若旧回合被打断后**新会话没建起来** → 交接失败，比"并行"更糟，立即回滚并报告。
-
-## 4. 排查（卡片不弹时按序查）
-
-1. 开关是否真的生效：`GET /api/dsh-auto-memory-pre/auto-continue-state`（或设置页）看 `enabled`；
-2. 日志有没有 `consolidate skip:` / `auto-continue` 任何一行；
-3. `modelKnown` 是否为真：首轮必为假（设计如此），只在**轮末**才可能 arm；
-4. 冷却：`autoContinueCooldownMinutes=30`，触发过一次后 30 分钟内不再弹——**验收期间只点一次**，要点第二次就先把它调小。
-
-## 5. 回滚（验完必做）
-
-```pwsh
-Copy-Item "$env:USERPROFILE\.dsh\dsh-auto-memory-pre.json.bak-accept35" "$env:USERPROFILE\.dsh\dsh-auto-memory-pre.json" -Force
-```
-然后重启 dsh web。**除非用户明确要求长期开启**，否则恢复成 `handoffEnabled=false` / `autoContinueEnabled=false` / `autoContinueThreshold=0.75`。
-
-> 待用户裁定（会写进交接账本）：这两个开关**日常要不要开**。若长期关着，则 #35 与 #31 第二半这两笔修复在水位/接续/白板面上**处于不生效状态**——修了但不在线。
-
-## 6. 纪律
-
-- 改配置**必须先备份**（用户级硬规则）；只改目标键，别整篇重写。
-- **不要**按进程名杀进程（曾误杀 harness）；要停就用精确 PID + `taskkill /PID <pid> /T /F`。
-- 不要拿主对话当接续靶子。
-- 验收结论无论通过与否都要落一笔到当日日志；失败要附原始日志片段，不要只写"没通过"。
-
-## 7. 真机验收结果（2026-09-14 17:37–17:41，Run 1）
-
-> 现场：旧会话 `session-d2c13583`（128 msgs）→ 新会话 `session-b8f093e4`。**在飞配置为 `handoffEnabled=true`**（非本文档 §2 设想的 A 轮），故本次实为 **B 轮**（完整两层载体）；**A 轮（白板关）仍未验**。
-> 验收人操作：用户在新窗口点「同意接续」（`decideAutoContinue('agree')`）。
-
-### 判据结果
-
-| # | 结果 | 证据 |
-|---|---|---|
-| 1 | **PASS** | `09:36:52.739Z auto-continue armed: sid=session-d2c13583… ratio=0.07 awaitIdle=true` |
-| 2 | **PASS** | `09:37:37.776Z auto-continue: stopped old turn sid=session-d2c13583…`；旧会话 `turn/end reason.kind=aborted/user` |
-| 3 | **FAIL（原因已查清，非逻辑缺陷）** | `09:39:08.082Z host refresh ritual: timeout, continuing with current material` → `lastOk.refreshRitual='timeout'` |
-| 4 | **PASS** | `09:39:08.106Z prev-session pack built … contSeq=22` → `09:39:08.247Z auto-continue host-executed: new session session-b8f093e4… ritual=timeout stopped=ok` |
-
-**反向断言**：④ 出现且 ② 同时出现 → 停旧回合生效；新会话成功建立（侧栏标题 `接续 #22 · dsh-auto-memory`，工作区/模型/权限 `deepseek-v4.1-flash` + `danger-full-access` 均继承）→ 无"比并行更糟"的交接失败。
-
-### 判据 3 超时的根因（已用旧会话原始事件流取证）
-
-不是判据写错，是**上游 API 故障把仪式推后到轮询窗之外**：
-
-1. `09:37:37.778Z` 仪式以 `mode:'queue'` 投给旧会话，**立刻**落为 `seq=244 user/message`，`turn=3` 同步启动 → 投递链路本身正常。
-2. `turn=3` 全窗没有一次成功的 assistant 产出：`llm/retry` 连续 5 次（`09:37:45`→`09:38:38`，61s），
-   `09:38:38.450Z turn/end reason.kind=error`，错误为 **`502: {"message":"上游拒绝请求","type":"upstream_bad_request"}`**。
-3. 90s 轮询窗（`autoContinueRefreshTimeoutSeconds`）到点 → 报 `timeout`，宿主按 fail-soft 继续接续。
-4. **仪式随后真的执行了**：用户后续「继续」推动 `turn=6`，`09:41:01.529Z`（seq 291–295）模型连调两次
-   `memory_note_pre`（`kind=plan` + `kind=handoff`）→ `PLAN.md` 与 `handoff-20260914-174101.md` 的 mtime 正是 `17:41:01`。
-
-结论：**因果闭合判据的实质成立**（事件数增长且出现 seq>239 的 `assistant/message` + `tool/call`），只是发生在 90s 窗之后（+114s）。**记为半通过**，按本文档 §3 的口径单独记录；若要让它真通过，应提高 `autoContinueRefreshTimeoutSeconds`（当前上限 600）。
-
-### 本轮新发现的真实风险：新会话会被立刻再次 arm（链式接续）
-
-- `09:42:49.340Z auto-continue armed: sid=session-b8f093e4…`（**即刚建出来的新会话**）→ 若无人干预，约 35s 后会再次掐掉新会话并再建一个。
-- 机制：`markContinuedSession(oldSid, newId)` 只给**旧**会话上闩（`isContinuedSession` 检查的是旧 sid）；新会话是全新身份，不受闩保护。而新会话首题就是超大交接包，`ratio` 开局即 ≈0.053。
-- 本次是阈值降到 `0.05` 的**验收态放大**了它；生产阈值 `0.75` 下新会话开局不可能越线，故**当前不判定为缺陷**，但值得在 3.1 决策：新会话是否也应有一段"免接续蜜月期"。
-- **已处置**：`POST /auto-continue-decide {action:'reject'}` 已拆引信（`rejectedEdgeAt=1789378969340`），armed 清空。
-
-### 收尾状态
-
-- 配置已按 §5 回滚：`autoContinueEnabled=false` / `autoContinueThreshold=0.75` / `autoContinueCooldownMinutes=30`（`handoffEnabled` 保持 `true`，与备份一致）。sha `3DEE4041F3E9`。
-- 回滚已**热生效**（`GET /api/dsh-auto-memory-pre/config` 内部会 `loadConfig()` 覆盖内存态；无需重启即生效，实测 `enabled:false`）——这与本文档 §2"每轮改完重启 dsh web"的旧说法不同，**热重载可用**。
-- 验收态快照留存：`~/.dsh/dsh-auto-memory-pre.json.bak-accept35-run1-evidence`。
-- **未验**：A 轮（`handoffEnabled=false`，判据 3′）、B 档"回合运行中点同意"（本次点同意时旧回合已自行 abort，`cancel` 对空转回合是空操作）。

package/docs/internal/ACCEPTANCE-20260914.md

@@ -1,90 +0,0 @@
-# 验收报告 · ZCode 交班对账
-
-> 验收时间：2026-09-14 02:2x–02:5x（本地）｜验收方：DSH 主对话（**只做取证与复核，未改任何产品代码**）
-> 验收对象：ZCode 交付的三任务 + 10 项追加需求 + 交班材料（对账单见对话与 `TODO-BACKLOG.md`）
-> 口径：**能独立复核的写实测值；不能复核的明确标注"不可独立复核"**，不用转述充证据。
-
-## 一、基线复核（实测）
-
-| 项 | 报告值 | 实测（命令/位置） | 判定 |
-| --- | --- | --- | --- |
-| npm latest | 2.5.2 | `npm view @a9i5k4/dsh-auto-memory version --registry=https://registry.npmjs.org` → `2.5.2`；`dist-tags.latest=2.5.2` | ✅ |
-| GitHub main = tag | `55c3deb` | REL 线 `D:\dsh_debug\_publish_dsh-auto-memory` HEAD = `55c3deb`，tag `v2.5.0/v2.5.1/v2.5.2` 齐 | ✅ |
-| REL 工作树 | （未提） | 唯一未跟踪 = `.github/cloud/qq-webhook/index.zip`（发版纪律要求排除构建产物，正常） | ✅ |
-| pre 线 HEAD | `747aa68` | **实测 `1c06c46`** —— 多出 4 个提交，全是 `docs/`：官方 discussion #5732 评论稿 3 版 + dshapi 中转反馈稿（**非 ZCode 线，是本机 DSH 会话产出**） | ⚠️ 偏差，已更正 |
-| 冒烟套件 | 71 全绿 | 首次全量 **70/71**（`m73` 假红，见三）→ 夹具加固后 **71/71 全绿**，125s | ✅（修复后） |
-| 静态检查 | — | `node --check lib/index.js`、`lib/client.js` 均 0；两文件首三字节非 `EF BB BF` | ✅ |
-
-## 二、10 项追加需求逐项取证（全部落到源码/文件，可独立复核）
-
-| # | 需求 | 取证点 | 判定 |
-| --- | --- | --- | --- |
-| 1 | PR #29 合并移植 | `lib/index.js:47` import `decodeZstdFramesHead`；调用点 `:1626`（巡检扫描）、`:1927`（`waterWindowForSession` 同防） | ✅ |
-| 2 | procedure 链路审计 + 缺口记录 | 结论落在 `TODO-BACKLOG.md` §A 末条（数据层从未产出 active procedure、`renderChecklist` 无子代理出口、`memory_recall` 无 procedures scope）——**没有独立审计文件** | ⚠️ 审计在、未单独成文 |
-| 3 | 白板整合预研 + 看板化评估 | `WB-GRAPH-RESEARCH-BRIEF.md`(7.7KB) / `-LOCAL.md`(21.2KB) / `-EXTERNAL.md`(33.2KB) / `WB-GRAPH-INTEGRATION-PLAN.md`(39.1KB)，四份齐 | ✅ |
-| 4 | 云函数定时自触发 | `.github/cloud/qq-webhook/index.js:366-368` timer 分支；`triggerName=digest_dispatch`；`TIMER_MIN_GAP_HOURS=10` 防重 | ✅ |
-| 5 | @ 答疑限额 env 化 | `index.js:47-50` `AI_MAX_PER_HOUR`（0/缺省=不限）/`AI_QUOTA_HOURS`（默认 1h）；配额落 gist | ✅ |
-| 6 | 日报去重（prompt + 确定性双层） | `group-digest.mjs:91-93` 30 分钟 schedule 去重；`:400` prompt 规则「不得新增重复条目」；`:417` 解析失败兜底按标题前 8 字去重 | ✅ |
-| 7 | 未解决事项跨期跟踪 + 自动销账 | `group-digest.mjs:327-331`（open/resolved/stale，14 天归档）、`:400` `resolved_titles` 规则、`:234` 日报渲染「✅ 已解决并移出」 | ✅ |
-| 8 | 反馈文件钉死 | 提交 `9f594db`「反馈文件钉死文件名（修复第一个文件换人/清空即删文件）」，code 侧仍在 | ✅ |
-| 9 | 思维链截断修复 | `index.js:232-249` `max_tokens: 1600` + 三层过滤（`reasoning_content` → `</think>` 切段 → 行首思考特征词剥除） | ✅ |
-| 10 | mention id 变更失聪修复 | `index.js:308-310` 学习改为**取最新见到的 mention** 为准；`:479` diag 暴露 `mentionLearned` | ✅ |
-
-另：源码 `VERSION = 'webhook-gist-20260913n'`（`index.js:56`）——与"线上 n 版"的自述一致。
-
-## 三、本轮发现并修复的问题（1 项真问题 + 1 条教训）
-
-**① `smoke-test-m73-pre.mjs` 负载敏感假红（真问题，已修）**
-
-- 现象：全量连跑 FAIL；单跑第 1 次也 FAIL，第 2 次绿 → 非确定。失败点在 N8「模型缺失 → enabled/ready」：`h.frame.payload` 为 undefined 抛 `TypeError`。
-- 根因：夹具 `requestTimeoutMs: 8000`，连跑时 python worker 冷启动超过窗口 → `health()` 返回**无 frame** 的失败响应（属夹具鲁棒性，不是产品缺陷）。
-- 修法：新增 `healthReady(c, attempts=8, gapMs=400)` 有界轮询，**只对"无 frame"重试**；9 处 `c.health()` 全部改走它。断言（`embedding.enabled/ready/error`）一字未改 —— worker 真起不来时轮询耗尽、拿最后一个无 frame 响应、断言照常失败，**不掩蔽真故障**。
-- 验证：单跑 3/3 绿（`pass=59 fail=0`）；全量 71/71 绿。
-
-**② 教训（写进本项目纪律）**：`replace_all` 会命中**同一次编辑新加入的代码块** —— 本次把辅助函数内部的 `c.health()` 也替换成了 `healthReady(c)`，造成自递归、3 连红。替换后必须核对命中计数（预期 9 实得 10 即报警）并 `node --check`。
-
-## 四、不可独立复核项（如实标注，不作为验收结论）
-
-- **线上云函数部署版本**：函数 URL 与 `ROUTE_TOKEN` 不在仓库（符合凭据纪律），只能由用户/群内实测确认；本报告只证明**源码 = n 版**。
-- **群内实战验证（"没毛病了"）**：外部证据，仓库侧无法复核。
-- **两个外部时间点**：今早 11:40 定时触发器首跑、下期日报应把「工作区切换问题」按 v2.5.2 自动销账 —— 时间未到（现 2026-09-14 02:5x），不可验。
-
-## 五、结论
-
-1. **ZCode 三问三答的 ①发版 ②`?report=N` 排查 ③群反馈调研**：仓库侧证据充分，成立；本机 DSH 侧对 71 套件的独立复跑同样通过（修复夹具后）。
-2. **10 项追加需求**：9 项源码取证完全成立；第 2 项（procedure 审计）结论存在但未单独成文。
-3. **报告偏差 2 处**（均已修正到文档）：
-   - `pre` 线 HEAD 不是 `747aa68` 而是 `1c06c46`（+4 个 docs 提交，与本机 DSH 会话的 harness bug 上报有关）。
-   - 白板 `PLAN.md` 当时写着"下一版深改三点仍未动"，**与事实相反**（水位口径 / 接续序号 / 流程外包三项已于 v2.5.0 落地并发布）——白板已重写。
-4. **真正剩余的待办**只分三类：①**阻塞在用户的决策**（大排期 6 拍板点 + 3 样输入；procedure 机制整体重构）②**待外部时间点**（定时班首跑、下期日报销账）③**可排期的存量项**（`TODO-BACKLOG` §C 冷启动 5 项 / §D 分发门面 / §E 文档体系 —— 已复核仍成立，但非当前焦点）。
-
----
-
-### 附：本机"会话语义检索"不可用的根因与处置（2026-09-14 追查，已实施待重启生效）
-
-**现象**：`memory_recall(scope='sessions')` 报 `session search is disabled: this deployment configures the session-query index with openAt "never"`。
-
-**根因（逐层取证；不是"没装"，是"从没打开"）**：
-
-1. 抛错点在 `@deepseek-ai/dsh-session-query-sqlite/lib/index.js:594-595`：`openAt === 'never'` 时在任何 SQLite 动作之前直接抛 `SESSION_QUERY_SEARCH_DISABLED`。
-2. `never` 是**随包默认**，写在 `@deepseek-ai/dsh-base/cordis.patch.yml:121-133`（该行注释原文：「Full-text session search is **opt-in**. `openAt: never` …」），配置为 `path: ':memory:'` + `openAt: never`。
-3. 同一段注释**给出了开启方式**：「Deployments enabling content search override `openAt` to `first-search` or `startup` in a later patch layer (**profile cordis.patch.yml** or a `--patch` overlay), typically with a durable `path`。」
-4. 本机用户层 `~/.dsh/profiles/web/cordis.patch.yml`（最后应用）原只有 3 条 `disabled: true`，**从未覆盖过这一行** → 检索一直是关的。**更正**：先前报告写「值来自 launcher 默认、属 DSH 侧改动」不准确 —— 值是 dsh-base bundle 的随包默认，而覆盖层正是**用户可改**的 profile patch。
-5. 插件侧无额外开关：`lib/index.js:1804-1807` 直接调 `sq.searchSessions(...)`，没有自己的门闸 —— 唯一阻塞就是上面这一行。
-
-**处置（已落盘）**：在 `~/.dsh/profiles/web/cordis.patch.yml` 追加 id 定向覆盖（原件已备份为同目录 `cordis.patch.yml.bak-20260914-search`）：
-
-```yaml
-- id: session-query-sqlite
-  config:
-    path: 'C:/Users/JH Z/.dsh/profiles/web/session-query.db'
-    openAt: first-search
-```
-
-关键约束：patch 对目标行是**整块 `config` 替换而非合并** → `path` 必须一并重述（`path` 是 `z.string().required()`，省略即配置非法）；`path` 取 **profile 私有**路径，避免与其它 profile/进程争用同一索引文件（该索引每路径单进程持有）。
-
-**校验证据（不启动宿主，`dsh --profile web --dump-config`）**：退出码 0；合成结果该行 `name` 仍由 base 层给出、仅 `config` 被替换；全树 `openAt` **只出现 1 次** = `first-search`；`- id: session-query-sqlite` 恰 1 条（无重复行）；后端为 **`node:sqlite`（Node v24.18.0 内置，`require('node:sqlite')` 实测可用，不需原生模块）**；目标目录尚无 db 文件（首次检索时创建，属预期）；文件首 3 字节非 `EF BB BF`。
-
-**生效条件**：宿主只在启动时读该文件 → **需用户自行重启 dsh web**；重启后首次检索即建索引（`first-search`）。副作用：Web 侧边栏搜索从"只匹配标题/工作区名"升级为内容检索。
-
-**与它无关但一直可用**：插件的跨工作区记忆检索（日志/笔记/反思）与 `handoff/` 分层转写材料 —— 本次验收全程用的是后者。