dsh-agent-soul 0.9.8 → 0.9.9

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,31 @@
7
7
 
8
8
  ---
9
9
 
10
+ ## 0.9.9 · 2026-11-09
11
+
12
+ 外部复检轮 **R14**(按 `docs/HANDOFF.md` §8 只交付不发布),本会话逐条复核后合并发布。
13
+ 4 文件 / +201 −25 / 1 个提交;四条修复**全部经毒化复核**确认「不修会红」。
14
+
15
+ ### 修复
16
+
17
+ - **笔记页反复误报「已变更」**(#20):`reconcile()` 的 `changed` 判据原来按**索引对位**比较,
18
+ 索引条目顺序一变(并发写索引、新建一篇 push 到尾部)每个对位都失配 → 恒 `changed=true` → 反复写盘。
19
+ 现在按 slug 建 Map 逐条比内容,顺序无关。
20
+ - **`readNote` 返回索引里的旧值**(#21):文件被外部改写后,`loadIndex()` 给的 `chars/summary`
21
+ 与磁盘不符。现在统一走 `reconcile()`(与 `listNotes()` 同口径)。
22
+ - **长订单号/雪花 ID 被当卡号抹掉且不可恢复**(#15):原来 `\b\d{16,19}\b` 见长数字就抹。
23
+ 现在改 **Luhn 校验 + 发卡前缀(3–6 开头)** 双判;不过 Luhn 但前文紧挨「卡号/银行卡/尾号」等
24
+ 上下文词的,仍兜底照抹。真卡号漏抹概率≈0(主流发卡组织强制 Luhn),随机长订单号命中率从 100% 降到约 1/25。
25
+ - **会话下拉的扫盘兜底每次全量扫**(#2):服务不可用/无活会话时的兜底路径加 60 秒 TTL 缓存。
26
+ 代价是新会话最多晚一分钟出现在下拉里(低频低精度展示,可接受)。
27
+
28
+ ### 变更
29
+
30
+ - `lib/memory/signals.js` 新增模块内私有 `luhnLike`、`CARD_CONTEXT_RE` —— **无新增导出**,契约快照不变。
31
+ - 文档更正:`KNOWN-ISSUES` 原把 #15 的位置写成 `lib/extract.js`,实现在 `lib/memory/signals.js`。
32
+
33
+ ---
34
+
10
35
  ## 0.9.8 · 2026-11-08
11
36
 
12
37
  本版是 **R13(外部复检轮)的合并 + 一处复核修复**。R13 有 5 个提交、26 文件、+628/−157,
@@ -0,0 +1,383 @@
1
+ # 交接文档 · dsh-agent-soul `0.9.9`
2
+
3
+ > 给接手的人(或 AI)。读完这一份就能开工,不需要翻聊天记录。
4
+ > 写作时间:2026-11-08(0.9.9 于 2026-11-09 更新)· 对应提交 `1b51d58` · tag `v0.9.9` · npm `latest = 0.9.9`
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
+ | 测试 | **85** 个测试文件 / 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. 当前遗留(8 条,全部是「结构」而非「功能」)
195
+
196
+ > 完整版在 [`docs/KNOWN-ISSUES.md`](KNOWN-ISSUES.md),每条带代码位置、影响、建议改法、验证程度(A 实测 / B 读代码 / C 仅归档)。
197
+ >
198
+ > **`0.9.9` 之后,「某个功能坏了」类的已知问题已经清零。** 剩下的只有一类:**代码结构**。
199
+
200
+ ### 唯一的「用户能感觉到」的一条
201
+
202
+ | # | 问题 | 位置 | 建议 |
203
+ |---|---|---|---|
204
+ | **23** | 「错误边界」接不住**渲染期**异常 → 白屏 | `lib/client/app.js` | 需要 `React.Component` 基类;本 bundle 作用域里没有,**做不了**,只能等宿主暴露 |
205
+
206
+ ### 可维护性(7 条,改起来有风险、但改了不解决用户问题)
207
+
208
+ | # | 问题 | 建议 |
209
+ |---|---|---|
210
+ | **26** | `diary/scheduler.js` 687 行混五种职责 | 拆 `diary/agent.js` + `diary/deliver.js` |
211
+ | **27** | `diary/compose.js` 591 行四类职责,`composeDiarySetup` 放错位置 | 移到 `scheduler` 或 `diary/agent.js` |
212
+ | **28** | `segment-memory.js` 的 `text()` ~150 行、8 种职责的上帝函数 | 拆 `runToneForTurn` / `collectDiaryMaterial` / `computeRecallText` / `applyBudget` |
213
+ | **32** | `build-client.mjs` 的 `ORDER` 硬编码;`DECL_RE` 只认 4 空格的 `var/function` | 自动扫描片段 + 放宽正则(`let/const` 现在逃检) |
214
+ | **33** | `revOf` 三处重复、`pad2`/`dateKeyOf` 同构重复、测试断言工具复制 40+ 份 | 收敛到 `constants.js` 与 `tests/helpers/` |
215
+ | **34** | `summarizeConversations` 死代码仍从门面导出;`askAgentToWrite` 的 `force` 参数恒 false | 删掉或标注 |
216
+ | **35** | `docs/preview.html` 手抄 `styles.js` 整套 CSS | 生成或加一致性检查 |
217
+
218
+ ### 明确「不修」的(想清楚了,别捡起来)
219
+
220
+ | 项 | 为什么 |
221
+ |---|---|
222
+ | 反代下 `isLoopbackRequest()` 恒真 | 代理会把 `remoteAddress` 变成 `127.0.0.1`,插件侧没有可靠信号区分真实远端。`DSH_SOUL_TRUSTED_PROXY` **只用于分桶与日志,不参与授权** —— 把那两个可伪造的头当授权依据就是提权漏洞 |
223
+ | 跨进程写卡不自动重写 | 已检测+告警;自动重写要给**每次**写盘加成本,而多进程并发是低频 |
224
+ | P3 大部分 | 改了不解决任何用户问题 |
225
+
226
+ ### 仍「待确认」的 2 条(依赖宿主行为,仓库里验不了)
227
+
228
+ | 项 | 兜法 |
229
+ |---|---|
230
+ | 压缩会话的 `snapshotEvents` 会不会抛 | 抛了也不推进锁:游标一定推进、整卡注入只宽限一次。**报「新会话没人格」先查这里** |
231
+ | 反代 + 非默认端口下 `Origin`/`Host` 形态 | 已按规范化权威比较;被拒时 403 响应体带 `origin`/`host` 可对照 |
232
+
233
+ ---
234
+
235
+ ## 6. 建议的下一轮顺序(0.9.9 后)
236
+
237
+ **功能类问题已清零**,剩下的都是重构。顺序建议:
238
+
239
+ 1. **`#28 segment-memory.js` 的 `text()`** —— 8 种职责、~150 行。它是最难单测的一块,
240
+ 先补特征测试再拆;拆成 `runToneForTurn` / `collectDiaryMaterial` / `computeRecallText` / `applyBudget`。
241
+ 2. **`#27 diary/compose.js`** —— 591 行四职责,`composeDiarySetup` 放错位置,移到 `scheduler` 或 `diary/agent.js`。
242
+ 3. **`#26 diary/scheduler.js`** —— 687 行五职责,拆 `diary/agent.js` + `diary/deliver.js`。
243
+ **必须放最后**:它依赖前两步的产物,先拆它会把 compose 的边界搞得更乱。
244
+ 4. **`#32–#35`(零风险清理)** —— 构建脚本硬编码、重复实现、死代码、预览页 CSS。
245
+ 可以和上面同轮做,也可以单独一次提交。
246
+ 5. **`#23`** —— 除非宿主文档明确暴露了 `React.Component`,否则不要动。
247
+
248
+ > 重构的纪律:**每一轮只拆一个文件**,拆之前先把该文件的特征测试补齐(断言当前行为,而不是理想行为),
249
+ > 拆完测试必须一条不改就全绿。做不到就说明拆错了。
250
+
251
+ ---
252
+
253
+ ## 7. 环境坑(Windows 为主,踩过才知道)
254
+
255
+ | 坑 | 表现 | 解法 |
256
+ |---|---|---|
257
+ | PowerShell 5.1 的 `Get-Content`/`ConvertFrom-Json` | 中文变乱码、UTF-8 被当 GBK | 用 `write`/`read` 工具编辑文件;或 `[System.IO.File]::ReadAllText($p, [Text.Encoding]::UTF8)` |
258
+ | `Set-Content -Encoding utf8` | 加 BOM,JSON 解析失败 | 用 `[System.IO.File]::WriteAllText($p, $s, (New-Object Text.UTF8Encoding($false)))` |
259
+ | CRLF | 多行字符串 `match`/`replace` 锚点对不上 | 用 `\r?\n` 的正则,别用字面换行 |
260
+ | 测试互相踩 `DSH_HOME` | 随机 ENOENT / 数据串味 | 每个测试文件 `mkdtempSync` 独立目录,结束时删 |
261
+ | 时区 | 日期相关断言漂 | 跑测试固定 `TZ=UTC`;代码里**不要**再用 `toISOString().slice(0,10)` 当本地日期 |
262
+ | `gh` 偶发 502 | 查不到 CI | 抓 `https://github.com/<repo>/actions` 页面看「completed successfully / failure」 |
263
+ | npm publish 后立刻 `npm view` | 报 404 / notarget | **发布方的事**;你在交付里别碰发布,就不会踩到 |
264
+
265
+ ---
266
+
267
+ ## 8. 交付流程(你只交付,不发布)
268
+
269
+ ### 8.1 你要做的
270
+
271
+ ```bash
272
+ # 1. 从干净的 main 拉一个分支(不要直接在 main 上改)
273
+ git switch -c fix/your-topic main
274
+
275
+ # 2. 改代码 + 补测试 + 走 REDGREEN(§4②)
276
+
277
+ # 3. 验证(三道,缺一不可)
278
+ npm run lint
279
+ npm test
280
+ npm run test:contracts
281
+ git diff --exit-code -- lib/client.js tests/contract/ # 必须干净
282
+
283
+ # 4. 提交到**自己的分支**(不推 main)
284
+ git add -A && git commit -m "..."
285
+
286
+ # 5. 打包交付物(见 8.2)
287
+ ```
288
+
289
+ **不要做的事**:`npm publish` / `git tag` / 改 `package.json` 的 `version` / 改 `CHANGELOG.md`。
290
+
291
+ > 版本号、CHANGELOG、tag、npm、安装副本这五处的一致性由发布者统一处理。
292
+ > 你改了版本号,合并时就要多解一次冲突,而冲突解法一旦错,发布的版本号就是错的那一个。
293
+
294
+ ### 8.2 交付物(四样,缺一样复核就会慢一半)
295
+
296
+ | 交付物 | 内容 | 为什么需要 |
297
+ |---|---|---|
298
+ | **分支** | `fix/your-topic`(能 push 到远端最好;不能就给 diff) | 复核时我会直接合并 + 跑全量,比看 diff 可靠 |
299
+ | **diff 文件** | `git diff main...fix/your-topic > xxx.diff`,并报「N 文件 / +A / −D」 | 快速对账:我合并后 `git diff --stat` 必须和你报的一致 |
300
+ | **进度档案** | 每条修复一个编号:**症状 → 改法 → 证据** | 「已修」两个字在上一轮骗过人(#1) |
301
+ | **测试证据** | 每条修复对应哪个测试、断言几条、**毒化后是否变红** | 这是唯一能证明「真修了」的东西 |
302
+
303
+ **进度档案模板**(每条都这么写):
304
+
305
+ ```md
306
+ ### #20 notes reconcile 按索引对位比较
307
+
308
+ - 症状:笔记页反复显示「已变更」;顺序一变就误报
309
+ - 位置:lib/notes.js:reconcile()
310
+ - 改法:改按 slug 建 Map 比较
311
+ - 测试:tests/xxx.test.js 第 3 节,5 条断言
312
+ - REDGREEN:把比较改回索引对位 → 第 4、5 条断言变红;恢复 → 绿
313
+ - 兼容性:老索引文件是否需要迁移?说明结论
314
+ ```
315
+
316
+ ### 8.3 复核会看什么(提前对齐,省一轮返工)
317
+
318
+ 1. **合并后**全量测试 + 契约 + lint 是否仍绿(不是你那棵树绿,是**合并进 main 之后**绿);
319
+ 2. **`lib/client.js` 能不能重建**:我会跑 `node tools/build-client.mjs` 要求零 diff;
320
+ 顺带检查 `d243fd7` 加的第三方署名注释没被覆盖;
321
+ 3. **有没有偷偷改既有测试**:`git diff main -- tests/` 里除了新增文件,其余改动要能解释;
322
+ 4. **契约基线是否走正规通道**:`SNAPSHOT_CHANGES.md` 里有没有带理由的记录;
323
+ 5. **逐条 REDGREEN 抽查**:我会挑 1–3 条自己毒化一遍,看是不是真红;
324
+ 6. **有没有顺手引入新依赖 / 硬编码路径 / 平台假设**。
325
+
326
+ 上一轮就是第 5 条抓出的问题:`#1` 的修复声称已修,测试也加了,
327
+ 但补的测试**修没修都是绿的**(前缀字节数让 UTF-8 切点正好落在字与字之间)。
328
+
329
+ ### 8.4 发布由谁做
330
+
331
+ 复核通过后,由委托方的常驻助手统一执行:
332
+
333
+ ```bash
334
+ # 版本号 / CHANGELOG / tag / npm / 安装副本同步 —— 这五步只在一处做
335
+ ```
336
+
337
+ 所以你在交付文档里**只要说清「改了什么、为什么、怎么验」**,不需要替我考虑发版。
338
+
339
+ ---
340
+
341
+ ## 9. 排查线索
342
+
343
+ ```
344
+ C:\Users\Administrator\.dsh\agents\soul.log ← 第一手线索,永远先看这里
345
+ ```
346
+
347
+ 日志是**本地时间**、带 `+08:00` 偏移。关键 tag:
348
+ `[apply]` 启动/装配 · `[api]` 接口 · `[memory]` 记忆 · `[diary]` 日记 · `[mood]` 心情 ·
349
+ `[tick]` 每回合维护 · `[extract]` 提取 · `[attest]` 装配证词。
350
+
351
+ **几条「看着像 bug 其实不是」的日志**:
352
+
353
+ | 日志 | 真相 |
354
+ |---|---|
355
+ | `[mood] 心情判定用的是自定义 provider「xxx」(不是 siliconflow)…` | 一次性告警,提醒「宿主不认识这个 provider 会让心情静默停摆」。看到它就往下翻一行确认判定是否成功 |
356
+ | `[memory]「想起来了」被去重挡空,已把去重表收到 N 条重试` | 设计好的退化:全被挡掉时缩小去重表重试,不会注入空段 |
357
+ | `[diary] 2026-11-xx 两篇都已写完,跳过` | 看门狗每 60 分钟检查一次,正常 |
358
+ | `[api] 设置页接口已注册` 后紧跟 `[diary] 看门狗已启动` | 正常启动序列,共约 11 行 |
359
+
360
+ ---
361
+
362
+ ## 10. 交接边界(这些不要自作主张)
363
+
364
+ 1. **不要发布** —— 不 `npm publish`、不打 tag、不改版本号、不改 `CHANGELOG.md`(见 §8)。
365
+ 2. **不要给鉴权加 trust-proxy 授权** —— 见 §5「明确不修」第一条。
366
+ 3. **不要手改 `tests/contract/*.json`** —— 走 `SOUL_UPDATE_SNAPSHOT`。
367
+ 4. **不要在读取路径写盘** —— `readCardQuietly` 就是为此而存在的:
368
+ `loadCard` 会 `parkCorrupt`(把坏卡改名+置只读),读取路径**绝不能**用它。
369
+ 5. **不要动 `lib/client.js`**(构建产物)—— 改 `lib/client/*.js` 片段后重建。
370
+ 6. **不要给 `lib/index.js` 的注入段改顺序** —— 顺序决定提示词结构,改了要同步契约与文档。
371
+ 7. **不要在源码里写死盘符、用户名、IP** —— 测试与公开仓库都会带上。
372
+
373
+ ---
374
+
375
+ ## 11. 一句话给接手的人
376
+
377
+ 这个项目最大的风险不是「功能不够」,而是**「看起来绿了,其实没测到」**。
378
+ `0.9.8` 里那条 UTF-8 bug 就是这么漏出去的:修复写了、测试也补了,但补的测试是假绿 ——
379
+ 而它正是上一轮外部交接时漏过来的。
380
+
381
+ 所以规矩只有一条:**改完先证明「不修会红」,再证明「修了会绿」。**
382
+
383
+ 至于发布:**你只管把证据备齐,发不发、什么时候发,由复核方定。**
@@ -1,7 +1,11 @@
1
- # 已知问题清单(截至 0.9.7;2026-11-08 R13 轮划掉 23 条)
1
+ # 已知问题清单(截至 0.9.9;R13 划掉 23 条,R14 再划 4 条)
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
+ > **仍打开:#23 #26–#28 #32–#35 与第五、六节。**
5
9
  >
6
10
  > **2026-11-08 复核补丁(0.9.8)**:R13 的 #1(`/diary/list` 只读头部 400 字节)按字节切 UTF-8,
7
11
  > 中文预览末尾会出现 `�`(U+FFFD)—— 400 % 3 ≠ 0,边界必然落在汉字中间。
@@ -13,8 +17,8 @@
13
17
  > 每条都标了「验证程度」,方便判断可信度:
14
18
  > **A = 读代码 + 实测复现过**,**B = 读代码确认**,**C = 只按报告描述归档,未逐行核**。
15
19
  >
16
- > 状态:`0.9.1`–`0.9.6` 清掉了全部 14 条 P1 与大部分 P2。下面剩下的**没有一条会立刻让插件罢工**,
17
- > 但每一条都会在特定条件下让人踩到。
20
+ > 状态:`0.9.1`–`0.9.6` 清掉全部 14 条 P1 与大部分 P2;R13 清 23 条、R14 清 4 条。
21
+ > 下面剩下的**没有一条会立刻让插件罢工**,但每一条都会在特定条件下让人踩到。
18
22
 
19
23
  ---
20
24
 
@@ -23,7 +27,7 @@
23
27
  | # | 问题 | 位置 | 影响 | 建议 | 验证 |
24
28
  |---|---|---|---|---|---|
25
29
  | ~~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 |
30
+ | ~~2~~ ✅已修(2026-11-09 R14) | `/diary/sessions` 两层 `readdir` + 逐目录 `stat` 兜底 | `lib/http/sessions.js` | 会话目录多时列表慢 | 加 TTL 缓存 + `withFileTypes` 一次拿全 | B |
27
31
  | ~~3~~ ✅已修(2026-11-08 R13) | `saveCard` 每次写盘前**完整解析旧文件**(只为判断能否备份)+ `copyFileSync` | `lib/memory/card-io.js` | 记忆写入路径多一次全量解析 | 本进程写过的可跳过解析;备份改硬链接/懒备份 | B |
28
32
  | ~~4~~ ✅已修(2026-11-08 R13) | `recallArchived` 读**全部**归档分片再截 tail | `lib/memory/card-io.js` | 归档攒多之后查历史慢 | 旧分片只读尾块 | B |
29
33
  | ~~5~~ ✅已修(2026-11-08 R13) | v1→v2 迁移失败时,每次 `loadCard` 都重试写盘 + 刷日志(且改写 mtime 使缓存 stamp 永远失配) | `lib/memory/card-io.js` | 一张老卡能刷满日志、并让缓存失效 | 迁移失败加退避 + `note` 节流;别在读取路径写盘 | B |
@@ -46,13 +50,13 @@
46
50
  | ~~12~~ ✅已修(2026-11-08 R13) | `validateConfigEntry` 的控制字符黑名单漏 C1 区(`\u0080-\u009F`)与 `U+2028/2029` | `lib/http/middleware.js` | 某些行分隔符能进配置值 | 改用 `/\p{Cc}\|[\u2028\u2029]/u` | B |
47
51
  | ~~13~~ ✅已修(2026-11-08 R13) | `mergeCards` 合并 `stats` 时漏了 `decayed` 字段 | `lib/memory/card.js` | 跨进程合并后衰减计数丢失 | 补字段 | B |
48
52
  | ~~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 |
53
+ | ~~15~~ ✅已修(2026-11-09 R14) | `redact` 的银行卡正则 `\b\d{16,19}\b` 误伤长订单号/雪花 ID,且不可恢复 | `lib/memory/signals.js`(原写 extract.js,实现在这里) | 正常内容被抹成 `[卡号]` | 改 Luhn + 发卡前缀(3–6)+ 上下文词兜底 | B |
50
54
  | ~~16~~ ✅已修(2026-11-08 R13) | `diaryWindowOf` 对 NaN 月/日静默回退成 1 月窗口 | `lib/diary/compose.js` | 坏日期会读错时间段 | 显式判 NaN 并返回空窗口 | B |
51
55
  | ~~17~~ ✅已修(2026-11-08 R13) | 日志轮转归档名精确到**分钟**,同分钟二次轮转覆盖/失败 | `lib/env.js` | 极端情况下丢一份归档 | 归档名加序号或毫秒 | B |
52
56
  | ~~18~~ ✅已修(2026-11-08 R13) | `diary-pick.js` 的布尔优先级可疑(`&&` 先于 `\|\|`) | `lib/core/diary-pick.js` | 选会话的条件可能和注释不符 | 加括号 + 补测试 | C |
53
57
  | ~~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 |
58
+ | ~~20~~ ✅已修(2026-11-09 R14) | `notes reconcile` 按**索引**对位比较,顺序一变就误报 `changed` | `lib/notes.js` | 笔记索引反复刷新 | 改按 slug 建 Map 比较 | B |
59
+ | ~~21~~ ✅已修(2026-11-09 R14) | `readNote` 用 `loadIndex` 而不是 `reconcile` | `lib/notes.js` | 可能返回已删文件的条目 | 统一走 reconcile | B |
56
60
 
57
61
  ---
58
62
 
@@ -103,13 +107,18 @@
103
107
 
104
108
  ---
105
109
 
106
- ## 七、建议的下一轮顺序
110
+ ## 七、建议的下一轮顺序(0.9.9 后更新)
111
+
112
+ 前四批(一致性 / 日志请求层 / 性能 / 前端里的多数)已在 R13、R14 清完。剩下的是:
113
+
114
+ 1. **重构:#26–#28**(三个大文件)—— **单独一轮**,先补特征测试再拆。这是当前最大的一块技术债,
115
+ 也是后面所有改动的摩擦来源。建议顺序:`segment-memory.js` 的 `text()` → `diary/compose.js` → `diary/scheduler.js`。
116
+ 2. **#32–#35**(构建脚本硬编码、重复实现、死代码、预览页 CSS)—— 零风险清理,可以和重构同轮做。
117
+ 3. **#23**(渲染期白屏)—— 除非宿主文档明确暴露了 `React.Component`,否则不要动。
118
+ 4. **第五节「不修」的 3 类** —— 保持不修,理由已写。
107
119
 
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 三个大文件(要单独一轮,且必须在测试稳定之后)。
120
+ > 这一轮之后,**「某个功能坏了」类的已知问题已经清零**,剩下的都是「代码结构不好」和
121
+ > 「特定部署形态下才成立」的差异。换句话说:功能面可以放心用,改造成本才是接下来要还的账。
113
122
 
114
123
  ---
115
124
 
@@ -60,6 +60,11 @@ export function currentSessionIdOf(ctx) {
60
60
  *
61
61
  * @returns {Array<{id:string,title:string,cwd:string,updatedAt:string}>}
62
62
  */
63
+
64
+ /** 扫盘兜底的 TTL 缓存(2026-11-09 KNOWN-ISSUES #2)。会话下拉低频低精度,60 秒内直接复用。 */
65
+ let fallbackScanCache = null
66
+ const FALLBACK_SCAN_TTL_MS = 60 * 1000
67
+
63
68
  export function listDiarySessions(ctx) {
64
69
  const byId = new Map()
65
70
  // 只取一次,两个来源共用;取不到时是空集合,put 里的判断自然全部放行
@@ -127,32 +132,43 @@ export function listDiarySessions(ctx) {
127
132
 
128
133
  // 服务挂了 / 一个活会话都没有时扫盘。只扫两层:<sessions>/<编码后的 cwd>/<会话 id>/
129
134
  if (byId.size === 0) {
130
- let cwdDirs = []
131
- try {
132
- cwdDirs = readdirSync(sessionsRoot(), { withFileTypes: true })
133
- } catch (error) {
134
- note('api', `日记会话列表:扫盘失败 ${sessionsRoot()}(${error instanceof Error ? error.message : error})`)
135
- }
136
- for (const cwdDir of cwdDirs) {
137
- if (cwdDir.isDirectory() !== true) continue
138
- const cwd = decodeSessionDirName(cwdDir.name)
139
- let sessionDirs = []
135
+ // 2026-11-09 修 KNOWN-ISSUES #2:扫盘兜底原来每次调用都两层 readdir + 逐目录
136
+ // stat —— 服务不可用/无活会话时设置页每刷一次就全量扫一遍。缓存 60 秒:
137
+ // 会话下拉是低频低精度的展示(新会话最多晚一分钟出现),TTL 内直接复用。
138
+ const now = Date.now()
139
+ if (fallbackScanCache !== null && now - fallbackScanCache.at < FALLBACK_SCAN_TTL_MS) {
140
+ for (const raw of fallbackScanCache.entries) put(raw)
141
+ } else {
142
+ const entries = []
143
+ let cwdDirs = []
140
144
  try {
141
- sessionDirs = readdirSync(join(sessionsRoot(), cwdDir.name), { withFileTypes: true })
145
+ cwdDirs = readdirSync(sessionsRoot(), { withFileTypes: true })
142
146
  } catch (error) {
143
- note('api', `日记会话列表:跳过 ${cwdDir.name}(${error instanceof Error ? error.message : error})`)
144
- continue
147
+ note('api', `日记会话列表:扫盘失败 ${sessionsRoot()}(${error instanceof Error ? error.message : error})`)
145
148
  }
146
- for (const sessionDir of sessionDirs) {
147
- if (sessionDir.isDirectory() !== true) continue
148
- let updatedAt = ''
149
+ for (const cwdDir of cwdDirs) {
150
+ if (cwdDir.isDirectory() !== true) continue
151
+ const cwd = decodeSessionDirName(cwdDir.name)
152
+ let sessionDirs = []
149
153
  try {
150
- updatedAt = statSync(join(sessionsRoot(), cwdDir.name, sessionDir.name)).mtime.toISOString()
151
- } catch {
152
- /* 读不到时间就留空 */
154
+ sessionDirs = readdirSync(join(sessionsRoot(), cwdDir.name), { withFileTypes: true })
155
+ } catch (error) {
156
+ note('api', `日记会话列表:跳过 ${cwdDir.name}(${error instanceof Error ? error.message : error})`)
157
+ continue
158
+ }
159
+ for (const sessionDir of sessionDirs) {
160
+ if (sessionDir.isDirectory() !== true) continue
161
+ let updatedAt = ''
162
+ try {
163
+ updatedAt = statSync(join(sessionsRoot(), cwdDir.name, sessionDir.name)).mtime.toISOString()
164
+ } catch {
165
+ /* 读不到时间就留空 */
166
+ }
167
+ entries.push({ id: sessionDir.name, title: '', cwd, updatedAt })
153
168
  }
154
- put({ id: sessionDir.name, title: '', cwd, updatedAt })
155
169
  }
170
+ fallbackScanCache = { at: now, entries }
171
+ for (const raw of entries) put(raw)
156
172
  }
157
173
  }
158
174
 
@@ -1,113 +1,146 @@
1
- /**
2
- * 记忆引擎 · signals.js
3
- * 由 lib/memory.js 按职责拆出(2026-11-06 模块化重构),函数体保持原样。
4
- */
5
-
6
-
7
-
8
- // ---- 语义信号(全部是正则,不调模型) ----
9
-
10
- /** 情绪浓度:强信号 3 分/词,中信号 2 分/词,上限 24。 */
11
- const EMOTION_STRONG_RE = /喜欢|想念|想你|舍不得|难过|委屈|哭|心疼|感动|害怕|孤单|抱歉|对不起|谢谢|抱抱|亲亲|陪伴|永远|最爱|在乎|重要|开心|太好了/g
12
-
13
- const EMOTION_MEDIUM_RE = /有点|挺|蛮|累了|困|饿|烦|郁闷|害羞|生气|讨厌|紧张|激动|惊讶|意外|终于|还好/g
14
-
15
- // ↑ 这两个是数出现次数(match),必须要 g;下面三个只判断「有没有」(test),绝不能带 g。
16
- /** 约定 / 承诺:这类事忘了会出问题,所以加权。 */
17
- export const PROMISE_RE = /答应|约定|说好|以后|下次|记得|不要忘|别忘了|发誓|保证|我会|明天|后天|下周/
18
-
19
- /** 矛盾 / 道歉 / 和好:情绪浓度高,值得记住。 */
20
- export const CONFLICT_RE = /吵架|生气|道歉|对不起|和好|误会|不理你|冷战|凶你|原谅|抱歉/
21
-
22
- /**
23
- * 关于「我」的偏好与长期事实:这是长期有用的画像,才值得留几十年。
24
- *
25
- * 为什么要区分「寒暄」和「长期事实」:
26
- * 「今天问了句编译器怎么配」是寒暄,忘了无所谓;
27
- * 「目标是嵌入式工程师」「喜欢喝冰美式」是画像,忘了就是失忆。
28
- * 光靠重要度分不开这两者(都是主人随口说的),所以单独识别。
29
- */
30
- /**
31
- * ⚠️ 下面这两个正则**不能带 g 标志**。
32
- * `g` 让 RegExp 变成有状态的(每次 test/exec 推进 lastIndex),
33
- * 连续判断多条记忆时会「漏一条、中一条」地跳着匹配 ——
34
- * 症状是「同样的句子,第一次认得出,第二次认不出」,极难排查。
35
- * 要数出现次数的地方(情绪强度)才用 g + match。
36
- */
37
- export const SELF_RE = /我(?:喜欢|讨厌|想要|是|会|在|叫|住|学|做|用|习惯|觉得|认为)|我的|我不|我觉|我准备|我打算|我计划|目标是|专业是|想当|在做|正在做|习惯用|平时用|常用/i
38
-
39
- /** 长期事实类信号:命中就进 self 标签,享受「永不遗忘」保护。 */
40
- export const FACT_RE = /目标是|专业是|想当|在做|正在做|习惯用|平时用|常用|我(?:喜欢|讨厌|习惯|住|学|专业)|我的(?:目标|专业|习惯|电脑)|大学|学院|专业|年级|大[一二三四]|研究生|在读|就读/i
41
-
42
-
43
- /**
44
- * 一次性流水账:吃了什么、穿了几件、几点到哪、天气冷热……
45
- *
46
- * 为什么要单独拦它(2026-10-29 实测发现的坑):
47
- * 「主人私下说的」原本直接 +42,而入选阈值就是 42 —— 等于只要是主人说的、
48
- * 超过 8 个字就必定入库。结果是记忆卡里躺着的五条全是「晚饭是牛肉丸子汤」
49
- * 「多穿了点衣服」,真正该留的画像反而被挤在后面。
50
- * 这类话每一天都在发生,记下来没有复用的价值。
51
- */
52
- export const EPHEMERAL_RE = /吃(?:了|饭|完|过)|(?:早|午|晚|夜)饭|喝(?:了|完)|(?:多|少)穿|穿(?:了|上|着)|天气|气温|(?:不|很|挺|有点)(?:冷|热)|宿舍|寝室|起床|睡了|睡觉|出门|在路上|下课|放学|洗澡|洗漱|刷牙|几点了/
53
-
54
-
55
- /** 「第一次」类事件:天然是锚点。 */
56
- export const FIRST_RE = /第一次|初次|头一次|最开始|刚认识|认识你|纪念日|第一天|从来没有过/
57
-
58
-
59
- /** 脱敏规则:入库前把明显的敏感信息抹掉。 */
60
- const REDACT_RULES = [
61
- [/\b(sk-[A-Za-z0-9_-]{8,})/g, '[密钥]'],
62
- [/\b([A-Za-z0-9_-]{24,})\b(?=[^\n]{0,20}(?:token|key|secret))/gi, '[令牌]'],
63
- [/\b1[3-9]\d{9}\b/g, '[手机号]'],
64
- [/\b\d{17}[\dXx]\b/g, '[身份证]'],
65
- [/\b\d{16,19}\b/g, '[卡号]'],
66
- // QQ 号:桥接消息的前缀里带(「(QQ 私聊·用户本人 QQ 3472302240)」),
67
- // 不脱敏的话账号会原样写进记忆卡,再随注入发出去。
68
- [/QQ[::\s]*(\d{5,12})/gi, '[QQ号]'],
69
- [/https?:\/\/[^\s,。;、))]+/g, '[链接]']
70
- ]
71
-
72
-
73
- export const clamp = (value, min, max) => {
74
- const num = Number(value)
75
- if (!Number.isFinite(num)) return min
76
- return Math.min(max, Math.max(min, num))
77
- }
78
-
79
-
80
- export function iso(now = Date.now()) {
81
- return new Date(now).toISOString()
82
- }
83
-
84
-
85
- export function timeOf(value, fallback = 0) {
86
- const num = typeof value === 'number' ? value : Date.parse(String(value ?? ''))
87
- return Number.isFinite(num) ? num : fallback
88
- }
89
-
90
-
91
- export function dateKey(now = Date.now()) {
92
- const d = new Date(now)
93
- return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, '0')}-${String(d.getDate()).padStart(2, '0')}`
94
- }
95
-
96
-
97
- /** 入库前脱敏。宁可少记一条细节,也不要把密钥写进长期记忆。 */
98
- export function redact(text, maxChars = 600) {
99
- let out = String(text ?? '')
100
- for (const [re, label] of REDACT_RULES) out = out.replace(re, label)
101
- out = out.replace(/\s+/g, ' ').trim()
102
- if (out.length > maxChars) out = `${out.slice(0, maxChars - 1)}…`
103
- return out
104
- }
105
-
106
-
107
- /** 情绪浓度 0-24:强信号权重高,中信号低一些。 */
108
- export function emotionScore(text) {
109
- const body = String(text ?? '')
110
- const strong = (body.match(EMOTION_STRONG_RE) ?? []).length
111
- const medium = (body.match(EMOTION_MEDIUM_RE) ?? []).length
112
- return clamp(strong * 3 + medium * 2, 0, 24)
113
- }
1
+ /**
2
+ * 记忆引擎 · signals.js
3
+ * 由 lib/memory.js 按职责拆出(2026-11-06 模块化重构),函数体保持原样。
4
+ */
5
+
6
+
7
+
8
+ // ---- 语义信号(全部是正则,不调模型) ----
9
+
10
+ /** 情绪浓度:强信号 3 分/词,中信号 2 分/词,上限 24。 */
11
+ const EMOTION_STRONG_RE = /喜欢|想念|想你|舍不得|难过|委屈|哭|心疼|感动|害怕|孤单|抱歉|对不起|谢谢|抱抱|亲亲|陪伴|永远|最爱|在乎|重要|开心|太好了/g
12
+
13
+ const EMOTION_MEDIUM_RE = /有点|挺|蛮|累了|困|饿|烦|郁闷|害羞|生气|讨厌|紧张|激动|惊讶|意外|终于|还好/g
14
+
15
+ // ↑ 这两个是数出现次数(match),必须要 g;下面三个只判断「有没有」(test),绝不能带 g。
16
+ /** 约定 / 承诺:这类事忘了会出问题,所以加权。 */
17
+ export const PROMISE_RE = /答应|约定|说好|以后|下次|记得|不要忘|别忘了|发誓|保证|我会|明天|后天|下周/
18
+
19
+ /** 矛盾 / 道歉 / 和好:情绪浓度高,值得记住。 */
20
+ export const CONFLICT_RE = /吵架|生气|道歉|对不起|和好|误会|不理你|冷战|凶你|原谅|抱歉/
21
+
22
+ /**
23
+ * 关于「我」的偏好与长期事实:这是长期有用的画像,才值得留几十年。
24
+ *
25
+ * 为什么要区分「寒暄」和「长期事实」:
26
+ * 「今天问了句编译器怎么配」是寒暄,忘了无所谓;
27
+ * 「目标是嵌入式工程师」「喜欢喝冰美式」是画像,忘了就是失忆。
28
+ * 光靠重要度分不开这两者(都是主人随口说的),所以单独识别。
29
+ */
30
+ /**
31
+ * ⚠️ 下面这两个正则**不能带 g 标志**。
32
+ * `g` 让 RegExp 变成有状态的(每次 test/exec 推进 lastIndex),
33
+ * 连续判断多条记忆时会「漏一条、中一条」地跳着匹配 ——
34
+ * 症状是「同样的句子,第一次认得出,第二次认不出」,极难排查。
35
+ * 要数出现次数的地方(情绪强度)才用 g + match。
36
+ */
37
+ export const SELF_RE = /我(?:喜欢|讨厌|想要|是|会|在|叫|住|学|做|用|习惯|觉得|认为)|我的|我不|我觉|我准备|我打算|我计划|目标是|专业是|想当|在做|正在做|习惯用|平时用|常用/i
38
+
39
+ /** 长期事实类信号:命中就进 self 标签,享受「永不遗忘」保护。 */
40
+ export const FACT_RE = /目标是|专业是|想当|在做|正在做|习惯用|平时用|常用|我(?:喜欢|讨厌|习惯|住|学|专业)|我的(?:目标|专业|习惯|电脑)|大学|学院|专业|年级|大[一二三四]|研究生|在读|就读/i
41
+
42
+
43
+ /**
44
+ * 一次性流水账:吃了什么、穿了几件、几点到哪、天气冷热……
45
+ *
46
+ * 为什么要单独拦它(2026-10-29 实测发现的坑):
47
+ * 「主人私下说的」原本直接 +42,而入选阈值就是 42 —— 等于只要是主人说的、
48
+ * 超过 8 个字就必定入库。结果是记忆卡里躺着的五条全是「晚饭是牛肉丸子汤」
49
+ * 「多穿了点衣服」,真正该留的画像反而被挤在后面。
50
+ * 这类话每一天都在发生,记下来没有复用的价值。
51
+ */
52
+ export const EPHEMERAL_RE = /吃(?:了|饭|完|过)|(?:早|午|晚|夜)饭|喝(?:了|完)|(?:多|少)穿|穿(?:了|上|着)|天气|气温|(?:不|很|挺|有点)(?:冷|热)|宿舍|寝室|起床|睡了|睡觉|出门|在路上|下课|放学|洗澡|洗漱|刷牙|几点了/
53
+
54
+
55
+ /** 「第一次」类事件:天然是锚点。 */
56
+ export const FIRST_RE = /第一次|初次|头一次|最开始|刚认识|认识你|纪念日|第一天|从来没有过/
57
+
58
+
59
+ /** 脱敏规则:入库前把明显的敏感信息抹掉。 */
60
+ const REDACT_RULES = [
61
+ [/\b(sk-[A-Za-z0-9_-]{8,})/g, '[密钥]'],
62
+ [/\b([A-Za-z0-9_-]{24,})\b(?=[^\n]{0,20}(?:token|key|secret))/gi, '[令牌]'],
63
+ [/\b1[3-9]\d{9}\b/g, '[手机号]'],
64
+ [/\b\d{17}[\dXx]\b/g, '[身份证]'],
65
+ // 卡号不走这张表:见 luhnLike 的注释(KNOWN-ISSUES #15)
66
+ // QQ 号:桥接消息的前缀里带(「(QQ 私聊·用户本人 QQ 3472302240)」),
67
+ // 不脱敏的话账号会原样写进记忆卡,再随注入发出去。
68
+ [/QQ[::\s]*(\d{5,12})/gi, '[QQ号]'],
69
+ [/https?:\/\/[^\s,。;、))]+/g, '[链接]']
70
+ ]
71
+
72
+ /**
73
+ * 卡号判定(2026-11-09 修 KNOWN-ISSUES #15):原来 `\b\d{16,19}\b` 见长数字就抹,
74
+ * 订单号 / 工单号 / 雪花 ID 被无差别毁掉,而且这是入库前的一次性变换,不可恢复。
75
+ *
76
+ * 产品取舍(两难:漏抹真卡号进长期记忆 vs 误抹订单号不可恢复):
77
+ * 用 **Luhn 校验 + 发卡组织前缀(3/4/5/6 开头)** 双重判 —— 主流发卡组织
78
+ * (Visa/Mastercard/Amex/银联/JCB/Discover)的卡号全部通过 Luhn,误抹率从
79
+ * 「任意 16–19 位数字」降到「3-6 开头且过 Luhn」,纯随机的长订单号命中概率
80
+ * 约 4/10 × 1/10 ≈ 1/25。真卡号漏抹的风险:几乎为零(Luhn 是发卡强制算法)。
81
+ * 若正文明确说「卡/卡号/银行卡」等上下文词,仍无条件抹(兜住非 Luhn 的罕见卡)。
82
+ */
83
+ function luhnLike(digits) {
84
+ let sum = 0
85
+ let dbl = false
86
+ for (let i = digits.length - 1; i >= 0; i -= 1) {
87
+ let d = digits.charCodeAt(i) - 48
88
+ if (dbl) { d *= 2; if (d > 9) d -= 9 }
89
+ sum += d
90
+ dbl = !dbl
91
+ }
92
+ return sum % 10 === 0
93
+ }
94
+
95
+ const CARD_CONTEXT_RE = /(?:银行卡|储蓄卡|信用卡|卡号|尾号|刷卡|银行卡号)\s*[::]?\s*$/
96
+
97
+
98
+ export const clamp = (value, min, max) => {
99
+ const num = Number(value)
100
+ if (!Number.isFinite(num)) return min
101
+ return Math.min(max, Math.max(min, num))
102
+ }
103
+
104
+
105
+ export function iso(now = Date.now()) {
106
+ return new Date(now).toISOString()
107
+ }
108
+
109
+
110
+ export function timeOf(value, fallback = 0) {
111
+ const num = typeof value === 'number' ? value : Date.parse(String(value ?? ''))
112
+ return Number.isFinite(num) ? num : fallback
113
+ }
114
+
115
+
116
+ export function dateKey(now = Date.now()) {
117
+ const d = new Date(now)
118
+ return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, '0')}-${String(d.getDate()).padStart(2, '0')}`
119
+ }
120
+
121
+
122
+ /** 入库前脱敏。宁可少记一条细节,也不要把密钥写进长期记忆。 */
123
+ export function redact(text, maxChars = 600) {
124
+ let out = String(text ?? '')
125
+ // 卡号单独判(在其它规则之前,免得后面的规则先改动数字周围的文本):
126
+ // 过 Luhn 且 3-6 开头 → 抹;不过但前面紧挨着「卡号/银行卡」等上下文词 → 也抹。
127
+ out = out.replace(/\b(\d{16,19})\b/g, (m, digits, offset, full) => {
128
+ if (/^[3-6]/.test(digits) && luhnLike(digits)) return '[卡号]'
129
+ const before = full.slice(Math.max(0, offset - 8), offset)
130
+ if (CARD_CONTEXT_RE.test(before)) return '[卡号]'
131
+ return m
132
+ })
133
+ for (const [re, label] of REDACT_RULES) out = out.replace(re, label)
134
+ out = out.replace(/\s+/g, ' ').trim()
135
+ if (out.length > maxChars) out = `${out.slice(0, maxChars - 1)}…`
136
+ return out
137
+ }
138
+
139
+
140
+ /** 情绪浓度 0-24:强信号权重高,中信号低一些。 */
141
+ export function emotionScore(text) {
142
+ const body = String(text ?? '')
143
+ const strong = (body.match(EMOTION_STRONG_RE) ?? []).length
144
+ const medium = (body.match(EMOTION_MEDIUM_RE) ?? []).length
145
+ return clamp(strong * 3 + medium * 2, 0, 24)
146
+ }
package/lib/notes.js CHANGED
@@ -308,11 +308,16 @@ export function reconcile(index) {
308
308
  const dropped = current.notes.filter((entry) => !seen.has(entry.slug))
309
309
  if (dropped.length > 0) log('notes', `索引清理:${dropped.length} 篇文件已不存在(${dropped.map((e) => e.slug).join('、')})`)
310
310
 
311
+ // 2026-11-09 修 KNOWN-ISSUES #20:changed 判据原来按**索引对位**比较 ——
312
+ // next 是按目录序重建的,current 的相对顺序一变(新建一篇 push 到尾部、
313
+ // 目录序与索引序交错)每个对位都失配 → 恒 changed=true,笔记页反复报「已变更」。
314
+ // 现在按 slug 建 Map 逐条对内容比较,顺序无关。
315
+ const oldBySlug = new Map(current.notes.map((entry) => [entry.slug, entry]))
311
316
  const changed = dropped.length > 0
312
317
  || next.length !== current.notes.length
313
- || next.some((entry, i) => {
314
- const old = current.notes[i]
315
- return old === undefined || old.slug !== entry.slug
318
+ || next.some((entry) => {
319
+ const old = oldBySlug.get(entry.slug)
320
+ return old === undefined
316
321
  || old.updatedAt !== entry.updatedAt || old.chars !== entry.chars || old.summary !== entry.summary
317
322
  })
318
323
 
@@ -355,7 +360,12 @@ export function readNote(slug) {
355
360
  } catch (error) {
356
361
  return { ok: false, reason: `读不出来:${error instanceof Error ? error.message : String(error)}` }
357
362
  }
358
- const entry = loadIndex().notes.find((item) => item.slug === key)
363
+ // 2026-11-09 修 KNOWN-ISSUES #21:这里原来用 loadIndex() —— 索引文件里可能
364
+ // 躺着已删文件的旧条目(chars/summary 与磁盘不符)。listNotes() 走的是
365
+ // reconcile()(按目录实况校正),readNote 也对齐同一口径。
366
+ // (reconcile 命中 TTL 缓存时不产生额外 IO;可能触发一次 saveIndex,
367
+ // 与 readNote 里已经调用的 listNotes() 同级,不引入新的读路径写盘。)
368
+ const entry = reconcile().notes.find((item) => item.slug === key)
359
369
  return {
360
370
  ok: true,
361
371
  note: entry ?? { slug: key, title: key, createdAt: mtimeOf(key), updatedAt: mtimeOf(key), chars: text.length, summary: summaryOf(text) },
package/package.json CHANGED
@@ -1,127 +1,127 @@
1
- {
2
- "name": "dsh-agent-soul",
3
- "version": "0.9.8",
4
- "type": "module",
5
- "description": "给 DSH 的 agent 一套会忘事的记忆、一份会变的人格和一份会起伏的心情:人格按小节合并(项目覆盖全局但不吃掉全局),记忆按人的规律衰减(清晰→模糊→只剩印象→遗忘),「心里惦记的事」让她的主动有连续性,心情跟着每轮对话自己判断、自己平复(不注入、无挂饰)。",
6
- "keywords": [
7
- "deepseek",
8
- "deepseek-harness",
9
- "dsh",
10
- "dsh-plugin",
11
- "agent",
12
- "memory",
13
- "mood",
14
- "persona",
15
- "personality",
16
- "soul"
17
- ],
18
- "main": "lib/index.js",
19
- "exports": {
20
- ".": "./lib/index.js",
21
- "./client": "./lib/client.js",
22
- "./cordis.patch.yml": "./cordis.patch.yml",
23
- "./package.json": "./package.json"
24
- },
25
- "files": [
26
- "lib",
27
- "assets",
28
- "docs",
29
- "tools",
30
- "cordis.patch.yml",
31
- "README.md",
32
- "CHANGELOG.md",
33
- "LICENSE",
34
- "THIRD-PARTY-NOTICES.md",
35
- "LICENSES"
36
- ],
37
- "scripts": {
38
- "prepack": "npm test",
39
- "build:client": "node tools/build-client.mjs",
40
- "sync:host": "node tools/build-client.mjs && node tools/sync.mjs",
41
- "test": "node tools/build-client.mjs && node tools/run-tests.mjs",
42
- "lint": "node tools/lint.mjs",
43
- "test:contracts": "node tools/run-tests.mjs --only=tests/contract/",
44
- "test:s1": "node tests/s1-hotfix.test.js",
45
- "test:s2": "node tests/s2-hardening.test.js",
46
- "test:llm-timeout": "node tests/llm-stream-timeout.test.js",
47
- "test:post-diary": "node tests/post-diary-api.test.js",
48
- "test:retention": "node tests/retention.test.js",
49
- "test:archive-rotate": "node tests/archive-rotate.test.js",
50
- "test:save-state": "node tests/save-state-failure.test.js",
51
- "bench:recall": "node tools/eval-recall.mjs",
52
- "test:owner": "node tests/owner-identity.test.js",
53
- "test:extract": "node tests/extract.test.js",
54
- "test:write-failure": "node tests/write-failure.test.js",
55
- "test:refine": "node tests/refine.test.js",
56
- "test:goal": "node tests/goal-revive.test.js",
57
- "test:archive": "node tests/archive.test.js",
58
- "test:diary": "node tests/diary.test.js",
59
- "test:diary-new": "node tests/diary-new-path.test.js",
60
- "test:notes": "node tests/notes.test.js",
61
- "test:diary-tool": "node tests/diary-tool.test.js",
62
- "test:api-auth": "node tests/api-auth.test.js",
63
- "test:memory": "node tests/memory.test.js",
64
- "test:integrity": "node tests/memory-integrity.test.js",
65
- "test:memory-dupe": "node tests/memory-near-dupe.test.js",
66
- "test:recall": "node tests/recall-dedupe.test.js",
67
- "test:recall-visibility": "node tests/recall-visibility.test.js",
68
- "test:host": "node tests/host-probe.test.js",
69
- "test:secrets": "node tests/secrets-judge.test.js",
70
- "test:tone": "node tests/tone.test.js",
71
- "test:threads": "node tests/threads.test.js",
72
- "test:recent": "node tests/recent-context.test.js",
73
- "test:log": "node tests/log-rotate.test.js",
74
- "test:health": "node tests/health.test.js",
75
- "test:inject": "node tests/inject.test.js",
76
- "test:echo": "node tests/echo.test.js",
77
- "test:mood": "node tests/mood.test.js",
78
- "test:mood-digest": "node tests/mood-digest.test.js",
79
- "test:emotion": "node tests/emotion-purpose.test.js",
80
- "test:persona": "node tests/persona.test.js",
81
- "test:purpose": "node tests/purpose.test.js",
82
- "test:registry": "node tests/registry.test.js",
83
- "test:session-title": "node tests/session-title.test.js",
84
- "test:smoke": "node tests/smoke.test.js",
85
- "test:client": "node tools/build-client.mjs && node tests/client.test.js",
86
- "sync": "node tools/build-client.mjs",
87
- "test:r1-persist": "node tests/r1-maintain-persist.test.js",
88
- "test:r16-uri": "node tests/r16-asset-uri.test.js",
89
- "test:r6-config": "node tests/r6-config-validation.test.js",
90
- "test:guards": "node tests/r2-r3-r4-guards.test.js"
91
- },
92
- "peerDependencies": {
93
- "@deepseek-ai/cordis": "^4.0.1"
94
- },
95
- "engines": {
96
- "node": ">=22.19",
97
- "dsh": ">=0.2.0-rc.1 || >=0.2.1-rc.2 || >=0.2.2-rc.1"
98
- },
99
- "author": "单树见月 <3472302240@qq.com>",
100
- "dsh": {
101
- "manifestVersion": 1,
102
- "bundle": {
103
- "patch": "./cordis.patch.yml"
104
- },
105
- "client": {
106
- "platform": "web",
107
- "inject": []
108
- },
109
- "compatibility": {
110
- "dshReleases": {
111
- "0.2.0-rc.1+": "compatible",
112
- "0.2.2-rc.1+": "unverified"
113
- },
114
- "verifiedOn": "0.2.1-rc.5",
115
- "note": "0.2.2-rc.1 仅声明 engines 放行,尚未实机验证(阶段 0);实测见阶段 1-4"
116
- }
117
- },
118
- "repository": {
119
- "type": "git",
120
- "url": "git+https://github.com/danshuyue/dsh-agent-soul.git"
121
- },
122
- "bugs": {
123
- "url": "https://github.com/danshuyue/dsh-agent-soul/issues"
124
- },
125
- "homepage": "https://github.com/danshuyue/dsh-agent-soul#readme",
126
- "license": "SEE LICENSE IN LICENSE"
127
- }
1
+ {
2
+ "name": "dsh-agent-soul",
3
+ "version": "0.9.9",
4
+ "type": "module",
5
+ "description": "给 DSH 的 agent 一套会忘事的记忆、一份会变的人格和一份会起伏的心情:人格按小节合并(项目覆盖全局但不吃掉全局),记忆按人的规律衰减(清晰→模糊→只剩印象→遗忘),「心里惦记的事」让她的主动有连续性,心情跟着每轮对话自己判断、自己平复(不注入、无挂饰)。",
6
+ "keywords": [
7
+ "deepseek",
8
+ "deepseek-harness",
9
+ "dsh",
10
+ "dsh-plugin",
11
+ "agent",
12
+ "memory",
13
+ "mood",
14
+ "persona",
15
+ "personality",
16
+ "soul"
17
+ ],
18
+ "main": "lib/index.js",
19
+ "exports": {
20
+ ".": "./lib/index.js",
21
+ "./client": "./lib/client.js",
22
+ "./cordis.patch.yml": "./cordis.patch.yml",
23
+ "./package.json": "./package.json"
24
+ },
25
+ "files": [
26
+ "lib",
27
+ "assets",
28
+ "docs",
29
+ "tools",
30
+ "cordis.patch.yml",
31
+ "README.md",
32
+ "CHANGELOG.md",
33
+ "LICENSE",
34
+ "THIRD-PARTY-NOTICES.md",
35
+ "LICENSES"
36
+ ],
37
+ "scripts": {
38
+ "prepack": "npm test",
39
+ "build:client": "node tools/build-client.mjs",
40
+ "sync:host": "node tools/build-client.mjs && node tools/sync.mjs",
41
+ "test": "node tools/build-client.mjs && node tools/run-tests.mjs",
42
+ "lint": "node tools/lint.mjs",
43
+ "test:contracts": "node tools/run-tests.mjs --only=tests/contract/",
44
+ "test:s1": "node tests/s1-hotfix.test.js",
45
+ "test:s2": "node tests/s2-hardening.test.js",
46
+ "test:llm-timeout": "node tests/llm-stream-timeout.test.js",
47
+ "test:post-diary": "node tests/post-diary-api.test.js",
48
+ "test:retention": "node tests/retention.test.js",
49
+ "test:archive-rotate": "node tests/archive-rotate.test.js",
50
+ "test:save-state": "node tests/save-state-failure.test.js",
51
+ "bench:recall": "node tools/eval-recall.mjs",
52
+ "test:owner": "node tests/owner-identity.test.js",
53
+ "test:extract": "node tests/extract.test.js",
54
+ "test:write-failure": "node tests/write-failure.test.js",
55
+ "test:refine": "node tests/refine.test.js",
56
+ "test:goal": "node tests/goal-revive.test.js",
57
+ "test:archive": "node tests/archive.test.js",
58
+ "test:diary": "node tests/diary.test.js",
59
+ "test:diary-new": "node tests/diary-new-path.test.js",
60
+ "test:notes": "node tests/notes.test.js",
61
+ "test:diary-tool": "node tests/diary-tool.test.js",
62
+ "test:api-auth": "node tests/api-auth.test.js",
63
+ "test:memory": "node tests/memory.test.js",
64
+ "test:integrity": "node tests/memory-integrity.test.js",
65
+ "test:memory-dupe": "node tests/memory-near-dupe.test.js",
66
+ "test:recall": "node tests/recall-dedupe.test.js",
67
+ "test:recall-visibility": "node tests/recall-visibility.test.js",
68
+ "test:host": "node tests/host-probe.test.js",
69
+ "test:secrets": "node tests/secrets-judge.test.js",
70
+ "test:tone": "node tests/tone.test.js",
71
+ "test:threads": "node tests/threads.test.js",
72
+ "test:recent": "node tests/recent-context.test.js",
73
+ "test:log": "node tests/log-rotate.test.js",
74
+ "test:health": "node tests/health.test.js",
75
+ "test:inject": "node tests/inject.test.js",
76
+ "test:echo": "node tests/echo.test.js",
77
+ "test:mood": "node tests/mood.test.js",
78
+ "test:mood-digest": "node tests/mood-digest.test.js",
79
+ "test:emotion": "node tests/emotion-purpose.test.js",
80
+ "test:persona": "node tests/persona.test.js",
81
+ "test:purpose": "node tests/purpose.test.js",
82
+ "test:registry": "node tests/registry.test.js",
83
+ "test:session-title": "node tests/session-title.test.js",
84
+ "test:smoke": "node tests/smoke.test.js",
85
+ "test:client": "node tools/build-client.mjs && node tests/client.test.js",
86
+ "sync": "node tools/build-client.mjs",
87
+ "test:r1-persist": "node tests/r1-maintain-persist.test.js",
88
+ "test:r16-uri": "node tests/r16-asset-uri.test.js",
89
+ "test:r6-config": "node tests/r6-config-validation.test.js",
90
+ "test:guards": "node tests/r2-r3-r4-guards.test.js"
91
+ },
92
+ "peerDependencies": {
93
+ "@deepseek-ai/cordis": "^4.0.1"
94
+ },
95
+ "engines": {
96
+ "node": ">=22.19",
97
+ "dsh": ">=0.2.0-rc.1 || >=0.2.1-rc.2 || >=0.2.2-rc.1"
98
+ },
99
+ "author": "单树见月 <3472302240@qq.com>",
100
+ "dsh": {
101
+ "manifestVersion": 1,
102
+ "bundle": {
103
+ "patch": "./cordis.patch.yml"
104
+ },
105
+ "client": {
106
+ "platform": "web",
107
+ "inject": []
108
+ },
109
+ "compatibility": {
110
+ "dshReleases": {
111
+ "0.2.0-rc.1+": "compatible",
112
+ "0.2.2-rc.1+": "unverified"
113
+ },
114
+ "verifiedOn": "0.2.1-rc.5",
115
+ "note": "0.2.2-rc.1 仅声明 engines 放行,尚未实机验证(阶段 0);实测见阶段 1-4"
116
+ }
117
+ },
118
+ "repository": {
119
+ "type": "git",
120
+ "url": "git+https://github.com/danshuyue/dsh-agent-soul.git"
121
+ },
122
+ "bugs": {
123
+ "url": "https://github.com/danshuyue/dsh-agent-soul/issues"
124
+ },
125
+ "homepage": "https://github.com/danshuyue/dsh-agent-soul#readme",
126
+ "license": "SEE LICENSE IN LICENSE"
127
+ }