@a9i5k4/dsh-auto-memory 3.0.1 → 3.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (134) hide show
  1. package/README.md +13 -8
  2. package/README.zh-CN.md +13 -8
  3. package/docs/HANDBOOK.md +92 -52
  4. package/docs/USER-GUIDE.en.md +9 -9
  5. package/docs/USER-GUIDE.zh-CN.md +9 -9
  6. package/docs/screenshots/promo/promo-0-banner-v4.png +0 -0
  7. package/docs/screenshots/promo/promo-1b-auto-recall.png +0 -0
  8. package/lib/activation-host.js +6 -1
  9. package/lib/client.js +1376 -255
  10. package/lib/config-io.js +59 -6
  11. package/lib/context-host.js +17 -2
  12. package/lib/episodic-store.js +90 -16
  13. package/lib/evidence-store.js +27 -1
  14. package/lib/fact-store.js +463 -41
  15. package/lib/hub-io.js +217 -0
  16. package/lib/index.js +904 -87
  17. package/lib/intent-clean-safe.js +1 -1
  18. package/lib/jsonl-tail-cursor.js +75 -0
  19. package/lib/m7-index-sync-host.js +4 -6
  20. package/lib/memory-hub.js +62 -7
  21. package/lib/migrate-pack.js +351 -0
  22. package/lib/note-status.js +9 -1
  23. package/lib/procedure-store.js +252 -31
  24. package/lib/procedure-switch.js +38 -0
  25. package/lib/python-setup.js +109 -27
  26. package/lib/python-sidecar-client.js +285 -8
  27. package/lib/recall-stats.js +242 -0
  28. package/lib/rules-layer.js +106 -15
  29. package/lib/semantic-js.js +25 -7
  30. package/lib/shadow-host.js +41 -2
  31. package/package.json +6 -2
  32. package/docs/internal/ACCEPT-35-LIVE.md +0 -143
  33. package/docs/internal/ACCEPTANCE-20260914.md +0 -90
  34. package/docs/internal/ARCH-REVIEW-BRIEF.md +0 -411
  35. package/docs/internal/ARCH-REVIEW-REQUEST.md +0 -201
  36. package/docs/internal/ARCH-REVIEW-ROUND2.md +0 -169
  37. package/docs/internal/ARCH-REVIEW-ROUND3.md +0 -206
  38. package/docs/internal/ARCHITECTURE-FOR-ZCODE-20260920.md +0 -397
  39. package/docs/internal/ART-DIRECTION-DEEPSEEK-20260920.md +0 -351
  40. package/docs/internal/ART-DIRECTION-WIREFRAME.md +0 -191
  41. package/docs/internal/ART-DIRECTION-WIREFRAME.md.bak-superseded +0 -181
  42. package/docs/internal/AUDIT-WB-GRAPH-FULL-20260916.md +0 -314
  43. package/docs/internal/BATTLE-PLAN-20260917.md +0 -871
  44. package/docs/internal/CONCURRENCY-INVESTIGATION-20260917.md +0 -192
  45. package/docs/internal/CROSS-SESSION-SEARCH-PATH-DECISION.md +0 -72
  46. package/docs/internal/CROSS-SESSION-SEARCH-RESEARCH.md +0 -131
  47. package/docs/internal/CUA-VISION-FIX-NOTES.md +0 -78
  48. package/docs/internal/DECISIONS-20260914-SESSION.md +0 -269
  49. package/docs/internal/DESIGN-OVERHAUL-PRE-RESEARCH.md +0 -292
  50. package/docs/internal/DESIGN-P1-STATE-COMMIT-20260915.md +0 -219
  51. package/docs/internal/DIRECTION-CHECK-WB-GRAPH-20260916.md +0 -132
  52. package/docs/internal/FEATURE-INVENTORY.md +0 -531
  53. package/docs/internal/FEEDBACK-TO-DSHAPI-RELAY.md +0 -13
  54. package/docs/internal/G-SERIES-EXECUTION-20260917.md +0 -248
  55. package/docs/internal/G3-DESIGN-20260918.md +0 -82
  56. package/docs/internal/G3-DISK-FORMAT-GAP-20260919.md +0 -92
  57. package/docs/internal/GH-DISCUSSION-5732-COMMENT.md +0 -74
  58. package/docs/internal/GPT-ACCEPTANCE-PROMPT-20260916.md +0 -352
  59. package/docs/internal/GPT-REVIEW-PROMPT.md +0 -216
  60. package/docs/internal/GROUP-DIGEST-SETUP.md +0 -62
  61. package/docs/internal/GROUP-LISTENER-SETUP.md +0 -49
  62. package/docs/internal/GROUP-WEBHOOK-SETUP.md +0 -93
  63. package/docs/internal/HANDOFF-TO-ZCODE-20260920.md +0 -309
  64. package/docs/internal/HANDOFF-TO-ZCODE.md +0 -168
  65. package/docs/internal/HERMES-DATA-VERIFICATION-20260919.md +0 -120
  66. package/docs/internal/HERMES-LEGACY-STATUS-20260919.md +0 -74
  67. package/docs/internal/ISSUE-55-58-VERIFICATION-20260918.md +0 -175
  68. package/docs/internal/ISSUE10-FIX-EXECUTION-20260919.md +0 -389
  69. package/docs/internal/ISSUE10-PLAN-20260919.md +0 -254
  70. package/docs/internal/ISSUE10B-FORENSICS-20260919.md +0 -468
  71. package/docs/internal/ISSUE9-PURGE-AND-R1-PLAIN-20260919.md +0 -150
  72. package/docs/internal/ISSUE9-RESIDUAL-FORENSICS-20260919.md +0 -114
  73. package/docs/internal/KICKOFF-P0.md +0 -254
  74. package/docs/internal/LESSON-TO-CANDIDATE-STATUS-20260919.md +0 -79
  75. package/docs/internal/MASTER-PLAN-3.0.md +0 -411
  76. package/docs/internal/MEMORY-GOVERNANCE-20260917.md +0 -309
  77. package/docs/internal/MEMORY-MUTATION-AND-INDEX-DESIGN.md +0 -85
  78. package/docs/internal/MERGE-CONFLICT-SCAN-20260914.md +0 -222
  79. package/docs/internal/NEXT-VERSION-TODO.md +0 -95
  80. package/docs/internal/OFFICIAL-DISCUSSION-DRAFT.md +0 -80
  81. package/docs/internal/PENDING-FIXES-20260916.md +0 -289
  82. package/docs/internal/PRE-FRONTEND-CHECKLIST-20260919.md +0 -705
  83. package/docs/internal/PRE-FRONTEND-CHECKLIST-20260919.md.bak-s10 +0 -649
  84. package/docs/internal/PROCEDURAL-MEMORY-AND-APPROVAL-DESIGN-20260918.md +0 -225
  85. package/docs/internal/PROGRESS-20260917.md +0 -93
  86. package/docs/internal/PROMPT-GAP-AUDIT-20260920.md +0 -128
  87. package/docs/internal/R1-DEGRADE-AUDIT-20260918.md +0 -163
  88. package/docs/internal/R1-READABILITY-FORENSICS-20260919.md +0 -127
  89. package/docs/internal/R2-EVIDENCE-DEEP-AUDIT-20260918.md +0 -140
  90. package/docs/internal/R3-DEGRADE-LEDGER-DESIGN-20260918.md +0 -138
  91. package/docs/internal/R4-RECALL-QUOTA-PLAN-20260918.md +0 -218
  92. package/docs/internal/RAG-KARPATHY-PROGRAM.md +0 -229
  93. package/docs/internal/RELEASE-PROCESS.md +0 -99
  94. package/docs/internal/REPORT-P0-NIGHTLY.md +0 -212
  95. package/docs/internal/REPORT-P5-ACCEPTANCE.md +0 -31
  96. package/docs/internal/REPORT-WB-GRAPH-NIGHTLY.md +0 -153
  97. package/docs/internal/RESUME-20260918.md +0 -171
  98. package/docs/internal/RESUME-20260919.md +0 -104
  99. package/docs/internal/REVIEW-WB-GRAPH-SELF.md +0 -81
  100. package/docs/internal/RHINELAB-TO-DEEPSEEK-FEASIBILITY.md +0 -198
  101. package/docs/internal/ROADMAP-20260917-WEEK.md +0 -439
  102. package/docs/internal/ROADMAP.md +0 -106
  103. package/docs/internal/RUN-P0-NIGHTLY.md +0 -227
  104. package/docs/internal/S10-CONSTRUCTION-HANDOFF-20260917.md +0 -185
  105. package/docs/internal/S10-GAP-INVENTORY-20260917.md +0 -239
  106. package/docs/internal/S10-GAPS-PLAIN-20260917.md +0 -125
  107. package/docs/internal/SEMANTIC-ARCHITECTURE-SPEC.md +0 -360
  108. package/docs/internal/SESSION-FILE-REPAIR-PROTOCOL.md +0 -90
  109. package/docs/internal/SUBAGENT-REPORT-ROUTING-PRE-RESEARCH.md +0 -261
  110. package/docs/internal/T6-EXECUTION-20260920.md +0 -130
  111. package/docs/internal/TELEMETRY-EFFECT-REPORT-DESIGN-20260918.md +0 -146
  112. package/docs/internal/THESIS-GAP-ANALYSIS-20260918.md +0 -89
  113. package/docs/internal/THESIS-OUTLINE-20260918.md +0 -147
  114. package/docs/internal/THREE-LAYER-CONTRACT.md +0 -219
  115. package/docs/internal/TODO-BACKLOG.md +0 -263
  116. package/docs/internal/TODO-GRAPH.html +0 -715
  117. package/docs/internal/TODO-GRAPH.html.bak-20260914-v2 +0 -493
  118. package/docs/internal/TODO-GRAPH.html.bak-20260915-alsfix +0 -710
  119. package/docs/internal/TODO-GRAPH.html.bak-20260915-p1 +0 -710
  120. package/docs/internal/TODO-GRAPH.html.bak-20260915-p6a-rev +0 -703
  121. package/docs/internal/TODO-GRAPH.html.bak-20260915-wshint +0 -710
  122. package/docs/internal/TODO-GRAPH.html.bak-20260916-batch +0 -715
  123. package/docs/internal/UPSTREAM-ISSUE-PR-TRIAGE-20260919.md +0 -297
  124. package/docs/internal/UPSTREAM-ISSUES-3RD-AUDIT-20260920.md +0 -104
  125. package/docs/internal/WB-FORMAT-CONVENTION.md +0 -112
  126. package/docs/internal/WB-GRAPH-DECISIONS-20260914.md +0 -71
  127. package/docs/internal/WB-GRAPH-INTEGRATION-PLAN.md +0 -386
  128. package/docs/internal/WB-GRAPH-RESEARCH-BRIEF.md +0 -118
  129. package/docs/internal/WB-GRAPH-RESEARCH-EXTERNAL.md +0 -228
  130. package/docs/internal/WB-GRAPH-RESEARCH-LOCAL.md +0 -190
  131. package/docs/internal/reviews/CLAIM-VERIFICATION-20260914.md +0 -56
  132. package/docs/internal/reviews/PLAN-gpt6astra-round2-20260914.md +0 -787
  133. package/docs/internal/reviews/REVIEW-gpt6astra-20260914.md +0 -112
  134. package/docs/internal/reviews/ROUND3-REVIEW-INTEGRATION-20260914.md +0 -230
@@ -28,7 +28,14 @@
28
28
  * "模型**真的收到了**"取决于宿主最终请求 messages 的确认(`MASTER-PLAN-3.0.md §7` 的 **U6**,
29
29
  * 尚未具备)⇒ **不得**据此宣称"规则的遵守问题已解决"(T7-7 的纪律)。
30
30
  *
31
- * S9 合规:零 IO、零依赖、纯函数、无网络/无 LLM/无子进程/无 await。UTF-8 无 BOM。
31
+ * S9 合规:零 IO、纯函数、无网络/无 LLM/无子进程/无 await。UTF-8 无 BOM。
32
+ *
33
+ * **P9 更新(2026-09-22)**:规则段从此**认状态** —— superseded / retracted 的条目进 retired
34
+ * 分项、**不再注入**(旧行为是规则段无视状态、过时条目每轮照发)。
35
+ * ★**本模块的「零 import」不变式保持不变**:状态解析用**等价内联**(statusOfEntryPre /
36
+ * stripStatusLinesPre,语法与 note-status.js 一致),不引入模块依赖。
37
+ * 理由:p6b 与 p6a 两条守卫都锁这条不变式,且 l0-extract.js:6504-6508 有同样先例;
38
+ * 等价性由守卫 tests/smoke/smoke-test-p9-rules-lifecycle-pre.mjs 逐例对照断言。
32
39
  */
33
40
 
34
41
  export const RULES_LAYER_VERSION = 'rules_layer_v1'
@@ -70,11 +77,73 @@ export const RULE_DESCRIPTION_MARKERS_V1 = Object.freeze([
70
77
  /** 条目切分锚点:与 `l0-extract.js` 的记忆锚点完全一致(不另立一套)。 */
71
78
  const MEM_ANCHOR_LINE_RE = /^<!--\s*memory:(mem_[0-9a-f]{32})\s*-->$/
72
79
 
73
- /** 条目内的日期小节(`## 2026-08-14`)——既有记忆文件的实际结构。 */
74
- const DATE_SECTION_RE = /^##\s*\d{4}-\d{2}-\d{2}\s*$/
80
+ /**
81
+ * 条目内的日期小节 —— 既有记忆文件的实际结构。
82
+ *
83
+ * P9 修正:从「只认 ## + 纯日期」放宽到「任意级别 + 可带标题」——
84
+ * 旧形态漏掉 `## 2026-09-22 · <标题>` / `### 2026-09-18 · <标题>` 这类带标题的日期小节。
85
+ */
86
+ const DATE_SECTION_RE = /^#{1,6}\s*\d{4}-\d{2}-\d{2}\s*$/
87
+
88
+ /** ATX 标题行(任意级别)—— 小节标记,不是规则正文。 */
89
+ const ATX_HEADING_RE = /^#{1,6}\s+(\S.*)$/
90
+
91
+ /** 标题行的可读文本(剥 # 前缀)—— 正文缺失时的兜底,绝不留空条。 */
92
+ function headingTextPre(line) {
93
+ const m = ATX_HEADING_RE.exec(clean(line))
94
+ return m ? m[1].trim() : ''
95
+ }
75
96
 
76
97
  const clean = (s) => String(s == null ? '' : s)
77
98
 
99
+ /**
100
+ * 条目状态行语法(与 note-status.js **完全一致**;刻意内联见文件头 P9 说明)。
101
+ * 只认整行、只认三态;非法 memoryId / 未知属性一律丢弃(fail-soft)。
102
+ */
103
+ const STATUS_LINE_RE_V1 = /^<!--\s*dsh-status:\s*(current|superseded|retracted)\s*((?:\w+=(?:"[^"]*"|[^\s"]+)\s*)*)-->$/
104
+ const STATUS_ATTR_RE_V1 = /(\w+)=(?:"([^"]*)"|([^\s"]+))/g
105
+ const MEM_ID_RE_V1 = /^mem_[0-9a-f]{32}$/
106
+ const STATUS_REASON_MAX_V1 = 120
107
+
108
+ /**
109
+ * 从条目正文解析状态:**最后一个**状态行胜出(口径同 note-status.js 的 statusOfBodyPre)。
110
+ * 无状态行 ⇒ { status: current }。等价性由 tests/smoke/smoke-test-p9-rules-lifecycle-pre.mjs 逐例对照。
111
+ * @param {string} body 条目正文(不含锚点行)
112
+ * @returns {{status:string, supersededBy?:string, reason?:string}}
113
+ */
114
+ export function statusOfEntryPre(body) {
115
+ const lines = clean(body).split(/\r?\n/)
116
+ for (let i = lines.length - 1; i >= 0; i--) {
117
+ const m = STATUS_LINE_RE_V1.exec(lines[i].trim())
118
+ if (!m) continue
119
+ const out = { status: m[1] }
120
+ STATUS_ATTR_RE_V1.lastIndex = 0
121
+ let a
122
+ while ((a = STATUS_ATTR_RE_V1.exec(m[2] || '')) !== null) {
123
+ const k = a[1]
124
+ const v = a[2] !== undefined ? a[2] : a[3]
125
+ if (k === 'by') { if (MEM_ID_RE_V1.test(String(v || ''))) out.supersededBy = String(v) }
126
+ else if (k === 'reason') {
127
+ const r = String(v || '').replace(/[\r\n]+/g, ' ').trim().slice(0, STATUS_REASON_MAX_V1)
128
+ if (r) out.reason = r
129
+ }
130
+ }
131
+ return out
132
+ }
133
+ return { status: 'current' }
134
+ }
135
+
136
+ /**
137
+ * 剥掉**整行**状态行,其余行逐字保留(口径同 note-status.js 的 stripStatusLinePre)。
138
+ * @param {string} body
139
+ * @returns {string}
140
+ */
141
+ export function stripStatusLinesPre(body) {
142
+ const s = clean(body)
143
+ if (!s.includes('<!-- dsh-status:')) return s
144
+ return s.split(/\r?\n/).filter((ln) => STATUS_LINE_RE_V1.exec(ln.trim()) === null).join('\n')
145
+ }
146
+
78
147
  /**
79
148
  * 把记忆文本按锚点切成条目(保持既有文件结构语义:无锚点的前置内容归入首条)。
80
149
  *
@@ -143,8 +212,8 @@ export function extractRulesLayerPre(input = {}) {
143
212
  const o = input && typeof input === 'object' ? input : {}
144
213
  const mode = clampMode(o.rulesLayeringMode)
145
214
  const empty = {
146
- version: RULES_LAYER_VERSION, mode, enabled: false, text: '', rules: [], candidates: [], references: [],
147
- counts: { entries: 0, rules: 0, candidates: 0, references: 0 }, chars: { rules: 0, candidates: 0, total: 0 },
215
+ version: RULES_LAYER_VERSION, mode, enabled: false, text: '', rules: [], candidates: [], references: [], retired: [],
216
+ counts: { entries: 0, rules: 0, candidates: 0, references: 0, retired: 0 }, chars: { rules: 0, candidates: 0, total: 0 },
148
217
  }
149
218
  if (mode === null) return empty
150
219
 
@@ -161,22 +230,32 @@ export function extractRulesLayerPre(input = {}) {
161
230
  const rules = []
162
231
  const candidates = []
163
232
  const references = []
233
+ const retired = []
164
234
  for (const e of sources) {
165
- const c = classifyText(e.text)
166
- const rec = { layer: e.layer, id: e.id, anchorLine: e.anchorLine, kind: c.kind, confidence: c.confidence, reasons: c.reasons, text: e.text }
235
+ // ★P9:先读状态、再分类 —— 状态行是元数据不是正文(留着会被当规则语汇参与分类)
236
+ const st = statusOfEntryPre(e.text)
237
+ const content = stripStatusLinesPre(e.text)
238
+ if (st.status !== 'current') {
239
+ retired.push({
240
+ layer: e.layer, id: e.id, anchorLine: e.anchorLine,
241
+ status: st.status, supersededBy: st.supersededBy || '', reason: st.reason || '',
242
+ text: content,
243
+ })
244
+ continue
245
+ }
246
+ const c = classifyText(content)
247
+ const rec = { layer: e.layer, id: e.id, anchorLine: e.anchorLine, kind: c.kind, confidence: c.confidence, reasons: c.reasons, text: content }
167
248
  if (c.kind === 'rule') rules.push(rec)
168
249
  else if (c.kind === 'candidate') candidates.push(rec)
169
250
  else references.push(rec)
170
251
  }
171
252
 
172
253
  // 规则层文本:只含规则条目(高/中置信),逐条一行摘要,**不掺参考类**
173
- const renderLine = (r) => '- ' + ruleSummaryPre(r.text)
174
- const parts = []
175
- if (rules.length) parts.push(rules.map(renderLine).join('\n'))
176
- const text = parts.join('\n')
254
+ const rowsOut = rules.map((r) => '- ' + ruleSummaryPre(r.text)).filter((s) => s !== '- ')
255
+ const text = rowsOut.join('\n')
177
256
  return {
178
- version: RULES_LAYER_VERSION, mode, enabled: true, text, rules, candidates, references,
179
- counts: { entries: sources.length, rules: rules.length, candidates: candidates.length, references: references.length },
257
+ version: RULES_LAYER_VERSION, mode, enabled: true, text, rules, candidates, references, retired,
258
+ counts: { entries: sources.length, rules: rules.length, candidates: candidates.length, references: references.length, retired: retired.length },
180
259
  chars: { rules: text.length, candidates: candidates.reduce((a, r) => a + ruleSummaryPre(r.text).length + 2, 0), total: text.length },
181
260
  }
182
261
  }
@@ -209,8 +288,16 @@ export function firstLine(text, max = 200) {
209
288
  */
210
289
  export function ruleSummaryPre(text, max = 200) {
211
290
  const lines = clean(text).split('\n').map((l) => l.trim()).filter(Boolean)
291
+ // ★P9(2026-09-22):ATX 标题一律视为**小节标记**,优先渲染正文首行;
292
+ // 正文缺失才回落到标题文本。旧行为把「## <日期> · <标题>」当正文渲染 ⇒
293
+ // 规则段里进去的全是标题,规则本体一条都不在场(实测 54 条规则多数如此)。
294
+ let headingFallback = ''
212
295
  for (const l of lines) {
213
296
  if (DATE_SECTION_RE.test(l)) continue
297
+ if (ATX_HEADING_RE.test(l)) {
298
+ if (!headingFallback) headingFallback = headingTextPre(l)
299
+ continue
300
+ }
214
301
  if (/^<!--/.test(l)) continue
215
302
  if (/^[-*+]\s*$/.test(l)) continue
216
303
  // 去掉列表前缀再返回,保持一条一行
@@ -218,9 +305,10 @@ export function ruleSummaryPre(text, max = 200) {
218
305
  // ★P6B:剥行内 kind 标记与前置时间戳(只影响渲染,不回写盘上原文)
219
306
  body = body.replace(LOG_KIND_TAG_RE_V1, ' ').trim()
220
307
  body = body.replace(/^\d{1,2}:\d{2}\s+/, '').trim()
308
+ if (!body) continue
221
309
  return body.length > max ? body.slice(0, Math.max(1, max - 1)) + '…' : body
222
310
  }
223
- return ''
311
+ return headingFallback.length > max ? headingFallback.slice(0, Math.max(1, max - 1)) + '…' : headingFallback
224
312
  }
225
313
 
226
314
  /**
@@ -241,7 +329,10 @@ export function renderRulesSectionPre(rules, opts = {}) {
241
329
  if (!list.length) return { text: '', chars: 0, guide: '' }
242
330
  const title = clean((opts && opts.title) || RULES_SECTION_TITLE_V1)
243
331
  const guide = clean((opts && opts.guide) || RULES_SECTION_GUIDE_V1)
244
- const text = '\n' + title + '\n' + guide + '\n' + list.map((x) => '- ' + ruleSummaryPre(x.text)).join('\n')
332
+ // ★P9:空摘要**不渲染**(旧写法会产出裸 "- " 行;放宽小节标记后更易出现)
333
+ const rows = list.map((x) => '- ' + ruleSummaryPre(x.text)).filter((r) => r !== '- ')
334
+ if (!rows.length) return { text: '', chars: 0, guide: '' }
335
+ const text = '\n' + title + '\n' + guide + '\n' + rows.join('\n')
245
336
  return { text, chars: text.length, guide }
246
337
  }
247
338
 
@@ -68,6 +68,22 @@ export function fuseD6Pre(pairs) {
68
68
 
69
69
  const E5_MODELS_SUBDIR = 'multilingual-e5-small'
70
70
 
71
+ /**
72
+ * ★P3-14(2026-09-22)→ **P10-B 修正(同日晚)**:`artifacts/m7-live-pre/js-semantic-trial` 是**纯维护者机器路径**
73
+ * (`.gitignore` 已排除其 models/ 与 node_modules/,用户机上结构性不存在)。
74
+ * P3-14 原用「环境变量 `DAM_DEV_TREE=1` 显式开启」来排除发布包 —— 但那个开关**把维护者本机也一起排除了**
75
+ * (实测:开发机该目录有 112.8MB 模型 + peer,却因开关默认关而报 `setup-both`)。
76
+ * ⇒ 改为**存在性判定**:目录存在即视为开发树;用户机上该目录结构性不存在 ⇒ 发布包行为不变。
77
+ * `DAM_DEV_TREE=1` 保留为**显式强制开启**(离线调试且目录另置时用)。
78
+ */
79
+ const DEV_TREE_ENABLED = process.env.DAM_DEV_TREE === '1'
80
+
81
+ /** 开发树 artifacts 候选根(显式开关**或该目录实际存在**时非 null —— 见上方 P10-B 修正)。 */
82
+ function devTreeRoot(pluginDir) {
83
+ const root = path.join(pluginDir, '..', 'artifacts', 'm7-live-pre', 'js-semantic-trial')
84
+ return (DEV_TREE_ENABLED || existsSync(root)) ? root : null
85
+ }
86
+
71
87
  function defaultModelsDirCandidates(pluginDir) {
72
88
  // 用户目录优先(#15 后续/B 修复):~/.dsh/models/js-semantic/ 跨插件升级存活——
73
89
  // 包目录(lib/models)在 npm 更新时会被整体重装,下载的 130MB 模型曾被冲掉。
@@ -76,8 +92,7 @@ function defaultModelsDirCandidates(pluginDir) {
76
92
  return [
77
93
  path.join(dshHome, 'models', 'js-semantic'),
78
94
  path.join(pluginDir, 'models'),
79
- path.join(pluginDir, '..', 'artifacts', 'm7-live-pre', 'js-semantic-trial', 'models'),
80
- ]
95
+ ].concat(devTreeRoot(pluginDir) ? [path.join(devTreeRoot(pluginDir), 'models')] : [])
81
96
  }
82
97
 
83
98
  function defaultPeerDirCandidates(pluginDir) {
@@ -87,13 +102,12 @@ function defaultPeerDirCandidates(pluginDir) {
87
102
  // 2) <pkg>/node_modules —— 包内邻接位(lib 上 1 级再进 node_modules)
88
103
  // 3) lib 上 3 级直拼 @huggingface —— 标准布局即 <root>/node_modules(pnpm hoisted/npm 提升),
89
104
  // pnpm isolated 下即虚拟存储包内位 .pnpm/<hash>/node_modules
90
- // 4) 开发树 artifacts
105
+ // 4) 开发树 artifacts(★P3-14:仅 DAM_DEV_TREE=1 时纳入;该路径 .gitignore 排除、用户机恒不存在)
91
106
  return [
92
107
  path.join(pluginDir, 'node_modules', '@huggingface', 'transformers'),
93
108
  path.join(pluginDir, '..', 'node_modules', '@huggingface', 'transformers'),
94
109
  path.join(pluginDir, '..', '..', '..', '@huggingface', 'transformers'),
95
- path.join(pluginDir, '..', 'artifacts', 'm7-live-pre', 'js-semantic-trial', 'node_modules', '@huggingface', 'transformers'),
96
- ]
110
+ ].concat(devTreeRoot(pluginDir) ? [path.join(devTreeRoot(pluginDir), 'node_modules', '@huggingface', 'transformers')] : [])
97
111
  }
98
112
 
99
113
  /**
@@ -180,8 +194,12 @@ export function probeJsSemanticAssets(pluginDir, extraDirs, degradedReason) {
180
194
  const modelCands = [
181
195
  path.join(dshHome, 'models', 'js-semantic', E5_MODELS_SUBDIR, 'onnx', 'model_quantized.onnx'),
182
196
  path.join(pluginDir, 'models', E5_MODELS_SUBDIR, 'onnx', 'model_quantized.onnx'),
183
- path.join(pluginDir, '..', 'artifacts', 'm7-live-pre', 'js-semantic-trial', 'models', E5_MODELS_SUBDIR, 'onnx', 'model_quantized.onnx'),
184
- ]
197
+ // ★P10-C(2026-09-22,用户裁定):dev 树闸门从「环境变量显式开启」统一为**存在性判定**。
198
+ // P10-B 只改了本文件另外两处(defaultModelsDirCandidates / defaultPeerDirCandidates),
199
+ // **探针这处漏改** ⇒ 开发机上 peer 已可解析(面板不再报 setup-both),但资产恒判 missing
200
+ // ⇒ 面板显示「JS 引擎模型 ✗ 未就绪」(用户报障)。三处口径现已一致。
201
+ // 保护意图不变:用户机上 `artifacts/m7-live-pre/` 结构性不存在 ⇒ 发布包行为零变化。
202
+ ].concat(devTreeRoot(pluginDir) ? [path.join(devTreeRoot(pluginDir), 'models', E5_MODELS_SUBDIR, 'onnx', 'model_quantized.onnx')] : [])
185
203
  const modelOnnx = modelCands.find((c) => existsSync(c)) || modelCands[0]
186
204
  const assetPresent = existsSync(modelOnnx)
187
205
  const peerDir = resolvePeerTransformersDir(pluginDir, extraDirs)
@@ -40,7 +40,30 @@ export function truncateAuditEvent(ev) {
40
40
  return e
41
41
  }
42
42
 
43
- export function createShadowHost({ engine }) {
43
+ /**
44
+ * ★P3-9(组2,2026-09-22):诊断**节流**表。
45
+ * 原先 `no-paths` 每个 Segment 都直接 console.error ⇒ 单次历史回放能刷出上百行。
46
+ * 表放**模块级**而非闭包级:同进程多实例共享 ⇒ 不会各自持一份而双写。
47
+ * 语义同 index.js 的 diagThrottled:首条立即透出,窗口内重复压掉。
48
+ */
49
+ const DIAG_THROTTLE_MS_V1 = 300000
50
+ const _diagAt = new Map()
51
+ function shouldReportDiag(key) {
52
+ try {
53
+ const now = Date.now()
54
+ if (now - (Number(_diagAt.get(key)) || 0) < DIAG_THROTTLE_MS_V1) return false
55
+ _diagAt.set(key, now)
56
+ } catch (_) { /* 计时失败不阻断上报 */ }
57
+ return true
58
+ }
59
+
60
+ /**
61
+ * @param {{engine: object, onDiag?: Function|null, recallStats?: object|null}} opts
62
+ * `recallStats` = 召回统计实例(可选)。**依赖注入而非模块级单例**:本模块保持零耦合,
63
+ * 测试可传假对象(不碰真磁盘);不传时埋点整段跳过,行为与从前逐字节相同。
64
+ * ★命名:不得叫 `stats` —— 本函数内部已有同名 const(shadow 自身计数器),会作用域冲突。
65
+ */
66
+ export function createShadowHost({ engine, onDiag = null, recallStats = null }) {
44
67
  const states = new WeakMap() // runtime → shadow state(lazy)
45
68
  const volatileRing = [] // ≤64 events(最小投影)
46
69
  const stats = { evaluated: 0, retrieved: 0, prefetched: 0, suppressed: 0, stale: 0, errors: 0 }
@@ -58,6 +81,13 @@ export function createShadowHost({ engine }) {
58
81
  engine.config.shadowRetrievalEnabled === true &&
59
82
  engine.config.memoryAnchorEnabled === true
60
83
 
84
+ /** ★P3-9(组2):节流上报。未注入 onDiag 时回落 console.error(保持既有行为,只去掉刷屏)。 */
85
+ function reportDiag(key, msg) {
86
+ if (!shouldReportDiag(key)) return
87
+ if (typeof onDiag === 'function') { try { onDiag(key, msg); return } catch (_) { /* 回落 */ } }
88
+ try { console.error(msg) } catch (_) {}
89
+ }
90
+
61
91
  function stateFor(runtime) {
62
92
  let st = states.get(runtime)
63
93
  if (!st) {
@@ -225,7 +255,7 @@ export function createShadowHost({ engine }) {
225
255
  return
226
256
  }
227
257
  const paths = pathsByKey.get(String(runtime.key || '')) || null
228
- if (!paths) { console.error('[shadow-diag] no-paths'); stats.suppressed++; pushVolatile({ reason: 'no-paths-captured', contextVersion: seg.contextVersion }); return }
258
+ if (!paths) { reportDiag('shadow:no-paths', '[shadow-diag] no-paths'); stats.suppressed++; pushVolatile({ reason: 'no-paths-captured', contextVersion: seg.contextVersion }); return }
229
259
  // window:segments ring 最近 8 条(含当前)
230
260
  const ringItems = runtime.segments ? runtime.segments.snapshot() : []
231
261
  const win = ringItems.slice(-8).map((w) => ({
@@ -320,6 +350,15 @@ export function createShadowHost({ engine }) {
320
350
  if (dec.action === 'retrieve') stats.retrieved++
321
351
  else stats.prefetched++
322
352
  st.recentHits.push({ queryDigest: qp.queryDigest, fresh: ls.kept.length > 0, memoryIds: ls.kept.map((k) => k.memoryId) })
353
+ // ★③ 召回统计 · shadow 通道(2026-09-22 用户拍板「分开计算」):
354
+ // 这条通路 = 系统**主动判断该唤起**,与「模型主动检索」是两回事,必须分账。
355
+ // 语义:命中率(kept 空 ⇒ 唤起了但没东西)+ 哪些内容被系统认为该唤起。
356
+ // ★只读:不改 ls / st / 决策,不影响任何 shadow 行为(守卫断言)。
357
+ if (recallStats && typeof recallStats.observe === 'function') {
358
+ try {
359
+ recallStats.observe(ls.kept.map((k) => ({ id: k.memoryId, layer: k.sourceClass || k.scope || 'shadow' })), { channel: 'shadow' })
360
+ } catch (_) {}
361
+ }
323
362
  if (st.recentHits.length > 64) st.recentHits.shift()
324
363
  st.completedKeys.add(qp.queryDigest + ':' + snapshotOut.memoryIndexVersion)
325
364
  if (st.completedKeys.size > 256) { const first = st.completedKeys.values().next().value; st.completedKeys.delete(first) }
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@a9i5k4/dsh-auto-memory",
3
3
  "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 式上下文管理:自动唤回/自动沉淀/技能固化/交接账本与白板跨窗口续命/水位感知。",
4
- "version": "3.0.1",
4
+ "version": "3.1.1",
5
5
  "type": "module",
6
6
  "main": "lib/index.js",
7
7
  "exports": {
@@ -15,7 +15,11 @@
15
15
  "docs",
16
16
  "cordis.patch.yml",
17
17
  "!python/bench",
18
- "!python/__pycache__"
18
+ "!python/__pycache__",
19
+ "!docs/internal",
20
+ "!docs/**/*.bak",
21
+ "!docs/**/*.bak-*",
22
+ "!**/*.mjs.bak-*"
19
23
  ],
20
24
  "dsh": {
21
25
  "bundle": {
@@ -1,143 +0,0 @@
1
- # #35 真机验收方案(停旧回合 → 仪式 → 真判据 → 新窗口)
2
-
3
- > 目标:把 #35 的修复从**夹具级**(`smoke-test-autocont-host-pre.mjs` 95 断言)升级为**真机级**。
4
- > 本文件给**新会话**执行;执行者不需要读原对话。改配置前先备份(用户级硬规则)。
5
-
6
- ## 0. 为什么必须换一个会话做
7
-
8
- - 验收的**核心那一档**要求在「回合正在运行时点同意」——那会**终止当前回合**。
9
- 拿重要对话当靶子会打断它,所以:**另开一个新会话当"旧会话"被接续**,本对话不受影响。
10
- - 新会话要够长、有实质内容(交接材料才有东西可带);空会话测不出材料质量。
11
-
12
- ## 1. 前置条件(**2026-09-14 解耦后已更新:只需开一个开关**)
13
-
14
- > 历史注记:解耦前 `handoffEnabled=false` 会让 `checkWaterLevel` 提前返回 → `waterLevelModelKnown` 不写 → fail-closed 闸永不 arm,所以当时**必须同时开两个开关**。那处耦合已切除(`lib/index.js` 的 `checkWaterLevel` 早退、`armAutoContinue` 早退、`autoContinueState.enabled` 二次与运算、`buildContinueCarry` 的 `handoff disabled` 早退,共 4 处)。
15
-
16
- 这台机器的现行配置(`~/.dsh/dsh-auto-memory-pre.json`):
17
-
18
- | 键 | 现值 | 现在的要求 |
19
- |---|---|---|
20
- | `autoContinueEnabled` | **false** | **必须临时改 true**——它是接续的唯一资格开关 |
21
- | `handoffEnabled` | false | **可保持 false**,此时走「最小转写载体」;也可改 true 走完整两层载体(见步骤 1 的 A/B 跑法) |
22
- | `autoContinueThreshold` | 0.75 | 正常会话很难自然达阈值,验收要临时降 |
23
-
24
- **结论:只开 `autoContinueEnabled` 即可跑验收。** 而且**建议第一轮就保持白板关闭**——那条路径是这次解耦才第一次可用的(此前直接 hard-fail),顺带把解耦也验了。
25
-
26
- ## 2. 步骤
27
-
28
- ### 步骤 0 · 备份(必做)
29
- ```pwsh
30
- Copy-Item "$env:USERPROFILE\.dsh\dsh-auto-memory-pre.json" "$env:USERPROFILE\.dsh\dsh-auto-memory-pre.json.bak-accept35" -Force
31
- ```
32
-
33
- ### 步骤 1 · 临时开开关 + 降阈值(**A/B 两轮**)
34
-
35
- **A 轮(先跑,白板关闭 —— 验解耦后的最小载体)**:
36
- ```json
37
- "autoContinueEnabled": true,
38
- "autoContinueThreshold": 0.05
39
- ```
40
- 保持 `handoffEnabled: false` 不动。此轮新会话应拿到**转写包 + 近期线程**,且材料里带一句自述「未启用白板/账本」;仪式步骤会被**跳过**(日志 `reason:'handoff-disabled'`),这是**预期**,不是失败。
41
-
42
- **B 轮(A 通过后再跑,白板打开 —— 验完整两层载体)**:
43
- 再把 `"handoffEnabled": true` 打开,重跑一次,观察步骤 ②③ 的仪式链路。
44
-
45
- > 为什么降的是 `autoContinueThreshold` 而不是 `waterLevelWindowTokens`:改窗口会让**水位测量本身**失真,连带 advisory 与自动账本写入都变形;降阈值只动"什么时候弹卡"。
46
- > 每轮改完**重启 dsh web**(注入面与开关在启动时读)。**注意冷却**:`autoContinueCooldownMinutes=30`,触发过一次后 30 分钟内不再弹——两轮之间要么等,要么把冷却临时调小。
47
-
48
- ### 步骤 2 · 造场景
49
- 在**新会话**里正常跑一两轮(有工具调用、有实质产出)。
50
- - 注意:**首轮 pre-step 拿不到模型信息**(`request/header` 还没写),按 #33 的 fail-closed 设计,首轮的按比例 arm 会被拦,**推迟到该轮 turn-stopping**。所以卡片应在**第一轮结束后**出现,而不是开局。
51
- - 若 10 分钟不弹卡:先查日志有没有 `auto-continue armed`,没有就回头查开关与 `modelKnown`(见 §4 排查)。
52
-
53
- ### 步骤 3 · 点「同意接续」并采日志
54
- 两种点法,验证深度不同——**建议先 A 后 B**:
55
-
56
- - **A 档(先做,安全)**:**空闲时点**。验通 ①→④ 全链路与节拍;`cancel` 对空转回合是空操作。
57
- - **B 档(核心,代价已知)**:**让一个回合跑着(多步工具调用/长输出),在运行中点同意**。这才是 issue 原现场,也是唯一能验「回合活跃时不再并行」的做法。**代价:该回合会被终止,未完成的回答落 `interrupted`。**
58
-
59
- 采集(改完配置重启后):
60
- ```pwsh
61
- Get-Content "$env:USERPROFILE\.dsh\dsh-auto-memory-pre-diagnose.log" -Tail 200 |
62
- Select-String 'auto-continue|ritual|prev-session|stopped|waited'
63
- ```
64
-
65
- ## 3. 判据(缺一不算过;第 3 条仅 B 轮适用,A 轮看 3′)
66
-
67
- | # | 期望日志 | 含义 |
68
- |---|---|---|
69
- | 1 | `auto-continue armed: … awaitIdle=true …` | 闸放行了(能验到这条本身就说明 #33 的 fail-closed 没误杀) |
70
- | 2 | **`auto-continue: stopped old turn sid=…`** | **① 新链路真的执行了**;若旧回合在跑,旧窗口应显示被打断 |
71
- | 3 | **`host refresh ritual: … waited=updated`**(**仅 B 轮/白板开时适用**) | **②③ 因果闭合判据通过**(若显示 `waited=stamp-fallback` → 说明 `sc.inspect` 不可用、退到弱判据,**要当作半通过并单独记**) |
72
- | 3′ | **A 轮(白板关)替代判据**:日志出现仪式的 `reason:'handoff-disabled'`(仪式按设计被跳过),**且**新会话交接材料里出现「未启用白板/账本」自述、**不含**磁盘上真实存在的 PLAN/账本正文 | 解耦生效:白板关 ≠ 不能接续;且降级是**显式**的,不是静默丢弃 |
73
- | 4 | `prev-session pack built` → `auto-continue host-executed: … stopped=ok` | ④ 新会话建立;`stopped=ok` 与判据 2 互相印证 |
74
-
75
- **反向断言(同样重要)**:
76
- - 若 ④ 出现但**没有** 2 → 停旧回合没生效(或旧会话无 id,`stopped=no-old-session`),必须记下来;
77
- - 若旧回合被打断后**新会话没建起来** → 交接失败,比"并行"更糟,立即回滚并报告。
78
-
79
- ## 4. 排查(卡片不弹时按序查)
80
-
81
- 1. 开关是否真的生效:`GET /api/dsh-auto-memory-pre/auto-continue-state`(或设置页)看 `enabled`;
82
- 2. 日志有没有 `consolidate skip:` / `auto-continue` 任何一行;
83
- 3. `modelKnown` 是否为真:首轮必为假(设计如此),只在**轮末**才可能 arm;
84
- 4. 冷却:`autoContinueCooldownMinutes=30`,触发过一次后 30 分钟内不再弹——**验收期间只点一次**,要点第二次就先把它调小。
85
-
86
- ## 5. 回滚(验完必做)
87
-
88
- ```pwsh
89
- Copy-Item "$env:USERPROFILE\.dsh\dsh-auto-memory-pre.json.bak-accept35" "$env:USERPROFILE\.dsh\dsh-auto-memory-pre.json" -Force
90
- ```
91
- 然后重启 dsh web。**除非用户明确要求长期开启**,否则恢复成 `handoffEnabled=false` / `autoContinueEnabled=false` / `autoContinueThreshold=0.75`。
92
-
93
- > 待用户裁定(会写进交接账本):这两个开关**日常要不要开**。若长期关着,则 #35 与 #31 第二半这两笔修复在水位/接续/白板面上**处于不生效状态**——修了但不在线。
94
-
95
- ## 6. 纪律
96
-
97
- - 改配置**必须先备份**(用户级硬规则);只改目标键,别整篇重写。
98
- - **不要**按进程名杀进程(曾误杀 harness);要停就用精确 PID + `taskkill /PID <pid> /T /F`。
99
- - 不要拿主对话当接续靶子。
100
- - 验收结论无论通过与否都要落一笔到当日日志;失败要附原始日志片段,不要只写"没通过"。
101
-
102
- ## 7. 真机验收结果(2026-09-14 17:37–17:41,Run 1)
103
-
104
- > 现场:旧会话 `session-d2c13583`(128 msgs)→ 新会话 `session-b8f093e4`。**在飞配置为 `handoffEnabled=true`**(非本文档 §2 设想的 A 轮),故本次实为 **B 轮**(完整两层载体);**A 轮(白板关)仍未验**。
105
- > 验收人操作:用户在新窗口点「同意接续」(`decideAutoContinue('agree')`)。
106
-
107
- ### 判据结果
108
-
109
- | # | 结果 | 证据 |
110
- |---|---|---|
111
- | 1 | **PASS** | `09:36:52.739Z auto-continue armed: sid=session-d2c13583… ratio=0.07 awaitIdle=true` |
112
- | 2 | **PASS** | `09:37:37.776Z auto-continue: stopped old turn sid=session-d2c13583…`;旧会话 `turn/end reason.kind=aborted/user` |
113
- | 3 | **FAIL(原因已查清,非逻辑缺陷)** | `09:39:08.082Z host refresh ritual: timeout, continuing with current material` → `lastOk.refreshRitual='timeout'` |
114
- | 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` |
115
-
116
- **反向断言**:④ 出现且 ② 同时出现 → 停旧回合生效;新会话成功建立(侧栏标题 `接续 #22 · dsh-auto-memory`,工作区/模型/权限 `deepseek-v4.1-flash` + `danger-full-access` 均继承)→ 无"比并行更糟"的交接失败。
117
-
118
- ### 判据 3 超时的根因(已用旧会话原始事件流取证)
119
-
120
- 不是判据写错,是**上游 API 故障把仪式推后到轮询窗之外**:
121
-
122
- 1. `09:37:37.778Z` 仪式以 `mode:'queue'` 投给旧会话,**立刻**落为 `seq=244 user/message`,`turn=3` 同步启动 → 投递链路本身正常。
123
- 2. `turn=3` 全窗没有一次成功的 assistant 产出:`llm/retry` 连续 5 次(`09:37:45`→`09:38:38`,61s),
124
- `09:38:38.450Z turn/end reason.kind=error`,错误为 **`502: {"message":"上游拒绝请求","type":"upstream_bad_request"}`**。
125
- 3. 90s 轮询窗(`autoContinueRefreshTimeoutSeconds`)到点 → 报 `timeout`,宿主按 fail-soft 继续接续。
126
- 4. **仪式随后真的执行了**:用户后续「继续」推动 `turn=6`,`09:41:01.529Z`(seq 291–295)模型连调两次
127
- `memory_note_pre`(`kind=plan` + `kind=handoff`)→ `PLAN.md` 与 `handoff-20260914-174101.md` 的 mtime 正是 `17:41:01`。
128
-
129
- 结论:**因果闭合判据的实质成立**(事件数增长且出现 seq>239 的 `assistant/message` + `tool/call`),只是发生在 90s 窗之后(+114s)。**记为半通过**,按本文档 §3 的口径单独记录;若要让它真通过,应提高 `autoContinueRefreshTimeoutSeconds`(当前上限 600)。
130
-
131
- ### 本轮新发现的真实风险:新会话会被立刻再次 arm(链式接续)
132
-
133
- - `09:42:49.340Z auto-continue armed: sid=session-b8f093e4…`(**即刚建出来的新会话**)→ 若无人干预,约 35s 后会再次掐掉新会话并再建一个。
134
- - 机制:`markContinuedSession(oldSid, newId)` 只给**旧**会话上闩(`isContinuedSession` 检查的是旧 sid);新会话是全新身份,不受闩保护。而新会话首题就是超大交接包,`ratio` 开局即 ≈0.053。
135
- - 本次是阈值降到 `0.05` 的**验收态放大**了它;生产阈值 `0.75` 下新会话开局不可能越线,故**当前不判定为缺陷**,但值得在 3.1 决策:新会话是否也应有一段"免接续蜜月期"。
136
- - **已处置**:`POST /auto-continue-decide {action:'reject'}` 已拆引信(`rejectedEdgeAt=1789378969340`),armed 清空。
137
-
138
- ### 收尾状态
139
-
140
- - 配置已按 §5 回滚:`autoContinueEnabled=false` / `autoContinueThreshold=0.75` / `autoContinueCooldownMinutes=30`(`handoffEnabled` 保持 `true`,与备份一致)。sha `3DEE4041F3E9`。
141
- - 回滚已**热生效**(`GET /api/dsh-auto-memory-pre/config` 内部会 `loadConfig()` 覆盖内存态;无需重启即生效,实测 `enabled:false`)——这与本文档 §2"每轮改完重启 dsh web"的旧说法不同,**热重载可用**。
142
- - 验收态快照留存:`~/.dsh/dsh-auto-memory-pre.json.bak-accept35-run1-evidence`。
143
- - **未验**:A 轮(`handoffEnabled=false`,判据 3′)、B 档"回合运行中点同意"(本次点同意时旧回合已自行 abort,`cancel` 对空转回合是空操作)。
@@ -1,90 +0,0 @@
1
- # 验收报告 · ZCode 交班对账
2
-
3
- > 验收时间:2026-09-14 02:2x–02:5x(本地)|验收方:DSH 主对话(**只做取证与复核,未改任何产品代码**)
4
- > 验收对象:ZCode 交付的三任务 + 10 项追加需求 + 交班材料(对账单见对话与 `TODO-BACKLOG.md`)
5
- > 口径:**能独立复核的写实测值;不能复核的明确标注"不可独立复核"**,不用转述充证据。
6
-
7
- ## 一、基线复核(实测)
8
-
9
- | 项 | 报告值 | 实测(命令/位置) | 判定 |
10
- | --- | --- | --- | --- |
11
- | 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` | ✅ |
12
- | GitHub main = tag | `55c3deb` | REL 线 `D:\dsh_debug\_publish_dsh-auto-memory` HEAD = `55c3deb`,tag `v2.5.0/v2.5.1/v2.5.2` 齐 | ✅ |
13
- | REL 工作树 | (未提) | 唯一未跟踪 = `.github/cloud/qq-webhook/index.zip`(发版纪律要求排除构建产物,正常) | ✅ |
14
- | pre 线 HEAD | `747aa68` | **实测 `1c06c46`** —— 多出 4 个提交,全是 `docs/`:官方 discussion #5732 评论稿 3 版 + dshapi 中转反馈稿(**非 ZCode 线,是本机 DSH 会话产出**) | ⚠️ 偏差,已更正 |
15
- | 冒烟套件 | 71 全绿 | 首次全量 **70/71**(`m73` 假红,见三)→ 夹具加固后 **71/71 全绿**,125s | ✅(修复后) |
16
- | 静态检查 | — | `node --check lib/index.js`、`lib/client.js` 均 0;两文件首三字节非 `EF BB BF` | ✅ |
17
-
18
- ## 二、10 项追加需求逐项取证(全部落到源码/文件,可独立复核)
19
-
20
- | # | 需求 | 取证点 | 判定 |
21
- | --- | --- | --- | --- |
22
- | 1 | PR #29 合并移植 | `lib/index.js:47` import `decodeZstdFramesHead`;调用点 `:1626`(巡检扫描)、`:1927`(`waterWindowForSession` 同防) | ✅ |
23
- | 2 | procedure 链路审计 + 缺口记录 | 结论落在 `TODO-BACKLOG.md` §A 末条(数据层从未产出 active procedure、`renderChecklist` 无子代理出口、`memory_recall` 无 procedures scope)——**没有独立审计文件** | ⚠️ 审计在、未单独成文 |
24
- | 3 | 白板整合预研 + 看板化评估 | `WB-GRAPH-RESEARCH-BRIEF.md`(7.7KB) / `-LOCAL.md`(21.2KB) / `-EXTERNAL.md`(33.2KB) / `WB-GRAPH-INTEGRATION-PLAN.md`(39.1KB),四份齐 | ✅ |
25
- | 4 | 云函数定时自触发 | `.github/cloud/qq-webhook/index.js:366-368` timer 分支;`triggerName=digest_dispatch`;`TIMER_MIN_GAP_HOURS=10` 防重 | ✅ |
26
- | 5 | @ 答疑限额 env 化 | `index.js:47-50` `AI_MAX_PER_HOUR`(0/缺省=不限)/`AI_QUOTA_HOURS`(默认 1h);配额落 gist | ✅ |
27
- | 6 | 日报去重(prompt + 确定性双层) | `group-digest.mjs:91-93` 30 分钟 schedule 去重;`:400` prompt 规则「不得新增重复条目」;`:417` 解析失败兜底按标题前 8 字去重 | ✅ |
28
- | 7 | 未解决事项跨期跟踪 + 自动销账 | `group-digest.mjs:327-331`(open/resolved/stale,14 天归档)、`:400` `resolved_titles` 规则、`:234` 日报渲染「✅ 已解决并移出」 | ✅ |
29
- | 8 | 反馈文件钉死 | 提交 `9f594db`「反馈文件钉死文件名(修复第一个文件换人/清空即删文件)」,code 侧仍在 | ✅ |
30
- | 9 | 思维链截断修复 | `index.js:232-249` `max_tokens: 1600` + 三层过滤(`reasoning_content` → `</think>` 切段 → 行首思考特征词剥除) | ✅ |
31
- | 10 | mention id 变更失聪修复 | `index.js:308-310` 学习改为**取最新见到的 mention** 为准;`:479` diag 暴露 `mentionLearned` | ✅ |
32
-
33
- 另:源码 `VERSION = 'webhook-gist-20260913n'`(`index.js:56`)——与"线上 n 版"的自述一致。
34
-
35
- ## 三、本轮发现并修复的问题(1 项真问题 + 1 条教训)
36
-
37
- **① `smoke-test-m73-pre.mjs` 负载敏感假红(真问题,已修)**
38
-
39
- - 现象:全量连跑 FAIL;单跑第 1 次也 FAIL,第 2 次绿 → 非确定。失败点在 N8「模型缺失 → enabled/ready」:`h.frame.payload` 为 undefined 抛 `TypeError`。
40
- - 根因:夹具 `requestTimeoutMs: 8000`,连跑时 python worker 冷启动超过窗口 → `health()` 返回**无 frame** 的失败响应(属夹具鲁棒性,不是产品缺陷)。
41
- - 修法:新增 `healthReady(c, attempts=8, gapMs=400)` 有界轮询,**只对"无 frame"重试**;9 处 `c.health()` 全部改走它。断言(`embedding.enabled/ready/error`)一字未改 —— worker 真起不来时轮询耗尽、拿最后一个无 frame 响应、断言照常失败,**不掩蔽真故障**。
42
- - 验证:单跑 3/3 绿(`pass=59 fail=0`);全量 71/71 绿。
43
-
44
- **② 教训(写进本项目纪律)**:`replace_all` 会命中**同一次编辑新加入的代码块** —— 本次把辅助函数内部的 `c.health()` 也替换成了 `healthReady(c)`,造成自递归、3 连红。替换后必须核对命中计数(预期 9 实得 10 即报警)并 `node --check`。
45
-
46
- ## 四、不可独立复核项(如实标注,不作为验收结论)
47
-
48
- - **线上云函数部署版本**:函数 URL 与 `ROUTE_TOKEN` 不在仓库(符合凭据纪律),只能由用户/群内实测确认;本报告只证明**源码 = n 版**。
49
- - **群内实战验证("没毛病了")**:外部证据,仓库侧无法复核。
50
- - **两个外部时间点**:今早 11:40 定时触发器首跑、下期日报应把「工作区切换问题」按 v2.5.2 自动销账 —— 时间未到(现 2026-09-14 02:5x),不可验。
51
-
52
- ## 五、结论
53
-
54
- 1. **ZCode 三问三答的 ①发版 ②`?report=N` 排查 ③群反馈调研**:仓库侧证据充分,成立;本机 DSH 侧对 71 套件的独立复跑同样通过(修复夹具后)。
55
- 2. **10 项追加需求**:9 项源码取证完全成立;第 2 项(procedure 审计)结论存在但未单独成文。
56
- 3. **报告偏差 2 处**(均已修正到文档):
57
- - `pre` 线 HEAD 不是 `747aa68` 而是 `1c06c46`(+4 个 docs 提交,与本机 DSH 会话的 harness bug 上报有关)。
58
- - 白板 `PLAN.md` 当时写着"下一版深改三点仍未动",**与事实相反**(水位口径 / 接续序号 / 流程外包三项已于 v2.5.0 落地并发布)——白板已重写。
59
- 4. **真正剩余的待办**只分三类:①**阻塞在用户的决策**(大排期 6 拍板点 + 3 样输入;procedure 机制整体重构)②**待外部时间点**(定时班首跑、下期日报销账)③**可排期的存量项**(`TODO-BACKLOG` §C 冷启动 5 项 / §D 分发门面 / §E 文档体系 —— 已复核仍成立,但非当前焦点)。
60
-
61
- ---
62
-
63
- ### 附:本机"会话语义检索"不可用的根因与处置(2026-09-14 追查,已实施待重启生效)
64
-
65
- **现象**:`memory_recall(scope='sessions')` 报 `session search is disabled: this deployment configures the session-query index with openAt "never"`。
66
-
67
- **根因(逐层取证;不是"没装",是"从没打开")**:
68
-
69
- 1. 抛错点在 `@deepseek-ai/dsh-session-query-sqlite/lib/index.js:594-595`:`openAt === 'never'` 时在任何 SQLite 动作之前直接抛 `SESSION_QUERY_SEARCH_DISABLED`。
70
- 2. `never` 是**随包默认**,写在 `@deepseek-ai/dsh-base/cordis.patch.yml:121-133`(该行注释原文:「Full-text session search is **opt-in**. `openAt: never` …」),配置为 `path: ':memory:'` + `openAt: never`。
71
- 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`。」
72
- 4. 本机用户层 `~/.dsh/profiles/web/cordis.patch.yml`(最后应用)原只有 3 条 `disabled: true`,**从未覆盖过这一行** → 检索一直是关的。**更正**:先前报告写「值来自 launcher 默认、属 DSH 侧改动」不准确 —— 值是 dsh-base bundle 的随包默认,而覆盖层正是**用户可改**的 profile patch。
73
- 5. 插件侧无额外开关:`lib/index.js:1804-1807` 直接调 `sq.searchSessions(...)`,没有自己的门闸 —— 唯一阻塞就是上面这一行。
74
-
75
- **处置(已落盘)**:在 `~/.dsh/profiles/web/cordis.patch.yml` 追加 id 定向覆盖(原件已备份为同目录 `cordis.patch.yml.bak-20260914-search`):
76
-
77
- ```yaml
78
- - id: session-query-sqlite
79
- config:
80
- path: 'C:/Users/JH Z/.dsh/profiles/web/session-query.db'
81
- openAt: first-search
82
- ```
83
-
84
- 关键约束:patch 对目标行是**整块 `config` 替换而非合并** → `path` 必须一并重述(`path` 是 `z.string().required()`,省略即配置非法);`path` 取 **profile 私有**路径,避免与其它 profile/进程争用同一索引文件(该索引每路径单进程持有)。
85
-
86
- **校验证据(不启动宿主,`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`。
87
-
88
- **生效条件**:宿主只在启动时读该文件 → **需用户自行重启 dsh web**;重启后首次检索即建索引(`first-search`)。副作用:Web 侧边栏搜索从"只匹配标题/工作区名"升级为内容检索。
89
-
90
- **与它无关但一直可用**:插件的跨工作区记忆检索(日志/笔记/反思)与 `handoff/` 分层转写材料 —— 本次验收全程用的是后者。