@jjh32456/dsh-longlive 1.6.8 → 1.8.0

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 (288) hide show
  1. package/CHANGELOG.md +69 -1539
  2. package/LICENSE +1 -1
  3. package/QUICKSTART.md +33 -12
  4. package/README.en.md +17 -7
  5. package/README.md +29 -10
  6. package/SPEC.md +5 -5
  7. package/cordis.patch.yml +17 -12
  8. package/docs/ANSWER-GUARD.md +92 -0
  9. package/docs/ARCHITECTURE.md +3 -3
  10. package/docs/AUTO-RECALL-WIRING.md +1 -1
  11. package/docs/AUTO-RECALL.md +15 -9
  12. package/docs/CONFIG.md +143 -37
  13. package/docs/ERRORS.md +17 -5
  14. package/docs/FAQ.md +7 -7
  15. package/docs/FEATURES.md +66 -29
  16. package/docs/MIGRATION-1.6.0.md +2 -2
  17. package/docs/OPERATIONS.md +6 -6
  18. package/docs/PANEL-INTEGRATION.md +6 -0
  19. package/docs/PRIVACY.md +88 -0
  20. package/docs/QUICKSTART.md +5 -5
  21. package/docs/README.en.md +3 -2
  22. package/docs/RESIDENT-WATCHER.md +1 -1
  23. package/docs/SESSION-WATCH.md +6 -6
  24. package/docs/TROUBLESHOOTING.md +4 -4
  25. package/package.json +42 -117
  26. package/runbook.md +2 -2
  27. package/scripts/backfill-auto-cards.mjs +98 -0
  28. package/scripts/install-surgery-task.ps1 +5 -2
  29. package/scripts/lib/session-watch-fixture.mjs +1 -1
  30. package/scripts/longlive-doctor.mjs +6 -0
  31. package/scripts/migrate-180.mjs +163 -0
  32. package/scripts/recall-index-build.mjs +128 -0
  33. package/scripts/session-watch-drill.mjs +1 -1
  34. package/scripts/surgery-run.cmd +1 -1
  35. package/scripts/unattended-surgery.ps1 +5 -2
  36. package/scripts/verify-card-anchors.mjs +138 -0
  37. package/src/actions/audit.js +125 -0
  38. package/src/actions/evidence.js +122 -0
  39. package/src/actions/fs.js +162 -0
  40. package/src/activity/index.js +129 -18
  41. package/src/activity/model.js +11 -1
  42. package/src/activity/store.js +22 -3
  43. package/src/activity/thinking.js +176 -0
  44. package/src/adapters/constants.js +11 -0
  45. package/src/adapters/engram/data/aliases.json +51 -0
  46. package/src/adapters/engram/data/policy.json +8 -0
  47. package/src/adapters/engram/data/routing-rules.json +546 -0
  48. package/src/adapters/engram/index.js +235 -0
  49. package/src/adapters/registry.js +315 -0
  50. package/src/answer/audit.js +193 -0
  51. package/src/answer/evidence.js +30 -0
  52. package/src/answer/guard.js +1370 -0
  53. package/src/answer/index.js +1067 -0
  54. package/src/answer/query.js +111 -0
  55. package/src/answer/second-hop.mjs +101 -0
  56. package/src/auto-truncate.js +1 -1
  57. package/src/config.js +145 -48
  58. package/src/deps.js +6 -4
  59. package/src/features.js +158 -8
  60. package/src/identity/index.js +13 -5
  61. package/src/identity/inject-position.js +2 -2
  62. package/src/index.js +97 -7
  63. package/src/lifecycle/gap-clocks.js +328 -0
  64. package/src/lifecycle/index.js +269 -0
  65. package/src/memory/activity-capture.js +229 -0
  66. package/src/memory/anchors.js +194 -0
  67. package/src/memory/audit-records.js +222 -0
  68. package/src/memory/auto-cards.js +401 -0
  69. package/src/memory/capture.js +442 -0
  70. package/src/memory/card-anchors.js +203 -0
  71. package/src/memory/conflicts.js +106 -0
  72. package/src/memory/decay.js +311 -0
  73. package/src/memory/distill.js +471 -0
  74. package/src/memory/event-index.js +917 -0
  75. package/src/memory/evidence-chain.js +295 -0
  76. package/src/memory/evidence.js +145 -0
  77. package/src/memory/filter-runner.js +1 -1
  78. package/src/memory/filter.js +5 -1
  79. package/src/memory/forget-v2.js +410 -0
  80. package/src/memory/forget.js +71 -0
  81. package/src/memory/frames-activation.js +247 -0
  82. package/src/memory/fts-query.js +174 -0
  83. package/src/memory/governance.js +604 -0
  84. package/src/memory/index.js +1 -0
  85. package/src/memory/l2-gate.js +169 -0
  86. package/src/memory/lock.js +121 -0
  87. package/src/memory/migrate.js +139 -0
  88. package/src/memory/recall-v2.js +223 -0
  89. package/src/memory/recall.js +65 -2
  90. package/src/memory/records.js +425 -0
  91. package/src/memory/retention.js +128 -0
  92. package/src/memory/review.js +124 -0
  93. package/src/memory/trust.js +88 -0
  94. package/src/memory/version-chain.js +264 -0
  95. package/src/memory/wal.js +137 -0
  96. package/src/memory/working-frame.js +516 -0
  97. package/src/metrics/classify.mjs +5 -3
  98. package/src/metrics/index.mjs +21 -1
  99. package/src/metrics/prestep-latency.mjs +300 -0
  100. package/src/metrics/store.mjs +25 -0
  101. package/src/policy-profile.js +18 -3
  102. package/src/recall/anaphora.mjs +87 -0
  103. package/src/recall/cards.mjs +7 -0
  104. package/src/recall/embedding.mjs +8 -8
  105. package/src/recall/entities.mjs +112 -0
  106. package/src/recall/index.js +235 -19
  107. package/src/recall/inject-order.mjs +10 -8
  108. package/src/recall/privacy.mjs +1 -1
  109. package/src/recall/recall-core.mjs +116 -10
  110. package/src/recall/shared-visibility.js +302 -0
  111. package/src/recall/time-normalizer.mjs +196 -0
  112. package/src/role/activation.js +191 -0
  113. package/src/role/attention.js +318 -0
  114. package/src/role/base.js +36 -0
  115. package/src/role/channels.js +423 -0
  116. package/src/role/index.js +425 -0
  117. package/src/role/interfaces.js +115 -0
  118. package/src/role/personality.js +370 -0
  119. package/src/role/readers.js +151 -0
  120. package/src/role/relationships.js +477 -0
  121. package/src/role/store.js +202 -0
  122. package/src/role/writeprotect.js +373 -0
  123. package/src/router/aliases.json +176 -25
  124. package/src/router/background/agent-runner.mjs +1 -1
  125. package/src/router/background/anchor.mjs +1 -1
  126. package/src/router/background/audit.mjs +2 -2
  127. package/src/router/background/budget-ledger.mjs +2 -2
  128. package/src/router/background/host-sim.mjs +1 -1
  129. package/src/router/background/memory.mjs +4 -4
  130. package/src/router/background/queue.mjs +1 -1
  131. package/src/router/background/retry.mjs +1 -1
  132. package/src/router/background/router.mjs +1 -1
  133. package/src/router/background/stream.mjs +1 -1
  134. package/src/router/background/tool-policy.mjs +1 -1
  135. package/src/router/design-headings.json +5 -5
  136. package/src/router/face/config.mjs +1 -1
  137. package/src/router/face/identity.mjs +3 -3
  138. package/src/router/judge.mjs +8 -7
  139. package/src/router/policies/generic.json +21 -4
  140. package/src/router/route.js +109 -22
  141. package/src/router/router.mjs +10 -6
  142. package/src/router/routing-rules.json +260 -445
  143. package/src/router/run-sim.mjs +8 -8
  144. package/src/router/runtime.js +23 -12
  145. package/src/router/service/config.mjs +5 -5
  146. package/src/router/service/context.mjs +1 -1
  147. package/src/router/service/queue.mjs +1 -1
  148. package/src/router/shadow.mjs +4 -3
  149. package/src/surgery-recovery.js +2 -2
  150. package/src/tool-output.js +2 -2
  151. package/src/tools.js +39 -7
  152. package/src/truncate-visible.js +2 -2
  153. package/src/ui/actions.js +1312 -0
  154. package/src/ui/panel-api.js +367 -0
  155. package/src/ui/panel-auth.js +251 -0
  156. package/src/ui/panel-integrity.js +243 -0
  157. package/src/ui/routes-readonly.js +695 -0
  158. package/src/ui/routes.js +3 -0
  159. package/docs/DEV.md +0 -279
  160. package/docs/PRESENCE-BUS-WIRING.md +0 -491
  161. package/docs/PRESENCE-BUS.md +0 -694
  162. package/docs/SURGERY.md +0 -186
  163. package/scripts/mark-core-cards.mjs +0 -289
  164. package/scripts/pack.mjs +0 -392
  165. package/scripts/router-proposals.mjs +0 -386
  166. package/src/router/fixtures/M1.json +0 -16
  167. package/src/router/fixtures/M2.json +0 -16
  168. package/src/router/fixtures/M3.json +0 -20
  169. package/src/router/fixtures/M4.json +0 -20
  170. package/src/router/fixtures/M5.json +0 -45
  171. package/src/router/fixtures/M6.json +0 -53
  172. package/src/router/fixtures/M7.json +0 -46
  173. package/src/router/fixtures/S1.json +0 -20
  174. package/src/router/fixtures/S2.json +0 -23
  175. package/src/router/fixtures/S3.json +0 -20
  176. package/src/router/fixtures/S4.json +0 -34
  177. package/src/router/fixtures/S5.json +0 -43
  178. package/src/router/fixtures/S6.json +0 -47
  179. package/src/router/fixtures/T1.json +0 -23
  180. package/src/router/fixtures/T2.json +0 -16
  181. package/src/router/fixtures/T3.json +0 -19
  182. package/src/router/fixtures/T4.json +0 -16
  183. package/src/router/fixtures/X1.json +0 -17
  184. package/src/router/fixtures/X2.json +0 -20
  185. package/src/router/gen-design-headings.mjs +0 -107
  186. package/src/router/policies/owner-rulings-2026-11-03.json +0 -62
  187. package/test/activity-realtime.test.mjs +0 -959
  188. package/test/activity-stream.test.mjs +0 -512
  189. package/test/auto-recall.test.mjs +0 -474
  190. package/test/auto-truncate.test.mjs +0 -931
  191. package/test/autobind.test.mjs +0 -399
  192. package/test/bus.test.mjs +0 -1572
  193. package/test/cli-guard.test.mjs +0 -198
  194. package/test/conclusion.test.mjs +0 -408
  195. package/test/config-schema.test.mjs +0 -210
  196. package/test/d6-output.test.mjs +0 -194
  197. package/test/d6.test.mjs +0 -395
  198. package/test/deps.test.mjs +0 -342
  199. package/test/doctor-setup.test.mjs +0 -297
  200. package/test/embedding-recall.test.mjs +0 -347
  201. package/test/feature-flags.test.mjs +0 -585
  202. package/test/filter-shadow.test.mjs +0 -170
  203. package/test/fixtures/activity-append-child.mjs +0 -29
  204. package/test/fixtures/baseline-0.8.0-registration.json +0 -556
  205. package/test/fixtures/d6-header-tools.json +0 -1
  206. package/test/fixtures/lock-child.mjs +0 -67
  207. package/test/fixtures/pre-step-container.mjs +0 -100
  208. package/test/fixtures/privacy-memory/topics/pii-unmarked.md +0 -9
  209. package/test/fixtures/privacy-memory/topics/secret-local-only.md +0 -11
  210. package/test/fixtures/profile-session-longlive-config.json +0 -20
  211. package/test/fixtures/proposal-cas-child.mjs +0 -66
  212. package/test/host-engine-status.test.mjs +0 -307
  213. package/test/hot-truncate.test.mjs +0 -1349
  214. package/test/identity-card-marker.test.mjs +0 -307
  215. package/test/identity-router/run.mjs +0 -721
  216. package/test/integration-pre-step.test.mjs +0 -553
  217. package/test/live.test.mjs +0 -1023
  218. package/test/maintenance-schedule.test.mjs +0 -538
  219. package/test/memory.test.mjs +0 -2828
  220. package/test/metrics.test.mjs +0 -478
  221. package/test/orchestrator.test.mjs +0 -266
  222. package/test/p1_probe.mjs +0 -97
  223. package/test/packaging.test.mjs +0 -184
  224. package/test/portability.test.mjs +0 -343
  225. package/test/rc4-regressions.test.mjs +0 -562
  226. package/test/rc5-regressions.test.mjs +0 -197
  227. package/test/rc6-chinese.test.mjs +0 -394
  228. package/test/router-1100/apply-off.test.mjs +0 -175
  229. package/test/router-1100/budget-reconcile.test.mjs +0 -215
  230. package/test/router-1100/config-context.test.mjs +0 -211
  231. package/test/router-1100/helpers.mjs +0 -129
  232. package/test/router-1100/hint-envelope.test.mjs +0 -150
  233. package/test/router-1100/lock-crossproc.test.mjs +0 -206
  234. package/test/router-1100/proposal-cas-crossproc.test.mjs +0 -184
  235. package/test/router-1100/router-apply.test.mjs +0 -372
  236. package/test/router-1100/router-fixb.test.mjs +0 -602
  237. package/test/router-1100/router-proposals.test.mjs +0 -405
  238. package/test/router-1100/router-queue-lease-wal.test.mjs +0 -355
  239. package/test/router-1100/router-security-cr.test.mjs +0 -333
  240. package/test/router-1100/service-lifecycle.test.mjs +0 -220
  241. package/test/router-1100/tools-contract.test.mjs +0 -164
  242. package/test/router-1100/turn-reflect-tick.test.mjs +0 -89
  243. package/test/router-1100/v6-contract.test.mjs +0 -158
  244. package/test/router-1100/v6b-contract.test.mjs +0 -293
  245. package/test/router-1100/v6c-contract.test.mjs +0 -249
  246. package/test/router-1100/wal-rotation.test.mjs +0 -375
  247. package/test/router-1100/wp1-config.test.mjs +0 -170
  248. package/test/router-1100/wp1-default-off.test.mjs +0 -77
  249. package/test/router-1100/wp1-model-status.test.mjs +0 -90
  250. package/test/router-1100/wp1-status.test.mjs +0 -220
  251. package/test/router-1100/wp1-tools.test.mjs +0 -146
  252. package/test/router-1100/wp5-cli.test.mjs +0 -240
  253. package/test/router-1100/wp5-model-auto.test.mjs +0 -418
  254. package/test/router-1100/wp6-merge.test.mjs +0 -386
  255. package/test/router-1100/wp6-wake.test.mjs +0 -502
  256. package/test/router-background/audit.test.mjs +0 -37
  257. package/test/router-background/budget-ledger.test.mjs +0 -330
  258. package/test/router-background/cross-process.test.mjs +0 -222
  259. package/test/router-background/fixtures/cross-child.mjs +0 -85
  260. package/test/router-background/fixtures/real-shapes.mjs +0 -239
  261. package/test/router-background/router.test.mjs +0 -1076
  262. package/test/router-background/stream-retry.test.mjs +0 -358
  263. package/test/router-background/tool-agent.test.mjs +0 -384
  264. package/test/router-face/bridge.test.mjs +0 -169
  265. package/test/router-face/face.test.mjs +0 -316
  266. package/test/router-failclosed.test.mjs +0 -466
  267. package/test/router-identity.test.mjs +0 -384
  268. package/test/router-l1-l2.contract.test.mjs +0 -1075
  269. package/test/router-memory-tools.test.mjs +0 -262
  270. package/test/router-policy.test.mjs +0 -225
  271. package/test/router-runtime.test.mjs +0 -438
  272. package/test/router-shadow.test.mjs +0 -287
  273. package/test/router.test.mjs +0 -903
  274. package/test/run-rc.mjs +0 -315
  275. package/test/run.mjs +0 -2469
  276. package/test/safety-defaults.test.mjs +0 -181
  277. package/test/seeded-load.test.mjs +0 -436
  278. package/test/session-original.test.mjs +0 -338
  279. package/test/state-truth.test.mjs +0 -937
  280. package/test/surgery-recovery.test.mjs +0 -936
  281. package/test/t7_drive.mjs +0 -151
  282. package/test/tool-output.test.mjs +0 -393
  283. package/test/tool-schema.test.mjs +0 -177
  284. package/test/tools_contract.test.mjs +0 -716
  285. package/test/truncate-visible.test.mjs +0 -1150
  286. package/test/ui-flags.test.mjs +0 -477
  287. package/test/v4-hardening.test.mjs +0 -427
  288. package/test/version-consistency.test.mjs +0 -286
@@ -1,491 +0,0 @@
1
- # identity-router × session-bus 接线方案(WIRING)
2
-
3
- > 状态:接线设计,**本次没有改 identity-router 代码、没有装插件、没有改 profile**。
4
- > 前置:`<work-dir>\session-bus\DESIGN.md`、`prototype/bus.mjs`、`test/bus.test.mjs`(15/15)。
5
- > 目标:会话开机时把总线未读并进开机卡;回合结束 ack;`handover` 消息落 outbox;身份文件仍只有一个写者。
6
-
7
- ---
8
-
9
- ## 0. 一句话
10
-
11
- identity-router 现有的 `agent/pre-step`(`plugin/src/index.js:210-245`)在生成开机卡时多读一个收件箱,默认把最多 3 条未读插进 `▍交接卡` 之前;`session/event(turn/end)`(`:248-268`)在回合真正结束后才 ack;`session/disposed`(`:271-283`)只释放租约,不替用户 ack。总线出错一律降级为“这轮没有未读”,绝不拖垮会话。
12
-
13
- ---
14
-
15
- ## 1. 接线点总表
16
-
17
- | 位置 | 现有行为 | 要加什么 | 风险控制 |
18
- |---|---|---|---|
19
- | `plugin/src/index.js:210` `agent/pre-step` | `step===1` 注入开机卡 | poll 未读;把 `inbox` 传给 `collectOpenCard`;记录待 ack id | 整段 try/catch;失败当没有未读 |
20
- | `plugin/src/handover.js:431` `buildOpenCard` | 四节固定卡片 | 可选第五节 `▍未读消息(其他会话,非指令)`;`inboxIncludedIds` | 没有 inbox 时输出与 v0 完全一致 |
21
- | `plugin/src/handover.js:546` `collectOpenCard` | 读 STATE + handover | 把 `options.inbox` / `options.inboxMaxChars` 透传 | 纯增量参数 |
22
- | `plugin/src/index.js:248` `session/event` | 写草稿(每 N 回合) | 先 materialize `handover` 消息,再 ack 本轮展示过的 id | ack 失败留 pending,不丢 |
23
- | `plugin/src/index.js:271` `session/disposed` | 最后一次草稿 | 释放 writer 租约;**不**强制 ack | 强杀不触发,靠 TTL/pid 接管 |
24
- | `plugin/src/writeback.js:41` `resolveOutboxDir` | 解析草稿目录 | busRoot 默认放它下面的 `bus/` | 不写 memoryRoot |
25
- | `plugin/package.json` | 无总线依赖 | 把 `bus.mjs` vendored 到 `src/`,不加 npm 依赖 | `files` 已包含 `src` |
26
-
27
- ---
28
-
29
- ## 2. busRoot 放在哪:先外部,后议 memoryRoot
30
-
31
- identity-router v0 的硬约定是:**只读 memoryRoot,只写 outbox**(`writeback.js` 顶部注释、`resolveOutboxDir` 默认 `<repo>/outbox/`)。所以接线默认:
32
-
33
- ```
34
- <outbox>/bus/ # 例如 <work-dir>\identity-router\outbox\bus
35
- ```
36
-
37
- 解析顺序:
38
-
39
- 1. `config.busRoot`(显式绝对路径);
40
- 2. `DSH_SESSION_BUS_ROOT`;
41
- 3. `path.join(resolveOutboxDir(config, env), 'bus')`;
42
- 4. 任何情况下拒绝 UNC;root 必须是本地可写目录。
43
-
44
- 这样 v0 的写范围只扩大了一个明确的子目录 `outbox/bus`,仍然不碰 `<memory-root>`。
45
-
46
- **生产升级项(本次不启用)**:`<memoryRoot>/.longlive/bus`。它与 live 登记表同根、随记忆目录备份,结构上更顺;但这是让插件写 memoryRoot,属于新的写权限,必须由 owner 单独批准,并明确“bus 归 session-bus 插件所有,identity-router 只是调用方”。不要因为 `.longlive` 已经是插件状态目录就默认合规。
47
-
48
- `memoryRoot` 的解析必须与 longlive 实际使用的一致:
49
-
50
- ```js
51
- const memoryRoot = resolveMemoryRoot(settings, process.env); // handover.js:380
52
- ```
53
-
54
- 本机实测 live 在 `<memory-root>\.longlive\live\`;如果这里解析成 `%USERPROFILE%\.dsh\longlive-memory`,所有 peer 会显示 `missing`,死会话不会被拒发。这是接线时最容易踩的坑,必须在启动日志里打一次实际路径。
55
-
56
- ---
57
-
58
- ## 3. 开机时读哪些未读
59
-
60
- ### 3.1 定义
61
-
62
- “未读”= `<busRoot>/inbox/<sessionId>/` 下所有 **pending `.json`**:
63
-
64
- - 不含 `acked/`(已确认);
65
- - 不含 `dead/`(损坏/外来,已隔离);
66
- - 不含过期(`poll` 负责删);
67
- - 不含 host 不匹配(`poll` 负责隔离);
68
- - `control` 不展示(机器协议,见 DESIGN §5.3)。
69
-
70
- **不需要游标文件**:ack 会把消息移出 pending,所以 pending 集合本身就是未读集合。开机 `poll({since: 0, limit: maxItems + 1})` 即可。`since` 只在同一回合内二次 poll 时使用;v0 默认只在 `step===1` poll 一次,所以不需要持久化 cursor。这样 identity-router 不用为游标再写一个文件,边界更干净。若这次 poll 投递了超前于本机时钟(5 分钟窗内)的消息,返回的 `cursor` 是数字时间戳而不是 id,下一轮会重放那条消息;语义见 §3.5。
71
-
72
- ### 3.2 伪代码
73
-
74
- ```js
75
- // plugin/src/index.js — pre-step 内,拿到 agent 之后
76
- const sessionId = normalizeSessionId(sessionKeyFor(agent)); // 来自 bus.mjs;失败→ warning,跳过总线
77
- const bus = getOrCreateBus(record, sessionId); // 每个会话一个句柄,缓存
78
-
79
- let inbox = null;
80
- if (bus) {
81
- try {
82
- const pending = bus.poll({ since: 0, limit: settings.busMaxItems + 1 });
83
- const usable = pending.messages.filter((m) => m.kind !== 'control');
84
- const visible = usable.slice(0, settings.busMaxItems);
85
- inbox = {
86
- messages: visible,
87
- total: usable.length + (pending.hasMore ? 1 : 0), // hasMore 只用于“还有更多”提示
88
- hasMore: pending.hasMore,
89
- };
90
- } catch (error) {
91
- logWarn(`BUS_POLL_FAILED:${error?.code ?? error?.message ?? error}`);
92
- inbox = null; // 降级:这轮没有未读
93
- }
94
- }
95
-
96
- const card = collectOpenCard({
97
- memoryRoot: settings.memoryRoot,
98
- statePath: settings.statePath,
99
- handoverDir: settings.handoverDir,
100
- maxChars: settings.maxChars,
101
- inbox: inbox ?? undefined, // 新增
102
- inboxMaxChars: settings.busMaxChars, // 新增,默认 320
103
- });
104
- // import { mergePendingAckIds } from './bus.mjs';
105
- // 1) 先重试上一轮没 ack 掉的 id(幂等,already 也算完成),仍未成功的留在
106
- // record.pendingAckIds;2) 再把本轮注入的 id 合并进来。不能无条件覆盖:
107
- // 覆盖会丢掉上一轮 ack 失败的 id,它们会一直 pending 到 TTL。
108
- if (record.bus && record.pendingAckIds?.length) {
109
- const remaining = [];
110
- for (const id of record.pendingAckIds) {
111
- try {
112
- const result = record.bus.ack(id);
113
- if (!result.ok && result.code !== 'E_NOT_FOUND') remaining.push(id);
114
- } catch (error) {
115
- remaining.push(id);
116
- logWarn(`BUS_ACK_RETRY_FAILED:${id}:${error?.code ?? error?.message ?? error}`);
117
- }
118
- }
119
- record.pendingAckIds = remaining;
120
- }
121
- record.pendingAckIds = mergePendingAckIds(record.pendingAckIds, card.inboxIncludedIds);
122
- ```
123
-
124
- 注意:
125
-
126
- - `bus.poll` 是同步的;`agent/pre-step` 是 async,但这里不需要 await。
127
- - 先 `next()` 再 poll,保持现有 waterfall 语义;下游 reject 就不注入、不 ack。
128
- - `record.opened` 仍只在注入成功后置 true;注入失败时 `pendingAckIds` 不要留(下次重来)。
129
- - **`pendingAckIds` 只能合并,不能覆盖**:`mergePendingAckIds(previous, included)` 去重、保序(旧 id 在前),幂等重试依赖它。上一轮 ack 失败的 id 必须活到下一次 `step===1`。
130
- - 卡片注入成功后**不立刻 ack**,等 `turn/end`。
131
- - **v0 只在会话首次 `pre-step` 注入一次**(`record.opened`)。同一会话之后新到的消息不会自动进上下文——总线的语义是“下次开门取信”,不是实时推送;要实时化得另做二次注入或每步 poll,见开放问题。
132
-
133
- ### 3.3 为什么 limit = maxItems + 1
134
-
135
- 多取一条用于判断“还有更多”,但只展示 `maxItems` 条;多出来的那条不展示、不 ack,留到下次。`hasMore` 为 true 时卡片尾部显示 `…另有 N 条`,N 至少为 1,精确值可以不知道(`poll` 的 `hasMore` 只说明还有)。
136
-
137
- ### 3.4 会话 id 不合法怎么办
138
-
139
- `sessionKeyFor(agent)` 可能是 UUID、`session-...` 或子代理 id。`normalizeSessionId` 只接受 `^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$`。
140
-
141
- - 合法 → lower-case 后作为 bus 身份。
142
- - 不合法(含 `:`、空格、中文等)→ 记一次 `BUS_INVALID_SESSION_ID:<id>`,**跳过总线**,不猜、不哈希。哈希会把地址变成不可预测的,别人没法 `send`。
143
- - 子代理:沿用 `skipSubagents`,默认不接总线(避免每个子脑都来抢卡)。
144
-
145
- ### 3.5 游标与 5 分钟时钟容忍窗
146
-
147
- `poll` 的 `maxClockSkewMs` 默认 300000ms(5 分钟)。发送侧用它拒绝超前墙钟的时间戳(`E_BAD_CLOCK`);接收侧把 `ts > now + 5 分钟` 的消息隔离成 `dead/<id>.future-ts.json`,不返回、不当游标。窗口**之内**的超前消息照常投递:对方时钟快几分钟不是坏消息。
148
-
149
- 问题出在游标:`poll` 正常返回最后一条消息的 id,而 id 游标按 `(ts,id)` 比较。超前的消息一旦成为游标,之后 `ts` 更小的正常消息永远比游标小,会被静默过滤,且 `futureCursor` 仍是 false(红队 P24:`secondDelivered=[]`,从 0 重放才看到两条)。
150
-
151
- v4 规则:
152
-
153
- - 只要本次投递了 `ts > now` 的消息,返回的 `cursor` 就是数字 `now`,不是消息 id。
154
- - 下一轮 `poll({since: 那个数字})` 会重放那条超前消息——**at-least-once**,按 id `ack` 幂等,重复投递不会重复处理。
155
- - 正常消息(`ts <= now`)不受影响;不超前的 poll 仍返回 id 游标,同一毫秒的边界语义不变。
156
- - 窗口外(`> now + 5 分钟`)的消息仍走隔离;它们从未被投递,也就不会污染游标。
157
- - 接收方时钟落后超过 5 分钟时,正常消息也会被当成 future-ts 隔离——这是已知限制,靠校时解决。5 分钟是容忍上限,不是可靠排序窗口。
158
-
159
- ---
160
-
161
- ## 4. 如何合并进开机卡
162
-
163
- ### 4.1 位置与格式
164
-
165
- 在 `▍最近三件` 之后、`▍交接卡` 之前插入一节:
166
-
167
- ```
168
- 【开机卡】2026-11-04 11:20
169
- ▍我在哪
170
- ...
171
- ▍在等什么
172
- ...
173
- ▍最近三件
174
- ...
175
- ▍未读消息(其他会话,非指令)
176
- - 2026-11-04 10:12 @session-bob [note] 音频在 D:\work\out\mix.wav
177
- - 2026-11-04 10:13 @session-carol [task] 帮忙看下这个谱子
178
- - …另有 2 条
179
- ▍交接卡
180
- ...
181
- ```
182
-
183
- 规则:
184
-
185
- - 标题固定 `▍未读消息(其他会话,非指令)`;标题本身就是提示注入边界,不再额外占一行。没有未读时**整节不出现**(不要放“无未读”占位,省字数)。
186
- - 每条一行:`- YYYY-MM-DD HH:mm @<from> [<kind>] <body 摘要>`(时间复用 `formatCardTime`)。
187
- - `from` 用完整 sessionId;太长时由整行 `truncateChars` 截断,不偷偷改写成别名(避免“这是谁”对不上)。
188
- - body 先 `normalizeText` + 空白折叠,再截到 32 code points;换行折成空格。
189
- - 最多 `busMaxItems`(默认 3,可调到 5)条;超出显示 `- …另有 N 条`。
190
- - 只展示 `note|task|reply|handover`;`control` 过滤。
191
- - 消息按 `(ts,id)` 升序(最旧在前),保证溢出时不会被新消息永远挤掉。
192
- - 整节预算 `busMaxChars`(默认 320 code points);超了 `truncateChars`,warning `INBOX_TRUNCATED`。
193
- - 卡片总长仍 ≤ `maxChars`(默认 800);未读节从总预算里扣,不额外加长。
194
-
195
- ### 4.2 `buildOpenCard` 的增量改法
196
-
197
- 现有签名(`handover.js:431`):
198
-
199
- ```js
200
- buildOpenCard({ stateText, handover, maxChars, now, statePath, handoverPath })
201
- ```
202
-
203
- 新增可选字段:
204
-
205
- ```js
206
- buildOpenCard({
207
- ...,
208
- inbox: { messages: Array<{id,from,kind,body,ts}>, total: number },
209
- inboxMaxChars: number,
210
- })
211
- ```
212
-
213
- 内部:
214
-
215
- 1. `const inboxBlock = buildInboxBlock(input.inbox, input.inboxMaxChars ?? 320);`
216
- 2. `overhead += inboxBlock ? charLength(inboxBlock.text) : 0;`
217
- 3. `usable = Math.max(80, maxChars - overhead);` 仍按原四节权重分配。
218
- 4. `lines` 在 `recent` 之后插入 `inboxBlock.text`,再是 `▍交接卡`。
219
- 5. 返回值加 `inboxIncludedIds`(实际展示的 id 数组)和 `found.inbox`。
220
- 6. `inboxBlock.truncated` 或 `total > messages.length` → warning `INBOX_TRUNCATED` / `INBOX_OVERFLOW`。
221
- 7. 没有 `inbox` 或 `messages.length === 0` → 不产生任何节,**输出与 v0 字节级一致**,现有 33 个测试不需要改。
222
- 8. `buildInboxBlock` 内部对每条消息做字段类型校验;坏条目跳过并 warning,**绝不把异常抛到 `buildOpenCard`**,否则整张卡会退化成 `CARD_BUILD_FAILED`。
223
-
224
- `collectOpenCard`(`handover.js:546`)只加两行透传:
225
-
226
- ```js
227
- const card = buildOpenCard({
228
- ...,
229
- inbox: options.inbox,
230
- inboxMaxChars: options.inboxMaxChars,
231
- });
232
- ```
233
-
234
- ### 4.3 预算例子(maxChars=800, inboxMaxChars=320)
235
-
236
- - 头部 + 五个标题 + 10 ≈ 100 字;
237
- - 未读节 ≤ 320 字;
238
- - 剩余约 380 字给 `我在哪/在等什么/最近三件/交接卡`,仍按 1.1/0.9/1.1/1.3 分,每节下限 24。
239
- - 如果没未读,320 字全部回到四节,和现在一样。
240
-
241
- 不要为了塞消息把 `maxChars` 调大;开机卡是每轮都进的上下文,800 已经不小。
242
-
243
- ---
244
-
245
- ## 5. ack 生命周期
246
-
247
- ### 5.1 时机
248
-
249
- | 时机 | 动作 | 理由 |
250
- |---|---|---|
251
- | `step===1` 卡片注入成功 | `record.pendingAckIds = mergePendingAckIds(record.pendingAckIds, card.inboxIncludedIds)` | 还没处理,不能 ack;与旧 id 合并,避免覆盖上一轮失败的重试 |
252
- | `turn/end` 且 `event.data.reason.kind === 'completed'` | 逐条 `bus.ack(id)` | 只有成功回合才接近“看到了并处理完” |
253
- | `turn/end` 且 `reason.kind` 为 `error` / `aborted` / 缺失 | **不** ack,保留 pendingAckIds | 宿主的 `turn/end` 在 `finally` 里发,失败回合也会来;ack 了消息就永久消失 |
254
- | `session/disposed` | **不** ack;只释放租约 | 销毁前可能没处理,宁可重投 |
255
- | 下一次 `step===1` | 先重试上一轮 pendingAckIds,再把新注入的 id 合并进去 | 幂等,重复 ack 返回 already;覆盖会让失败 id 永远 pending |
256
- | `busAckOn='never'` | 永不 ack | 只用于调试;消息会一直重投到 TTL |
257
-
258
- ### 5.2 代码位置
259
-
260
- 在 `session/event` 的 `turn/end` 分支开头(现有草稿逻辑之前):
261
-
262
- ```js
263
- // import { shouldAckOnTurnEnd } from './bus.mjs';
264
- if (event?.type === 'turn/end') {
265
- if (shouldAckOnTurnEnd(event)) {
266
- // Same key as buildCardFor: sessionKeyFor(agent), not session?.id.
267
- const record = stateFor(sessionKeyFor(agent));
268
- if (record.bus && record.pendingAckIds?.length) {
269
- const remaining = [];
270
- for (const id of record.pendingAckIds) {
271
- try {
272
- const result = record.bus.ack(id);
273
- if (!result.ok && result.code !== 'E_NOT_FOUND') remaining.push(id);
274
- } catch (error) {
275
- remaining.push(id);
276
- logWarn(`BUS_ACK_FAILED:${id}:${error?.code ?? error?.message ?? error}`);
277
- }
278
- }
279
- record.pendingAckIds = remaining;
280
- }
281
- }
282
- // 原有草稿逻辑继续(error/aborted 回合也要走到这里)
283
- }
284
- ```
285
-
286
- `shouldAckOnTurnEnd(event)` 就是 `event.type === 'turn/end' && event.data?.reason?.kind === 'completed'`;缺失/未知 reason 一律 false(fail closed)。`turn/end` 分支本身仍要执行原有草稿逻辑——只是 ack 被包在条件里,不要 `return` 掉整个分支。
287
-
288
- `E_NOT_FOUND` 视为完成(可能被上一轮 ack 掉了,或 TTL 过期被 poll 删了);其余错误保留,下次重试。
289
-
290
- **位置警告**:这段必须插在现有 `if (!settings.writeOnTurnEnd || settings.writeEveryTurns <= 0) return;` 和 `if (record.turns % settings.writeEveryTurns !== 0) return;` **之前**(`plugin/src/index.js:259-261`)。否则只有“写草稿的回合”才 ack,其它回合的消息会一直重投。`record` 键要和 `buildCardFor` 用同一个 `sessionKeyFor(agent)`;正常会话两者都是 `session.id`,异常情况下不要只按 `session?.id` 猜。
291
-
292
- ### 5.3 为什么不在注入后立刻 ack
293
-
294
- 注入成功不等于模型看到/处理;如果注入后崩溃,立刻 ack 会让消息永久消失。等到 `turn/end` 是折中:
295
-
296
- - 回合正常结束且 `reason.kind === 'completed'` → ack;
297
- - 回合以 `error` / `aborted` 结束 → 宿主 `finally` 仍发 `turn/end`,但**不** ack → 下次重投;
298
- - 回合中途崩溃 → 没有 `turn/end` → 不 ack → 下次重投;
299
- - 模型看到了但选择不处理 → 仍然 ack(at-least-once 不保证“处理”,只保证“送达”)。
300
-
301
- 需要“处理确认”的场景用 `kind:"task"` + 对方回 `kind:"reply"`,不要指望 ack 表达业务成功。
302
-
303
- ### 5.4 唤醒:live 与 cold 两条路(v0 只走邮箱)
304
-
305
- 宿主不是“不能唤醒”,v0 只是没有接:
306
-
307
- - **live 空闲会话**:`ctx.agents.get(sessionId)?.followup(msg)` 能让它开始新一轮(`asar/agent.js:597`、`asar/agent-loop.js:806-807`、`README.md:47`)。若将来接:先写 inbox(持久化成功),再 `followup` 一条“你有新 bus 消息”的短提示;`followup` 失败只 warning,消息仍在 inbox,下次 `pre-step` 照常取。
308
- - **cold 会话**:进程已退出/未启动,没有 live agent 可 `followup`;由 api-session-controller 的 resume 路径恢复(`:228,794,950`),恢复后的第一次 `agent/pre-step` poll 到消息。
309
- - **v0 的选择**:两条都不接,投递只写 inbox;延迟上界 = 对方下一次 `pre-step`。这样不依赖未稳定导出的内部 API,也不会在会话忙/重启窗口里丢消息。
310
-
311
- ---
312
-
313
- ## 6. `kind:"handover"` 消息怎么落
314
-
315
- ### 6.1 卡片里
316
-
317
- 只显示一行摘要(同其他 kind),完整内容不在卡片里展开——800 字卡片塞不下。
318
-
319
- ### 6.2 outbox 里
320
-
321
- `turn/end` ack 之前,对**本轮展示过**的 `handover` 消息逐条写:
322
-
323
- ```
324
- <outbox>/bus-handover-<ts>-<messageId>.md
325
- ```
326
-
327
- 内容:
328
-
329
- ```markdown
330
- # 来自会话总线
331
-
332
- - id: m-...
333
- - from: session-alice
334
- - to: session-bob
335
- - ts: 2026-11-04T02:12:00.000Z
336
- - kind: handover
337
-
338
- ---
339
-
340
- <body 原文>
341
- ```
342
-
343
- 规则:
344
-
345
- - 文件名含 message id,天然唯一;已存在就跳过(幂等)。
346
- - **绝不改 `handover/*.md`,绝不改 `STATE.md`**;outbox 是草稿区,合并由人/后续流程做。
347
- - body 超过 `DRAFT_MAX_CHARS`(1600)时截断并加 `<!-- truncated -->`;完整内容仍在总线 `acked/` 里(如果还没 GC)。
348
- - 写文件失败 → 这条 handover 不 ack,留在 pending 下轮重试;其他消息正常 ack。
349
- - 不需要 writer 租约:每个消息一个独立文件,不会互相覆盖。
350
- - 如果未来改成“追加到同一份草稿”,才需要 §7 的租约。
351
-
352
- ### 6.3 顺序
353
-
354
- 1. materialize handover 文件(成功/已存在);
355
- 2. 再 ack 这条消息;
356
- 3. 非 handover 消息直接 ack。
357
-
358
- 这样即使 ack 后进程崩溃,outbox 里已经有完整内容;反过来(先 ack 后写)会丢。
359
-
360
- ---
361
-
362
- ## 7. 身份文件与写者唯一
363
-
364
- ### 7.1 谁写什么
365
-
366
- | 文件 | 写者 | identity-router 的行为 |
367
- |---|---|---|
368
- | `<memoryRoot>/STATE.md` | 人/主会话 | 只读 |
369
- | `<memoryRoot>/handover/*.md` | 人 | 只读 |
370
- | `<outbox>/*.md` | identity-router | 写(现有 v0 行为) |
371
- | `<outbox>/bus-handover-*.md` | identity-router | 新增:每条 handover 消息一个文件 |
372
- | `<busRoot>/writer.lock` | 租约持有者 | 新增:只在“合并到同一份草稿”时获取 |
373
- | `<busRoot>/inbox/**` | 各会话 | 读写 |
374
-
375
- 总线不拥有身份文件;它只是把消息送到 outbox。**身份仍然是“一份 STATE + 最新 handover,所有会话读同一份”**,不存在多副本同步。
376
-
377
- ### 7.2 什么时候需要租约
378
-
379
- - v0 的 `bus-handover-<id>.md` 是每消息独立文件,**不需要**租约。
380
- - 只有以下情况需要 `claimWriter`:
381
- - 把多条 handover 合并进同一个 `outbox/merged-*.md`;
382
- - 未来直接写 `handover/*.md`(当前禁止);
383
- - 多个会话争同一个 canonical 草稿。
384
- - 获取:`const lease = bus.claimWriter({ holder: sessionId, ttlMs: settings.busWriterTtlMs })`;默认 TTL **1800000 ms(30 分钟)**。返回值含 `{ token, nonce }`,存进 `record`,**不要写日志**。
385
- - 续租:`bus.renewWriter({ nonce: lease.nonce, token: lease.token, ttlMs })`;或同 holder 再 `claimWriter`(token/nonce 不变,只刷新 `expiresAt`)。租约已过期时续租返回 `E_LEASE_LOST`,必须重新 `claimWriter` 拿新 token。
386
- - 写回:`bus.fencedWrite({ file, token: lease.token, nonce: lease.nonce, value })`;锁被新持有者接管后,旧 token 的写回抛 `E_LEASE_LOST`,不会覆盖新值。
387
- - 释放:`bus.releaseWriter({ nonce: lease.nonce, token: lease.token })`;不是 holder 返回 `not-holder`,nonce 缺失/不对返回 `bad-nonce`,不误删。
388
- - 抢不到:跳过合并,warning `BUS_LEASE_HELD:<holder>`;卡片和单消息 outbox 不受影响。
389
- - 崩溃:同 host pid 不在 → 下一次 claim 立即接管;跨 host 不存在(总线不跨机器)。
390
-
391
- ### 7.3 边界声明(必须写进插件 README)
392
-
393
- > v0 的 identity-router 只读 memoryRoot、只写 outbox。接入 session-bus 后,写范围增加 `<outbox>/bus/**` 和 `<outbox>/bus-handover-*.md`,仍然不写 memoryRoot。若要改为 `<memoryRoot>/.longlive/bus`,必须先获得 owner 对“插件写 memoryRoot”的明确批准。
394
-
395
- ---
396
-
397
- ## 8. 配置
398
-
399
- 在 `normalizeConfig`(`plugin/src/index.js:31`)增加(全部有默认值,坏值不抛):
400
-
401
- | 键 | 默认 | 范围 | 说明 |
402
- |---|---|---|---|
403
- | `busEnabled` | `false` | bool | 总开关;关闭时零 IO |
404
- | `busRoot` | `null` | path | null → `<outbox>/bus`;拒绝 UNC |
405
- | `busMaxItems` | `3` | 1..5 | 卡片最多展示几条 |
406
- | `busMaxChars` | `320` | 120..400 | 未读节预算 |
407
- | `busAckOn` | `'turn-end'` | `turn-end \| never` | ack 时机 |
408
- | `busWriterTtlMs` | `1800000`(ms) | 60000..86400000 | 30 分钟租约;单位毫秒,与 `DEFAULT_WRITER_TTL_MS` 一致 |
409
- | `busPollEveryStep` | `false` | bool | 长回合内额外 poll(节流 ≥1s,v0 不实现) |
410
- | `busMergeHandover` | `true` | bool | 是否把 handover 消息落 outbox |
411
-
412
- 环境变量:`DSH_SESSION_BUS_ENABLED`、`DSH_SESSION_BUS_ROOT`;其余走 profile 配置。
413
-
414
- ---
415
-
416
- ## 9. 失败与降级
417
-
418
- | 情况 | 行为 | 用户可见性 |
419
- |---|---|---|
420
- | `createBus` 抛错(root 权限/UNC) | `record.bus=null`,warning 一次 | 卡片无未读节;其他功能正常 |
421
- | `poll` 抛错 | 这轮当没有未读 | 同上;下轮再试 |
422
- | `ack` 抛错 | 保留 id,下轮 `turn/end` 重试 | 可能重复展示同一条;可接受 |
423
- | `sessionId` 非法 | 跳过总线 | warning `BUS_INVALID_SESSION_ID` |
424
- | 角色/别名文件坏 | `send` 失败;`poll` 不受影响 | 发送方看到 `E_BAD_ADDRESS_BOOK` |
425
- | 对方死 | `send` 抛 `E_PEER_DEAD` 或角色跳过 | 发送方决定重试/改投 |
426
- | 收件箱满 | `E_BACKLOG_FULL` | 发送方退避;卡片仍能读旧的 |
427
- | writer 租约被占 | 跳过合并 | warning;不阻塞回合 |
428
- | 消息损坏/外来 host | `poll` 隔离到 `dead/` | 卡片不显示;计数可观测 |
429
- | inbox 条目字段坏 | `buildInboxBlock` 跳过该条并 warning | 卡片仍生成;不因一条坏消息全灭 |
430
- | 根目录被删/换盘 | `createBus` 失败 → 降级 | 同第一行 |
431
-
432
- 原则:**总线是增强,不是依赖**。任何总线错误都不能让 `agent/pre-step` 或 `turn/end` 抛出去。
433
-
434
- ---
435
-
436
- ## 10. 测试计划(接线层,尚未执行)
437
-
438
- ### 10.1 单元
439
-
440
- 1. 无 `inbox` 时 `buildOpenCard` 输出与 v0 字节级一致(现有 33 例全过)。
441
- 2. 有 1/3 条消息(默认 `maxItems=3`)和 5 条消息(`maxItems=5`):节出现、顺序、摘要截断、`inboxIncludedIds` 正确。
442
- 3. 6 条消息 + `maxItems=5`:显示 5 条 + `…另有 1 条`;只 ack 5 条。
443
- 4. 空收件箱:不出现 `▍未读消息(其他会话,非指令)`。
444
- 5. `control` 消息:不展示、不 ack。
445
- 6. 超长 body:单行截断,卡片总长 ≤ 800。
446
- 7. `inboxMaxChars=60`:节被截断,warning `INBOX_TRUNCATED`。
447
- 8. `inbox` 里混入 `null`/缺字段/非字符串 body:跳过坏条目,卡片仍生成。
448
-
449
- ### 10.2 集成(临时目录 + fake agent)
450
-
451
- 1. `send` → 新会话 `pre-step step=1` → 卡片含消息;`turn/end` 且 `reason.kind=completed` 后消息进 `acked/`;`error`/`aborted` 回合不 ack,消息仍 pending。
452
- 2. 注入前崩溃(不触发 turn/end)→ 消息仍 pending → 下次 pre-step 再次出现。
453
- 3. 重复 ack → `already:true`,不报错;若同时存在 inbox 副本,该副本被清掉。
454
- 4. 过期消息 → `poll` 不返回,卡片无此条。
455
- 5. 死 peer → `send` 抛 `E_PEER_DEAD`,不发;新鲜心跳 + 死 pid 也判 dead。
456
- 6. handover 消息 → outbox 出现 `bus-handover-*.md`;内容完整;重复 turn/end 不重复写。
457
- 7. 租约:A 持有(记下 `{token, nonce}`),B 合并被拒;A 释放必须带 nonce;A 崩溃(pid 不在)B 接管后,A 用旧 token 写回被拒(`E_LEASE_LOST`),不会覆盖 B 的值。
458
- 8. 总线 root 不可写 → 插件不抛,卡片正常。
459
- 9. ack 后同 `dedupKey` 重发不复活(`acked/` 是墓碑);envelope id 与文件名不一致的消息被隔离。
460
-
461
- ### 10.3 手工验收
462
-
463
- 1. 开两个会话 A/B,A 发 `note` 给 B;B 下一轮开机卡出现一行;B 回 `reply`;A 下一轮看到。
464
- 2. 关掉 B 进程再发;B 重启后能读到(未过期)。
465
- 3. 把 B 的 live 心跳改成 10 分钟前,A 发 → `E_PEER_DEAD`;`allowDead:true` 能存。
466
- 4. 看 `acked/` 与 `dead/`,确认没有半截 JSON。
467
-
468
- ---
469
-
470
- ## 11. 上线步骤
471
-
472
- 1. `busEnabled=false` 合并代码;跑现有 33 例,确认零变化。
473
- 2. 在测试 profile 开 `busEnabled=true`,`busRoot` 指到 `<work-dir>\identity-router\outbox\bus`。
474
- 3. 只开一个会话,手工 `send` 一条 `note` 给自己,验证卡片/ack。
475
- 4. 开两个会话,验证互发、重启恢复、死会话拒发。
476
- 5. 观察一周:`BUS_POLL_FAILED`、`BUS_ACK_FAILED`、`INBOX_TRUNCATED`、`corrupt/foreignHost` 计数。
477
- 6. 再讨论是否迁到 `<memoryRoot>/.longlive/bus`(需要 owner 批准)。
478
- 7. 不要在这次只读调研里执行以上任何一步。
479
-
480
- ---
481
-
482
- ## 12. 开放问题(接线相关)
483
-
484
- 1. `buildOpenCard` 的 `inbox` 参数是否算 v0.1 破坏性变更?建议按可选字段加,默认输出不变。
485
- 2. `turn/end` 自动 ack 对 `task` 类消息是否太早?是否要 `task` 只在显式回复后 ack?
486
- 3. `busPollEveryStep` 要不要做?长回合(工具跑 10 分钟)期间消息延迟是否可接受?
487
- 4. 会话 id 非法时,是否允许配置 `busSessionId` 覆盖?还是坚持跳过?
488
- 5. handover 消息落 outbox 后,谁负责合并进 `handover/*.md`?人,还是主会话的下一轮?
489
- 6. 租约 TTL 30 分钟是否合适?长回合超过 30 分钟时,续租点够不够?
490
- 7. 未读节 320 字、3 条是否够?如果不够,是加 `maxChars` 还是改成两行摘要?
491
- 8. 同一会话存活期间新消息不自动进上下文(只在首次 pre-step 注入),这个延迟能否接受?要不要做“每 N 回合重开一次卡”或独立 `bus_poll` 工具?