dsh-agent-soul 0.9.12 → 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,40 @@
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
+
10
44
  ## 0.9.12 · 2026-11-10
11
45
 
12
46
  外部复检轮 **R17(最后一个大文件)**,2 个提交 / 8 文件 / +353 −241。**对外行为零变化**:
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.12`
1
+ # 交接文档 · dsh-agent-soul `0.9.13`
2
2
 
3
3
  > 给接手的人(或 AI)。读完这一份就能开工,不需要翻聊天记录。
4
- > 写作时间:2026-11-08(0.9.12 于 2026-11-10 更新)· tag `v0.9.12` · npm `latest = 0.9.12`
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
- | 测试 | **89** 个测试文件 / 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 |
@@ -226,16 +226,32 @@ git switch -c fix/your-topic main # 从干净 main 拉
226
226
 
227
227
  ---
228
228
 
229
- ## 6. 下一轮该做什么(0.9.12 后)
229
+ ## 6. 下一轮该做什么(0.9.13 后)
230
230
 
231
- **代码层面的待修项已经清零。** 剩下的都不是「改代码」:
231
+ R18 的三条(description 对齐 / 废弃键不落盘 / 开关证据)**已合并发布**。下一轮第一件事:
232
232
 
233
- 1. **`#23`** —— 等宿主暴露 `React.Component`。在那之前别动:`try/catch` 包不住渲染期异常
234
- (渲染发生在 React 内部),改了只会得到一个假的错误边界。
235
- 2. **两条「待确认」**(见 §5 之后的第六节)—— 都需要**真实环境**:压缩会话的 `snapshotEvents`
236
- 会不会抛、反代 + 非默认端口下的 `Origin`/`Host` 形态。谁遇到谁先留日志。
233
+ ### ① 给动态证据补「接线测试」(R18 留下的缺口)
237
234
 
238
- 如果还想继续改,方向应该是**新需求**,不是还债。
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`)各来一条。
248
+
249
+ ### ② 还剩两件事,都不是「改代码」
250
+
251
+ - **`#23`** —— 等宿主暴露 `React.Component`。在那之前别动:`try/catch` 包不住渲染期异常
252
+ (渲染发生在 React 内部),改了只会得到一个假的错误边界。
253
+ - **两条「待确认」**(见第六节)—— 都需要**真实环境**:压缩会话的 `snapshotEvents`
254
+ 会不会抛、反代 + 非默认端口下的 `Origin`/`Host` 形态。谁遇到谁先留日志。
239
255
 
240
256
  > 三条重构纪律(R15 / R16 / R17 三轮验证有效,照抄):
241
257
  > **先补特征测试钉住当下行为 → 再拆 → 特征测试一条不改必须全绿 → 毒化一次证明测试网有效。**
@@ -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
 
@@ -0,0 +1,168 @@
1
+ /**
2
+ * evidence.js —— 开关的「生效 / 未生效」证据(2026-11-10 R18-C)。
3
+ *
4
+ * ── 为什么要它 ──
5
+ * 语气链失效三天,日志一句错都没有,测试全绿。根因:**开关的值 ≠ 开关的效果** ——
6
+ * `moodToneInject: true` 只说明「用户没关它」,说明不了「它这一轮真的挂了语气」。
7
+ * 同类事故还有:记忆卡一次都没创建、日志里连报错都没有(extract.js:179 记过)。
8
+ *
9
+ * 本模块提供两只眼睛:
10
+ * ① mark(key, note) —— 动态证据:这个开关**上次真的发生**是什么时候、发生了几次。
11
+ * 内存 Map,不落盘(写盘会带来「统计本身就是新的失败面」)。
12
+ * ② statuses(cfg, extra) —— 静态生效性:这个配置组合下开关**可能**生效吗?
13
+ * inert(不可能生效)时必须给出**人话原因**(「心情关了」,而不是 moodEnabled=false)。
14
+ *
15
+ * ── 噪音纪律 ──
16
+ * 启动打一行(index.js)+ 每日健康行带一句(health.js),**绝不每轮打** ——
17
+ * 噪音会让人不再看日志,「哪一轮全掉了」就被淹掉了。
18
+ *
19
+ * ── 「0 次」≠「N/A」──
20
+ * report() 里区分「从未发生」(开关可能生效但还没轮到它)与
21
+ * 「未生效:原因」(配置组合下不可能发生)。两者混报是这轮要消灭的假旋钮。
22
+ */
23
+ import { exists, diaryPublicPath } from './paths.js'
24
+ import { yesterdayKey } from './diary/completion.js'
25
+
26
+ /** key → { count, lastAt, note }。全进程共享(开关证据本来就不分会话)。 */
27
+ const marks = new Map()
28
+
29
+ /**
30
+ * 记一次「真的发生了」。由各链路的**送达点**调用(不是决策点):
31
+ * · moodTone —— 语气消息真的 append 进了她的 inbox(inject.js)
32
+ * · moodJudge —— 心情判定成功写回(mood/judge.js)
33
+ * · memory —— 记忆段真的注入了非空文本(segment-memory.js)
34
+ * · memoryRefine—— 提炼结果真的被接受入库(refine.js)
35
+ * @param {string} key
36
+ * @param {string} [note] 人话备注(进 report,截 40 字)
37
+ */
38
+ export function mark(key, note = '') {
39
+ const prev = marks.get(key)
40
+ marks.set(key, {
41
+ count: (prev?.count ?? 0) + 1,
42
+ lastAt: Date.now(),
43
+ note: String(note ?? '').slice(0, 40)
44
+ })
45
+ }
46
+
47
+ /** 测试与 /state 用:只读快照。 */
48
+ export function markSnapshot() {
49
+ return [...marks.entries()].map(([key, v]) => ({ key, count: v.count, lastAt: v.lastAt, note: v.note }))
50
+ }
51
+
52
+ /** 测试用:清空(正常流程永不调)。 */
53
+ export function __resetEvidenceForTest() {
54
+ marks.clear()
55
+ }
56
+
57
+ /**
58
+ * 单个开关的动态证据怎么写。
59
+ * @returns {string} ''(没有 mark 点的开关)| '0 次' | 'N 次'
60
+ */
61
+ function evidenceOf(key) {
62
+ const m = marks.get(key)
63
+ if (m === undefined) return ''
64
+ return `${m.count} 次`
65
+ }
66
+
67
+ /**
68
+ * 全部开关的静态生效性 + 动态证据。
69
+ *
70
+ * @param {object} cfg loadConfig() 的结果
71
+ * @param {{ memoryRecords?: number, notesCount?: number }} [extra] 调用方算好的数据面
72
+ * @returns {Array<{key:string, label:string, status:'生效'|'未生效'|'暂无'|'从未发生'|'生效(N次)'|'边界', reason:string}>}
73
+ */
74
+ export function statuses(cfg, extra = {}) {
75
+ const out = []
76
+ const push = (key, label, status, reason = '') => out.push({ key, label, status, reason })
77
+ const on = (v) => v !== false
78
+ const memoryRecords = Number(extra.memoryRecords)
79
+ const notesCount = Number(extra.notesCount)
80
+
81
+ // ---- 总开关 ----
82
+ if (on(cfg.enabled)) push('enabled', '总开关', '生效')
83
+ else {
84
+ push('enabled', '总开关', '未生效', '插件总开关关了——下面的全部跟着停')
85
+ push('memoryEnabled', '记忆', '未生效', '插件总开关关了')
86
+ push('purposeEnabled', '目的', '未生效', '插件总开关关了')
87
+ push('notesEnabled', '笔记', '未生效', '插件总开关关了')
88
+ push('moodEnabled', '心情', '未生效', '插件总开关关了')
89
+ push('moodToneInject', '心情语气', '未生效', '插件总开关关了')
90
+ push('diaryEnabled', '日记', '未生效', '插件总开关关了')
91
+ push('memoryRefine', '提炼', '未生效', '插件总开关关了')
92
+ push('projectMemoryEnabled', '项目记忆', '未生效', '插件总开关关了')
93
+ push('projectPersonaEnabled', '项目人格', '未生效', '插件总开关关了')
94
+ return out
95
+ }
96
+
97
+ // ---- 记忆 ----
98
+ if (on(cfg.memoryEnabled)) {
99
+ if (Number.isFinite(memoryRecords) && memoryRecords === 0) push('memoryEnabled', '记忆', '暂无', '还没有一条记忆(聊出值得记的事才会有)')
100
+ else push('memoryEnabled', '记忆', '生效', Number.isFinite(memoryRecords) ? `${memoryRecords} 条` : '')
101
+ } else push('memoryEnabled', '记忆', '未生效', '记忆关了(素材照常收集,只是不注入不提取)')
102
+
103
+ // ---- 提炼(最贵,出过静默降级)----
104
+ if (on(cfg.memoryRefine)) {
105
+ const n = evidenceOf('memoryRefine')
106
+ if (n === '') push('memoryRefine', '提炼', '从未发生', '开关开着,但还没有一次提炼发生(等下一条入库;没配提炼模型会一直停在这)')
107
+ else push('memoryRefine', '提炼', `生效(${n})`)
108
+ } else push('memoryRefine', '提炼', '未生效', '提炼关了——记忆直存原话')
109
+
110
+ // ---- 目的 ----
111
+ push('purposeEnabled', on(cfg.purposeEnabled) ? '目的' : '目的', on(cfg.purposeEnabled) ? '生效' : '未生效', on(cfg.purposeEnabled) ? '' : '目的关了')
112
+
113
+ // ---- 笔记 ----
114
+ if (on(cfg.notesEnabled)) {
115
+ if (Number.isFinite(notesCount) && notesCount === 0) push('notesEnabled', '笔记', '暂无', '笔记目录是空的(她还没写过一篇)')
116
+ else push('notesEnabled', '笔记', '生效', Number.isFinite(notesCount) ? `${notesCount} 篇` : '')
117
+ } else push('notesEnabled', '笔记', '未生效', '笔记关了')
118
+
119
+ // ---- 心情 + 语气(出过三天静默事故的那条链)----
120
+ if (on(cfg.moodEnabled)) {
121
+ const judge = evidenceOf('moodJudge')
122
+ push('moodEnabled', '心情', judge === '' ? '从未发生' : `生效(判定 ${judge})`, judge === '' ? '开关开着,但还没有一次判定发生(等第一轮对话结束)' : '')
123
+ if (on(cfg.moodToneInject)) {
124
+ const tone = evidenceOf('moodTone')
125
+ if (tone === '') push('moodToneInject', '心情语气', '从未发生', '开关开着,但还没有一次语气真的挂出去(要等判定成功 + 轮次节流到点)')
126
+ else push('moodToneInject', '心情语气', `生效(挂 ${tone})`)
127
+ } else push('moodToneInject', '心情语气', '未生效', '语气开关关了——心情照样判,只是不往对话里挂')
128
+ } else {
129
+ push('moodEnabled', '心情', '未生效', '心情关了')
130
+ push('moodToneInject', '心情语气', '未生效', '心情关了——判定不跑,语气无从挂起')
131
+ }
132
+
133
+ // ---- 日记 ----
134
+ if (on(cfg.diaryEnabled)) {
135
+ const yesterdayWritten = exists(diaryPublicPath(yesterdayKey(Date.now())))
136
+ push('diaryEnabled', '日记', yesterdayWritten ? '生效' : '从未发生', yesterdayWritten ? '昨天的已写' : '昨天的还没写(看门狗/兜底会来补)')
137
+ } else push('diaryEnabled', '日记', '未生效', '日记关了')
138
+
139
+ // ---- 其余开关(静态,无 mark 点)----
140
+ push('projectMemoryEnabled', on(cfg.projectMemoryEnabled) ? '项目记忆' : '项目记忆', on(cfg.projectMemoryEnabled) ? '生效' : '未生效', on(cfg.projectMemoryEnabled) ? '' : '项目记忆关了(只记全局一张卡)')
141
+ push('projectPersonaEnabled', on(cfg.projectPersonaEnabled) ? '项目人格' : '项目人格', on(cfg.projectPersonaEnabled) ? '生效' : '未生效', on(cfg.projectPersonaEnabled) ? '' : '项目人格关了(只吃全局人格)')
142
+ push('includeGlobal', on(cfg.includeGlobal) ? '全局人格' : '全局人格', on(cfg.includeGlobal) ? '生效' : '未生效', on(cfg.includeGlobal) ? '' : '关了 =「纯项目制」,没有项目人格的会话将没有人格')
143
+ push('memoryRecentDiaryIncludePrivate', '最近日记含私密', on(cfg.memoryRecentDiaryIncludePrivate) ? '生效' : '未生效', on(cfg.memoryRecentDiaryIncludePrivate) ? '' : '关了 =「最近」段只带公开日记')
144
+ push('diaryCatchUp', '日记追补', on(cfg.diaryCatchUp) ? '生效' : '未生效', on(cfg.diaryCatchUp) ? '' : '关了 = 错过的日子不往前补')
145
+ push('diaryOverwrite', '日记重写', on(cfg.diaryOverwrite) ? '生效' : '未生效', on(cfg.diaryOverwrite) ? '' : '关了 = 已存在的日记不覆盖')
146
+ push('diaryAgentWrite', '先投给她写', on(cfg.diaryAgentWrite) ? '生效' : '未生效', on(cfg.diaryAgentWrite) ? '' : '关了 = 跳过「让她自己写」,直接兜底生成')
147
+ push('diaryManualNote', '手动触发带备注', on(cfg.diaryManualNote) ? '生效' : '未生效', on(cfg.diaryManualNote) ? '' : '关了 = 手动触发不接受备注')
148
+ push('apiLoopbackOnly', '仅本机访问', cfg.apiLoopbackOnly === false ? '边界' : '边界', cfg.apiLoopbackOnly === false ? '⚠ 已放宽(需启动环境 DSH_SOUL_ALLOW_REMOTE_API=1)——确认是你自己干的' : '设置页接口只允许本机回环')
149
+
150
+ return out
151
+ }
152
+
153
+ /**
154
+ * 一行人话总览(启动 + 每日健康行用)。
155
+ * @returns {string}
156
+ */
157
+ export function reportLine(cfg, extra = {}) {
158
+ const rows = statuses(cfg, extra)
159
+ const mark = (row) => row.status === '未生效' ? '✗' : row.status === '暂无' || row.status === '从未发生' ? '◐' : '✓'
160
+ const okPart = rows.filter((r) => mark(r) === '✓').map((r) => `${r.label}${r.reason !== '' && !r.label.includes('开关') ? `(${r.reason})` : ''}✓`)
161
+ const pendingPart = rows.filter((r) => mark(r) === '◐').map((r) => `${r.label}◐(${r.reason})`)
162
+ const offPart = rows.filter((r) => r.status === '未生效').map((r) => `${r.label}✗(${r.reason})`)
163
+ const parts = []
164
+ if (okPart.length > 0) parts.push(`生效:${okPart.join(' ')}`)
165
+ if (pendingPart.length > 0) parts.push(`暂未发生:${pendingPart.join(' ')}`)
166
+ if (offPart.length > 0) parts.push(`未生效:${offPart.join(' ')}`)
167
+ return `开关证据|${parts.join(' | ')}`
168
+ }
package/lib/health.js CHANGED
@@ -40,6 +40,7 @@ import { normalizeConfig, ownerImportant } from './memory.js'
40
40
  // 现在 health 只依赖不碰 store 的时间/完整性工具,环断掉,依赖图门禁会强制守住。
41
41
  import { diaryIsCompleteFor, todayKey } from './diary/completion.js'
42
42
  import { ingestFailureCount, resetIngestFailureCount } from './extract.js'
43
+ import { reportLine } from './evidence.js'
43
44
 
44
45
  // --------------------------------------------------------------------------
45
46
  // 提炼队列计数(入队 +1、出队 -1)
@@ -219,7 +220,7 @@ export function renderHealthLine({ cwd = '', config = {}, cards = {}, now = Date
219
220
  const writeFailures = safe(() => ingestFailureCount() + cardWriteFailureCount(), null)
220
221
  const refineQueue = safe(() => refinePendingCount(), null)
221
222
 
222
- return '[health] ' + [
223
+ const base = '[health] ' + [
223
224
  memoryBlock,
224
225
  `归档 ${archiveLines === null ? '-' : archiveLines} 条`,
225
226
  `笔记 ${noteCount === null ? '-' : noteCount} 篇`,
@@ -229,6 +230,15 @@ export function renderHealthLine({ cwd = '', config = {}, cards = {}, now = Date
229
230
  `写盘失败 ${writeFailures === null ? '-' : writeFailures}`,
230
231
  `提炼队列 ${refineQueue === null ? '-' : refineQueue}`
231
232
  ].join('|')
233
+
234
+ // 2026-11-10 R18-C:每日健康行带上开关证据(一天一行,噪音纪律同健康行本身)
235
+ const evidenceSuffix = safe(() => {
236
+ const memoryRecords = projectMetric !== null && globalMetric !== null
237
+ ? projectMetric.count + globalMetric.count
238
+ : undefined
239
+ return reportLine(cfg, { memoryRecords, notesCount: noteCount === null ? undefined : noteCount })
240
+ }, '')
241
+ return evidenceSuffix === '' ? base : `${base}|${evidenceSuffix}`
232
242
  }
233
243
 
234
244
  // --------------------------------------------------------------------------