dsh-agent-soul 0.9.8 → 0.9.10

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.
package/CHANGELOG.md CHANGED
@@ -7,6 +7,61 @@
7
7
 
8
8
  ---
9
9
 
10
+ ## 0.9.10 · 2026-11-09
11
+
12
+ 外部复检轮 **R15(重构轮)**,3 个提交 / 13 文件 / +451 −137。**对外行为零变化**,
13
+ 四道门禁(lint / 87 测试 / 11 契约 / bundle 零 diff)全绿;特征测试先于拆分提交,拆分后一条未改。
14
+
15
+ ### 重构
16
+
17
+ - **`segment-memory.js` 的 `text()` 拆分**(#28):~150 行的编排降为 ~35 行调度 + 三个**文件私有**函数
18
+ (`collectDiaryMaterial` / `memoryBudgetPlan` / `computeRecallText`)。无新增导出,契约零变化。
19
+ 分开的五条路径(首轮整卡 / 关召回老路 / 退化 query / 粘性复用 / 按句召回)与粘性读写位置逐个比对一致,
20
+ 所有事故注释随代码搬到对应函数。
21
+
22
+ ### 修复
23
+
24
+ - **preview.html 的 CSS 已经漂移了**(#35):手工抄的那份还停在 `.soul-legend`,`styles.js` 早已是
25
+ `.soul-banner` —— 也就是说预览页一直是错的,只是没人比对过。现在同步 + 新增
26
+ `tests/preview-css.test.js` 逐字符比对(塞一个空格就红)。
27
+ - **构建会静默吞掉未登记的片段**(#32):`lib/client/` 下不在 `ORDER` 里的文件不报错、拼不进 bundle、
28
+ 页签一片空白。现在反向扫描,未登记直接构建失败并列出文件名;`DECL_RE` 同时放宽到 `let/const`
29
+ (原来顶层 `let/const` 逃过跨片段重名检查)。
30
+
31
+ ### 变更
32
+
33
+ - **`revOf` 三处逐字重复收敛到 `memory/constants.js`**(#33):快照 `+revOf`,理由已入 `SNAPSHOT_CHANGES.md`。
34
+ - `summarizeConversations` 标注废弃(#34,主流程已不用,`tests/diary.test.js` 仍经门面在测)。
35
+ **更正一处文档错误**:`askAgentToWrite` 的 `force` 参数**不是**死代码 ——
36
+ `regenerateDiary` 确实传 `{ force: true }`,手动重写在用。
37
+
38
+ ---
39
+
40
+ ## 0.9.9 · 2026-11-09
41
+
42
+ 外部复检轮 **R14**(按 `docs/HANDOFF.md` §8 只交付不发布),本会话逐条复核后合并发布。
43
+ 4 文件 / +201 −25 / 1 个提交;四条修复**全部经毒化复核**确认「不修会红」。
44
+
45
+ ### 修复
46
+
47
+ - **笔记页反复误报「已变更」**(#20):`reconcile()` 的 `changed` 判据原来按**索引对位**比较,
48
+ 索引条目顺序一变(并发写索引、新建一篇 push 到尾部)每个对位都失配 → 恒 `changed=true` → 反复写盘。
49
+ 现在按 slug 建 Map 逐条比内容,顺序无关。
50
+ - **`readNote` 返回索引里的旧值**(#21):文件被外部改写后,`loadIndex()` 给的 `chars/summary`
51
+ 与磁盘不符。现在统一走 `reconcile()`(与 `listNotes()` 同口径)。
52
+ - **长订单号/雪花 ID 被当卡号抹掉且不可恢复**(#15):原来 `\b\d{16,19}\b` 见长数字就抹。
53
+ 现在改 **Luhn 校验 + 发卡前缀(3–6 开头)** 双判;不过 Luhn 但前文紧挨「卡号/银行卡/尾号」等
54
+ 上下文词的,仍兜底照抹。真卡号漏抹概率≈0(主流发卡组织强制 Luhn),随机长订单号命中率从 100% 降到约 1/25。
55
+ - **会话下拉的扫盘兜底每次全量扫**(#2):服务不可用/无活会话时的兜底路径加 60 秒 TTL 缓存。
56
+ 代价是新会话最多晚一分钟出现在下拉里(低频低精度展示,可接受)。
57
+
58
+ ### 变更
59
+
60
+ - `lib/memory/signals.js` 新增模块内私有 `luhnLike`、`CARD_CONTEXT_RE` —— **无新增导出**,契约快照不变。
61
+ - 文档更正:`KNOWN-ISSUES` 原把 #15 的位置写成 `lib/extract.js`,实现在 `lib/memory/signals.js`。
62
+
63
+ ---
64
+
10
65
  ## 0.9.8 · 2026-11-08
11
66
 
12
67
  本版是 **R13(外部复检轮)的合并 + 一处复核修复**。R13 有 5 个提交、26 文件、+628/−157,
@@ -0,0 +1,384 @@
1
+ # 交接文档 · dsh-agent-soul `0.9.10`
2
+
3
+ > 给接手的人(或 AI)。读完这一份就能开工,不需要翻聊天记录。
4
+ > 写作时间:2026-11-08(0.9.10 于 2026-11-09 更新)· tag `v0.9.10` · npm `latest = 0.9.10`
5
+
6
+ ---
7
+
8
+ ## 最重要的一条(先读这个,再看别的)
9
+
10
+ **你负责改,不负责发。**
11
+
12
+ - ❌ **不要** `npm publish`
13
+ - ❌ **不要** 打 tag(`git tag`)
14
+ - ❌ **不要** 改 `package.json` 的 `version`
15
+ - ❌ **不要** 动 `CHANGELOG.md`
16
+
17
+ 做完之后**交付**(分支 + diff + 进度档案,格式见 §8),由委托方的常驻助手**复核后统一发布**。
18
+ 发布这件事牵涉版本号、CHANGELOG、tag、npm、安装副本同步五处一致性,还有一个我踩过的坑:
19
+ `npm publish` 之后立刻 `npm view` 会报 404,必须等 2–4 分钟传播 —— 这些由发布者一个人扛,
20
+ 不要让两边各发一半。
21
+
22
+ > 上一轮的实际情况可以佐证:上一版(`0.9.8`,含 R13 的 23 条修复)就是外部 AI 改的,
23
+ > 交付了分支 + diff + 进度档案,由本人复核后发的。**复核时发现其中一条(#1)其实没修好** ——
24
+ > 所以 §8 的交付物里必须自带「不修就红」的证据,别只写「已修」。
25
+
26
+ ---
27
+
28
+ ## 0. 一句话现状
29
+
30
+ 这是一个 DSH/Cordis 插件,给「糖糖」这个 AI 伴侣做**人格 + 记忆 + 心情 + 目的 + 笔记 + 日记**。
31
+ `0.9.1`–`0.9.8` 八天里清掉了全部 14 条 P1 与大部分 P2,目前**没有会让插件罢工的已知缺陷**,
32
+ 剩 12 条「特定条件下才发作」的问题(见 §5)。
33
+
34
+ | 指标 | 数值 |
35
+ |---|---|
36
+ | 测试 | **87** 个测试文件 / 0 失败;契约 **11** / 0 |
37
+ | 代码量 | `lib/` 97 个文件 / ~19.9k 行 |
38
+ | 运行时依赖 | **零**(`dependencies` 为空,刻意如此) |
39
+ | 支持 | Node ≥ 22.19;CI 跑 Node 22 + 24 + Windows |
40
+ | 发布物 | `lib assets docs tools cordis.patch.yml README CHANGELOG LICENSE THIRD-PARTY-NOTICES LICENSES` |
41
+
42
+ ---
43
+
44
+ ## 1. 代码从哪来
45
+
46
+ ```
47
+ 仓库:https://github.com/danshuyue/dsh-agent-soul
48
+ 分支:main(HEAD = b57d856)
49
+ 版本:0.9.8(package.json / npm / tag v0.9.8 三者一致)
50
+ 安装副本:C:\Users\Administrator\.dsh\plugins\dsh-agent-soul ← 与 main 同步
51
+ 运行日志:C:\Users\Administrator\.dsh\agents\soul.log
52
+ ```
53
+
54
+ **开工第一步:确认你拿到的是不是这个版本。**
55
+
56
+ ```bash
57
+ git log --oneline -1 # 应为 b57d856 或其后代
58
+ node -e "console.log(require('./package.json').version)" # 应为 0.9.8
59
+ git tag --list | tail -3 # 应含 v0.9.8
60
+ ```
61
+
62
+ ---
63
+
64
+ ## 2. 三条命令,先跑通再动手
65
+
66
+ ```bash
67
+ export DSH_HOME=/tmp/soul-dev TZ=UTC # Windows: $env:DSH_HOME="..."; $env:TZ="UTC"
68
+ npm test # 84 个文件,约 30–60 秒;期望「汇总:收集 84 / 执行 84 / 失败 0」
69
+ npm run lint # 期望「lint: 没有发现问题」
70
+ npm run test:contracts # 11 个,期望 0 失败
71
+ ```
72
+
73
+ `DSH_HOME` **必须**指向临时目录 —— 否则测试会写真实用户数据。
74
+ `npm test` 会先跑 `build-client.mjs` 再跑全量(构建失败会直接红)。
75
+
76
+ ---
77
+
78
+ ## 3. 结构地图(先看这 8 个文件,够你改 80% 的事)
79
+
80
+ ```
81
+ lib/index.js 插件入口:注册工具/注入段/HTTP/定时器。改行为先看这里
82
+ lib/env.js note() 日志、appendLogLine、sanitizeLogText、健康计数
83
+ lib/paths.js 所有落盘路径 + atomicWrite(所有写盘都走它)
84
+ lib/store.js 门面:把各 state 模块的导出汇总(契约快照盯的就是它)
85
+ lib/host/runtime/ 宿主装配:turns(轮次/游标)inject(注入段)tick(每回合维护)
86
+ lib/memory/ 记忆卡:card-io(读写/损坏迁移)card(合并/ref/搜索)
87
+ lib/diary/ 日记:scheduler(定时/看门狗)compose(拼素材)feed(流水/选段)
88
+ lib/http/ 设置页 API:server(路由分发/鉴权)routes/* middleware
89
+ lib/client/*.js 设置页前端片段 → 由 tools/build-client.mjs 拼成 lib/client.js
90
+ ```
91
+
92
+ **注入顺序**(`ctx.systemPrompt.context({order})`,改顺序会影响提示词结构):
93
+
94
+ ```
95
+ 230 心情 / 240 目的 / 245 笔记 / 250 记忆 / 260 人格 / 270 数据边界
96
+ ```
97
+
98
+ ---
99
+
100
+ ## 4. 工作纪律(红线,破了会出事)
101
+
102
+ ### ① 测试是门禁,不是装饰
103
+
104
+ ```bash
105
+ npm test # 全量
106
+ npm run test:contracts # 契约:导出集合、路由分支、行为 golden、依赖图、探针
107
+ ```
108
+
109
+ 新增测试就放进 `tests/`,命名 `xxx.test.js`,`tools/run-tests.mjs` 会自动收集(**不需要登记**)。
110
+ 每个文件有 180 秒超时,可用 `--timeout=<秒>` 覆盖。
111
+
112
+ **测试模板**(仓库里的自建 runner 都是这个形状):
113
+
114
+ ```js
115
+ import { mkdtempSync, mkdirSync, rmSync } from 'node:fs'
116
+ import { tmpdir } from 'node:os'
117
+ import { join, dirname } from 'node:path'
118
+ import { fileURLToPath, pathToFileURL } from 'node:url'
119
+
120
+ const root = join(dirname(fileURLToPath(import.meta.url)), '..')
121
+ const imp = (p) => import(pathToFileURL(join(root, 'lib', p)).href)
122
+ const sandbox = mkdtempSync(join(tmpdir(), 'soul-x-'))
123
+ process.env.DSH_HOME = sandbox
124
+ mkdirSync(join(sandbox, 'agents'), { recursive: true })
125
+
126
+ let passed = 0, failed = 0
127
+ const ok = (c, n) => { if (c) { passed++; console.log(` ✓ ${n}`) } else { failed++; console.error(` ✗ ${n}`) } }
128
+
129
+ // ... 断言 ...
130
+
131
+ console.log(`\n结果:${passed} 过 / ${failed} 败`)
132
+ rmSync(sandbox, { recursive: true, force: true })
133
+ process.exit(failed === 0 ? 0 : 1)
134
+ ```
135
+
136
+ ### ② 修 bug 必须证明「不修就红」(REDGREEN)
137
+
138
+ 改完代码,**把源码退回旧写法**(改源文件,不要用运行时钩子),跑测试看它红;再恢复。
139
+ 只靠「改完绿了」不算验证 —— 可能你加的断言本来就是恒真的。
140
+
141
+ > 真实教训:`0.9.8` 修 `/diary/list` 的 UTF-8 截断,第一版测试在前面加了 25 字节前缀,
142
+ > 让 400 字节的切点正好落在字与字之间 —— **修没修都是绿的**。是毒化复核才发现的假绿。
143
+ > 现在这条测试用纯中文正文(`400 % 3 = 1`),毒化后必红。
144
+
145
+ ### ③ 契约快照只能走正规通道
146
+
147
+ `tests/contract/` 下的 `exports.snapshot.json`、`behavior-golden.json` 是**基线**,
148
+ **不允许手改**。变了就:
149
+
150
+ ```bash
151
+ SOUL_UPDATE_SNAPSHOT=1 SOUL_SNAPSHOT_REASON='中文说明为什么变' node tests/contract/exports.snapshot.test.js
152
+ ```
153
+
154
+ 理由会自动记进 `tests/contract/SNAPSHOT_CHANGES.md`。**没写理由的刷新等于作弊。**
155
+
156
+ ### ④ 前端改了片段必须重建
157
+
158
+ ```bash
159
+ node tools/build-client.mjs # lib/client/*.js → lib/client.js
160
+ ```
161
+
162
+ CI 会 `git diff --exit-code -- lib/client.js tests/contract/`,忘了重建直接红。
163
+ 构建脚本会做语法/重名/符号表检查。
164
+
165
+ ### ⑤ 不许加运行时依赖
166
+
167
+ `dependencies` 必须保持为空。这不是洁癖:插件要在用户机器上零安装跑起来。
168
+
169
+ ### ⑥ 零宽字符/混合宽度这类「看起来没事」的输入,要单独想
170
+
171
+ `lib/core/prompt-guard.js` 负责把不可信数据包进边界标签。它处理:ASCII 标签、全角标签、
172
+ 混合宽度(`<`…`>`)、零宽字符(`\u200B-\u200D`)、控制字符。
173
+
174
+ ### ⑦ lint 是硬门禁
175
+
176
+ `npm run lint` → `tools/lint.mjs`,只查两条(都是真出过问题的):
177
+ 未使用的 import、测试里的恒真断言 `ok(true, …)`。
178
+ 真需要「到这里没抛就算过」,行尾写 `// lint-allow:ok-true` 并说明理由。
179
+
180
+ ### ⑧ 只在分支上改,不发布
181
+
182
+ ```bash
183
+ git switch -c fix/your-topic main # 从干净 main 拉
184
+ ```
185
+
186
+ **不 `npm publish`、不打 tag、不改 `package.json` 的 `version`、不改 `CHANGELOG.md`。**
187
+ 版本号 / 发版 / tag / 安装副本同步都由复核方统一做(见 §8)。
188
+
189
+ 理由不只是「分工」:这五处必须同时改对,两边各改一半就会出现
190
+ 「npm 上是 0.9.9、tag 是 v0.9.8、package.json 是 0.10.0」这种再也对不上的状态。
191
+
192
+ ---
193
+
194
+ ## 5. 当前遗留(3 条)
195
+
196
+ > 完整版在 [`docs/KNOWN-ISSUES.md`](KNOWN-ISSUES.md),每条带代码位置、影响、建议改法、验证程度(A 实测 / B 读代码 / C 仅归档)。
197
+ >
198
+ > **`0.9.10` 之后,「功能坏了」和「零散清理」类问题**全部清零**。** 只剩两条大文件重构 + 一条受宿主限制的。
199
+
200
+ ### 唯一的「用户能感觉到」的一条
201
+
202
+ | # | 问题 | 位置 | 建议 |
203
+ |---|---|---|---|
204
+ | **23** | 「错误边界」接不住**渲染期**异常 → 白屏 | `lib/client/app.js` | 需要 `React.Component` 基类;本 bundle 作用域里没有,**做不了**,只能等宿主暴露 |
205
+
206
+ ### 大文件重构(2 条,有依赖顺序,别反过来)
207
+
208
+ | # | 问题 | 建议 |
209
+ |---|---|---|
210
+ | **27** | `diary/compose.js` 591 行四类职责,`composeDiarySetup` 放错位置 | 先把 `composeDiarySetup` 移回 `scheduler` 或新建 `diary/agent.js`,再按职责切四块 |
211
+ | **26** | `diary/scheduler.js` 687 行混五种职责 | 拆 `diary/agent.js` + `diary/deliver.js`。**必须最后做**:它依赖 #27 的产物 |
212
+
213
+ > 已清掉的:#28(`text()` 拆成三个私有函数)、#32(构建拒绝未登记片段)、
214
+ > #33(`revOf` 收敛)、#34(死代码标注;并更正了「`force` 恒 false」这个**我方文档错误** ——
215
+ > `regenerateDiary` 实际传了 `{ force: true }`)、#35(preview CSS 已漂移,现为逐字符门禁)。
216
+
217
+ ### 明确「不修」的(想清楚了,别捡起来)
218
+
219
+ | 项 | 为什么 |
220
+ |---|---|
221
+ | 反代下 `isLoopbackRequest()` 恒真 | 代理会把 `remoteAddress` 变成 `127.0.0.1`,插件侧没有可靠信号区分真实远端。`DSH_SOUL_TRUSTED_PROXY` **只用于分桶与日志,不参与授权** —— 把那两个可伪造的头当授权依据就是提权漏洞 |
222
+ | 跨进程写卡不自动重写 | 已检测+告警;自动重写要给**每次**写盘加成本,而多进程并发是低频 |
223
+ | P3 大部分 | 改了不解决任何用户问题 |
224
+
225
+ ### 仍「待确认」的 2 条(依赖宿主行为,仓库里验不了)
226
+
227
+ | 项 | 兜法 |
228
+ |---|---|
229
+ | 压缩会话的 `snapshotEvents` 会不会抛 | 抛了也不推进锁:游标一定推进、整卡注入只宽限一次。**报「新会话没人格」先查这里** |
230
+ | 反代 + 非默认端口下 `Origin`/`Host` 形态 | 已按规范化权威比较;被拒时 403 响应体带 `origin`/`host` 可对照 |
231
+
232
+ ---
233
+
234
+ ## 6. 建议的下一轮顺序(0.9.9 后)
235
+
236
+ **功能类与清理类问题已清零**,只剩两条大文件重构。顺序是硬约束(先 #27 后 #26):
237
+
238
+ 1. **`#27 diary/compose.js`(591 行四职责)** —— 先把 `composeDiarySetup` 移到 `scheduler`
239
+ 或新建的 `diary/agent.js`,再按职责切四块。
240
+ 2. **`#26 diary/scheduler.js`(687 行五职责)** —— 拆 `diary/agent.js` + `diary/deliver.js`。
241
+ **必须放最后**:它依赖 #27 的产物,先拆它会把 compose 的边界搞得更乱。
242
+ 3. **`#23`** —— 除非宿主文档明确暴露了 `React.Component`,否则不要动。
243
+
244
+ > 重构的纪律(R15 已验证有效,照抄):
245
+ > **先补特征测试钉住当下行为 → 再拆 → 特征测试一条不改必须全绿 → 毒化一次证明测试网有效。**
246
+ >
247
+ > R15 的两个实践细节值得学:
248
+ > ① 特征测试**单独一个提交**、并且要在**拆分之前**就在旧代码上全绿 —— 否则它可能断言的是实现;
249
+ > ② 毒化点要选对:R15 第一版选了「粘性复用分支」,但召回是确定性的、重算结果字节相同 → 不会红,
250
+ > 换到「回声头」才红。**毒化不红时,先怀疑毒化点选错了,别急着怀疑测试无效。**
251
+
252
+ ---
253
+
254
+ ## 7. 环境坑(Windows 为主,踩过才知道)
255
+
256
+ | 坑 | 表现 | 解法 |
257
+ |---|---|---|
258
+ | PowerShell 5.1 的 `Get-Content`/`ConvertFrom-Json` | 中文变乱码、UTF-8 被当 GBK | 用 `write`/`read` 工具编辑文件;或 `[System.IO.File]::ReadAllText($p, [Text.Encoding]::UTF8)` |
259
+ | `Set-Content -Encoding utf8` | 加 BOM,JSON 解析失败 | 用 `[System.IO.File]::WriteAllText($p, $s, (New-Object Text.UTF8Encoding($false)))` |
260
+ | CRLF | 多行字符串 `match`/`replace` 锚点对不上 | 用 `\r?\n` 的正则,别用字面换行 |
261
+ | 测试互相踩 `DSH_HOME` | 随机 ENOENT / 数据串味 | 每个测试文件 `mkdtempSync` 独立目录,结束时删 |
262
+ | 时区 | 日期相关断言漂 | 跑测试固定 `TZ=UTC`;代码里**不要**再用 `toISOString().slice(0,10)` 当本地日期 |
263
+ | `gh` 偶发 502 | 查不到 CI | 抓 `https://github.com/<repo>/actions` 页面看「completed successfully / failure」 |
264
+ | npm publish 后立刻 `npm view` | 报 404 / notarget | **发布方的事**;你在交付里别碰发布,就不会踩到 |
265
+
266
+ ---
267
+
268
+ ## 8. 交付流程(你只交付,不发布)
269
+
270
+ ### 8.1 你要做的
271
+
272
+ ```bash
273
+ # 1. 从干净的 main 拉一个分支(不要直接在 main 上改)
274
+ git switch -c fix/your-topic main
275
+
276
+ # 2. 改代码 + 补测试 + 走 REDGREEN(§4②)
277
+
278
+ # 3. 验证(三道,缺一不可)
279
+ npm run lint
280
+ npm test
281
+ npm run test:contracts
282
+ git diff --exit-code -- lib/client.js tests/contract/ # 必须干净
283
+
284
+ # 4. 提交到**自己的分支**(不推 main)
285
+ git add -A && git commit -m "..."
286
+
287
+ # 5. 打包交付物(见 8.2)
288
+ ```
289
+
290
+ **不要做的事**:`npm publish` / `git tag` / 改 `package.json` 的 `version` / 改 `CHANGELOG.md`。
291
+
292
+ > 版本号、CHANGELOG、tag、npm、安装副本这五处的一致性由发布者统一处理。
293
+ > 你改了版本号,合并时就要多解一次冲突,而冲突解法一旦错,发布的版本号就是错的那一个。
294
+
295
+ ### 8.2 交付物(四样,缺一样复核就会慢一半)
296
+
297
+ | 交付物 | 内容 | 为什么需要 |
298
+ |---|---|---|
299
+ | **分支** | `fix/your-topic`(能 push 到远端最好;不能就给 diff) | 复核时我会直接合并 + 跑全量,比看 diff 可靠 |
300
+ | **diff 文件** | `git diff main...fix/your-topic > xxx.diff`,并报「N 文件 / +A / −D」 | 快速对账:我合并后 `git diff --stat` 必须和你报的一致 |
301
+ | **进度档案** | 每条修复一个编号:**症状 → 改法 → 证据** | 「已修」两个字在上一轮骗过人(#1) |
302
+ | **测试证据** | 每条修复对应哪个测试、断言几条、**毒化后是否变红** | 这是唯一能证明「真修了」的东西 |
303
+
304
+ **进度档案模板**(每条都这么写):
305
+
306
+ ```md
307
+ ### #20 notes reconcile 按索引对位比较
308
+
309
+ - 症状:笔记页反复显示「已变更」;顺序一变就误报
310
+ - 位置:lib/notes.js:reconcile()
311
+ - 改法:改按 slug 建 Map 比较
312
+ - 测试:tests/xxx.test.js 第 3 节,5 条断言
313
+ - REDGREEN:把比较改回索引对位 → 第 4、5 条断言变红;恢复 → 绿
314
+ - 兼容性:老索引文件是否需要迁移?说明结论
315
+ ```
316
+
317
+ ### 8.3 复核会看什么(提前对齐,省一轮返工)
318
+
319
+ 1. **合并后**全量测试 + 契约 + lint 是否仍绿(不是你那棵树绿,是**合并进 main 之后**绿);
320
+ 2. **`lib/client.js` 能不能重建**:我会跑 `node tools/build-client.mjs` 要求零 diff;
321
+ 顺带检查 `d243fd7` 加的第三方署名注释没被覆盖;
322
+ 3. **有没有偷偷改既有测试**:`git diff main -- tests/` 里除了新增文件,其余改动要能解释;
323
+ 4. **契约基线是否走正规通道**:`SNAPSHOT_CHANGES.md` 里有没有带理由的记录;
324
+ 5. **逐条 REDGREEN 抽查**:我会挑 1–3 条自己毒化一遍,看是不是真红;
325
+ 6. **有没有顺手引入新依赖 / 硬编码路径 / 平台假设**。
326
+
327
+ 上一轮就是第 5 条抓出的问题:`#1` 的修复声称已修,测试也加了,
328
+ 但补的测试**修没修都是绿的**(前缀字节数让 UTF-8 切点正好落在字与字之间)。
329
+
330
+ ### 8.4 发布由谁做
331
+
332
+ 复核通过后,由委托方的常驻助手统一执行:
333
+
334
+ ```bash
335
+ # 版本号 / CHANGELOG / tag / npm / 安装副本同步 —— 这五步只在一处做
336
+ ```
337
+
338
+ 所以你在交付文档里**只要说清「改了什么、为什么、怎么验」**,不需要替我考虑发版。
339
+
340
+ ---
341
+
342
+ ## 9. 排查线索
343
+
344
+ ```
345
+ C:\Users\Administrator\.dsh\agents\soul.log ← 第一手线索,永远先看这里
346
+ ```
347
+
348
+ 日志是**本地时间**、带 `+08:00` 偏移。关键 tag:
349
+ `[apply]` 启动/装配 · `[api]` 接口 · `[memory]` 记忆 · `[diary]` 日记 · `[mood]` 心情 ·
350
+ `[tick]` 每回合维护 · `[extract]` 提取 · `[attest]` 装配证词。
351
+
352
+ **几条「看着像 bug 其实不是」的日志**:
353
+
354
+ | 日志 | 真相 |
355
+ |---|---|
356
+ | `[mood] 心情判定用的是自定义 provider「xxx」(不是 siliconflow)…` | 一次性告警,提醒「宿主不认识这个 provider 会让心情静默停摆」。看到它就往下翻一行确认判定是否成功 |
357
+ | `[memory]「想起来了」被去重挡空,已把去重表收到 N 条重试` | 设计好的退化:全被挡掉时缩小去重表重试,不会注入空段 |
358
+ | `[diary] 2026-11-xx 两篇都已写完,跳过` | 看门狗每 60 分钟检查一次,正常 |
359
+ | `[api] 设置页接口已注册` 后紧跟 `[diary] 看门狗已启动` | 正常启动序列,共约 11 行 |
360
+
361
+ ---
362
+
363
+ ## 10. 交接边界(这些不要自作主张)
364
+
365
+ 1. **不要发布** —— 不 `npm publish`、不打 tag、不改版本号、不改 `CHANGELOG.md`(见 §8)。
366
+ 2. **不要给鉴权加 trust-proxy 授权** —— 见 §5「明确不修」第一条。
367
+ 3. **不要手改 `tests/contract/*.json`** —— 走 `SOUL_UPDATE_SNAPSHOT`。
368
+ 4. **不要在读取路径写盘** —— `readCardQuietly` 就是为此而存在的:
369
+ `loadCard` 会 `parkCorrupt`(把坏卡改名+置只读),读取路径**绝不能**用它。
370
+ 5. **不要动 `lib/client.js`**(构建产物)—— 改 `lib/client/*.js` 片段后重建。
371
+ 6. **不要给 `lib/index.js` 的注入段改顺序** —— 顺序决定提示词结构,改了要同步契约与文档。
372
+ 7. **不要在源码里写死盘符、用户名、IP** —— 测试与公开仓库都会带上。
373
+
374
+ ---
375
+
376
+ ## 11. 一句话给接手的人
377
+
378
+ 这个项目最大的风险不是「功能不够」,而是**「看起来绿了,其实没测到」**。
379
+ `0.9.8` 里那条 UTF-8 bug 就是这么漏出去的:修复写了、测试也补了,但补的测试是假绿 ——
380
+ 而它正是上一轮外部交接时漏过来的。
381
+
382
+ 所以规矩只有一条:**改完先证明「不修会红」,再证明「修了会绿」。**
383
+
384
+ 至于发布:**你只管把证据备齐,发不发、什么时候发,由复核方定。**
@@ -1,7 +1,16 @@
1
- # 已知问题清单(截至 0.9.7;2026-11-08 R13 轮划掉 23 条)
1
+ # 已知问题清单(截至 0.9.10;R13 划 23 条、R14 划 4 条、R15 划 5 条)
2
2
 
3
3
  > 2026-11-08 R13 轮:~~划线~~ 条目已修,测试锚定在 `tests/r13-batch.test.js`(36 断言),
4
- > 修法见提交历史(fix/known-issues-r13 分支 R13 批次一~五)。仍打开:#2 #15 #20 #21 #23 #26–#28 #32–#35 与第五、六节。
4
+ > 修法见提交历史(fix/known-issues-r13 分支 R13 批次一~五)。
5
+ >
6
+ > **2026-11-09 R14 轮(0.9.9)**:又划掉 **#2 #15 #20 #21** 四条,测试锚定在
7
+ > `tests/r14-notes-redact-sessions.test.js`(13 断言),四条均经发布方毒化复核为红。
8
+ >
9
+ > **2026-11-09 R15 轮(0.9.10,重构)**:划掉 **#28 #32 #33 #34 #35**。
10
+ > #28 的 `text()` 拆成三个文件私有函数(无新导出,契约只多了 #33 的 `revOf`);
11
+ > 特征测试 `tests/r15-segment-feature.test.js`(13 断言)**先于拆分提交**,拆分后一条不改全绿。
12
+ > #35 是**真问题**:preview 的 CSS 确实已经漂移到旧类名,现在是逐字符比对的硬门禁。
13
+ > **仍打开:#23 #26 #27 与第五、六节。**
5
14
  >
6
15
  > **2026-11-08 复核补丁(0.9.8)**:R13 的 #1(`/diary/list` 只读头部 400 字节)按字节切 UTF-8,
7
16
  > 中文预览末尾会出现 `�`(U+FFFD)—— 400 % 3 ≠ 0,边界必然落在汉字中间。
@@ -13,8 +22,8 @@
13
22
  > 每条都标了「验证程度」,方便判断可信度:
14
23
  > **A = 读代码 + 实测复现过**,**B = 读代码确认**,**C = 只按报告描述归档,未逐行核**。
15
24
  >
16
- > 状态:`0.9.1`–`0.9.6` 清掉了全部 14 条 P1 与大部分 P2。下面剩下的**没有一条会立刻让插件罢工**,
17
- > 但每一条都会在特定条件下让人踩到。
25
+ > 状态:`0.9.1`–`0.9.6` 清掉全部 14 条 P1 与大部分 P2;R13 清 23 条、R14 清 4 条。
26
+ > 下面剩下的**没有一条会立刻让插件罢工**,但每一条都会在特定条件下让人踩到。
18
27
 
19
28
  ---
20
29
 
@@ -23,7 +32,7 @@
23
32
  | # | 问题 | 位置 | 影响 | 建议 | 验证 |
24
33
  |---|---|---|---|---|---|
25
34
  | ~~1~~ ✅已修(2026-11-08 R13) | `/diary/list` 循环 30 天**全量**读日记,只取前 400 字 | `lib/http/routes/diary.js` | 每天 2 次请求,30 天 × 全量读 → 打开日记标签页要等一下 | 读前 400 字节(`readFileSync` 带 `length`),或按需懒加载 | B |
26
- | 2 | `/diary/sessions` 两层 `readdir` + 逐目录 `stat` 兜底 | `lib/http/sessions.js` | 会话目录多时列表慢 | 加 TTL 缓存 + `withFileTypes` 一次拿全 | B |
35
+ | ~~2~~ ✅已修(2026-11-09 R14) | `/diary/sessions` 两层 `readdir` + 逐目录 `stat` 兜底 | `lib/http/sessions.js` | 会话目录多时列表慢 | 加 TTL 缓存 + `withFileTypes` 一次拿全 | B |
27
36
  | ~~3~~ ✅已修(2026-11-08 R13) | `saveCard` 每次写盘前**完整解析旧文件**(只为判断能否备份)+ `copyFileSync` | `lib/memory/card-io.js` | 记忆写入路径多一次全量解析 | 本进程写过的可跳过解析;备份改硬链接/懒备份 | B |
28
37
  | ~~4~~ ✅已修(2026-11-08 R13) | `recallArchived` 读**全部**归档分片再截 tail | `lib/memory/card-io.js` | 归档攒多之后查历史慢 | 旧分片只读尾块 | B |
29
38
  | ~~5~~ ✅已修(2026-11-08 R13) | v1→v2 迁移失败时,每次 `loadCard` 都重试写盘 + 刷日志(且改写 mtime 使缓存 stamp 永远失配) | `lib/memory/card-io.js` | 一张老卡能刷满日志、并让缓存失效 | 迁移失败加退避 + `note` 节流;别在读取路径写盘 | B |
@@ -46,13 +55,13 @@
46
55
  | ~~12~~ ✅已修(2026-11-08 R13) | `validateConfigEntry` 的控制字符黑名单漏 C1 区(`\u0080-\u009F`)与 `U+2028/2029` | `lib/http/middleware.js` | 某些行分隔符能进配置值 | 改用 `/\p{Cc}\|[\u2028\u2029]/u` | B |
47
56
  | ~~13~~ ✅已修(2026-11-08 R13) | `mergeCards` 合并 `stats` 时漏了 `decayed` 字段 | `lib/memory/card.js` | 跨进程合并后衰减计数丢失 | 补字段 | B |
48
57
  | ~~14~~ ✅已修(2026-11-08 R13) | `normalizeRecord` 补 id 的哈希不掺 `scope` | `lib/memory/card.js` | 跨卡「同文本 + 同时间」会撞 id,被误并成一条 | 哈希里加 scope | B |
49
- | 15 | `redact` 的银行卡正则 `\b\d{16,19}\b` 误伤长订单号/雪花 ID,且不可恢复 | `lib/extract.js` | 正常内容被抹成 `[卡号]` | 加前缀白名单(62/4/5 开头)或按 Luhn 校验 | B |
58
+ | ~~15~~ ✅已修(2026-11-09 R14) | `redact` 的银行卡正则 `\b\d{16,19}\b` 误伤长订单号/雪花 ID,且不可恢复 | `lib/memory/signals.js`(原写 extract.js,实现在这里) | 正常内容被抹成 `[卡号]` | 改 Luhn + 发卡前缀(3–6)+ 上下文词兜底 | B |
50
59
  | ~~16~~ ✅已修(2026-11-08 R13) | `diaryWindowOf` 对 NaN 月/日静默回退成 1 月窗口 | `lib/diary/compose.js` | 坏日期会读错时间段 | 显式判 NaN 并返回空窗口 | B |
51
60
  | ~~17~~ ✅已修(2026-11-08 R13) | 日志轮转归档名精确到**分钟**,同分钟二次轮转覆盖/失败 | `lib/env.js` | 极端情况下丢一份归档 | 归档名加序号或毫秒 | B |
52
61
  | ~~18~~ ✅已修(2026-11-08 R13) | `diary-pick.js` 的布尔优先级可疑(`&&` 先于 `\|\|`) | `lib/core/diary-pick.js` | 选会话的条件可能和注释不符 | 加括号 + 补测试 | C |
53
62
  | ~~19~~ ✅已修(2026-11-08 R13) | mood digest 把 `decay` 模板句收进「那天你自己的想法」候选 | `lib/mood/digest.js` | 日记里出现系统模板句 | 跳过 `kind === 'decay'` | B |
54
- | 20 | `notes reconcile` 按**索引**对位比较,顺序一变就误报 `changed` | `lib/notes.js` | 笔记索引反复刷新 | 改按 slug 建 Map 比较 | B |
55
- | 21 | `readNote` 用 `loadIndex` 而不是 `reconcile` | `lib/notes.js` | 可能返回已删文件的条目 | 统一走 reconcile | B |
63
+ | ~~20~~ ✅已修(2026-11-09 R14) | `notes reconcile` 按**索引**对位比较,顺序一变就误报 `changed` | `lib/notes.js` | 笔记索引反复刷新 | 改按 slug 建 Map 比较 | B |
64
+ | ~~21~~ ✅已修(2026-11-09 R14) | `readNote` 用 `loadIndex` 而不是 `reconcile` | `lib/notes.js` | 可能返回已删文件的条目 | 统一走 reconcile | B |
56
65
 
57
66
  ---
58
67
 
@@ -73,14 +82,14 @@
73
82
  |---|---|---|---|
74
83
  | 26 | `diary/scheduler.js` 687 行混五种职责 | 改一处要读整文件 | 拆 `diary/agent.js` + `diary/deliver.js` |
75
84
  | 27 | `diary/compose.js` 591 行四类职责,`composeDiarySetup` 放错位置 | 同上 | 移到 `scheduler` 或 `diary/agent.js` |
76
- | 28 | `host/runtime/segment-memory.js` 的 `text()` 约 150 行、8 种职责的上帝函数 | 难以单测 | 拆 `runToneForTurn` / `collectDiaryMaterial` / `computeRecallText` / `applyBudget` |
85
+ | ~~28~~ ✅已修(2026-11-08 R15) | `host/runtime/segment-memory.js` 的 `text()` 约 150 行、8 种职责的上帝函数 | 难以单测 | 拆 `collectDiaryMaterial` / `memoryBudgetPlan` / `computeRecallText`(均文件私有,无新导出) |
77
86
  | ~~29~~ ✅已修(2026-11-08 R13) | `index.js` 顶部注释的注入顺序漏了 `soul:data-policy` | 文档与代码漂移 | 补一句 |
78
87
  | ~~30~~ ✅已修(2026-11-08 R13) | `extract` 游标对「无 id 会话」统一用 `'default'` 键 | 两个会话互吃扫描窗口 | 用会话对象身份做键 |
79
88
  | ~~31~~ ✅已修(2026-11-08 R13) | `TITLE_CACHE` / `PATH_CACHE` 全仓库唯一无上限缓存 | 长跑内存缓慢增长 | 用 `trimMap` 限一下 |
80
- | 32 | `build-client.mjs` 的 `ORDER` 硬编码;符号扫描 `DECL_RE` 只认 4 空格的 `var/function` | 新增片段漏登记会静默丢失;`let/const` 逃检 | 自动扫描 + 放宽正则 |
81
- | 33 | `revOf` 三处逐字重复;`pad2`/`dateKeyOf` 同构重复;测试断言工具在 40+ 文件逐份复制 | 改一处要改 N 处 | 收敛到 `constants.js` 与 `tests/helpers/assert.mjs` |
82
- | 34 | `summarizeConversations` 成死代码仍从门面导出;`askAgentToWrite` 的 `force` 参数恒 false | 误导读者 | 删掉或标注 |
83
- | 35 | `docs/preview.html` 手工复制 `styles.js` 整套 CSS | 改样式后预览过期 | 生成或加一致性检查 |
89
+ | ~~32~~ ✅已修(2026-11-08 R15) | `build-client.mjs` 的 `ORDER` 硬编码;符号扫描 `DECL_RE` 只认 4 空格的 `var/function` | 新增片段漏登记会静默丢失;`let/const` 逃检 | 构建反向扫描 + 未登记即失败;`DECL_RE` 放宽到 `let/const` |
90
+ | ~~33~~ ✅已修(2026-11-08 R15) | `revOf` 三处逐字重复(`card.js`/`card-io.js`/`state/cards.js`) | 改一处要改 N 处 | 收敛到 `memory/constants.js` 单份导出(快照 +revOf,已入档) |
91
+ | ~~34~~ ✅已处理(2026-11-08 R15) | `summarizeConversations` 主流程已不用 | 误导读者 | docblock 标注 ⚠️ 废弃(测试迁移后连门面导出一起删)。**更正**:`force` 参数**不是**死代码 —— `regenerateDiary` 传 `{ force: true }`,手动重写在用 |
92
+ | ~~35~~ ✅已修(2026-11-08 R15) | `docs/preview.html` 手工复制 `styles.js` 整套 CSS | 改样式后预览过期 | 已实测漂移(`.soul-legend` vs `.soul-banner`);同步 + 新增 `tests/preview-css.test.js` 逐字符比对 |
84
93
 
85
94
  ---
86
95
 
@@ -103,13 +112,21 @@
103
112
 
104
113
  ---
105
114
 
106
- ## 七、建议的下一轮顺序
115
+ ## 七、建议的下一轮顺序(0.9.10 后更新)
116
+
117
+ 只剩两条,且都是「大文件」重构,按依赖顺序:
118
+
119
+ 1. **#27 `diary/compose.js`(591 行四职责)** —— 先把 `composeDiarySetup` 移回 `scheduler` 或新建
120
+ `diary/agent.js`,再按职责切四块。
121
+ 2. **#26 `diary/scheduler.js`(687 行五职责)** —— **必须最后做**:它依赖前一步的产物,
122
+ 先拆它会把 compose 的边界搞得更乱。
123
+ 3. **#23(渲染期白屏)** —— 除非宿主文档明确暴露了 `React.Component`,否则不要动。
124
+
125
+ 重构纪律(R15 已验证有效,照抄):**先补特征测试钉住当下行为 → 再拆 → 特征测试一条不改必须全绿 →
126
+ 毒化一次证明测试网有效**。R15 的 13 条特征断言就是这么用的。
107
127
 
108
- 1. **一致性**:#8(`maxRecords` 两处夹取)、#12(控制字符)、#13/#14(合并与 id)—— 都是小改动、纯正确性。
109
- 2. **日志与请求层**:#9(日志注入)、#10(413)、#11(TOCTOU)。
110
- 3. **性能**:#1、#3、#5(最常被调用的三条)。
111
- 4. **前端**:#22(config 单点)、#24(后台暂停)。
112
- 5. **重构**:#26–#28 三个大文件(要单独一轮,且必须在测试稳定之后)。
128
+ > 这一轮之后,**功能类与清理类已知问题全部清零**。剩下的两条是纯重构,
129
+ > 风险已经从「用户会踩到」变成「改的人会踩到」。
113
130
 
114
131
  ---
115
132
 
package/docs/preview.html CHANGED
@@ -75,17 +75,6 @@ border:1px solid var(--soul-line);border-radius:14px;overflow:hidden;background:
75
75
  .soul-err{margin:0;padding:6px 0;font-size:12px;color:var(--soul-err)}
76
76
  .soul-pill{font-size:11px;padding:2px 8px;border-radius:999px;border:1px solid var(--soul-line-soft);color:var(--soul-muted);white-space:nowrap}
77
77
  .soul-hint{font-size:11px;color:var(--soul-faint)}
78
- .soul-legend{display:flex;gap:9px;align-items:flex-start;padding:8px 0;border-bottom:.5px solid var(--soul-line-soft)}
79
- .soul-legend:last-child{border-bottom:none}
80
- .soul-lv{flex:0 0 auto;width:18px;height:18px;border-radius:50%;display:flex;align-items:center;justify-content:center;font-size:10.5px;font-weight:600;background:rgba(127,127,127,.14);color:var(--soul-muted);margin-top:1px}
81
- .soul-legend.on .soul-lv{background:var(--soul-brand);color:#fff}
82
- .soul-legend-body{flex:1 1 auto;min-width:0}
83
- .soul-legend-name{display:flex;align-items:center;gap:6px;flex-wrap:wrap;font-size:12.5px}
84
- .soul-path{margin-top:2px;font-size:11px;line-height:15px;color:var(--soul-faint);word-break:break-all;font-family:var(--dsw-font-family-mono,ui-monospace,Menlo,monospace)}
85
- .soul-warn-box{margin-top:9px;padding:8px 10px;border:1px solid rgba(255,176,32,.45);border-radius:8px;background:rgba(255,176,32,.10);font-size:11.5px;line-height:17px;color:var(--soul-warn)}
86
- .soul-btn:disabled{opacity:.45;cursor:not-allowed}
87
- .soul-priority{display:inline-flex;align-items:center;gap:4px;font-size:11px;color:var(--soul-faint)}
88
- .soul-section-title{font-size:14px;font-weight:600;margin:0}
89
78
  .soul-banner{border:1px solid var(--soul-line-soft);border-radius:9px;padding:8px 11px;background:rgba(127,127,127,.05)}
90
79
  .soul-banner-line{display:flex;gap:10px;padding:3px 0;font-size:12px;align-items:flex-start}
91
80
  .soul-banner-key{flex:0 0 92px;color:var(--soul-faint);white-space:nowrap}
@@ -110,6 +99,33 @@ border:1px solid var(--soul-line);border-radius:14px;overflow:hidden;background:
110
99
  .soul-row-label{flex:0 0 52px;font-size:12px;color:var(--soul-faint);white-space:nowrap}
111
100
  .soul-filebar{display:flex;align-items:center;gap:10px;padding:7px 10px;border:1px solid var(--soul-line-soft);border-radius:8px;background:rgba(127,127,127,.04);font-size:11.5px;color:var(--soul-faint);flex-wrap:wrap}
112
101
  .soul-filebar-path{flex:1 1 auto;min-width:0;word-break:break-all;font-family:var(--dsw-font-family-mono,ui-monospace,Menlo,monospace);color:var(--soul-muted)}
102
+ .soul-section-title{font-size:14px;font-weight:600;margin:0}
103
+ .soul-legend{display:flex;gap:9px;align-items:flex-start;padding:8px 0;border-bottom:.5px solid var(--soul-line-soft)}
104
+ .soul-legend:last-child{border-bottom:none}
105
+ .soul-lv{flex:0 0 auto;width:18px;height:18px;border-radius:50%;display:flex;align-items:center;justify-content:center;font-size:10.5px;font-weight:600;background:rgba(127,127,127,.14);color:var(--soul-muted);margin-top:1px}
106
+ .soul-legend.on .soul-lv{background:var(--soul-brand);color:#fff}
107
+ .soul-legend-body{flex:1 1 auto;min-width:0}
108
+ .soul-legend-name{display:flex;align-items:center;gap:6px;flex-wrap:wrap;font-size:12.5px}
109
+ .soul-path{margin-top:2px;font-size:11px;line-height:15px;color:var(--soul-faint);word-break:break-all;font-family:var(--dsw-font-family-mono,ui-monospace,Menlo,monospace)}
110
+ .soul-warn-box{margin-top:9px;padding:8px 10px;border:1px solid rgba(255,176,32,.45);border-radius:8px;background:rgba(255,176,32,.10);font-size:11.5px;line-height:17px;color:var(--soul-warn)}
111
+ .soul-btn:disabled{opacity:.45;cursor:not-allowed}
112
+ .soul-priority{display:inline-flex;align-items:center;gap:4px;font-size:11px;color:var(--soul-faint)}
113
+ .soul-mood-hero{display:flex;align-items:center;gap:14px;flex-wrap:wrap}
114
+ .soul-mood-face img{width:104px;height:82px;object-fit:contain;border-radius:10px;background:rgba(127,127,127,.10);display:block}
115
+ .soul-mood-num{font-size:34px;font-weight:650;line-height:1;letter-spacing:-.02em}
116
+ .soul-mood-label{font-size:13px;color:var(--soul-muted);margin-top:3px}
117
+ .soul-mood-reason{flex:1 1 220px;min-width:0;font-size:12px;line-height:18px;color:var(--soul-muted);border-left:2px solid var(--soul-line);padding-left:10px}
118
+ .soul-dim{display:flex;align-items:center;gap:8px;padding:4px 0;font-size:12px}
119
+ .soul-dim-name{flex:0 0 46px;color:var(--soul-faint)}
120
+ .soul-dim-val{flex:0 0 30px;text-align:right;color:var(--soul-muted)}
121
+ .soul-tl{display:flex;flex-direction:column;gap:0;max-height:320px;overflow:auto}
122
+ .soul-tl-item{display:flex;gap:9px;padding:8px 2px;border-bottom:.5px solid var(--soul-line-soft);font-size:11.5px;line-height:17px}
123
+ .soul-tl-item:last-child{border-bottom:none}
124
+ .soul-tl-time{flex:0 0 88px;color:var(--soul-faint);white-space:nowrap}
125
+ .soul-tl-delta{flex:0 0 40px;text-align:right;font-weight:600}
126
+ .soul-tl-delta.up{color:#c0392b}
127
+ .soul-tl-delta.down{color:#2f6b46}
128
+ .soul-tl-body{flex:1 1 auto;min-width:0;color:var(--soul-muted);word-break:break-word}
113
129
  @supports not (color:var(--dsw-alias-label-primary)){.soul-app{--soul-fg:#241f18;--soul-muted:#6f6558;--soul-faint:#9a9084;--soul-line:#e0d7c8;--soul-line-soft:#ece5d8;--soul-bg:#fffdf8;--soul-bg2:#f6f2ea;--soul-brand:#1f6feb;--soul-ok:#2f6b46;--soul-warn:#8a6a2f;--soul-err:#a83a2c}}
114
130
  </style>
115
131
  </head>
@@ -40,6 +40,11 @@ function describeFinishReason(reason) {
40
40
  /**
41
41
  * 把当天对话全文压缩成摘要。
42
42
  *
43
+ * ⚠️ 已废弃(2026-11-09 KNOWN-ISSUES #34):日记主流程不再走它(scheduler.js
44
+ * 现在直接用 composeDiaryText 组装),导出只为兼容旧调用方/测试
45
+ * (tests/diary.test.js 仍在测它)。新代码**不要**调用;等测试迁移后连门面
46
+ * 导出一起删。
47
+ *
43
48
  * 跟 mood.js 的 judgeMood 同款模式:流式调用 + 超时保护。
44
49
  * 失败返回 null,调用方用原始对话兜底(截断后直接塞进 prompt)。
45
50
  *