dsh-agent-soul 0.9.11 → 0.9.13

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,71 @@
7
7
 
8
8
  ---
9
9
 
10
+ ## 0.9.13 · 2026-11-10
11
+
12
+ 外部复检轮 **R18**(文档漂移 / 废弃键 / 开关生效证据),15 文件 / +439 −5。90 测试 / 11 契约全绿。
13
+
14
+ ### 新增
15
+
16
+ - **`lib/evidence.js` —— 开关的「生效 / 未生效」证据**(这是本轮真正的东西):
17
+ - `mark(key, note)`:动态证据,只在**送达点**调用(语气真的进了收件箱、判定真的记了账、
18
+ 提炼真的入了库、四段真的进了装配);
19
+ - `statuses(cfg)`:17 个布尔开关的静态生效性 + **人话原因**(「心情关了——判定不跑,语气无从挂起」);
20
+ - `reportLine(cfg)`:一行三段式总览(生效 / 暂未发生 / 未生效)。
21
+ - 输出只在三处:**启动一行 + 每日健康行 + `/state`**,绝不每轮(噪音会让人不再看日志)。
22
+ - 动机是那次**语气链失效三天、日志一句错都没有、测试全绿** —— 开关的值不等于开关的效果。
23
+ - `/state` 新增 `switches`(开关证据)与 `legacyKeys`(配置文件里还躺着的废弃键)。
24
+
25
+ ### 修复
26
+
27
+ - **介绍与实现对不上**:`package.json` 的 description 与 README 都还写着心情「不注入、无挂饰」,
28
+ 而心情语气 2026-11-01 就上线了、`soul:mood` 段每轮都进上下文。
29
+ 连带修正 4 处同款过时注释(`index.js` 头、`mood.js` 头、`cache.js` 的 `moodEnabled` 注释、
30
+ `mood/digest.js` 的类比)—— 这 4 处是 R18 漏掉的,发布前复核补上。
31
+ - **废弃配置键不再写回配置文件**:`diarySchedule` 与 `moodOwnerName` 仍**接受**(不 400,保兼容),
32
+ 但 `saveConfig` 落盘前剔除,每个键只记一行日志;`moodOwnerName` 只在 `ownerName` 迁移完成后剔
33
+ (不然会把老用户的迁移源数据弄丢)。`DEFAULT_CONFIG` 两键保留 —— 删了会让 `validateConfigEntry`
34
+ 开始报「未知配置项」,那是破坏性变更。
35
+
36
+ ### 已知缺口(不阻塞发布)
37
+
38
+ - 动态证据目前只有**单元级**覆盖(测试直接调 `mark()`),**没有「注入链路真的会调 mark」的接线测试** ——
39
+ 把 `inject.js` 里那行 `mark('moodTone')` 删掉,25 条测试仍然全绿。
40
+ 静态那一半有真覆盖(假旋钮毒化 → 3 条红)。已记入 `docs/HANDOFF.md` §6 作为下一轮第一件事。
41
+
42
+ ---
43
+
44
+ ## 0.9.12 · 2026-11-10
45
+
46
+ 外部复检轮 **R17(最后一个大文件)**,2 个提交 / 8 文件 / +353 −241。**对外行为零变化**:
47
+ 89 测试 / 11 契约 / lint / bundle 零 diff 全绿;四个搬迁函数的**函数体在旧新位置逐字一致**。
48
+
49
+ ### 重构
50
+
51
+ - **`diary/scheduler.js`(779 行五职责)拆分**(#26):
52
+ - `diary/deliver.js`(新)—— 投递与回执判定:`shouldAskAgain` / `askAgentToWrite` / `mtimeMsOf`
53
+ - `diary/agent.js` —— `diaryAgent` 并入(与 R16 移进来的 `composeDiarySetup` 同属「会话获取 / 冷启动」)
54
+ - `diary/scheduler.js` —— 只留定时器 / 双层锁 / 主流程 / `regenerateDiary` / `runCatchUp`(779 → 551 行)
55
+ - 函数体由脚本按段落切分,**逐字未改**;`askAgentToWrite` 因跨模块调用由私有改导出(已披露)。
56
+ - `lib/diary.js` 门面导出名集合(29 个)不变,`diaryAgent` 改从 `agent.js` re-export。
57
+
58
+ ### 测试
59
+
60
+ - 新增 `tests/r17-deliver-feature.test.js`(11 断言),**先于拆分提交**且在旧代码上全绿:
61
+ 补上了 `shouldAskAgain` 这块**零直接覆盖**的判定矩阵(force / 不存在 / since=0 老行为 /
62
+ 旧文件重写 / 新文件不重问 / mtime 被拨老),以及 `since` 语义的端到端验证 ——
63
+ 那就是 P1-D3「看门狗每 30 分钟空转、日志却写『日记完成』」那条事故的判据。
64
+ - 既有 `tests/r05-diary-state.test.js` 只改了 import 路径与调用点,**断言一字未动**(已逐行核对)。
65
+
66
+ ### 变更
67
+
68
+ - 契约快照走正规通道:`deliver.js` 新增 `askAgentToWrite` / `shouldAskAgain`,
69
+ `agent.js` +`diaryAgent`,`scheduler.js` −2。理由已记入 `SNAPSHOT_CHANGES.md`
70
+ (其中「R16 #26」是交付方的笔误,发布时更正为 R17)。
71
+ - **至此 `docs/KNOWN-ISSUES.md` 只剩 #23**(错误边界需宿主暴露 `React.Component`)。
72
+
73
+ ---
74
+
10
75
  ## 0.9.11 · 2026-11-10
11
76
 
12
77
  外部复检轮 **R16(重构轮)**,2 个提交 / 9 文件 / +583 −443。**对外行为零变化**:
package/README.md CHANGED
@@ -11,7 +11,7 @@
11
11
  | **人格** | 用 Markdown 写「你是谁」。项目人格只覆盖同名小节,全局的照常生效 —— 不会因为某个目录里有 `AGENT.md`,你在全局写的话就整份失效 |
12
12
  | **记忆** | 值得记的事自己进来,随时间变模糊:清晰 → 清楚 → 模糊 → 只剩印象 → 遗忘。忘了不是删掉,是**先变得说不清** |
13
13
  | **目的** | 从记忆里长出一份「心里惦记的事」,让她的主动有连续性 —— 不是定时问候,是主动想起 |
14
- | **心情** | 每轮对话后自己判一次起伏(心情值 + 七情 + 时间线),**不注入提示词**。记下来的情绪有两个出口:当日记的底色、推着目的机制的驱动 |
14
+ | **心情** | 每轮对话后自己判一次起伏(心情值 + 七情 + 时间线),并作为 `soul:mood` 段把状态注进上下文、隔几轮往她的消息后面挂一句语气(设置里可关)。记下来的情绪另外两个出口:当日记的底色、推着目的机制的驱动 |
15
15
  | **日记** | 开机时把**前一天**沉淀成两篇:一篇公开(可以拿给你看),一篇私密(只写给自己)。**先投消息让她用 `soul_diary` 自己写**,文件没出现才由插件 `llm.stream` 兜底生成 |
16
16
  | **笔记** | 她自己写的 md:一篇一个主题、自由格式、**永不衰减**。提示词里只给索引,正文用 `soul_note` 按需读 |
17
17
 
package/docs/HANDOFF.md CHANGED
@@ -1,7 +1,7 @@
1
- # 交接文档 · dsh-agent-soul `0.9.11`
1
+ # 交接文档 · dsh-agent-soul `0.9.13`
2
2
 
3
3
  > 给接手的人(或 AI)。读完这一份就能开工,不需要翻聊天记录。
4
- > 写作时间:2026-11-08(0.9.11 于 2026-11-10 更新)· tag `v0.9.11` · npm `latest = 0.9.11`
4
+ > 写作时间:2026-11-08(0.9.13 于 2026-11-10 更新)· tag `v0.9.13` · npm `latest = 0.9.13`
5
5
 
6
6
  ---
7
7
 
@@ -33,7 +33,7 @@
33
33
 
34
34
  | 指标 | 数值 |
35
35
  |---|---|
36
- | 测试 | **88** 个测试文件 / 0 失败;契约 **11** / 0 |
36
+ | 测试 | **90** 个测试文件 / 0 失败;契约 **11** / 0 |
37
37
  | 代码量 | `lib/` 97 个文件 / ~19.9k 行 |
38
38
  | 运行时依赖 | **零**(`dependencies` 为空,刻意如此) |
39
39
  | 支持 | Node ≥ 22.19;CI 跑 Node 22 + 24 + Windows |
@@ -191,29 +191,23 @@ git switch -c fix/your-topic main # 从干净 main 拉
191
191
 
192
192
  ---
193
193
 
194
- ## 5. 当前遗留(2 条)
194
+ ## 5. 当前遗留(1 条)
195
195
 
196
196
  > 完整版在 [`docs/KNOWN-ISSUES.md`](KNOWN-ISSUES.md),每条带代码位置、影响、建议改法、验证程度(A 实测 / B 读代码 / C 仅归档)。
197
197
  >
198
- > **`0.9.11` 之后,「功能坏了」与「零散清理」类问题全部清零。** 只剩最后一个大文件 + 一条受宿主限制的。
198
+ > **`0.9.12` 之后,功能类 / 清理类 / 重构类已知问题全部清零。** 只剩这一条,而且**做不了**。
199
199
 
200
- ### 唯一的「用户能感觉到」的一条
201
-
202
- | # | 问题 | 位置 | 建议 |
200
+ | # | 问题 | 位置 | 为什么现在做不了 |
203
201
  |---|---|---|---|
204
- | **23** | 「错误边界」接不住**渲染期**异常 → 白屏 | `lib/client/app.js` | 需要 `React.Component` 基类;本 bundle 作用域里没有,**做不了**,只能等宿主暴露 |
205
-
206
- ### 最后一个大文件(1 条)
207
-
208
- | # | 问题 | 建议 |
209
- |---|---|---|
210
- | **26** | `diary/scheduler.js` 687 行混五种职责 | 拆 `diary/deliver.js`(投递 / 超时 / 等待她写)+ 会话相关部分并进 `diary/agent.js`(R16 已把 `composeDiarySetup` 放那儿了) |
202
+ | **23** | 「错误边界」接不住**渲染期**异常 → 白屏 | `lib/client/app.js` | 需要 `React.Component` 基类;本 bundle 的作用域里只有 `h` 与几个 hook,没有 `Component`。**等宿主暴露**,别自欺欺人地改成 `try/catch`(渲染发生在 React 内部,抓不到) |
211
203
 
212
- > 已清掉的:#28(`text()` 拆成三个私有函数)、#32(构建拒绝未登记片段)、
213
- > #33(`revOf` 收敛)、#34(死代码标注;并更正了「`force` 恒 false」这个**我方文档错误** ——
214
- > `regenerateDiary` 实际传了 `{ force: true }`)、#35(preview CSS 已漂移,现为逐字符门禁)、
215
- > #27(`compose.js` 切四块:`llm.js` / `history.js` / `agent.js` / `compose.js`,
216
- > 10 个函数体逐字未改、门面 29 个导出名前后一致)。
204
+ > 已清掉的(按轮次):#28 与 #32–#35(R15)、#27(R16)、#26(R17)、
205
+ > 以及更早的 #1–#22 大部分。三个大文件都已拆完:
206
+ > `segment-memory.js`(`text()` → 三个私有函数)、`diary/compose.js`(→ `llm` / `history` / `agent`)、
207
+ > `diary/scheduler.js`(→ `deliver` + `agent`,主文件 679 → 551 行)。
208
+ >
209
+ > 还有一个**我方文档错误**已更正:`askAgentToWrite` 的 `force` 参数不是死代码,
210
+ > `regenerateDiary` 确实传了 `{ force: true }`。
217
211
 
218
212
  ### 明确「不修」的(想清楚了,别捡起来)
219
213
 
@@ -232,15 +226,34 @@ git switch -c fix/your-topic main # 从干净 main 拉
232
226
 
233
227
  ---
234
228
 
235
- ## 6. 建议的下一轮顺序(0.9.11 后)
229
+ ## 6. 下一轮该做什么(0.9.13 后)
230
+
231
+ R18 的三条(description 对齐 / 废弃键不落盘 / 开关证据)**已合并发布**。下一轮第一件事:
232
+
233
+ ### ① 给动态证据补「接线测试」(R18 留下的缺口)
234
+
235
+ 现在 `lib/evidence.js` 的 `mark()` 只有**单元级**覆盖 —— 测试直接调 `mark()` 再看报告。
236
+ 但**没有任何测试证明「注入链路真的会调 mark」**:
237
+
238
+ > 把 `lib/host/runtime/inject.js` 里那行 `mark('moodTone', …)` 删掉,25 条 R18 测试仍然全绿。
239
+
240
+ 这不是「假报生效」(删了会诚实地说「从未发生」),而是**证据也会瞎**:
241
+ 链路断了,报告永远显示 ◐「从未发生」,没人会注意到。
242
+
243
+ **建议做法**:用 `registerToneForTurn(agent, null)` + 假 `agent.inbox.append` 探针,
244
+ 断言 `markSnapshot()` 里出现 `moodTone`。我试过一版,**没能走到 `append`**
245
+ (`takeTone` 的节流/心情状态没设对,`mood=30`、`moodToneEveryTurns=1` 也没触发)——
246
+ 下一轮先摸清 `takeTone` 依赖哪些状态字段,再写这个测试。同样的接线测试也该给
247
+ `moodJudge`(`mood/hooks.js:110`)和 `memoryRefine`(`refine.js:148`)各来一条。
236
248
 
237
- **只剩最后一个大文件。**
249
+ ### ② 还剩两件事,都不是「改代码」
238
250
 
239
- 1. **`#26 diary/scheduler.js`(687 行五职责)** —— 拆 `diary/deliver.js`(投递 / 超时 / 等待她写)
240
- + 会话相关部分并进 `diary/agent.js`(R16 已把 `composeDiarySetup` 放那儿了)。
241
- 2. **`#23`** —— 除非宿主文档明确暴露了 `React.Component`,否则不要动。
251
+ - **`#23`** —— 等宿主暴露 `React.Component`。在那之前别动:`try/catch` 包不住渲染期异常
252
+ (渲染发生在 React 内部),改了只会得到一个假的错误边界。
253
+ - **两条「待确认」**(见第六节)—— 都需要**真实环境**:压缩会话的 `snapshotEvents`
254
+ 会不会抛、反代 + 非默认端口下的 `Origin`/`Host` 形态。谁遇到谁先留日志。
242
255
 
243
- > 重构的纪律(R15 / R16 两轮验证有效,照抄):
256
+ > 三条重构纪律(R15 / R16 / R17 三轮验证有效,照抄):
244
257
  > **先补特征测试钉住当下行为 → 再拆 → 特征测试一条不改必须全绿 → 毒化一次证明测试网有效。**
245
258
  >
246
259
  > 三个实践细节值得学:
@@ -1,4 +1,4 @@
1
- # 已知问题清单(截至 0.9.11;R13 划 23 条、R14 划 4 条、R15 划 5 条、R16 划 1 条)
1
+ # 已知问题清单(截至 0.9.12;R13 划 23、R14 划 4、R15 划 5、R16 划 1、R17 划 1)
2
2
 
3
3
  > 2026-11-08 R13 轮:~~划线~~ 条目已修,测试锚定在 `tests/r13-batch.test.js`(36 断言),
4
4
  > 修法见提交历史(fix/known-issues-r13 分支 R13 批次一~五)。
@@ -15,7 +15,14 @@
15
15
  > `llm.js` / `history.js` / `agent.js`(`composeDiarySetup` 移正)/ `compose.js` 只留 prompt 组装。
16
16
  > 特征测试 `tests/r16-compose-feature.test.js`(11 断言)先于拆分提交;复核时逐个函数比对,
17
17
  > **10 个函数体在新旧位置逐字一致**,门面导出 29 个名字前后完全相同。
18
- > **仍打开:#26(最后一个大文件)、#23(等宿主暴露 React.Component)与第五、六节。**
18
+ >
19
+ > **2026-11-10 R17 轮(0.9.12,重构)**:划掉 **#26**。`scheduler.js`(779 行)拆出
20
+ > `deliver.js`(`shouldAskAgain` / `askAgentToWrite` / `mtimeMsOf`)+ `diaryAgent` 并入 `agent.js`,
21
+ > 主文件降到 551 行。特征测试 `tests/r17-deliver-feature.test.js`(11 断言)先于拆分提交,
22
+ > 补上了 `shouldAskAgain` 这块**零直接覆盖**的判定矩阵。毒化复核是**双网**:
23
+ > 特征测试 4 条红 + 既有 `r05-diary-state` 1 条红。
24
+ >
25
+ > **至此 KNOWN-ISSUES 只剩 #23(需宿主暴露 `React.Component`)与第五、六节(明确不修 / 待确认)。**
19
26
  >
20
27
  > **2026-11-08 复核补丁(0.9.8)**:R13 的 #1(`/diary/list` 只读头部 400 字节)按字节切 UTF-8,
21
28
  > 中文预览末尾会出现 `�`(U+FFFD)—— 400 % 3 ≠ 0,边界必然落在汉字中间。
@@ -85,7 +92,7 @@
85
92
 
86
93
  | # | 问题 | 影响 | 建议 |
87
94
  |---|---|---|---|
88
- | 26 | `diary/scheduler.js` 687 行混五种职责 | 改一处要读整文件 | 拆 `diary/agent.js` + `diary/deliver.js` |
95
+ | ~~26~~ ✅已修(2026-11-10 R17) | `diary/scheduler.js` 779 行混五种职责 | 改一处要读整文件 | 拆出 `diary/deliver.js`(投递与回执判定)+ `diaryAgent` 并入 `diary/agent.js`;scheduler 留定时器/双层锁/主流程(551 行);函数体逐字未改 |
89
96
  | ~~27~~ ✅已修(2026-11-10 R16) | `diary/compose.js` 644 行四类职责,`composeDiarySetup` 放错位置 | 同上 | 已切四块:`llm.js`(LLM 调用)/ `history.js`(最近日记)/ `agent.js`(`composeDiarySetup` 移正)/ `compose.js` 只留 prompt 组装(217 行);10 个函数体逐字未改 |
90
97
  | ~~28~~ ✅已修(2026-11-08 R15) | `host/runtime/segment-memory.js` 的 `text()` 约 150 行、8 种职责的上帝函数 | 难以单测 | 拆 `collectDiaryMaterial` / `memoryBudgetPlan` / `computeRecallText`(均文件私有,无新导出) |
91
98
  | ~~29~~ ✅已修(2026-11-08 R13) | `index.js` 顶部注释的注入顺序漏了 `soul:data-policy` | 文档与代码漂移 | 补一句 |
@@ -117,27 +124,34 @@
117
124
 
118
125
  ---
119
126
 
120
- ## 七、建议的下一轮顺序(0.9.11 后更新)
127
+ ## 七、下一轮该做什么(0.9.12 后更新)
128
+
129
+ **代码层面的待修项已经清零。** 剩下的只有两类,都不是「改代码」:
130
+
131
+ 1. **#23(渲染期白屏)** —— 需要宿主的 `React.Component`。**先等等**:如果哪天 DSH 文档里
132
+ 明确暴露了基类,再做;否则做了也是假的(当前这个「错误边界」只能接住 window 错误与
133
+ unhandledrejection,接不住渲染期异常)。
134
+ 2. **两条「待确认」**(见第六节)—— 都需要**真实环境**才能验:压缩会话的 `snapshotEvents`
135
+ 会不会抛、反代 + 非默认端口下的 `Origin`/`Host` 形态。谁遇到谁先记日志。
121
136
 
122
- **只剩一条重构 + 一条受宿主限制的。**
137
+ 如果还想继续改,方向应该是「新需求」而不是「还债」了。
123
138
 
124
- 1. **#26 `diary/scheduler.js`(687 行五职责)** —— 拆 `diary/deliver.js`(投递 / 超时 / 等待她写)
125
- + 会话相关部分并进 `diary/agent.js`(R16 已经把 `composeDiarySetup` 放在那儿了)。
126
- 这是最后一条大文件。
127
- 2. **#23(渲染期白屏)** —— 除非宿主文档明确暴露了 `React.Component`,否则不要动。
139
+ ### 留给下一个重构者的话
128
140
 
129
- 重构纪律(R15/R16 两轮验证有效,照抄):
141
+ R15 / R16 / R17 三轮把三个大文件拆完了,过程中验证有效的六条做法,写在这里免得重走弯路:
130
142
 
131
143
  - **先补特征测试**,单独一个提交,且要在**拆分之前**就在旧代码上全绿 —— 否则它可能断言的是实现;
132
- - 拆分用**脚本按段落切分**(R16 的做法),别手抄 —— 手抄一定会在某处少一个空格或漏一行;
144
+ - 拆分用**脚本按段落切分**(R16 / R17 的做法),别手抄 —— 手抄一定会少一个空格或漏一行;
133
145
  - 拆完特征测试**一条不改**必须全绿;
134
146
  - **毒化一次**证明测试网有效。毒化不红时先怀疑毒化点或毒化写法:
135
147
  R15 第一版选了确定性路径(重算字节相同 → 不红),R16 第一版把条件写成 `A || B && false`
136
148
  (运算符优先级让毒化失效)—— **两次都是毒化写错,不是测试无效**;
137
- - 复核方会**逐个函数比对**「函数体在新旧位置是否逐字一致」,这是纯移动的唯一硬证据。
149
+ - 复核方会**逐个函数比对**「函数体在新旧位置是否逐字一致」,这是纯移动的唯一硬证据;
150
+ - 函数跨模块移动时,**既有测试的 import 路径与调用点必须跟着改**,但**断言一个字符都不许动**
151
+ —— R16、R17 都这么做的,diff 里能一眼看清。
138
152
 
139
- > 这一轮之后,**功能类与清理类已知问题全部清零,只剩最后一个大文件**。
140
- > 风险已经从「用户会踩到」变成「改的人会踩到」。
153
+ > 这三轮之后,**功能类、清理类、重构类已知问题全部清零**。
154
+ > 代码结构不再是「改一处要读整文件」的状态了。
141
155
 
142
156
  ---
143
157
 
@@ -0,0 +1,212 @@
1
+ # R18 任务书(三条:文档漂移 / 废弃键 / 开关生效证据)
2
+
3
+ > 给接手的 AI。**先读 `docs/HANDOFF.md`**,那份是总纲(纪律、结构、复核清单都在里面);
4
+ > 这一份只写本轮三件事。
5
+ >
6
+ > 基线:`v0.9.12`(提交 `19648ae`)· 交付方式:分支 + diff + 进度档案,**不要发布**(HANDOFF §8)
7
+
8
+ ---
9
+
10
+ ## 0. 这三条的共同点:都不是 bug,都是「说的和做的不一样」
11
+
12
+ 三条都不会让插件崩,但都会让人(包括下一个维护者)**判断错**:
13
+
14
+ | # | 症状 | 后果 |
15
+ |---|---|---|
16
+ | A | `package.json` 的 description 还写着心情「不注入、无挂饰」 | 别人读完介绍就以为心情只影响提示词里的措辞,不会想到每轮都有一段动态文本进上下文 |
17
+ | B | 两个已停用 / 已废弃的配置键还在配置表里 | 有人照着配置表去改它,改了没有任何反应,还以为生效了 |
18
+ | C | 大部分功能开关**没有生效证据** | 开关是 true,但链路早就断了 —— 日志不说,测试全绿 |
19
+
20
+ C 是重点,A/B 是顺手的。
21
+
22
+ **先说明一处需求描述需要更正**(见 §2):B 那条「仍列在配置表、建议设置页隐藏或标灰」——
23
+ **设置页早就没有这两项了**,我核过。真正的问题在别处,写清楚了。
24
+
25
+ ---
26
+
27
+ ## 1. 任务 A:`package.json` 的 description 已经过期
28
+
29
+ ### 已确认(我核过,可直接采信)
30
+
31
+ ```jsonc
32
+ // package.json
33
+ "description": "……心情跟着每轮对话自己判断、自己平复(不注入、无挂饰)。"
34
+ ```
35
+
36
+ 括号里那句「(不注入、无挂饰)」是**旧版**的事实,现在是错的:
37
+
38
+ - `lib/state/cache.js` 的 `DEFAULT_CONFIG` 里有 `moodToneInject: true`(2026-11-01 上线);
39
+ - `lib/host/runtime/segment-mood.js` 注册了 `soul:mood` 注入段(`order: 230`);
40
+ - 也就是说,心情**每轮都在往上下文里进一段文本**,而且隔几轮还会往用户消息后挂一行语气。
41
+
42
+ ### 要做的事
43
+
44
+ 1. 重写 description,**同时准确描述现状**:列出四类注入(人格 / 记忆 / 笔记 / 目的)+ 心情语气,
45
+ 并说明记忆会衰减、心情会自己判断。长度控制在 npm 卡片一行能看全(≤ 120 字为宜)。
46
+ 2. 顺手核一遍:description 里每一句,代码里都还成立吗?**逐句对着代码找到落点**。
47
+ 我上一轮就栽在这类地方 —— `HANDOFF.md` 写过「`force` 参数恒 false」,
48
+ 实际 `regenerateDiary` 一直在传 `{ force: true }`(R15 才被外部复核方纠正)。
49
+ 3. 如果 README 首屏也复述了同一句话,一起改(`grep "不注入"` 一把)。
50
+
51
+ ### 验收
52
+
53
+ - `grep -rn "不注入\|无挂饰" .` 只剩历史 CHANGELOG 里的记录(那是历史,不该改);
54
+ - description 里提到的每个能力,都能在代码里指到具体文件(在交付档案里列出来)。
55
+
56
+ ---
57
+
58
+ ## 2. 任务 B:两个废弃键 —— 需求描述要更正
59
+
60
+ ### 先更正事实
61
+
62
+ 原来的说法是「`diarySchedule` 与 `moodOwnerName` 仍列在配置表,建议设置页隐藏或标灰」。
63
+
64
+ **设置页根本没有这两项**(我核过):
65
+
66
+ - `lib/client/diary-tab.js` 只有一段注释解释「22:00 到点触发」为什么被删,
67
+ 界面上是「自动写日记」开关 + 「兜底检查间隔」;
68
+ - `lib/client/mood-tab.js` 用的是 `ownerName`(注释说明 `moodOwnerName` 只做迁移)。
69
+
70
+ 所以「隐藏 / 标灰」这件事**已经做完了**。剩下的是另一个问题:
71
+
72
+ ### 真正的问题
73
+
74
+ `lib/http/middleware.js` 的 `validateConfigEntry` 有一条**硬规则**:
75
+
76
+ ```js
77
+ if (!Object.prototype.hasOwnProperty.call(DEFAULT_CONFIG, key)) return { ok: false, error: '未知配置项' }
78
+ ```
79
+
80
+ 于是这两个键**必须**留在 `DEFAULT_CONFIG` 里,否则老客户端/手写调用往 `/config` 发它们会直接 400。
81
+ 它们现在的身份是「**兼容占位**」,不是「配置项」:
82
+
83
+ | 键 | 现状 | 真正的用途 |
84
+ |---|---|---|
85
+ | `diarySchedule: '22:00'` | 代码里**没人读**它做任何决策 | 只为不让旧配置报错 |
86
+ | `moodOwnerName: ''` | 只有迁移逻辑读它(`migrateOwnerName`) | 老配置迁移到 `ownerName` 用 |
87
+
88
+ **残留的坏味道**(这才是要修的):`/config` 会把它们**照原样写回 config.json**,
89
+ 于是它们在文件里永远活着,看起来像有效配置。
90
+
91
+ ### 要做的事(建议方案,可提出更好方案)
92
+
93
+ 1. 在 `middleware.js` 加一张 `LEGACY_CONFIG_KEYS` 表(`diarySchedule` / `moodOwnerName`):
94
+ - **接受**(不报 400,保持兼容);
95
+ - **不落盘**(`handlePostConfig` 合并前剔除);
96
+ - **每个进程只记一行日志**:`[config] 忽略已废弃配置键 diarySchedule(旧版遗留,当前无效果)`。
97
+ 2. `DEFAULT_CONFIG` 里这两个键的注释已经在(写得挺好),**保持**,别删键。
98
+ 3. 给 `/state` 或 `/attestation` 的返回加一个 `legacyKeys` 字段,说明「你的配置文件里有这些,
99
+ 现在没有效果」—— 这是**给用户看的**,比藏在代码注释里强。
100
+
101
+ ### 明确不要做
102
+
103
+ - ❌ **不要**从 `DEFAULT_CONFIG` 删这两个键 —— `validateConfigEntry` 会开始报「未知配置项」,
104
+ 这是破坏性变更,老用户直接撞 400;
105
+ - ❌ 不要为了「统一」把 `moodOwnerName` 的迁移逻辑删掉 —— 还有人配置在老版本上。
106
+
107
+ ### 验收
108
+
109
+ - 发一个含 `diarySchedule` 的 `/config` 请求 → 200,且 config.json 里**不出现**该键;
110
+ - 发一个含 `moodOwnerName` 的 → 200,且迁移逻辑(如果 `ownerName` 还空)仍然生效;
111
+ - 有测试覆盖上面两条;日志只打一行(不是每次请求一行)。
112
+
113
+ ---
114
+
115
+ ## 3. 任务 C(重点):每个功能开关都要有「生效 / 未生效」证据
116
+
117
+ ### 为什么
118
+
119
+ 项目历史上出过一次:**语气链失效了三天,日志里一句错都没有,测试全绿**。
120
+ 同类形状还有好几处(`lib/extract.js:179` 记的「记忆卡一次都没被创建、日志里连句报错都没有」)。
121
+
122
+ 根因是同一个:**开关的值 ≠ 开关的效果**。
123
+ `moodToneInject: true` 只能说明「用户没关它」,说明不了「它这一轮真的挂了语气」——
124
+ 中间任何一环断了(心情没判定成功、被判成机器来源、宿主改了事件形状),都是静默的。
125
+
126
+ 现在已经有两只眼睛,但只盯住了两处:
127
+
128
+ | 已有的观测 | 盯的是什么 | 位置 |
129
+ |---|---|---|
130
+ | `[attest] 装配证词` | 注入段**有没有内容**(人格 1277 字 · 记忆 794 字 · 笔记 227 字 · 目的 166 字,4/4 到位) | `lib/attest.js` + `host/runtime/entry.js` |
131
+ | `probeHostOnce` 宿主形状自检 | 宿主事件**能不能抠出正文** | `lib/core/host.js:170` 附近 |
132
+
133
+ **这一轮要把它推广到每个开关。**
134
+
135
+ ### 建议的设计(可调整,但下面三条要求别丢)
136
+
137
+ **① 静态生效性**:配置组合下这个开关是否**可能**生效。典型反例:
138
+
139
+ - `moodToneInject: true` 但 `moodEnabled: false` → 语气链 inert,原因必须是「心情关了」;
140
+ - `memoryEnabled: true` 但 `enabled: false` → 全关;
141
+ - `notesEnabled: true` 但笔记目录为空 → 不能算「生效」,要写「暂无内容」。
142
+
143
+ **② 动态证据**:它**上次真的发生**是什么时候。形式建议:
144
+
145
+ ```js
146
+ // 每个开关一个计数器 + 最后发生时间(内存即可,不落盘)
147
+ switchEvidence.mark('moodTone', { note: '给她挂了「有点困」的语气' })
148
+ ```
149
+
150
+ 启动时打一行、每日健康行里带一句,**不要每轮打日志**(噪音会让人不再看日志)。
151
+
152
+ **③ 一条命令能看见全部**:`[attest]` 或 `/state` 里给一张表:
153
+
154
+ ```
155
+ [attest] 开关生效:总开关✓ 记忆✓(89 条) 笔记✓(12 篇) 目的✓ 心情✓(判定 14 次/失败 0) 语气✓(近 7 轮挂 2 次) 日记✓(昨天已写)
156
+ 未生效:心动✗(功能未实现) 提炼✗(没配模型)
157
+ ```
158
+
159
+ ### 要做的事(按这个顺序,别一次全上)
160
+
161
+ 1. **先盘清单**:把 `DEFAULT_CONFIG` 里所有布尔开关列出来(我数到 17 个:`enabled` /
162
+ `apiLoopbackOnly` / `includeGlobal` / `projectPersonaEnabled` / `memoryEnabled` /
163
+ `projectMemoryEnabled` / `memoryRefine` / `memoryRecentDiaryIncludePrivate` / `purposeEnabled` /
164
+ `notesEnabled` / `moodEnabled` / `moodToneInject` / `diaryEnabled` / `diaryCatchUp` /
165
+ `diaryOverwrite` / `diaryAgentWrite` / `diaryManualNote`),
166
+ 逐个标注:**谁在用它 / 断了会怎么表现 / 现在有没有观测**。写进交付档案,这就是本轮的资产。
167
+ 2. **先做最贵的那三个**:`moodToneInject`(出事过)、`memoryEnabled`(出事过)、`memoryRefine`
168
+ (静默降级到原话直存的路径)。剩下的按「断了会不会完全没痕迹」排序。
169
+ 3. **抽出 `lib/evidence.js`**(或复用 `attest.js`),提供 `mark(key, detail)` / `report()`;
170
+ 把 `[attest]` 那一行和 `/state` 接上。
171
+ 4. **给 inert 的每种组合写测试**(这是最容易漏的):
172
+ `moodToneInject=true + moodEnabled=false` → report 里必须是「未生效:心情关了」,
173
+ 而不是「生效」也不算「未知」。
174
+
175
+ ### 要求(别做成假旋钮的反面)
176
+
177
+ - ❌ 不要用「配置是 true」冒充「生效」—— 那就是这轮要消灭的东西;
178
+ - ❌ 不要每轮往日志里灌;一行启动 + 一行每日健康,够了;
179
+ - ✅ inert 的**原因**必须写人话(「心情关了」而不是 `moodEnabled=false`);
180
+ - ✅ 「从未发生」和「发生了 N 次」要能分开(`0 次` ≠ `N/A`)。
181
+
182
+ ### 验收
183
+
184
+ - 至少 3 个开关有完整证据(静态 + 动态 + inert 原因),其余开关有清单和明确优先级;
185
+ - inert 组合有测试,且**毒化后必须红**(照 HANDOFF §6 的纪律:毒化不红先怀疑毒化写错);
186
+ - 交付档案里那张「开关清单」表本身,就是这一轮的主要产出之一。
187
+
188
+ ---
189
+
190
+ ## 4. 明确不做(免得白费力气)
191
+
192
+ | 不做 | 为什么 |
193
+ |---|---|
194
+ | 给设置页加回这两项(或标灰) | UI 早就没有,加了反而是倒退 |
195
+ | 从 `DEFAULT_CONFIG` 删废弃键 | 会让 `validateConfigEntry` 开始报「未知配置项」,破坏性变更 |
196
+ | 把开关证据做成落盘的历史统计 | 内存够用;写盘会带来「统计本身就是新的失败面」 |
197
+ | 改 `#23`(渲染期白屏) | 等宿主暴露 `React.Component`,见 HANDOFF §6 |
198
+
199
+ ---
200
+
201
+ ## 5. 交付与复核
202
+
203
+ 照 `HANDOFF.md` §8 做,只交付不发布。本轮复核会额外看:
204
+
205
+ 1. **description 的每一句都能在代码里找到落点**(我会逐句核,和 R15 那次 `force` 一样);
206
+ 2. **废弃键的兼容性**:老配置文件(含 `diarySchedule` / `moodOwnerName`)加载后行为不变,
207
+ 且新写入不再带上它们;
208
+ 3. **开关证据不是假绿**:我会挑一个 inert 组合,把配置改成那个组合,看报告是否真的说「未生效:原因」;
209
+ 4. **噪音**:跑一次完整会话,看日志里开关证据是不是只有启动那一行(多了就是错)。
210
+
211
+ > 这一轮要做对,靠的不是多写代码,而是**先承认「我不知道这个开关现在有没有在工作」**,
212
+ > 然后为这句话补上眼睛。
package/lib/attest.js CHANGED
@@ -35,6 +35,7 @@
35
35
  */
36
36
  import { note } from './env.js'
37
37
  import { shortHash } from './paths.js'
38
+ import { mark } from './evidence.js'
38
39
 
39
40
  /** 要盯的四段:名字必须与 index.js 里注册的完全一致。 */
40
41
  const WATCHED = [
@@ -121,6 +122,11 @@ export function recordAssembly(assembly, context) {
121
122
  }
122
123
 
123
124
  last = snapshot
125
+ // 2026-11-10 R18-C:四段进了装配 = 各自开关的最硬动态证据
126
+ // (「我返回了文本」不算,「模型收到了」才算 —— 本模块存在的意义)。
127
+ for (const item of items) {
128
+ if (item.state === 'present') mark(item.name, `${item.chars} 字`)
129
+ }
124
130
  history.push(snapshot)
125
131
  if (history.length > HISTORY_CAP) history.splice(0, history.length - HISTORY_CAP)
126
132
 
@@ -7,6 +7,7 @@
7
7
  * scheduler.js),本轮一并删除。
8
8
  */
9
9
  import { note, serviceOf } from '../env.js'
10
+ import { loadConfig } from '../store.js'
10
11
  import { readSessionMeta } from '../session-title.js'
11
12
 
12
13
 
@@ -74,3 +75,92 @@ export async function composeDiarySetup(ctx, sessionId) {
74
75
  return undefined
75
76
  }
76
77
  }
78
+
79
+ /**
80
+ * 取绑定好的日记会话(2026-10-31:从「自建会话」改成「绑定已有会话」;2026-11-03 补冷启动 preset;
81
+ * 2026-11-05 补 agentOptions.model)。2026-11-10 #26 由 scheduler.js 并入本模块 ——
82
+ * 「会话获取/冷启动」与 composeDiarySetup 本来就是同一件事的两半。
83
+ * 完整的事故推理链见原 scheduler.js 版本(git 历史)与本函数体内注释。
84
+ */
85
+ export async function diaryAgent(ctx) {
86
+ const config = loadConfig()
87
+ const sessionId = String(config.diarySessionId ?? '').trim()
88
+
89
+ if (sessionId === '') {
90
+ // 没有绑定就是没有绑定。以前这里会去捞「最近活跃会话」,等于把日记写进
91
+ // 用户正在聊的那个会话 —— 语义错了,私密内容还可能摆到不该看的人面前。
92
+ note('diary', '没有绑定日记会话(diarySessionId 为空),跳过本次投递。去设置页「日记」里点「把当前会话指定为日记会话」')
93
+ return undefined
94
+ }
95
+
96
+ const agents = serviceOf(ctx, 'agents')
97
+ if (agents === undefined || agents === null || typeof agents.get !== 'function') {
98
+ note('diary', `绑定的日记会话不可用:宿主没有 agents 服务(${sessionId})`)
99
+ return undefined
100
+ }
101
+
102
+ const reasons = []
103
+
104
+ // ① 活着的
105
+ try {
106
+ const live = agents.get(sessionId)
107
+ if (live !== undefined && live !== null) {
108
+ note('diary', `绑定的日记会话已在运行:${sessionId}`)
109
+ return live
110
+ }
111
+ reasons.push('当前不活跃')
112
+ } catch (error) {
113
+ const message = error instanceof Error ? error.message : String(error)
114
+ note('diary', `取活会话 ${sessionId} 失败:${message}`)
115
+ reasons.push(`get 失败:${message}`)
116
+ }
117
+
118
+ // ② 冷启动
119
+ if (typeof agents.resume !== 'function') {
120
+ reasons.push('agents 服务没有 resume 方法')
121
+ } else {
122
+ try {
123
+ // 必须带上 setup:resume 只恢复会话,不恢复 preset。
124
+ // 不带的话日记会话会「活着但没有工具」,而且不报错(2026-11-03 事故)。
125
+ const setup = await composeDiarySetup(ctx, sessionId)
126
+
127
+ // 2026-11-05 修:还必须有 agentOptions.model。
128
+ //
129
+ // 文档原话:「agents[].provider / agents[].model —— 模型路由;分发前两者都必须存在」。
130
+ // resume 一个持久化会话时,模型**不会**从会话里恢复(session 头里根本没这个字段),
131
+ // 不显式传就得到一个没有模型的 agent。后果不是「模型选错了」,而是装配直接抛:
132
+ // prompt variable "{{model}}" has no value (section "deployment:persona-prefix")
133
+ // 每一轮都抛,日记一个字也写不出来 —— 而且界面只显示「本轮运行失败」,很难联想到模型。
134
+ //
135
+ // 路由取日记专用配置;没配就退回 diarySummarize*(也是给日记用的),
136
+ // 两个都没有时明确记一行,不要静默传空。
137
+ const provider = String(config.diaryAgentProvider ?? '').trim() || String(config.diarySummarizeProvider ?? '').trim()
138
+ const model = String(config.diaryAgentModel ?? '').trim() || String(config.diarySummarizeModel ?? '').trim()
139
+ let agentOptions
140
+ if (provider !== '' && model !== '') {
141
+ agentOptions = { provider, model }
142
+ } else {
143
+ note('diary', '没配 diaryAgentProvider/Model 也没配 diarySummarize*:冷启动的日记会话将没有模型,装配会失败')
144
+ }
145
+
146
+ const handle = await agents.resume({
147
+ resumeSessionId: sessionId,
148
+ ...(agentOptions === undefined ? {} : { agentOptions }),
149
+ ...(setup === undefined ? {} : { setup })
150
+ })
151
+ const agent = handle?.agent
152
+ if (agent !== undefined && agent !== null) {
153
+ note('diary', `冷启动绑定的日记会话成功:${sessionId}`)
154
+ return agent
155
+ }
156
+ reasons.push('resume 没有返回 agent')
157
+ } catch (error) {
158
+ const message = error instanceof Error ? error.message : String(error)
159
+ note('diary', `冷启动绑定的日记会话 ${sessionId} 失败:${message}`)
160
+ reasons.push(`resume 失败:${message}`)
161
+ }
162
+ }
163
+
164
+ note('diary', `绑定的日记会话不可用:${reasons.join(';') || '未知原因'}(${sessionId})`)
165
+ return undefined
166
+ }