dsh-agent-soul 0.9.16 → 0.9.17
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 +505 -431
- package/docs/HANDOFF.md +416 -401
- package/docs/KNOWN-ISSUES.md +21 -2
- package/lib/attest.js +5 -2
- package/lib/client/api.js +6 -3
- package/lib/client/diary-tab.js +4 -1
- package/lib/client/mood-tab.js +3 -1
- package/lib/client/settings-tab.js +3 -1
- package/lib/client.js +16 -6
- package/lib/core/api-token.js +24 -8
- package/lib/core/diary-pick.js +5 -2
- package/lib/core/prompt-guard.js +143 -141
- package/lib/core/secrets.js +29 -3
- package/lib/core/situation.js +202 -199
- package/lib/diary/compose.js +59 -16
- package/lib/diary/llm.js +26 -11
- package/lib/diary/scheduler.js +30 -6
- package/lib/diary/to-today.js +114 -108
- package/lib/env.js +12 -3
- package/lib/host/runtime/entry.js +4 -0
- package/lib/host/runtime/segment-cache.js +166 -0
- package/lib/host/runtime/segment-memory.js +36 -1
- package/lib/host/runtime/segment-notes.js +65 -40
- package/lib/host/runtime/segment-persona.js +81 -51
- package/lib/host/runtime/segment-purpose.js +89 -58
- package/lib/http/middleware.js +22 -4
- package/lib/http/routes/system.js +29 -11
- package/lib/http/server.js +18 -5
- package/lib/http/sessions.js +21 -4
- package/lib/index.js +5 -4
- package/lib/memory/config.js +72 -71
- package/lib/memory/constants.js +9 -1
- package/lib/memory/render.js +546 -542
- package/lib/memory/scoring.js +169 -165
- package/lib/mood/digest.js +24 -4
- package/lib/mood/hooks.js +15 -0
- package/lib/notes.js +5 -0
- package/lib/persona.js +6 -2
- package/lib/retention.js +26 -4
- package/lib/state/cache.js +16 -4
- package/lib/state/cards.js +5 -0
- package/lib/state/maintain.js +5 -2
- package/package.json +3 -3
- package/tools/build-client.mjs +25 -5
- package/tools/lint.mjs +264 -102
package/CHANGELOG.md
CHANGED
|
@@ -1,431 +1,505 @@
|
|
|
1
|
-
# 变更记录
|
|
2
|
-
|
|
3
|
-
本项目从 `0.9.2` 起维护本文件。更早版本只能靠 git tag 和提交记录回溯 —— 这正是本文件存在的原因:
|
|
4
|
-
`0.8.3` 加了一道会让反代部署整页 403 的 Host 白名单,却没有任何变更说明,最后是使用方撞上并报回来的([#1](https://github.com/danshuyue/dsh-agent-soul/issues/1))。
|
|
5
|
-
|
|
6
|
-
格式:`## 版本 · 日期` / 变更按「新增 / 变更 / 修复 / 破坏性」分类。
|
|
7
|
-
|
|
8
|
-
---
|
|
9
|
-
|
|
10
|
-
## 0.9.
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
- `
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
-
|
|
60
|
-
|
|
61
|
-
###
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
-
|
|
78
|
-
|
|
79
|
-
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
-
|
|
131
|
-
-
|
|
132
|
-
|
|
133
|
-
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
-
|
|
207
|
-
- `
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
###
|
|
251
|
-
|
|
252
|
-
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
- **`
|
|
298
|
-
|
|
299
|
-
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
###
|
|
325
|
-
|
|
326
|
-
|
|
327
|
-
|
|
328
|
-
-
|
|
329
|
-
-
|
|
330
|
-
-
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
- `lib/
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
-
|
|
348
|
-
-
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
|
|
353
|
-
|
|
354
|
-
|
|
355
|
-
|
|
356
|
-
-
|
|
357
|
-
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
- `
|
|
361
|
-
-
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
|
|
369
|
-
|
|
370
|
-
-
|
|
371
|
-
|
|
372
|
-
|
|
373
|
-
|
|
374
|
-
-
|
|
375
|
-
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
|
|
379
|
-
|
|
380
|
-
|
|
381
|
-
|
|
382
|
-
|
|
383
|
-
-
|
|
384
|
-
-
|
|
385
|
-
-
|
|
386
|
-
-
|
|
387
|
-
-
|
|
388
|
-
|
|
389
|
-
|
|
390
|
-
|
|
391
|
-
|
|
392
|
-
-
|
|
393
|
-
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
397
|
-
|
|
398
|
-
|
|
399
|
-
|
|
400
|
-
|
|
401
|
-
|
|
402
|
-
|
|
403
|
-
|
|
404
|
-
|
|
405
|
-
|
|
406
|
-
-
|
|
407
|
-
|
|
408
|
-
|
|
409
|
-
|
|
410
|
-
|
|
411
|
-
|
|
412
|
-
|
|
413
|
-
|
|
414
|
-
|
|
415
|
-
|
|
416
|
-
|
|
417
|
-
|
|
418
|
-
|
|
419
|
-
|
|
420
|
-
|
|
421
|
-
|
|
422
|
-
-
|
|
423
|
-
|
|
424
|
-
|
|
425
|
-
|
|
426
|
-
|
|
427
|
-
|
|
428
|
-
|
|
429
|
-
|
|
430
|
-
|
|
431
|
-
|
|
1
|
+
# 变更记录
|
|
2
|
+
|
|
3
|
+
本项目从 `0.9.2` 起维护本文件。更早版本只能靠 git tag 和提交记录回溯 —— 这正是本文件存在的原因:
|
|
4
|
+
`0.8.3` 加了一道会让反代部署整页 403 的 Host 白名单,却没有任何变更说明,最后是使用方撞上并报回来的([#1](https://github.com/danshuyue/dsh-agent-soul/issues/1))。
|
|
5
|
+
|
|
6
|
+
格式:`## 版本 · 日期` / 变更按「新增 / 变更 / 修复 / 破坏性」分类。
|
|
7
|
+
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## 0.9.17 · 2026-11-12
|
|
11
|
+
|
|
12
|
+
外部审查(43 条)整改轮 **R20**。审查报告基于 `47549e5`,整改落在 `4805cd7` 之后。
|
|
13
|
+
|
|
14
|
+
### 安全 / 可用性(P0–P1)
|
|
15
|
+
|
|
16
|
+
- **路径归属双闸**(S2):`?cwd=` 以前只做字符串前缀比较,`<DSH_HOME>/..` 能读到外部目录的
|
|
17
|
+
`AGENT.md`。现在 `normalizeCwdParam` 先 `resolve()`,`isOwnedCwd` 改 `relative()` 判定 ——
|
|
18
|
+
两道闸,任一道都能拦。**这条击穿过 R01/R02 两轮加固,是本轮唯一的 P0 路径问题。**
|
|
19
|
+
- **字符串 `"false"` 不再锁死设置页**(H5):`{"apiLoopbackOnly":"false"}` 曾穿过闸门落盘,
|
|
20
|
+
之后连本机回环都 403,用户只能手改文件。现在闸门判**归一化之后**的值;并且未授权放宽时
|
|
21
|
+
`shouldAllowApiRequest` **回落到回环判定**(边界是「别让非本机进来」,不是「锁死本机」)。
|
|
22
|
+
- **日记不再永久停摆**(S1):底层 `resume`/`presets` 挂起时,超时孤儿链的锁永不释放。
|
|
23
|
+
现在 orphan 记录带 TTL(预算 ×1.5 = 18 分钟),过期强制放行并留 ⚠️ 日志。
|
|
24
|
+
- **`/state.legacyKeys` 从来没用过**(H1):函数体用了没导入的 `readFileSync`/`CONFIG_FILE`,
|
|
25
|
+
ReferenceError 被 `catch` 吞掉 → 恒返回 `[]`。补导入,并把 catch 收窄成「文件不存在 / JSON 坏」。
|
|
26
|
+
- **限流分桶只认有效令牌**(H2):以前对**未校验**的候选令牌取摘要分桶,随机令牌每个一个新桶,
|
|
27
|
+
限流形同虚设、Map 还会无限增长。现在只有校验通过的令牌才分桶,无效令牌一律落 peer 桶;
|
|
28
|
+
桶表加 LRU 上限 1024。
|
|
29
|
+
- **发布链不再写源码树**(H8):`prepack` 从裸 `npm test` 改成 `npm run lint && npm test`;
|
|
30
|
+
`s2` 测试改在临时副本里改片段(不再动仓库里的 `overview-tab.js`);
|
|
31
|
+
`build-client` 改 tmp + rename 原子写。
|
|
32
|
+
|
|
33
|
+
### 语义(会直接影响行为的)
|
|
34
|
+
|
|
35
|
+
- **不再代填作者昵称**(H4):老配置缺 `ownerName` 时,兜底从 `'树树'` 改成空串 ——
|
|
36
|
+
把作者昵称写进陌生用户的提示词、还静默改他的配置文件,在公开发布的包里是硬伤。
|
|
37
|
+
`moodOwnerName` 的真实迁移(有旧键就搬它的值)不受影响。
|
|
38
|
+
- **`memoryRecallTopK` 上限 50 → 20**(M4):与 HTTP 的 `NUMBER_RANGES` 统一。
|
|
39
|
+
配了 20 以上的会被夹到 20。
|
|
40
|
+
- **畸形 JSON 回 400**(M2),不再是 500。
|
|
41
|
+
- **召回阈值分判**(H7):英文单词查询以前因 `minHits=2` 恒空,现在 `wholeHits`/`gramHits` 分开判。
|
|
42
|
+
- **生活词加分不再只算一个**(H6):`LIFE_WORDS` 缺 `g`,`match()` 只返回首个匹配。
|
|
43
|
+
- **`/session` 与 `/session/rotate` 补限流**(M13);**`/attestation` 不再回显绝对路径**(M14)。
|
|
44
|
+
- **防抖被合并的请求不再假装成功**(M25):`resolve(null)` → `resolve({merged:true})`,
|
|
45
|
+
调用方只在真实成功时提示「已保存」并刷新。
|
|
46
|
+
- 其它:私密日记去 TOCTOU(M3)、`saveConfig` 缓存与落盘一致(M7 半程)、
|
|
47
|
+
密钥熔断覆盖「伪 PowerShell」(M12)、控制字符统一清洗(M9)、
|
|
48
|
+
情境缓存键修正(M10)、`projectMemoryEnabled` 贯穿素材与健康(M6)、静态路由补 config(M1)。
|
|
49
|
+
|
|
50
|
+
### 门禁(这一轮最该记住的部分)
|
|
51
|
+
|
|
52
|
+
上一轮之所以能「清零」六天后被找出 43 条,是因为**门禁看不见「返回 200 但内容不对」**。
|
|
53
|
+
|
|
54
|
+
- `tools/lint.mjs` 新增 **「用了但没导入」** 检查(H1 的解药)+ 多行 `import` 误判修复 +
|
|
55
|
+
`|| true` 型恒真断言识别(原来只认字面量 `ok(true,…)`)。
|
|
56
|
+
- `tests/smoke.test.js` 的「没有漏导入」断言原来是**恒真**的(先 `rmSync` 临时目录,再读日志)——
|
|
57
|
+
修成真断言。
|
|
58
|
+
- 契约补响应体断言;`test:contracts` 前置构建;`prepack` 接 lint;
|
|
59
|
+
`dep-graph` 探针覆盖服务端模块;`tools/sync-preview.mjs` 第一次有测试。
|
|
60
|
+
|
|
61
|
+
### 未修(8 条,各有理由)
|
|
62
|
+
|
|
63
|
+
M7(并发写配置,要新的 mtime 比对模型)、M8(密钥三处不一致,要老环境兼容设计)、
|
|
64
|
+
M11(单调时钟 + 跨端口放宽是设计决策)、M18(入库门槛语义要产品口径)、
|
|
65
|
+
M19(LLM 结构校验要先定义 schema)、M21(两套重要性评分收敛要等价性验证)、
|
|
66
|
+
M22(归档召回性能要有真实样本)、M23(`sync.mjs` 工具链改造)。
|
|
67
|
+
|
|
68
|
+
### 未验证(如实交底)
|
|
69
|
+
|
|
70
|
+
- **S1 的 TTL 没有单测毒化**:`orphanExpired` 是模块私有,触发需要「永不 settle 的链 + 18 分钟」,
|
|
71
|
+
单测里难以既稳定又不拖慢套件。复核建议:把 TTL 调小 + 注入假链。
|
|
72
|
+
- **M5 的跨时区没有实测**:Windows 的 Node 忽略 `TZ`,负时区造不出来。逻辑已改成纯日历运算,
|
|
73
|
+
红需要 Linux CI 加 `TZ=America/New_York`。
|
|
74
|
+
|
|
75
|
+
### 对审查报告的更正
|
|
76
|
+
|
|
77
|
+
- **M17 是误报**:`commitIngestBatch` 是 `cursors.set(key, to + 1)` + 严格 `>` 过滤,
|
|
78
|
+
与 `feed.js` 同一口径,不存在重复消费。
|
|
79
|
+
- **H3⑦ 是误报**:`dep-graph` 只排除 `lib/client/`,服务端模块全在依赖图里。
|
|
80
|
+
- **M16 在基线里已被修**(0.9.17 之前)。
|
|
81
|
+
|
|
82
|
+
---
|
|
83
|
+
|
|
84
|
+
## 0.9.16 · 2026-11-09
|
|
85
|
+
|
|
86
|
+
### 变更
|
|
87
|
+
|
|
88
|
+
- **长列表自己滚**:日记「最近日记」、记忆记录、笔记列表、目的「惦记的事」四处
|
|
89
|
+
加 `max-height:min(46vh,420px) + overflow:auto`(跟心情页时间线 `.soul-tl` 同一个套路)。
|
|
90
|
+
条目一多时不再把整页撑长,下面的卡片不用划半天才看得到。
|
|
91
|
+
加 `overscroll-behavior:contain`:内层滚到底不把滚动传给外层,免得整页突然跳走。
|
|
92
|
+
- 新增 `tools/sync-preview.mjs`:把 `styles.js` 的 CSS 一键同步进 `docs/preview.html`。
|
|
93
|
+
R15 的 `preview-css` 门禁能拦住「改了样式忘了同步」,但同步一直是手工的 —— 现在是一条命令。
|
|
94
|
+
- 新增 `tests/ui-scroll.test.js`(10 断言):断言样式规则存在(有界高度 / 可滚 / 不传滚动),
|
|
95
|
+
且四个片段真的挂上了 class —— 只加样式不挂 class 是最常见的「改了等于没改」。
|
|
96
|
+
|
|
97
|
+
### 修复
|
|
98
|
+
|
|
99
|
+
- `docs/preview.html` 的插件 CSS 与 `styles.js` 同步(否则 `preview-css` 契约红)。
|
|
100
|
+
|
|
101
|
+
---
|
|
102
|
+
|
|
103
|
+
## 0.9.15 · 2026-11-09
|
|
104
|
+
|
|
105
|
+
### 修复
|
|
106
|
+
|
|
107
|
+
- **0.9.14 的两个新功能在设置页看不见**:`diaryToTodayEnabled` / `situationEnabled` 只加了配置键、
|
|
108
|
+
没加界面 —— 而「每个功能都要在设置 UI 里能关」是这个项目定过的规矩。
|
|
109
|
+
- **卡片只在「今天已经有一句」时才渲染**:用户什么都没看到,会以为功能没做。
|
|
110
|
+
现在功能开着就一直有这张卡片;今天还没那句时给**一句轻说明**
|
|
111
|
+
(「她写完私密日记、在末尾写一行「想对明天说:…」时就有了」),不是整块消失,也不催更。
|
|
112
|
+
|
|
113
|
+
### 测试
|
|
114
|
+
|
|
115
|
+
- `tests/r19-situation-to-today.test.js` 加 4 条**界面契约**断言:客户端产物里必须有这张卡片、
|
|
116
|
+
两个开关、以及那句空状态说明 —— 防止「配了键忘了接界面」这类静默漏做再发生。
|
|
117
|
+
|
|
118
|
+
---
|
|
119
|
+
|
|
120
|
+
## 0.9.14 · 2026-11-09
|
|
121
|
+
|
|
122
|
+
功能增补轮 **R19**(依据 `dsh-agent-soul-0.9.8-功能增补设计.md`,按 0.9.13 的实际代码修正落点)。
|
|
123
|
+
两项都**不新增状态源、不新增模型调用**,各带一个总开关,关掉后逐字节等价。
|
|
124
|
+
|
|
125
|
+
### 新增 · 现实情境(④)
|
|
126
|
+
|
|
127
|
+
- 新增 `lib/core/situation.js`:**纯规则、零模型成本**地算时段(深夜 / 清晨 / 上午 / 下午 / 晚上)、
|
|
128
|
+
月份与季节、节日、久未交互天数。节日表可编辑(`agents/situation.json`),读不到或写坏就用内置默认。
|
|
129
|
+
- 三个消费者,都不进提示词主干(否则每轮上下文随时间抖动,长缓存全废):
|
|
130
|
+
- **日记素材**:写成「(背景:11 月·秋;今天是国庆。)」,只给事实,不给「你要写得温暖一点」;
|
|
131
|
+
- **目的段**:跟着「心里惦记的事」带一句短状态(`(已经 3 天没聊过了,现在是深夜。)`),
|
|
132
|
+
而且**只在这一段本来就要发的时候**带,不额外开一条注入面;
|
|
133
|
+
- 久未交互只看 `agents/conversations/` 的**文件名**(不读内容),60 秒缓存。
|
|
134
|
+
|
|
135
|
+
### 新增 · 昨天想对今天说的话(⑥)
|
|
136
|
+
|
|
137
|
+
- 她写完**私密日记**之后,可以在正文末尾多写一行 `想对明天说:…`;插件把它摘出来单独存
|
|
138
|
+
(`agents/diary/to-today.json`,单条按天覆盖),当天每个新会话的**首轮**带进上下文,
|
|
139
|
+
设置页日记卡片里能看到、能**改写 / 删掉**。
|
|
140
|
+
- **不新增模型调用**:搭私密篇那一次产出的末班车。没写 / 超过 30 字 / 写盘失败 → 今天就没有这句,
|
|
141
|
+
不重试、不兜底、不告警。
|
|
142
|
+
- **不改写私密正文**:scheduler 在私密落盘后本来就会把正文读回来(给连续线用),
|
|
143
|
+
所以这里只**解析**、不**改写** —— 「从不改写」比「剥完逐字节一致」更强。
|
|
144
|
+
设计稿原本要「剥掉那一行」,这一版改成保留:那行话留在她自己的日记里反而更像日记。
|
|
145
|
+
- 跨天作废按 `date` 严格匹配,不需要清理任务;不进记忆卡、不进人格文件、不参与统计。
|
|
146
|
+
|
|
147
|
+
### 变更
|
|
148
|
+
|
|
149
|
+
- 新增配置键:`situationEnabled`(默认 true)、`diaryToTodayEnabled`(默认 true)、
|
|
150
|
+
`diaryToTodayMaxChars`(默认 30,范围 10–60,`NUMBER_RANGES` 与 `normalizeConfig` 两处同步登记)。
|
|
151
|
+
- 新增路由 `POST /diary/to-today`(`{action:'edit'|'delete'}`);`GET /diary/list` 多返回一个 `toToday`。
|
|
152
|
+
- 开关证据(0.9.13 的 `lib/evidence.js`)新增两项:`昨天那句话` 与 `现实情境`。
|
|
153
|
+
- **这一轮的接线是真的测过的**:毒化「scheduler 里不记那一句」+「注入分支关掉」→ 5 条断言变红,
|
|
154
|
+
恢复全绿。这正是 0.9.13 记下的那个缺口(R18 的动态证据当初只有单元级覆盖)。
|
|
155
|
+
|
|
156
|
+
### 已知不做
|
|
157
|
+
|
|
158
|
+
- **② 联想召回(assoc)暂缓**:全局记忆才 92 条,三道闸下边密度建不起来,收益接近零,
|
|
159
|
+
却要引入新状态文件 + 离线建边 + 拿基线对比。等记忆到 300~500 条、且确实「该想起来的没想起来」时再做。
|
|
160
|
+
|
|
161
|
+
---
|
|
162
|
+
|
|
163
|
+
## 0.9.13 · 2026-11-09
|
|
164
|
+
|
|
165
|
+
外部复检轮 **R18**(文档漂移 / 废弃键 / 开关生效证据),15 文件 / +439 −5。90 测试 / 11 契约全绿。
|
|
166
|
+
|
|
167
|
+
### 新增
|
|
168
|
+
|
|
169
|
+
- **`lib/evidence.js` —— 开关的「生效 / 未生效」证据**(这是本轮真正的东西):
|
|
170
|
+
- `mark(key, note)`:动态证据,只在**送达点**调用(语气真的进了收件箱、判定真的记了账、
|
|
171
|
+
提炼真的入了库、四段真的进了装配);
|
|
172
|
+
- `statuses(cfg)`:17 个布尔开关的静态生效性 + **人话原因**(「心情关了——判定不跑,语气无从挂起」);
|
|
173
|
+
- `reportLine(cfg)`:一行三段式总览(生效 / 暂未发生 / 未生效)。
|
|
174
|
+
- 输出只在三处:**启动一行 + 每日健康行 + `/state`**,绝不每轮(噪音会让人不再看日志)。
|
|
175
|
+
- 动机是那次**语气链失效三天、日志一句错都没有、测试全绿** —— 开关的值不等于开关的效果。
|
|
176
|
+
- `/state` 新增 `switches`(开关证据)与 `legacyKeys`(配置文件里还躺着的废弃键)。
|
|
177
|
+
|
|
178
|
+
### 修复
|
|
179
|
+
|
|
180
|
+
- **介绍与实现对不上**:`package.json` 的 description 与 README 都还写着心情「不注入、无挂饰」,
|
|
181
|
+
而心情语气 2026-11-01 就上线了、`soul:mood` 段每轮都进上下文。
|
|
182
|
+
连带修正 4 处同款过时注释(`index.js` 头、`mood.js` 头、`cache.js` 的 `moodEnabled` 注释、
|
|
183
|
+
`mood/digest.js` 的类比)—— 这 4 处是 R18 漏掉的,发布前复核补上。
|
|
184
|
+
- **废弃配置键不再写回配置文件**:`diarySchedule` 与 `moodOwnerName` 仍**接受**(不 400,保兼容),
|
|
185
|
+
但 `saveConfig` 落盘前剔除,每个键只记一行日志;`moodOwnerName` 只在 `ownerName` 迁移完成后剔
|
|
186
|
+
(不然会把老用户的迁移源数据弄丢)。`DEFAULT_CONFIG` 两键保留 —— 删了会让 `validateConfigEntry`
|
|
187
|
+
开始报「未知配置项」,那是破坏性变更。
|
|
188
|
+
|
|
189
|
+
### 已知缺口(不阻塞发布)
|
|
190
|
+
|
|
191
|
+
- 动态证据目前只有**单元级**覆盖(测试直接调 `mark()`),**没有「注入链路真的会调 mark」的接线测试** ——
|
|
192
|
+
把 `inject.js` 里那行 `mark('moodTone')` 删掉,25 条测试仍然全绿。
|
|
193
|
+
静态那一半有真覆盖(假旋钮毒化 → 3 条红)。已记入 `docs/HANDOFF.md` §6 作为下一轮第一件事。
|
|
194
|
+
|
|
195
|
+
---
|
|
196
|
+
|
|
197
|
+
## 0.9.12 · 2026-11-08
|
|
198
|
+
|
|
199
|
+
外部复检轮 **R17(最后一个大文件)**,2 个提交 / 8 文件 / +353 −241。**对外行为零变化**:
|
|
200
|
+
89 测试 / 11 契约 / lint / bundle 零 diff 全绿;四个搬迁函数的**函数体在旧新位置逐字一致**。
|
|
201
|
+
|
|
202
|
+
### 重构
|
|
203
|
+
|
|
204
|
+
- **`diary/scheduler.js`(779 行五职责)拆分**(#26):
|
|
205
|
+
- `diary/deliver.js`(新)—— 投递与回执判定:`shouldAskAgain` / `askAgentToWrite` / `mtimeMsOf`
|
|
206
|
+
- `diary/agent.js` —— `diaryAgent` 并入(与 R16 移进来的 `composeDiarySetup` 同属「会话获取 / 冷启动」)
|
|
207
|
+
- `diary/scheduler.js` —— 只留定时器 / 双层锁 / 主流程 / `regenerateDiary` / `runCatchUp`(779 → 551 行)
|
|
208
|
+
- 函数体由脚本按段落切分,**逐字未改**;`askAgentToWrite` 因跨模块调用由私有改导出(已披露)。
|
|
209
|
+
- `lib/diary.js` 门面导出名集合(29 个)不变,`diaryAgent` 改从 `agent.js` re-export。
|
|
210
|
+
|
|
211
|
+
### 测试
|
|
212
|
+
|
|
213
|
+
- 新增 `tests/r17-deliver-feature.test.js`(11 断言),**先于拆分提交**且在旧代码上全绿:
|
|
214
|
+
补上了 `shouldAskAgain` 这块**零直接覆盖**的判定矩阵(force / 不存在 / since=0 老行为 /
|
|
215
|
+
旧文件重写 / 新文件不重问 / mtime 被拨老),以及 `since` 语义的端到端验证 ——
|
|
216
|
+
那就是 P1-D3「看门狗每 30 分钟空转、日志却写『日记完成』」那条事故的判据。
|
|
217
|
+
- 既有 `tests/r05-diary-state.test.js` 只改了 import 路径与调用点,**断言一字未动**(已逐行核对)。
|
|
218
|
+
|
|
219
|
+
### 变更
|
|
220
|
+
|
|
221
|
+
- 契约快照走正规通道:`deliver.js` 新增 `askAgentToWrite` / `shouldAskAgain`,
|
|
222
|
+
`agent.js` +`diaryAgent`,`scheduler.js` −2。理由已记入 `SNAPSHOT_CHANGES.md`
|
|
223
|
+
(其中「R16 #26」是交付方的笔误,发布时更正为 R17)。
|
|
224
|
+
- **至此 `docs/KNOWN-ISSUES.md` 只剩 #23**(错误边界需宿主暴露 `React.Component`)。
|
|
225
|
+
|
|
226
|
+
---
|
|
227
|
+
|
|
228
|
+
## 0.9.11 · 2026-11-08
|
|
229
|
+
|
|
230
|
+
外部复检轮 **R16(重构轮)**,2 个提交 / 9 文件 / +583 −443。**对外行为零变化**:
|
|
231
|
+
88 测试 / 11 契约 / lint / bundle 零 diff 全绿;复核时逐个函数比对,**10 个函数体在新旧位置逐字一致**。
|
|
232
|
+
|
|
233
|
+
### 重构
|
|
234
|
+
|
|
235
|
+
- **`diary/compose.js`(644 行四职责)按职责切四块**(#27):
|
|
236
|
+
- `diary/llm.js` —— `describeFinishReason` / `summarizeConversations` / `composeDiaryText`(246 行)
|
|
237
|
+
- `diary/history.js` —— `readRecentDiaries` / `digestDiaries`(84 行)
|
|
238
|
+
- `diary/agent.js` —— `composeDiarySetup`(76 行,**移正到 HANDOFF 建议的位置**:它全是宿主服务交互,与拼 prompt 无关)
|
|
239
|
+
- `diary/compose.js` —— 只剩 prompt 组装:`diaryWindowOf` / `buildMoodBlocks` / `composePublicMessage` / `composePrivateMessage`(217 行)
|
|
240
|
+
- 函数体由脚本按段落切分,**逐字未改**;事故注释随代码搬家;顺手删掉两段孤儿 docblock
|
|
241
|
+
(`diaryAgent` 的注释,函数本体 2026-11-06 已迁 `scheduler.js`,注释被遗留在 compose.js)。
|
|
242
|
+
- `lib/diary.js` 门面导出名集合(29 个)前后**完全一致**,只是改由 `llm` / `history` / `compose` 三处分发。
|
|
243
|
+
|
|
244
|
+
### 测试
|
|
245
|
+
|
|
246
|
+
- 新增 `tests/r16-compose-feature.test.js`(11 断言),**先于拆分提交**且在旧代码上全绿。
|
|
247
|
+
它补上了此前**零直接覆盖**的两个函数:`buildMoodBlocks` 与 `composeDiarySetup`
|
|
248
|
+
(后者含 2026-11-05 那次事故修的行为:会话不活跃时从落盘日志回读 preset)。
|
|
249
|
+
|
|
250
|
+
### 变更
|
|
251
|
+
|
|
252
|
+
- 契约快照走正规通道:新增 `diary/agent.js`、`diary/history.js`、`diary/llm.js` 三个模块,
|
|
253
|
+
`compose.js` 移出 5 个导出;理由已记入 `SNAPSHOT_CHANGES.md`。
|
|
254
|
+
|
|
255
|
+
---
|
|
256
|
+
|
|
257
|
+
## 0.9.10 · 2026-11-09
|
|
258
|
+
|
|
259
|
+
外部复检轮 **R15(重构轮)**,3 个提交 / 13 文件 / +451 −137。**对外行为零变化**,
|
|
260
|
+
四道门禁(lint / 87 测试 / 11 契约 / bundle 零 diff)全绿;特征测试先于拆分提交,拆分后一条未改。
|
|
261
|
+
|
|
262
|
+
### 重构
|
|
263
|
+
|
|
264
|
+
- **`segment-memory.js` 的 `text()` 拆分**(#28):~150 行的编排降为 ~35 行调度 + 三个**文件私有**函数
|
|
265
|
+
(`collectDiaryMaterial` / `memoryBudgetPlan` / `computeRecallText`)。无新增导出,契约零变化。
|
|
266
|
+
分开的五条路径(首轮整卡 / 关召回老路 / 退化 query / 粘性复用 / 按句召回)与粘性读写位置逐个比对一致,
|
|
267
|
+
所有事故注释随代码搬到对应函数。
|
|
268
|
+
|
|
269
|
+
### 修复
|
|
270
|
+
|
|
271
|
+
- **preview.html 的 CSS 已经漂移了**(#35):手工抄的那份还停在 `.soul-legend`,`styles.js` 早已是
|
|
272
|
+
`.soul-banner` —— 也就是说预览页一直是错的,只是没人比对过。现在同步 + 新增
|
|
273
|
+
`tests/preview-css.test.js` 逐字符比对(塞一个空格就红)。
|
|
274
|
+
- **构建会静默吞掉未登记的片段**(#32):`lib/client/` 下不在 `ORDER` 里的文件不报错、拼不进 bundle、
|
|
275
|
+
页签一片空白。现在反向扫描,未登记直接构建失败并列出文件名;`DECL_RE` 同时放宽到 `let/const`
|
|
276
|
+
(原来顶层 `let/const` 逃过跨片段重名检查)。
|
|
277
|
+
|
|
278
|
+
### 变更
|
|
279
|
+
|
|
280
|
+
- **`revOf` 三处逐字重复收敛到 `memory/constants.js`**(#33):快照 `+revOf`,理由已入 `SNAPSHOT_CHANGES.md`。
|
|
281
|
+
- `summarizeConversations` 标注废弃(#34,主流程已不用,`tests/diary.test.js` 仍经门面在测)。
|
|
282
|
+
**更正一处文档错误**:`askAgentToWrite` 的 `force` 参数**不是**死代码 ——
|
|
283
|
+
`regenerateDiary` 确实传 `{ force: true }`,手动重写在用。
|
|
284
|
+
|
|
285
|
+
---
|
|
286
|
+
|
|
287
|
+
## 0.9.9 · 2026-11-09
|
|
288
|
+
|
|
289
|
+
外部复检轮 **R14**(按 `docs/HANDOFF.md` §8 只交付不发布),本会话逐条复核后合并发布。
|
|
290
|
+
4 文件 / +201 −25 / 1 个提交;四条修复**全部经毒化复核**确认「不修会红」。
|
|
291
|
+
|
|
292
|
+
### 修复
|
|
293
|
+
|
|
294
|
+
- **笔记页反复误报「已变更」**(#20):`reconcile()` 的 `changed` 判据原来按**索引对位**比较,
|
|
295
|
+
索引条目顺序一变(并发写索引、新建一篇 push 到尾部)每个对位都失配 → 恒 `changed=true` → 反复写盘。
|
|
296
|
+
现在按 slug 建 Map 逐条比内容,顺序无关。
|
|
297
|
+
- **`readNote` 返回索引里的旧值**(#21):文件被外部改写后,`loadIndex()` 给的 `chars/summary`
|
|
298
|
+
与磁盘不符。现在统一走 `reconcile()`(与 `listNotes()` 同口径)。
|
|
299
|
+
- **长订单号/雪花 ID 被当卡号抹掉且不可恢复**(#15):原来 `\b\d{16,19}\b` 见长数字就抹。
|
|
300
|
+
现在改 **Luhn 校验 + 发卡前缀(3–6 开头)** 双判;不过 Luhn 但前文紧挨「卡号/银行卡/尾号」等
|
|
301
|
+
上下文词的,仍兜底照抹。真卡号漏抹概率≈0(主流发卡组织强制 Luhn),随机长订单号命中率从 100% 降到约 1/25。
|
|
302
|
+
- **会话下拉的扫盘兜底每次全量扫**(#2):服务不可用/无活会话时的兜底路径加 60 秒 TTL 缓存。
|
|
303
|
+
代价是新会话最多晚一分钟出现在下拉里(低频低精度展示,可接受)。
|
|
304
|
+
|
|
305
|
+
### 变更
|
|
306
|
+
|
|
307
|
+
- `lib/memory/signals.js` 新增模块内私有 `luhnLike`、`CARD_CONTEXT_RE` —— **无新增导出**,契约快照不变。
|
|
308
|
+
- 文档更正:`KNOWN-ISSUES` 原把 #15 的位置写成 `lib/extract.js`,实现在 `lib/memory/signals.js`。
|
|
309
|
+
|
|
310
|
+
---
|
|
311
|
+
|
|
312
|
+
## 0.9.8 · 2026-11-08
|
|
313
|
+
|
|
314
|
+
本版是 **R13(外部复检轮)的合并 + 一处复核修复**。R13 有 5 个提交、26 文件、+628/−157,
|
|
315
|
+
来自基于 v0.9.7 的独立分支,本会话逐项复核后合并(说明见 `docs/KNOWN-ISSUES.md` 顶部)。
|
|
316
|
+
|
|
317
|
+
### 修复
|
|
318
|
+
|
|
319
|
+
- **日记列表预览把汉字切成半个**(R13 #1 的复核补丁):`/diary/list` 改成只读头部 400 字节后,
|
|
320
|
+
`400 % 3 ≠ 0` 让边界必然落在某个汉字中间,预览末尾出现 `�`(U+FFFD)。
|
|
321
|
+
现在多读 3 字节再丢掉残缺尾字。附带补了带 REDGREEN 的断言 ——
|
|
322
|
+
第一版测试因为前缀字节数恰好让边界落在字与字之间,**修没修都是绿的**,poison 复核时才发现。
|
|
323
|
+
|
|
324
|
+
### R13 合并进来的修复(23 条)
|
|
325
|
+
|
|
326
|
+
- **一致性**:#8 `maxRecords` 口径统一、#12 控制字符补 C1/U+2028-2029、#13 合并补 `decayed`、
|
|
327
|
+
#14 `id` 哈希掺 scope、#16 `diaryWindowOf` 空窗、#18 布尔优先级、#19 digest 跳过模板块。
|
|
328
|
+
- **日志与请求层**:#9 `sanitizeLogText`、#10 `readBody` 413、#11 TOCTOU、#17 轮转撞名序号。
|
|
329
|
+
- **性能**:#1 只读头部、#3 备份免全量解析、#4 归档尾块读、#5 迁移退避、#6 mood key 全局化、#7 meta 缓存。
|
|
330
|
+
- **前端与架构**:#22 config 只发改动键、#24 后台暂停轮询、#25 预览受控渲染、
|
|
331
|
+
#29 注释补 data-policy、#30 游标按 agent 分键、#31 缓存上限。
|
|
332
|
+
|
|
333
|
+
### 变更
|
|
334
|
+
|
|
335
|
+
- `env.js` 新增 `sanitizeLogText` 导出;`tools/lint.mjs` 仍零问题。
|
|
336
|
+
- 与 `d243fd7`(第三方许可声明)合并后,`lib/client.js` 里的原作者署名注释完整保留。
|
|
337
|
+
- **合并同期另一条改动**:日记对话流水改为按「工作区 → 会话 → 时间」分组(新增 `lib/core/session-groups.js`),
|
|
338
|
+
同时开着的几个对话不再交错。这是一次**有意的输出变更**,`behavior-golden` 基线已按正规通道刷新
|
|
339
|
+
(理由记为:分组 + R13 的 compose/feed 修复叠加)。
|
|
340
|
+
|
|
341
|
+
---
|
|
342
|
+
|
|
343
|
+
## 0.9.7 · 2026-11-07
|
|
344
|
+
|
|
345
|
+
### 文档
|
|
346
|
+
|
|
347
|
+
- 新增 [`docs/KNOWN-ISSUES.md`](docs/KNOWN-ISSUES.md):把**尚未修**的条目集中列出来(性能 7 条、一致性 14 条、前端 4 条、可维护性 10 条、明确不修 3 类、待确认 2 条),每条带代码位置、影响、建议改法与「验证程度」(A 实测 / B 读代码 / C 仅按报告归档)。
|
|
348
|
+
- 这一版**不改任何代码**,只是把「还剩什么」写清楚,避免下一轮凭记忆修。
|
|
349
|
+
|
|
350
|
+
---
|
|
351
|
+
|
|
352
|
+
## 0.9.6 · 2026-11-07
|
|
353
|
+
|
|
354
|
+
### 工程化
|
|
355
|
+
|
|
356
|
+
- **单个测试文件加超时**(P2-29):`tools/run-tests.mjs` 原来没有超时,一个挂死的用例(未 settle 的 await)能把 CI 拖到 GitHub 的 6 小时上限。现在默认 180 秒、`--timeout=<秒>` 可覆盖,超时按失败计并点名。
|
|
357
|
+
- **CI 加 `timeout-minutes` 与 `concurrency`**(P2-30):前者防止一次挂死烧光额度,后者让同一分支的旧 run 自动取消。
|
|
358
|
+
- **Linux job 跑 Node 22 + 24 矩阵**:`engines` 要求 ≥22.19,而 24 是当前主力版本,之前从没在 24 上跑过 CI。
|
|
359
|
+
- **新增 `npm run lint`(`tools/lint.mjs`)**:不引入 eslint(本项目零依赖),只查两条真出过问题的:未使用的 import、以及测试里的恒真断言 `ok(true, …)`。
|
|
360
|
+
- **清掉 9 处恒真断言**:`ok(true, '临时目录已清理')` 这类直接删除(清理动作仍在,只是不再假报一条绿);`r1-maintain-persist` 那条「没产生归档就跳过」改成**前置条件失败即红**;`smoke` 的 `disposer 可调用` 改成真断言「调用没抛错」。
|
|
361
|
+
- **修掉 1 处未使用导入**:`core/api-token.js` 的 `serviceOf`。
|
|
362
|
+
|
|
363
|
+
---
|
|
364
|
+
|
|
365
|
+
## 0.9.5 · 2026-11-07
|
|
366
|
+
|
|
367
|
+
### 修复
|
|
368
|
+
|
|
369
|
+
- **清理对话记录可能早删一天**(P2-20):`dateKeyOf` 用的是 UTC,而引擎其它所有日期键都是本地时间。东八区晚上 8 点后本地已是第二天、UTC 还是当天 —— 清理时算错「今天」,把还该留的那天删掉。现在统一本地口径。
|
|
370
|
+
- **项目卡损坏在设置页看不见**(P2-21):`memoryHealth` 原来只查全局卡。现在把全局卡与所有项目卡一起汇总(含已被改名的 `.corrupt-*`),并指出是哪一张。
|
|
371
|
+
- **`soul_diary` 正文没有字数上限**(P2-32):一次写几万字会持续撑爆每轮注入预算。现在与 `notes` 同量级卡在 20000 字,并明确告诉她原因。
|
|
372
|
+
- **看门狗间隔改配置不生效**(P2-22):原来启动时读一次就固定。现在 1 分钟滴答、每次现读配置。
|
|
373
|
+
- **维护失败当天不再重试**(P2-24):`dailyHour` 模式下 `maintainClock.day` 原来在维护**执行前**就置位,抛错当天就再也不跑。现在置位挪到成功之后。
|
|
374
|
+
- **日记启动流程双层预算嵌套**(P2-23):两次 `runDiaryOnce` 原来各吃满 12 分钟,追补最长 ~24 分钟;现在共用一份预算。
|
|
375
|
+
- **「错误边界」其实不是错误边界**(P2-27):它只监听 `window.error`,接不住未处理的 Promise 拒绝(而设置页最多的就是 fetch 失败)。现在补上 `unhandledrejection`。**渲染期抛错仍会白屏** —— 真正的 React 边界需要 `Component` 基类,这段 bundle 的作用域里没有,不假装已解决。
|
|
376
|
+
|
|
377
|
+
---
|
|
378
|
+
|
|
379
|
+
## 0.9.4 · 2026-11-07
|
|
380
|
+
|
|
381
|
+
### 安全
|
|
382
|
+
|
|
383
|
+
- **限流在反代下退化成全局单桶**(P2-16):原来只按 `remoteAddress` 分桶,反代后面所有人的来源都是代理地址 —— 一个远程用户把 `/session` 桶打空就能锁死所有人的设置页。现在持有效令牌的请求按**令牌摘要**分桶,无令牌的仍按来源 IP。
|
|
384
|
+
- **新增 `DSH_SOUL_TRUSTED_PROXY=1`**(反代来源折中):开启后限流分桶与日志用 `X-Forwarded-For` / `X-Real-IP` 里的真实来源。**只影响日志与分桶,不参与任何授权判定** —— 这两个头客户端可伪造,配错最坏是限流变松,不会提权。
|
|
385
|
+
- **会话令牌 24 小时自动轮换**(P2-15):原来令牌永不变化,泄露后只能重启。现在到期自动换(前端 401 后自己重新取,用户无感);另加 `POST /session/rotate` 手动作废(要带当前令牌)。
|
|
386
|
+
- **prompt-guard 的混合宽度与零宽字符绕过**(P2-17):`<`…`>`、`<`…`>` 这类混搭、以及 `</untr\u200Busted_data>` 这种零宽插入,原来都不中和。现在先清零宽字符,再按混合宽度规则中和。
|
|
387
|
+
- **echo 段切在闭合标签中间**(P2-18):原来先包边界再 `slice` 截断,超预算时会切掉闭合标签;改成先裁正文再包。
|
|
388
|
+
|
|
389
|
+
### 变更
|
|
390
|
+
|
|
391
|
+
- 新增环境变量 `DSH_SOUL_TRUSTED_PROXY`(见 README「反向代理部署」)。
|
|
392
|
+
- 新增路由 `POST /session/rotate`。
|
|
393
|
+
|
|
394
|
+
---
|
|
395
|
+
|
|
396
|
+
## 0.9.3 · 2026-11-07
|
|
397
|
+
|
|
398
|
+
### 性能
|
|
399
|
+
|
|
400
|
+
这一批**不改变任何对外行为**,只是少做无用功。
|
|
401
|
+
|
|
402
|
+
- **第 201 个会话会让其余会话集体失忆**(P2-10):8 处 `if (map.size > N) map.clear()` 改成 `trimMap(map, N)`(只淘汰最旧的)。原来清空意味着重注人格、去重表失效、游标从头重扫全量事件。
|
|
403
|
+
- **日志每行 4 次系统调用**(P2-1):`mkdirSync` / `chmodSync` 改成每个文件只做一次(Windows 上 chmod 原来每行抛一次异常再吞掉)。目录被删、权限变化时会在同一次调用里自愈并重试一次。
|
|
404
|
+
- **`snapshotEvents()` 无参全量拷贝**(P2-2):`turnKeyOf` / `hasHumanInputThisTurn` 改成只取尾部 400 条;窗口里没有 assistant 消息(超长工具轮)时**自动退回全量**,不拿正确性换性能。
|
|
405
|
+
- **`readRecentChat` 每次全量 parse 当天 JSONL**(P2-5):按 `(size, mtimeMs)` 缓存,文件一被追加就失效 —— 不需要 TTL 计时器。
|
|
406
|
+
- **`purpose.json` 每回合写盘**(P2-8):drives 是 0~1 的对象,任一维变化 > 0.01 或距上次写盘超 10 分钟才落盘(时间漂移导致的缓慢变化也会定期持久化)。
|
|
407
|
+
|
|
408
|
+
### 新增
|
|
409
|
+
|
|
410
|
+
- `lib/core/lru.js`:`trimMap` / `touchMap`。
|
|
411
|
+
|
|
412
|
+
---
|
|
413
|
+
|
|
414
|
+
## 0.9.2 · 2026-11-07
|
|
415
|
+
|
|
416
|
+
### 修复
|
|
417
|
+
|
|
418
|
+
- **合并路径会把主记忆文件挪走**(P2-12,数据安全级):`saveCardMerged` 在合并前调 `loadCard`,而它的 catch 会 `parkCorrupt` —— 一次瞬时读失败就把主卡改名 + 置只读,随后写盘往空路径写新卡。新增无副作用读 `readCardQuietly`,合并与写后回读都改用它;`loadCard` 只留给真正的加载路径。
|
|
419
|
+
- **鉴权链没有任何兜底**:Origin / Host / 回环 / 令牌四段校验原先裸奔在 handler 体里,任何一段将来抛错都会逃出 `webServer` → 未捕获 → **宿主进程退出**。现在整段包一层 catch,异常记日志 + 回 500 + 追踪码。
|
|
420
|
+
- **自定义 judge provider 静默失败**(P2-19):`judgeProvider` 配成非 siliconflow 时会把 provider 原样交给宿主,宿主不认识就每轮判定失败、只留一行日志,表现为「她情绪一直不变」。现在第一次调用就明确告警。
|
|
421
|
+
- **设置页改配置会丢**(P2-25/26):三个 Tab 原来都 POST **全量**配置,跨 Tab 保存互相覆盖;文本输入框还是逐键 POST。现在各 Tab 只发改动键(服务端本就按 key 合并),并加 300ms 防抖。
|
|
422
|
+
- **记忆搜索逐键重取**(P2-28):带 query 时 300ms 防抖。
|
|
423
|
+
- **日记「文件存在但不完整」死循环**:`startupWork` 判定要重写,但 `askAgentToWrite` 只要看到文件存在就认为「她写好了」,于是每轮空转、日志写「日记完成」,内容永远补不回来。现在「要不要再找她写」多了时间基线(`shouldAskAgain`)。
|
|
424
|
+
- **兜底覆盖她迟到写出的日记**:`waitForWrite` 超时后插件兜底写盘,会盖掉她几秒后落盘的那篇。`writeDiaryFile` 增加 `skipIfNewerThan`,比她旧才写。
|
|
425
|
+
- **`lastTalkAtOf` 只扫末 80 行**:文件本就整份读进内存,只遍历尾部纯属遗留写法;多会话交错时最后一句会被挤出窗口,导致「半天版」被判完整。
|
|
426
|
+
- **固定区(pinned / initial)无上限**:固定区有独立预算(`injectMaxChars × 2`),2 倍以内宁可超出也完整保留,超过才裁并明说「还有 N 条这轮没放下」。
|
|
427
|
+
- **游标在 `snapshotEvents` 抛错时不推进**:现在一定推进,且整卡注入只宽限一次。
|
|
428
|
+
- **`mountedOffs` 强引用**:改存 `WeakRef`,会话关闭后 agent 可被回收。
|
|
429
|
+
- **喂给 `drives` 的素材顺序**:由「数组尾部 12 条」改为按 `lastSeenAt`(最近被想起)优先排序。
|
|
430
|
+
- **跨进程写卡竞态**:写后回读 `rev`,发现被别人覆盖时记日志(**只检测,不自动重写**)。
|
|
431
|
+
|
|
432
|
+
### 变更
|
|
433
|
+
|
|
434
|
+
- `lib/state/maintain.js` 新增 `pickRecentMaterials`(纯函数,可单独测)。
|
|
435
|
+
- `lib/memory/card-io.js` 新增 `readCardQuietly`(无副作用读卡)。
|
|
436
|
+
- 客户端新增 `apiPostDebounced`(按 key 防抖的 POST)。
|
|
437
|
+
|
|
438
|
+
---
|
|
439
|
+
|
|
440
|
+
## 0.9.1 · 2026-11-07
|
|
441
|
+
|
|
442
|
+
### 修复(安全)
|
|
443
|
+
|
|
444
|
+
- **反代部署下 `/api/soul/*` 全量 403**([#1](https://github.com/danshuyue/dsh-agent-soul/issues/1)):
|
|
445
|
+
Host 判定改为**以宿主为准** —— 先问 `ctx.connection.requestRejection(req)`,
|
|
446
|
+
`null` 放行、`401`(宿主侧未登录)放行到插件自己的 `x-soul-token` 校验、`403` 才拒;
|
|
447
|
+
宿主不可用 / 抛错时退回插件白名单。原来插件自维护信任名单,与宿主 `--trusted-host` 两套 fence 打架。
|
|
448
|
+
- **任意文件读取**(`GET /state?cwd=<任意目录>` 可读该目录 `AGENT.md` 前 400 字):
|
|
449
|
+
cwd 归属校验收口,`GET /persona` 一并补上。
|
|
450
|
+
- **`GET /persona` 绕过 cwd 归属校验**且返回全文。
|
|
451
|
+
- **UNC / 设备路径**(`\\host\share`、`\\.\`、`\\?\`):`statSync` 会发起 SMB 连接并携带 NTLM 凭据,且同步阻塞事件循环。现在字符串阶段直接拒,`statSync` 挪到归属判定之后。
|
|
452
|
+
- **`sec-fetch-site` 值拼错**(`'samesite'` ≠ `'same-site'`),同站防线此前从未生效。
|
|
453
|
+
- **错误原文回显**:`/pick`、`/persona` 保存、`/open` 三处不再把含绝对路径的 `error.message` 回给客户端,改为固定文案 + 追踪码。
|
|
454
|
+
- **数据边界可伪造**:`<user_data>` 换成带内容哈希 nonce 的 `<untrusted_data>`,内容拼不出真闭合标签;人格段补 `PERSONA_GUARD` 声明。
|
|
455
|
+
- **配置数值无上限**:新增 `NUMBER_RANGES` 覆盖 35 个数值键,越界拒绝(此前 `diaryAgentTimeoutMs = 1e12` 也能存)。
|
|
456
|
+
- **日记主流程无总超时**:12 分钟总预算 + 超时后 orphan 防重入。
|
|
457
|
+
- **`/register` 反向放行归属校验**:新增写侧唯一入口 `resolvePostCwd`。
|
|
458
|
+
- **PowerShell 回退链是断的**(裸名字分支直接 return,第三级永远不可达);顺带校验 DPAPI 输出,避免存下解不开的空密文。
|
|
459
|
+
- **`POST /memory` 的 `edit` 分支绕过脱敏**。
|
|
460
|
+
- **`maintain` 无视 `projectMemoryEnabled`**。
|
|
461
|
+
- **记忆卡容量到顶且无可压缩项时仍 `push`**。
|
|
462
|
+
- **Origin/Host 端口比较**:`String(host).split(':')[1]` 对无端口的 Host 与 `[::1]:8080` 都恒不相等;改为规范化权威比较,两端同为回环时允许端口不同。
|
|
463
|
+
|
|
464
|
+
### 变更
|
|
465
|
+
|
|
466
|
+
- 新增一次性提示:接口被非本机 Host 访问时在日志里提醒(只记一次)。
|
|
467
|
+
|
|
468
|
+
### 破坏性
|
|
469
|
+
|
|
470
|
+
- **`POST /register` 不再接受任意路径**:只接受「已登记 / 宿主会话给的 / `DSH_HOME` 内」。设置页「把路径粘到输入框」这条路关闭,请改用「选择文件夹」。
|
|
471
|
+
- **`POST /config` 数值越界返回 400**(此前静默接受)。
|
|
472
|
+
- `DSH_SOUL_POWERSHELL` 指向不存在的路径时保存密钥直接失败,不再静默回退。
|
|
473
|
+
|
|
474
|
+
---
|
|
475
|
+
|
|
476
|
+
## 0.9.0 · 2026-11-06
|
|
477
|
+
|
|
478
|
+
### 变更
|
|
479
|
+
|
|
480
|
+
- **模块化重构**:`lib/` 拆成 95 个模块(`host/runtime`、`memory/`、`state/`、`diary/`、`http/`、`core/`)。
|
|
481
|
+
- 新增契约门禁三件套:导出快照、行为 golden、依赖图;刷基线必须写明理由并留痕。
|
|
482
|
+
|
|
483
|
+
### 破坏性
|
|
484
|
+
|
|
485
|
+
- **新增 Host 白名单**(见 `0.8.3`):`/api/soul/*` 只接受 `localhost` / `127.0.0.1` / `[::1]` / `::1`
|
|
486
|
+
以及 `DSH_SOUL_ALLOWED_HOSTS` 里的值。**反向代理 + 公网域名/IP 的部署会整页 403** ——
|
|
487
|
+
这就是 `0.9.1` 修的那条([#1](https://github.com/danshuyue/dsh-agent-soul/issues/1))。
|
|
488
|
+
当时没有写进任何变更说明,是本项目的流程失误。
|
|
489
|
+
|
|
490
|
+
---
|
|
491
|
+
|
|
492
|
+
## 0.8.3 · 2026-11-06
|
|
493
|
+
|
|
494
|
+
### 变更
|
|
495
|
+
|
|
496
|
+
- 加固(R2/R3/R4):**Host 白名单**、`localNames` 只认纯文件名、回环门控下沉。
|
|
497
|
+
|
|
498
|
+
> **注意**:`DSH_SOUL_ALLOWED_HOSTS` 是 `DSH_` 前缀的启动期变量,**只能**通过
|
|
499
|
+
> `systemd Environment=` / `docker -e` / shell `export` 设置。写进 `.env` 会让 dsh 直接启动失败。
|
|
500
|
+
|
|
501
|
+
---
|
|
502
|
+
|
|
503
|
+
## 0.8.0 – 0.8.2 · 2026-11-05 / 11-06
|
|
504
|
+
|
|
505
|
+
无变更记录(本文件从 `0.9.2` 起才存在)。这几个版本没有 Host 白名单。
|