dsh-retrace 0.4.148 → 0.4.151

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 (42) hide show
  1. package/README.md +15 -14
  2. package/README.zh.md +18 -10
  3. package/bin/retrace.mjs +0 -0
  4. package/lib/adapter/dsh-writer.js +2 -2
  5. package/lib/adapter/dsh.js +8 -508
  6. package/lib/archaeology-cli.js +3 -3
  7. package/lib/boot-pin.js +1 -1
  8. package/lib/client-i18n.js +22 -13
  9. package/lib/client.bundle.js +3 -3
  10. package/lib/client.js +136 -205
  11. package/lib/close-guard-client.js +2 -2
  12. package/lib/dynamic-client.js +3 -3
  13. package/lib/dynamic-host.js +8 -257
  14. package/lib/host-core.js +2 -193
  15. package/lib/http.js +3 -132
  16. package/lib/index.js +365 -862
  17. package/lib/marker-carrier.js +4 -4
  18. package/lib/platform/session-paths.js +11 -43
  19. package/lib/prewrite-guard.js +0 -28
  20. package/lib/span-semantics.js +1 -1
  21. package/lib/versioning.js +34 -2
  22. package/package.json +20 -16
  23. package/lib/adapter/compaction-backend.js +0 -92
  24. package/lib/adapter/register-compaction-backend.js +0 -93
  25. package/lib/auto-fold-scheduler.js +0 -519
  26. package/lib/badge.js +0 -65
  27. package/lib/cache-metrics.js +0 -358
  28. package/lib/context-level.js +0 -139
  29. package/lib/core-contract.js +0 -77
  30. package/lib/fold-auto.js +0 -621
  31. package/lib/fold-boundary.js +0 -1051
  32. package/lib/fold-core-text.js +0 -52
  33. package/lib/fold-core.js +0 -191
  34. package/lib/fold-summary.js +0 -168
  35. package/lib/hw3-fallback.js +0 -262
  36. package/lib/identity/code-assign.js +0 -228
  37. package/lib/identity/dedupe.js +0 -168
  38. package/lib/identity/shortcode.js +0 -782
  39. package/lib/identity/sidebar-badge.js +0 -270
  40. package/lib/identity-check-cli.js +0 -379
  41. package/lib/ledger-guard.js +0 -491
  42. package/lib/token-estimate.js +0 -91
package/lib/client.js CHANGED
@@ -16,10 +16,10 @@
16
16
  * `/api/plugins/retrace/*` registered by the Host half.
17
17
  */
18
18
  import { Component, createElement, useEffect, useRef, useState } from 'react'
19
- import { createSidebarBadge } from './identity/sidebar-badge.js'
20
- // 渲染去重核心(纯函数):同一会话只产出一组谱系标识。去重键/判定与 identity 层
21
- // **单一实现**(`lib/identity/dedupe.js`),本文件只做"喂给渲染层之前"的数据归一。
22
- import { codeKeyOf, dedupeCodeText, oneCodePerSession } from './identity/dedupe.js'
19
+ const createSidebarBadge = null
20
+ const codeKeyOf = (sessionId) => String(sessionId ?? '')
21
+ const dedupeCodeText = (text) => String(text ?? '')
22
+ const oneCodePerSession = (entries) => new Map((Array.isArray(entries) ? entries : []).map((entry, index) => [`${entry?.sessionId ?? index}`, entry]))
23
23
  import { AUDIT_CONTEXT_KIND, auditContextDefinition, carrierShadowedSeqs, carrierTargetSeq, isCarrierMarkerEvent, shadowedSeqsOfAudit, spanRangeOf } from './marker-carrier.js'
24
24
  import {
25
25
  GUARD_POLL_MS,
@@ -45,12 +45,7 @@ import {
45
45
  // dictionaries now live in lib/client-i18n.js (published per-file byte limit).
46
46
  export { en, isReopenBlocked, opFailureText, rollbackFailureText, zh }
47
47
 
48
- /* @public-strip:start */
49
- /** 公开版构建期裁剪:本仓 false;投影/public tree true ⇒ **不渲染谱系标识**(同一份代码两种呈现)。 */
50
- const SIDEBAR_BADGE_PUBLIC_BUILD = false
51
- /* @public-strip:else
52
48
  const SIDEBAR_BADGE_PUBLIC_BUILD = true
53
- @public-strip:end */
54
49
 
55
50
  export const name = 'dsh-retrace'
56
51
  // ⚠️ 只列**新基座确实存在**的客户端服务。旧名 `conversationEvents`(由已移除的
@@ -155,7 +150,7 @@ function cancelsOf(event) {
155
150
  let wire = null
156
151
 
157
152
  /**
158
- * 规范谱系标识缓存(客户端**同步渲染路径**的唯一来源)。
153
+ * 规范会话标识缓存(客户端**同步渲染路径**的唯一来源)。
159
154
  *
160
155
  * 为什么客户端不能自己算:客户端侧只有一个 FNV 兜底模块 `badge.js`,那套值与宿主
161
156
  * 的规范码(表 + 解析器)**不是同一个值** —— 横幅用 FNV、读档点视图用宿主 op,
@@ -165,9 +160,9 @@ let wire = null
165
160
  */
166
161
  const badgeBySession = new Map()
167
162
  /**
168
- * 名字缓存(id → **纯名字**),由宿主 titleMap 填充;拿不到 ⇒ 只显示谱系标识。
163
+ * 名字缓存(id → **纯名字**),由宿主 titleMap 填充;拿不到 ⇒ 只显示会话标识。
169
164
  *
170
- * 渲染去重(本轮):宿主真值标题在 pin 过之后是 `[谱系标识] 名字`;若把它原样当"名字"
165
+ * 渲染去重(本轮):宿主真值标题在 pin 过之后是 `[会话标识] 名字`;若把它原样当"名字"
171
166
  * 交给注入层再拼一次,就会拼成 `[码] [码] 名字`("一行两组码"的来源之一)。
172
167
  * ⇒ 缓存里只存**剥掉开头码组后的名字**,码由徽标单独渲染一次。
173
168
  */
@@ -179,7 +174,7 @@ const titleBySession = new Map()
179
174
  const badgeKeyOf = (id) => codeKeyOf(id)
180
175
  /** 标题里**开头连续**的码组(形状口径与注入层 CODE_PREFIX 一致:`[` + 4–24 个非空白 + `]`)。 */
181
176
  const LEADING_CODE_RE = /^\s*(?:\[[^\]\s]{4,24}\]\s*)+/
182
- /** 侧栏注入层重扫钩子(未装配 = no-op)。见 apply 里装配处与 setBadgeTitle 调用点。 */
177
+ /** 侧栏注入层重扫钩子(未装配 = no-op)。见 apply 里装配处与副作用调用点。 */
183
178
  let refreshSidebarBadges = () => {}
184
179
  function rememberBadge(sessionId, badge) {
185
180
  if (typeof badge !== 'string' || badge === '') return
@@ -192,7 +187,7 @@ function canonicalBadgeOf(sessionId) {
192
187
  return typeof hit === 'string' ? hit : ''
193
188
  }
194
189
  /**
195
- * 批量填充(宿主 badgeMap 载荷形状:`{ <verbatim id>: <谱系标识> }`);返回新增条数。
190
+ * 批量填充(宿主 badgeMap 载荷形状:`{ <verbatim id>: <会话标识> }`);返回新增条数。
196
191
  *
197
192
  * 数据源去重(本轮):同一会话在载荷里可能有多个来源 / 两种 id 形态,这里先按去重键
198
193
  * 折算成**一条**码(`oneCodePerSession`,先出现者稳定优先)再入缓存 ⇒ 渲染读到的
@@ -627,25 +622,6 @@ export function isSubagentSessionView({ sessionId, useSessions, useSession } = {
627
622
  return false
628
623
  }
629
624
 
630
- /* @public-strip:start */
631
- /** 私有:热区派生展示卡(不当普通输入渲染、不给编辑/撤回入口)。 */
632
- function isHotzoneCardMessage(event) {
633
- if (!event || event.type !== 'user/message') return false
634
- const data = event.data
635
- if (!data || typeof data !== 'object') return false
636
- return data.kind === 'hotzone' || data.source?.kind === 'hotzone'
637
- }
638
-
639
- /**
640
- * 撤回回填的私有闸:目标原本是热区卡(host 已前移到真实用户)时,
641
- * 回填文本/图片只用 host 返回的真实原文,不带卡内容。
642
- */
643
- function recallBackfillOf(result) {
644
- if (result?.value?.retargetedFromCard !== true) return null
645
- return { text: typeof result.value.text === 'string' ? result.value.text : '', content: [] }
646
- }
647
- /* @public-strip:end */
648
-
649
625
  /** One small action row per user-sent message (edit / recall). */
650
626
  const userActionsDefinition = {
651
627
  kind: 'retrace-actions',
@@ -656,10 +632,7 @@ const userActionsDefinition = {
656
632
  && (event.surfaceOp === 'append' || event.surfaceOp === undefined)
657
633
  // 一并接受 **goal 注入轮**(source.kind='goal',实测 177 例,同样带 id/content)
658
634
  && (event.data.source?.kind === 'user' || event.data.source?.kind === 'goal')
659
- /* @public-strip:start */
660
- // 私有:热区卡不是用户输入 ⇒ 不渲染编辑/撤回/回填入口(卡保持只读)。
661
- && !isHotzoneCardMessage(event)
662
- /* @public-strip:end */
635
+
663
636
  ? { id: String(event.data.id), role: 'start' }
664
637
  : null
665
638
  ),
@@ -730,9 +703,7 @@ const userReferenceDefinition = {
730
703
  // rc.2 下普通追加可能**不再显式**携带 surfaceOp:'append' ⇒ 缺省也按 append 处理
731
704
  && (event.surfaceOp === 'append' || event.surfaceOp === undefined)
732
705
  && event.data.source?.kind === 'user'
733
- /* @public-strip:start */
734
- && !isHotzoneCardMessage(event)
735
- /* @public-strip:end */
706
+
736
707
  ? { id: `ref:${String(event.data.id)}`, role: 'start' }
737
708
  : null
738
709
  ),
@@ -752,10 +723,6 @@ const userReferenceDefinition = {
752
723
  },
753
724
  }
754
725
 
755
- /* @public-strip:start */
756
- export const __hotzonePrivate = { isHotzoneCardMessage, recallBackfillOf, userActionsDefinition, userReferenceDefinition }
757
- /* @public-strip:end */
758
-
759
726
  function markerOpFromId(id) {
760
727
  for (const p of MARKER_PREFIXES) {
761
728
  // 取消标记(0.4.124 撤销撤回)必须**先于**其它 op 判:它挂在同一个 `retrace-`
@@ -769,9 +736,7 @@ function markerOpFromId(id) {
769
736
  // 回档 marker(rollback execute 写 `retrace-restore-*`)。此前不认 ⇒ 落到兜底
770
737
  // 'edit',界面把回档显示成「已编辑此消息并重新发送」。
771
738
  if (id.startsWith(`${p}-restore-`)) return 'restore'
772
- /* @public-strip:start */
773
- if (id.startsWith(`${p}-fold-`)) return 'fold'
774
- /* @public-strip:end */
739
+
775
740
  }
776
741
  return 'edit'
777
742
  }
@@ -2164,12 +2129,7 @@ function UserActionsRow({ node, sessionId, useChat, inputActions, t, useSessions
2164
2129
  ? result.value.text
2165
2130
  : textOf(content)
2166
2131
  let refillContent = content
2167
- /* @public-strip:start */
2168
- {
2169
- const forced = recallBackfillOf(result)
2170
- if (forced !== null) { echoed = forced.text; refillContent = forced.content }
2171
- }
2172
- /* @public-strip:end */
2132
+
2173
2133
  // 回填(文本 + 图片):文本同步先写;图片异步读字节/注册草稿。失败只降级为
2174
2134
  // "已回填的部分 + 可见提示 + 宿主日志",不改变撤回结果;token 防旧回填覆盖新草稿。
2175
2135
  const refillToken = beginRecallRefillToken(sessionId)
@@ -2476,13 +2436,9 @@ function RecallMarkerRow({ node, sessionId, useChat, t }) {
2476
2436
  ? (count > 1 ? t('marker.recallMany', { count }) : t('marker.recallOne'))
2477
2437
  // 回档 marker 独立文案(公共/私有两版都要有 ⇒ 放在 neutral 块之外)。
2478
2438
  : op === 'restore' ? t('marker.restore')
2479
- /* @public-strip:start */
2480
- : op === 'regenerate' ? t('marker.regenerate')
2481
- : op === 'fold' ? t('marker.fold', { count })
2482
- : t('marker.edit')
2483
- /* @public-strip:else
2439
+
2484
2440
  : op === 'regenerate' ? t('marker.regenerate') : t('marker.edit')
2485
- @public-strip:end */
2441
+
2486
2442
  // A per-marker safety-guard trip (e.g. "start a fresh conversation") and a
2487
2443
  // collective-hide hint appear once, on the first marker row.
2488
2444
  const degradedHint = !legacy && plan?.degraded === true
@@ -2825,9 +2781,9 @@ function reportJumpUnavailable(reason, detail = {}) {
2825
2781
  }
2826
2782
 
2827
2783
  /**
2828
- * 谱系标识写入 / 批量 pin 的失败要**显式报出来**(发布前审计 §B)。
2784
+ * 会话标识写入 / 批量 pin 的失败要**显式报出来**(发布前审计 §B)。
2829
2785
  *
2830
- * 静默吞错是这一族问题("冷列表里既没谱系标识也没名字")的共同形态:用户看到的是
2786
+ * 静默吞错是这一族问题("冷列表里既没会话标识也没名字")的共同形态:用户看到的是
2831
2787
  * "什么都没发生",宿主日志里也是 0 命中,无法定位。
2832
2788
  *
2833
2789
  * 两条出口都走:① 渲染器 `console.warn`(人当场可见);② `clientReport`
@@ -2844,7 +2800,7 @@ function reportBadgeFailure(op, detail) {
2844
2800
  }
2845
2801
 
2846
2802
  /**
2847
- * 谱系标识诊断(**成功路径**也要留痕,按组合去重):只有失败才报的话,"发了没到"
2803
+ * 会话标识诊断(**成功路径**也要留痕,按组合去重):只有失败才报的话,"发了没到"
2848
2804
  * 与"到了没写"在宿主日志里长得一模一样(都是 0 行)。
2849
2805
  */
2850
2806
  const badgeInfoSent = new Set()
@@ -2865,7 +2821,7 @@ function reportBadgeInfo(op, detail) {
2865
2821
  * ⚠️ 动态客户端 realm 把裸 `setTimeout/setInterval` 换成了会抛错的"教学陷阱"
2866
2822
  * (`dsh-cordis-client-runner` 的 closureTraps,见本文件 scheduleClientReport 的注释)。
2867
2823
  * 裸用会让**整个 apply 抛错** ⇒ 插件 UI 完全不注册(inject=[] definitions=0 slots=0 seats=0)。
2868
- * 真回归就是这条:一个**可选**的谱系标识数据拉取把整段初始化带崩。
2824
+ * 真回归就是这条:一个**可选**的会话标识数据拉取把整段初始化带崩。
2869
2825
  * ⇒ 一律走 `window.*`;无 window(单测/无 DOM)退到微任务。
2870
2826
  * @returns {() => void} 取消(安全,不抛)
2871
2827
  */
@@ -2882,53 +2838,19 @@ function safeSchedule(fn, delayMs) {
2882
2838
  }
2883
2839
 
2884
2840
  /**
2885
- * 冷启动批量 pin 谱系标识标题(发布前审计 §B ①)。
2841
+ * 冷启动批量 pin 会话标识标题(发布前审计 §B ①)。
2886
2842
  *
2887
2843
  * 为何由客户端发起:宿主启动时的 `bootPin(0)` 只覆盖"启动那一刻已驻留"的会话
2888
2844
  * (20×30s 窗口);窗口过后才驻留 / 当时未驻留的会话再没有机会 —— 用户看到的
2889
- * 是"列表里没有谱系标识、名字也没有"。客户端在插件装载时补一次请求(幂等:宿主对
2890
- * 已含谱系标识的会话直接跳过)。
2845
+ * 是"列表里没有会话标识、名字也没有"。客户端在插件装载时补一次请求(幂等:宿主对
2846
+ * 已含会话标识的会话直接跳过)。
2891
2847
  *
2892
2848
  * 失败处理:不静默 —— 每次失败都 reportBadgeFailure,并退避重试(宿主路由可能
2893
2849
  * 还没就绪);重试耗尽后留最后一条报告,不再继续。
2894
2850
  *
2895
2851
  * @returns {() => void} 取消挂起的重试(插件卸载时调用)
2896
2852
  */
2897
- function bootstrapBadgeTitles({ attempts = 5, delayMs = 3000 } = {}) {
2898
- // 真机上三次不同失败(not defined / not ready / HTTP 404 + 注册归零)
2899
- // ⇒ 按 「文件/脚本优先」原则,谱系标识/名字改走脚本层;此处**默认关闭**(置 true 可开)。
2900
- if (globalThis.__DSH_RETRACE_BADGE_BOOTSTRAP !== true) return () => {}
2901
-
2902
- // 一次性取全量映射(横幅同步渲染路径要用)。失败走 reportBadgeFailure,
2903
- // 不影响标题 pin 的重试链。
2904
- let mapPending
2905
- try { mapPending = callOp('badgeMap', {}) } catch (cause) { mapPending = Promise.reject(cause) }
2906
- Promise.resolve(mapPending).then((result) => {
2907
- if (result && result.ok === true) reportBadgeInfo('badgeMap', `loaded ${rememberBadgeMap(result.value?.badges)}`)
2908
- else reportBadgeFailure('badgeMap', result?.error?.message ?? 'host returned ok:false')
2909
- }).catch((cause) => reportBadgeFailure('badgeMap', cause))
2910
- let cancelTimer = () => {}
2911
- let cancelled = false
2912
- let left = attempts
2913
- const attempt = () => {
2914
- if (cancelled) return
2915
- let pending
2916
- try { pending = callOp('initBadgeTitles', {}) } catch (cause) { pending = Promise.reject(cause) }
2917
- Promise.resolve(pending).then((result) => {
2918
- if (result && result.ok === true) return
2919
- throw new Error(result?.error?.message ?? 'host returned ok:false')
2920
- }).catch((cause) => {
2921
- if (cancelled) return
2922
- left -= 1
2923
- const suffix = left > 0 ? `(retry, ${left} left)` : '(retries exhausted)'
2924
- reportBadgeFailure('initBadgeTitles', `${cause?.message ?? cause} ${suffix}`)
2925
- if (left > 0) cancelTimer = safeSchedule(attempt, delayMs)
2926
- })
2927
- }
2928
- cancelTimer = safeSchedule(attempt, 0)
2929
- return () => { cancelled = true; if (cancelTimer) cancelTimer() }
2930
- }
2931
-
2853
+ // public build: batch title-write bootstrap removed
2932
2854
  /**
2933
2855
  * Shared jump (checkpoint view): resolve the anchor key FIRST, then
2934
2856
  * switch to the chat tab and scroll the rendered row into view.
@@ -3290,7 +3212,7 @@ function rowHeightOf(row) {
3290
3212
  * Nesting is NEVER inferred by the client (no numeric ranges) — only the
3291
3213
  * server's `parent`/`children` links are followed.
3292
3214
  */
3293
- function buildDisplayRows({ versions, digests, tree, expanded, detailOpen = null, t = null }) {
3215
+ function buildDisplayRows({ versions, digests, tree, expanded, detailOpen = null, t = null, collapseQuiet = true }) {
3294
3216
  const list = Array.isArray(versions) ? versions : []
3295
3217
  // `t` is only used to detect the artifact line; a key-echo fallback keeps the
3296
3218
  // row model callable from tests (the LINE COUNT is translation-independent).
@@ -3315,6 +3237,16 @@ function buildDisplayRows({ versions, digests, tree, expanded, detailOpen = null
3315
3237
  seen.add(seq)
3316
3238
  return childrenOf(seq).reduce((sum, kid) => sum + 1 + descendants(kid, seen), 0)
3317
3239
  }
3240
+ // 防御(与上面 flatten 同因):只有当**父边界已加载**时才挂到父下;父链缺环(分页/
3241
+ // 过滤/宿主替换)⇒ 该节点自己当根:不让"祖先不在本页"把整棵子树吞掉。
3242
+ const anchoredToLoadedParent = (seq, seen = new Set()) => {
3243
+ const node = nodeOf(seq)
3244
+ if (node === undefined || node.parent === null) return false
3245
+ if (seen.has(seq) || seen.size > 4096) return true // 环/超深:按挂靠处理,由上层兜底
3246
+ seen.add(seq)
3247
+ if (!bySeq.has(node.parent)) return false // 父边界没加载 ⇒ 不能挂靠
3248
+ return true
3249
+ }
3318
3250
  // `expanded` values are the per-node DEPTH BUDGET (levels opened below that
3319
3251
  // node; `true` is the legacy one-level form). DEFAULT: COLLAPSED for every node
3320
3252
  // — nothing auto-expands, the user clicks whichever row/chip they want to open
@@ -3334,7 +3266,12 @@ function buildDisplayRows({ versions, digests, tree, expanded, detailOpen = null
3334
3266
  const record = bySeq.get(seq)
3335
3267
  if (record === undefined) return
3336
3268
  const kids = childrenOf(seq)
3337
- if (isQuiet(seq)) {
3269
+ // P1(2026-11-12 真机反馈「只渲染 4 条」的第二根因):R20 的"简单改动"折叠把
3270
+ // **静默档**从主列表里摘掉(真机 66 个读档点里 57 个是 quiet ⇒ 只剩 4 行,而顶部
3271
+ // 仍写「已显示 40」)。读档点列表的用途是"逐条挑一个回档",静默档也是**可回的读档点**
3272
+ // ⇒ 该列表关闭折叠(collapseQuiet=false),静默档照常成行、可预览/可回;时间线(全量
3273
+ // 大纲)仍保留 R20 折叠。
3274
+ if (isQuiet(seq) && collapseQuiet) {
3338
3275
  // R20: no main-timeline row. Keep the skeleton so nested content stays
3339
3276
  // reachable (the quiet node is a real node in the server forest).
3340
3277
  if (kids.length > 0) {
@@ -3427,7 +3364,7 @@ function buildDisplayRows({ versions, digests, tree, expanded, detailOpen = null
3427
3364
  const turn = roundOf(digestOf(seq)?.turn) ?? roundOf(bySeq.get(seq)?.turn)
3428
3365
  return turn === null ? kindLabel(bySeq.get(seq)?.kind, tr) : tr('timeline.round', { n: turn })
3429
3366
  }
3430
- emitGroup(list.map((record) => record.boundarySeq).filter((seq) => !isNested(seq)), 0)
3367
+ emitGroup(list.map((record) => record.boundarySeq).filter((seq) => !anchoredToLoadedParent(seq)), 0)
3431
3368
  return rows
3432
3369
  }
3433
3370
 
@@ -3668,12 +3605,15 @@ function RetraceView({ sessionId, useChat, useProjection, t, actions, store }) {
3668
3605
  const [gitBusy, setGitBusy] = useState(false)
3669
3606
  const [preview, setPreview] = useState(null)
3670
3607
  const [previewScope, setPreviewScope] = useState('both')
3671
- // 语义谱系标识:默认空,异步从 host 谱系标识表拿(工作区+序号语义)。
3608
+ // 语义会话标识:默认空,异步从 host 会话标识表拿(工作区+序号语义)。
3672
3609
  // 不用 FNV 兜底显示——该规则产出的是语义码,不是随机 hash。
3673
3610
  const [badge, setBadge] = useState('')
3674
3611
  const [rollbackBusy, setRollbackBusy] = useState(false)
3675
3612
  const [scrollTop, setScrollTop] = useState(0)
3676
3613
  const [doctor, setDoctor] = useState(null)
3614
+ // issue #7:历史版本往标题写过「[谱系标识]」前缀 ⇒ 这里给一个**手动清理**入口(只重命名标题,
3615
+ // 不动会话内容)。状态机:null | {busy} | {done:{scanned,restored,skipped,failed}} | {error}
3616
+ const [titleClean, setTitleClean] = useState(null)
3677
3617
  // boundarySeq → boundary digest record (`what` + optional `summary`). Not in
3678
3618
  // the projection wire; fetched once per open and refreshed with the list.
3679
3619
  const [digests, setDigests] = useState(null)
@@ -3759,22 +3699,9 @@ function RetraceView({ sessionId, useChat, useProjection, t, actions, store }) {
3759
3699
  timelineGet(`/doctor?sessionId=${encodeURIComponent(sessionId)}`)
3760
3700
  .then((result) => setDoctor(result?.ok === true ? result.value : null))
3761
3701
  .catch(() => setDoctor(null))
3762
- // 写入谱系标识 title(一次:如果标题已含谱系标识则跳过)。失败**不静默**:
3763
- // host 返回 ok:false 或请求抛错都要报出来(发布前审计 §B)。
3764
- callOp('setBadgeTitle', { sessionId }).then((result) => {
3765
- if (!result || result.ok !== true) {
3766
- reportBadgeFailure('setBadgeTitle', result?.error?.message ?? 'host returned ok:false')
3767
- return
3768
- }
3769
- // 渲染去重(刷新路径):pin 后标题真值变成 `[码] 名字` ⇒ 名字缓存只留纯名字,
3770
- // 再**主动重扫**侧栏。宿主改标题只产生 characterData 变更,注入层的 childList
3771
- // observer 收不到 ⇒ 不主动重扫会残留旧徽标 + 新标题码(同一行两组码)。
3772
- const pinnedTitle = result.value?.title
3773
- if (typeof pinnedTitle === 'string' && pinnedTitle !== '') rememberBadgeTitle(sessionId, pinnedTitle)
3774
- refreshSidebarBadges()
3775
- reportBadgeInfo('setBadgeTitle', `${sessionId} → ${result.value?.title ?? ''}${result.value?.alreadyTagged === true ? '(alreadyTagged)' : ''}`)
3776
- }).catch((cause) => reportBadgeFailure('setBadgeTitle', cause))
3777
- // 语义谱系标识:host 谱系标识表优先(工作区+序号);表里没有的会话
3702
+ // 会话绑定标识(session binding id)—— **只读读取**:不重命名、不写标题、
3703
+ // 不改会话内容(issue #7 对外口径)。读取失败不静默(宿主日志)。
3704
+ // 语义会话标识:host 会话标识表优先(工作区+序号);表里没有的会话
3778
3705
  // 由 host 的解析器按"钉住 + 追加"给出,不再回退 FNV。
3779
3706
  callOp('sessionBadge', { sessionId }).then((result) => {
3780
3707
  if (result && result.ok === true && typeof result.value?.badge === 'string') {
@@ -3947,6 +3874,37 @@ function RetraceView({ sessionId, useChat, useProjection, t, actions, store }) {
3947
3874
  })
3948
3875
  }
3949
3876
 
3877
+ /**
3878
+ * issue #7:把历史版本写进会话标题的插件前缀清掉(ASCII `[id]` 与全角 `【id】` 都支持;
3879
+ * 服务端只走官方 `sessionTitle.rename`,**不写会话日志/消息**;无前缀的标题原样跳过 ⇒
3880
+ * 幂等:再点一次 restored=0)。
3881
+ * 失败要**可见**(ok:false 与网络异常都落到 error 状态),不做静默兜底。
3882
+ */
3883
+ const cleanTitles = () => {
3884
+ if (!window.confirm(t('title.cleanConfirm'))) return
3885
+ setTitleClean({ busy: true })
3886
+ callOp('restoreSessionTitles', {}).then((result) => {
3887
+ if (!result || result.ok !== true) {
3888
+ const code = result?.error?.code ?? 'internal'
3889
+ setTitleClean({ error: opFailureText(code, result?.error?.message ?? null, t) })
3890
+ return
3891
+ }
3892
+ const value = result.value ?? {}
3893
+ const count = (v) => (Number.isSafeInteger(v) && v >= 0 ? v : 0)
3894
+ setTitleClean({ done: {
3895
+ scanned: count(value.scanned),
3896
+ restored: count(value.restored),
3897
+ skipped: count(value.skipped),
3898
+ failed: count(value.failed),
3899
+ // 未驻留会话:官方 rename 需要会话对象 ⇒ 打开该会话后再点一次即可清理
3900
+ pending: count(value.pending),
3901
+ } })
3902
+ }).catch((cause) => {
3903
+ // 网络/HTTP 失败同样可见(状态整体替换 ⇒ 按钮照旧可点,不留下永久禁用)
3904
+ setTitleClean({ error: opFailureText('internal', String(cause?.message ?? cause), t) })
3905
+ })
3906
+ }
3907
+
3950
3908
  const initGit = () => {
3951
3909
  if (!window.confirm(t('timeline.gitInitConfirm'))) return
3952
3910
  setGitBusy(true)
@@ -3990,7 +3948,21 @@ function RetraceView({ sessionId, useChat, useProjection, t, actions, store }) {
3990
3948
  const list = unifiedList ?? (versions ?? []).filter((record) => record?.kind !== 'replace')
3991
3949
  // Outline display list (flat when `tree` is absent; nested per the server forest).
3992
3950
  // Rows are COMPACT (ROW_H = two lines); an open detail block adds DETAIL_H per line.
3993
- const rows = buildDisplayRows({ versions: list, digests, tree, expanded, detailOpen, t })
3951
+ // ── P1 根因(2026-11-12 真机反馈「只渲染 4 条」)─────────────────────────────
3952
+ // `tree`(outline forest,lib/boundary-tree.js)是**整会话**算的:parent(C)= 覆盖 C 的
3953
+ // 那个边界。而读档点是**分页**列表(20/页),页内只带一部分边界 ⇒ 绝大多数行的 parent
3954
+ // 落在**未加载的页外**,`buildDisplayRows` 只从 `!isNested` 的根开始 emit
3955
+ //(`lib/client.js:3448`)⇒ 这些行既不渲染、也没有任何 chip 能到达 ⇒ 静默丢失
3956
+ // (真机:total 64、已加载 40、实际只渲染 4)。
3957
+ // 读档点是要"逐条看/逐条回"的清单,不是层级大纲 ⇒ 分页时**不套 forest**(扁平化),
3958
+ // 行数 = 已加载条数 = 顶部「已显示」;层级只在完整历史的大纲(versions 全量)上保留。
3959
+ const restoreMode = Array.isArray(restorePage.entries)
3960
+ const outlineTree = restoreMode ? null : tree
3961
+ // 读档点列表:不套森林 + 不折叠静默档 ⇒ 每一条已加载的读档点都占一行(可回),
3962
+ // 与顶部「已显示」严格一致;时间线(全量大纲)保持原行为。
3963
+ const rows = buildDisplayRows({
3964
+ versions: list, digests, tree: outlineTree, expanded, detailOpen, t, collapseQuiet: !restoreMode,
3965
+ })
3994
3966
  // 0.4.148: 顶部总数用 host 的 total(不是当前页长度);「已显示」才是本页行数。
3995
3967
  const totalCount = Array.isArray(restorePage.entries)
3996
3968
  ? (Number.isSafeInteger(restorePage.total) ? restorePage.total : list.length)
@@ -4078,7 +4050,9 @@ function RetraceView({ sessionId, useChat, useProjection, t, actions, store }) {
4078
4050
  // 0.4.148: 底部两块的统计一律用**全量**数据,不拿分页页充当全量。
4079
4051
  // 全量 = projection/HTTP 的 versions;拿不到时才退回当前页。
4080
4052
  const fullVersions = Array.isArray(versions) && versions.length > 0 ? versions : list
4081
- const quietRuns = quietRunsOf(fullVersions, digests)
4053
+ // 读档点模式下静默档已在列表里成行 ⇒ 底部「简单改动」块不再重复列一遍(否则同一条改动
4054
+ // 出现两处,而且那块只列不可回)。时间线模式保持原样。
4055
+ const quietRuns = restoreMode ? [] : quietRunsOf(fullVersions, digests)
4082
4056
  const toggleRun = (key) => setOpenRuns((prev) => {
4083
4057
  const next = new Map(prev instanceof Map ? prev : [])
4084
4058
  next.set(key, next.get(key) !== true)
@@ -4102,7 +4076,7 @@ function RetraceView({ sessionId, useChat, useProjection, t, actions, store }) {
4102
4076
  return createElement('div', { className: 'dsh-rt-view' }, [
4103
4077
  createElement('div', { key: 'head', className: 'dsh-rt-timeline-head' }, [
4104
4078
  createElement('span', { key: 'title', className: 'dsh-rt-timeline-title' }, t('timeline.title')),
4105
- // 会话铭牌:所有界面统一展示谱系标识,沟通任务用
4079
+ // 会话铭牌:所有界面统一展示会话标识,沟通任务用
4106
4080
  sessionId && createElement('code', { key: 'badge', className: 'dsh-rt-fork-badge-code', title: t('badge.hint') }, `[${badge}]`),
4107
4081
  createElement('button', {
4108
4082
  key: 'refresh',
@@ -4120,6 +4094,28 @@ function RetraceView({ sessionId, useChat, useProjection, t, actions, store }) {
4120
4094
  t(Array.isArray(restorePage.entries) ? 'restore.orderHint' : 'timeline.orderHint')),
4121
4095
  ]),
4122
4096
 
4097
+ // issue #7:标题旧前缀清理(一次性维护动作)。入口放读档点页顶部,结果/失败都在原地可见。
4098
+ createElement('div', { key: 'title-clean', className: 'dsh-rt-title-clean' }, [
4099
+ createElement('button', {
4100
+ key: 'clean',
4101
+ type: 'button',
4102
+ className: 'dsh-rt-chip dsh-rt-title-clean-btn',
4103
+ disabled: titleClean?.busy === true,
4104
+ onClick: cleanTitles,
4105
+ title: t('title.cleanHint'),
4106
+ }, titleClean?.busy === true ? t('title.cleaning') : t('title.clean')),
4107
+ titleClean?.done !== undefined && createElement('span', { key: 'result', className: 'dsh-rt-title-clean-result' },
4108
+ t('title.cleanDone', {
4109
+ scanned: titleClean.done.scanned,
4110
+ restored: titleClean.done.restored,
4111
+ skipped: titleClean.done.skipped,
4112
+ })
4113
+ + (titleClean.done.failed > 0 ? t('title.cleanFailedCount', { failed: titleClean.done.failed }) : '')
4114
+ + (titleClean.done.pending > 0 ? t('title.cleanPending', { pending: titleClean.done.pending }) : '')),
4115
+ titleClean?.error !== undefined && createElement('span', { key: 'error', className: 'dsh-rt-error dsh-rt-title-clean-error' },
4116
+ t('title.cleanError', { message: titleClean.error })),
4117
+ ]),
4118
+
4123
4119
  restorePage.unavailable === true && createElement('div', { key: 'host-old', className: 'dsh-rt-error dsh-rt-host-old' }, t('restore.hostTooOld')),
4124
4120
 
4125
4121
  doctor && doctor.enabled && doctor.markerCount > 0 && createElement('div', { key: 'doctor', className: 'dsh-rt-timeline-git dsh-rt-doctor' }, [
@@ -4819,8 +4815,12 @@ function whatLineList(what, summaryText, { suppressContinue = false, artifacts =
4819
4815
  // 显示错了。
4820
4816
  const mergedSame = kind !== 'recall' && nowExcerpt !== '' && nowExcerpt === firstOld
4821
4817
  if (kind === 'recall') {
4822
- // 纯撤回没有"新内容":后续的输入是另一件事,不是它的对应物。
4823
- lines.push({ kind: 'now-none', key: 'now-none', reason: 'recall' })
4818
+ // 撤回**有**内容(被撤回的原文),只是没有"新内容"(后续输入是另一件事)。
4819
+ // 旧实现无条件写「这条没有新的对应内容」当**首行** ⇒ 真机上 47/64 行都顶着
4820
+ // 这句话(读起来像数据缺失/误判)。有原文时改成如实说"撤回了 N 条(原文见下)";
4821
+ // 连原文都拿不到时,才保留那句诚实的「没有对应内容」。
4822
+ if (replacedTotal > 0) lines.push({ kind: 'recall-removed', key: 'recall-removed', count: replacedTotal })
4823
+ else lines.push({ kind: 'now-none', key: 'now-none', reason: 'recall' })
4824
4824
  } else if (mergedSame) {
4825
4825
  lines.push({ kind: 'now-same', key: 'now-same', text: nowExcerpt })
4826
4826
  } else if (nowExcerpt !== '') {
@@ -4909,6 +4909,10 @@ function whatLineElement(line, t, { onJump = null } = {}) {
4909
4909
  createElement('span', { key: 'text', className: 'dsh-rt-what-text' }, `「${line.entry.excerpt}」`),
4910
4910
  ])
4911
4911
  }
4912
+ if (line.kind === 'recall-removed') {
4913
+ // 撤回行:先说清"撤回了多少条",原文紧跟在下面(不再用"没有新内容"当标题)
4914
+ return createElement('div', { key: line.key, className: 'dsh-rt-what-more dsh-rt-what-recall' }, t('what.recallRemoved', { count: line.count }))
4915
+ }
4912
4916
  if (line.kind === 'compacted') {
4913
4917
  return createElement('div', { key: line.key, className: 'dsh-rt-what-more' }, t('what.compacted', { count: line.count }))
4914
4918
  }
@@ -4985,7 +4989,7 @@ function installCloseGuard(t) {
4985
4989
  let failures = 0
4986
4990
 
4987
4991
  /**
4988
- * 会话 id → 显示名。码一律取**规范谱系标识缓存**(宿主 badgeMap 下发);
4992
+ * 会话 id → 显示名。码一律取**规范会话标识缓存**(宿主 badgeMap 下发);
4989
4993
  * 未知时退回原始 id 占位(用户明确"原始 id 显示与否不作要求")——
4990
4994
  * **绝不**回落本地 FNV:那正是"横幅与读档点视图两个码"的来源。
4991
4995
  */
@@ -5318,85 +5322,12 @@ export function apply(ctx) {
5318
5322
  })
5319
5323
  return () => __setRecallRefillDeps(null)
5320
5324
  }, 'dsh-retrace: recall attachment refill')
5321
- // 冷启动批量 pin 谱系标识标题:客户端侧唯一的启动触发点。挂在 effect 上是为插件
5322
- // 卸载时清掉未完成的重试定时器。失败走 reportBadgeFailure(不静默)。
5323
- // ⚠️ 这是**可选**的数据拉取:任何同步异常都吞在这里并返回空 disposer,
5324
- // 让后面的 slot/Definition 注册照常执行。
5325
- ctx.effect(() => {
5326
- try { return bootstrapBadgeTitles() } catch (error) {
5327
- reportBadgeFailure('initBadgeTitles', error)
5328
- return () => {}
5329
- }
5330
- }, 'dsh-retrace: init badge titles')
5331
-
5332
- // 侧栏谱系标识注入层:**增强不替换** + MutationObserver 保活。
5333
- // 数据源 = **既有客户端谱系标识缓存**(canonicalBadgeOf,由宿主路由 badgeMap 填充)⇒ **表不进发布面**。
5325
+ // 不再自动批量重命名会话标题(issue #7):客户端启动路径零标题写入。
5326
+ // (`bootstrapBadgeTitles` 仅保留为显式内部工具;不再有启动触发点。)
5327
+ // 侧栏会话标识注入层:**增强不替换** + MutationObserver 保活。
5328
+ // 数据源 = **既有客户端会话标识缓存**(canonicalBadgeOf,由宿主路由 badgeMap 填充)⇒ **表不进发布面**。
5334
5329
  // 缓存为空时**只在本 effect 内**发一次 badgeMap(不碰默认关着的启动路径 __DSH_RETRACE_BADGE_BOOTSTRAP)。
5335
- ctx.effect(() => {
5336
- try {
5337
- const inst = createSidebarBadge({
5338
- doc: typeof document === 'undefined' ? undefined : document,
5339
- codeOf: (id) => canonicalBadgeOf(id) || null,
5340
- // 渲染去重:名字缓存里只存**纯名字**(开头码已剥)⇒ 徽标里码只出现一次。
5341
- titleOf: (id) => badgeTitleOf(id),
5342
- enabled: () => getConfig().sidebarBadge !== false,
5343
- report: (op, msg) => reportBadgeInfo('sidebarBadge', `${op}: ${msg}`),
5344
- publicBuild: SIDEBAR_BADGE_PUBLIC_BUILD,
5345
- })
5346
- if (!inst.start()) return () => {}
5347
- // 主动重扫钩子:列表刷新/标题 pin/码到手时由调用方触发(不依赖 observer 的
5348
- // childList 变更 —— characterData 变更它收不到)。dispose 时复位成 no-op。
5349
- refreshSidebarBadges = () => { try { inst.scan() } catch (error) { reportBadgeInfo('sidebarBadge', `rescan 异常: ${error?.message ?? error}`) } }
5350
- // 名字映射(只读):拿不到 ⇒ 只显示谱系标识(fail-soft)
5351
- // (懒加载):只请求**当前可见行**的标题(去重 + 300ms 去抖 + 只取未缓存 id);ids 为空 ⇒ 不发请求。
5352
- {
5353
- const pendingIds = new Set()
5354
- let debounce = null
5355
- const flush = () => {
5356
- debounce = null
5357
- const want = [...pendingIds].filter((id) => badgeTitleOf(id) === null)
5358
- pendingIds.clear()
5359
- if (want.length === 0) return
5360
- let pending
5361
- try { pending = callOp('titleMap', { ids: want }) } catch (cause) { pending = Promise.reject(cause) }
5362
- Promise.resolve(pending).then((result) => {
5363
- if (result && result.ok === true) {
5364
- // 渲染去重:入缓存前剥掉 `[码]` 前缀(只留名字),键=去重键 ⇒ 幂等。
5365
- for (const [k, v] of Object.entries(result.value?.titles ?? {})) if (typeof v === 'string' && v !== '') rememberBadgeTitle(k, v)
5366
- inst.scan()
5367
- } else reportBadgeInfo('sidebarBadge', `titleMap(懒取) 失败: ${result?.error?.message ?? 'ok:false'}`)
5368
- }).catch((cause) => reportBadgeInfo('sidebarBadge', `titleMap(懒取) 异常: ${cause?.message ?? cause}`))
5369
- }
5370
- const poke = () => {
5371
- try {
5372
- const ids = typeof inst.visibleIds === 'function' ? inst.visibleIds() : []
5373
- for (const id of ids) if (badgeTitleOf(id) === null) pendingIds.add(id)
5374
- if (pendingIds.size > 0 && debounce === null) debounce = setTimeout(flush, 300)
5375
- } catch (cause) { reportBadgeInfo('sidebarBadge', `visibleIds 异常: ${cause?.message ?? cause}`) }
5376
- }
5377
- poke()
5378
- if (typeof MutationObserver !== 'undefined') {
5379
- const mo = new MutationObserver(() => { try { poke() } catch { /* fail-soft */ } })
5380
- try { mo.observe(doc.body ?? doc.documentElement, { childList: true, subtree: true }) } catch { /* fail-soft */ }
5381
- }
5382
- }
5383
- if (badgeBySession.size === 0) {
5384
- let pending
5385
- try { pending = callOp('badgeMap', {}) } catch (cause) { pending = Promise.reject(cause) }
5386
- Promise.resolve(pending).then((result) => {
5387
- if (result && result.ok === true) { rememberBadgeMap(result.value?.badges); inst.scan() }
5388
- else reportBadgeInfo('sidebarBadge', `badgeMap 失败: ${result?.error?.message ?? 'ok:false'}`)
5389
- }).catch((cause) => reportBadgeInfo('sidebarBadge', `badgeMap 异常: ${cause?.message ?? cause}`))
5390
- }
5391
- return () => {
5392
- refreshSidebarBadges = () => {}
5393
- inst.stop()
5394
- }
5395
- } catch (error) {
5396
- reportBadgeFailure('sidebarBadge', error)
5397
- return () => {}
5398
- }
5399
- }, 'dsh-retrace: sidebar badge')
5330
+ ctx.effect(() => () => {}, 'dsh-retrace: sidebar badge')
5400
5331
  const t = ctx.locale.bind(NS)
5401
5332
 
5402
5333
  // 关闭守卫 V2:页面关闭 beforeunload 阻止(A 强拦/B 轻
@@ -63,7 +63,7 @@
63
63
  * 装配钩子受文件边界约束(client.js 归并行线):本模块的 `createGuardStore` 是 client.js
64
64
  * 唯一调用点,自绘门在那里以微任务装上(排在 client.js 自己的 beforeunload 监听之后)。
65
65
  */
66
- import { sessionBadge } from './badge.js'
66
+ const sessionBadge = () => ''
67
67
 
68
68
  /** 轮询间隔(运行中状态快照刷新)。 */
69
69
  export const GUARD_POLL_MS = 5000
@@ -117,7 +117,7 @@ export function describeReason(reason, locale = 'zh') {
117
117
  /**
118
118
  * 单个运行中会话的一行描述。
119
119
  * @param {{sessionId:string, reasons?:string[]}} item - runningSessions 元素。
120
- * @param {object} [opts] - { locale, label }(label 覆盖原始 id,如会话谱系标识)。
120
+ * @param {object} [opts] - { locale, label }(label 覆盖原始 id,如会话会话标识)。
121
121
  */
122
122
  export function sessionLine(item, { locale = 'zh', label } = {}) {
123
123
  const lang = localeOf(locale)