dsh-agent-soul 0.9.17 → 0.10.0

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.
Files changed (46) hide show
  1. package/CHANGELOG.md +122 -0
  2. package/README.md +99 -123
  3. package/docs/HANDOFF.md +26 -39
  4. package/docs/KNOWN-ISSUES.md +4 -0
  5. package/lib/api.js +7 -8
  6. package/lib/client/app.js +2 -2
  7. package/lib/client/diary-tab.js +71 -205
  8. package/lib/client/mood-tab.js +2 -2
  9. package/lib/client/overview-tab.js +6 -6
  10. package/lib/client/settings-tab.js +3 -3
  11. package/lib/client.js +84 -218
  12. package/lib/diary/agent.js +4 -4
  13. package/lib/diary/completion.js +7 -10
  14. package/lib/diary/compose.js +70 -260
  15. package/lib/diary/excerpt.js +153 -0
  16. package/lib/diary/fallback.js +50 -0
  17. package/lib/diary/feed.js +481 -481
  18. package/lib/diary/files.js +37 -30
  19. package/lib/diary/history.js +57 -84
  20. package/lib/diary/scheduler.js +77 -217
  21. package/lib/diary-tool.js +197 -203
  22. package/lib/diary.js +51 -48
  23. package/lib/env.js +1 -1
  24. package/lib/evidence.js +10 -18
  25. package/lib/health.js +15 -19
  26. package/lib/host/runtime/entry.js +1 -4
  27. package/lib/host/runtime/inject.js +12 -23
  28. package/lib/host/runtime/segment-cache.js +31 -5
  29. package/lib/host/runtime/segment-notes.js +6 -0
  30. package/lib/host/runtime/state.js +0 -2
  31. package/lib/host/runtime/turns.js +11 -27
  32. package/lib/http/middleware.js +6 -50
  33. package/lib/http/routes/diary.js +208 -218
  34. package/lib/http/routes/index.js +4 -3
  35. package/lib/http/routes/system.js +10 -11
  36. package/lib/http/server.js +5 -13
  37. package/lib/memory/config.js +3 -3
  38. package/lib/memory/constants.js +11 -16
  39. package/lib/mood/hooks.js +8 -8
  40. package/lib/paths.js +21 -18
  41. package/lib/state/cache.js +86 -32
  42. package/package.json +126 -127
  43. package/lib/core/diary-pick.js +0 -182
  44. package/lib/diary/llm.js +0 -268
  45. package/lib/diary/to-today.js +0 -114
  46. package/lib/threads.js +0 -252
package/CHANGELOG.md CHANGED
@@ -7,6 +7,128 @@
7
7
 
8
8
  ---
9
9
 
10
+ ## 0.10.0 · 2026-11-21
11
+
12
+ **日记 → 摘录。** 这一天不再写「一篇公开 + 一篇私密」,只写一篇**事实条目**:
13
+ `agents/diary/excerpt/YYYY-MM-DD.md`,一行一条,不写时间、不写感受。
14
+
15
+ 语义变了,所以是 0.10.0 而不是 0.9.x。
16
+
17
+ ### 变更 · 产出从两篇变一篇
18
+
19
+ ```
20
+ # 2026-11-20
21
+
22
+ - 灵魂插件:日记改成「摘录」,去掉公开/私密两篇
23
+ - 复变:确认下周四考试,定了每天两小时
24
+ ```
25
+
26
+ - 目录:`agents/diary/excerpt/`(新)。**不再写** `public/` 与 `private/`。
27
+ - 格式是硬规则,由插件统一收口(`lib/diary/excerpt.js`):一行一条、`- ` 开头、
28
+ 去掉时间戳与标题、丢弃带「觉得 / 看得出 / 其实 / 似乎 / 也许」的句子、
29
+ 最多 `excerptMaxLines`(默认 15)条。
30
+ - 超上限时优先保留「约定 / 决定 / 时间 / 待办」(最多 3 条,放在最前面)。
31
+ - 当天没有对话 → 一行 `(今天没有对话)`。
32
+ - 触发链路**没动**:启动补写 + 看门狗(`startDiaryTimer` / `runStartupFlow` /
33
+ `runDiaryOnce` / `withDeadline` / 孤儿链 TTL 全部保持原样),只是从两条消息收成一条。
34
+ - 兜底从「插件再调一次模型生成一篇」改成**规则化提取**:
35
+ 从 `conversations/YYYY-MM-DD.jsonl` 每行取 `role + 首句`,最多 20 条,**不调模型**。
36
+
37
+ ### 删除 · 四类功能
38
+
39
+ | 删 | 连带删掉的东西 |
40
+ |---|---|
41
+ | **给明天一句话** | `lib/diary/to-today.js`、`markToToday`、首轮注入那段、`POST /diary/to-today`、设置页卡片、证据条目、`diaryToTodayEnabled` / `diaryToTodayMaxChars`(配置三处) |
42
+ | **连续线** | `lib/threads.js`、日记里的开线/关线、`threadSection` 参数与文案 |
43
+ | **素材打分** | `lib/core/diary-pick.js`、按分数挑对话(摘录直接读流水,只做长度截断) |
44
+ | **公开/私密区分** | `private/` 写入路径、`diaryPrivateTone`、`diaryPrivateVisible`、`GET /diary/private`、私密语气输入、私密可见开关、私密历史回喂(`continueFromPublic`) |
45
+
46
+ 顺带删掉的死路径:`lib/diary/llm.js`(`composeDiaryText` / `summarizeConversations`)——
47
+ 摘录主流程不再自己调模型,这条兜底没有对象了。
48
+
49
+ ### 新增 · 配置
50
+
51
+ - `excerptSessionId`:绑定的摘录会话(原 `diarySessionId`)。
52
+ - `excerptMaxLines`:一天最多几条,默认 15,范围 5~60
53
+ (`NUMBER_RANGES` 与 `normalizeConfig` 两处一致)。
54
+
55
+ ### 迁移 · 老用户的绑定不会丢
56
+
57
+ `diarySessionId` → `excerptSessionId` **自动迁移**:`loadConfig` 发现配置里没有新键、
58
+ 却有旧键时,把值(连同 `diarySessionBornAt` → `excerptSessionBornAt`)搬过去并写回
59
+ `persona.json`,日志留一行。老用户升级后摘录照常写进原来那个会话,不需要重新绑定。
60
+
61
+ ### 旧数据 · 一个字节都不删
62
+
63
+ `agents/diary/public/`、`private/`、`threads.json`、`to-today.json` **原样保留、不改写、不迁移**。
64
+ 设置页「摘录」页签里旧内容仍可显示,但标成**「旧日记」只读**;
65
+ 旧私密篇的正文跟以前一样不出服务器(`GET /diary/read` 只回旧公开篇,旧私密只报存在性)。
66
+ 0.10.0 起「那天写过没有」只看 `excerpt/`——旧日记不会让一个缺失日被误判成「已写」。
67
+
68
+ ### 注入
69
+
70
+ 「最近」段从「前几天的日记(每篇一段摘要)」改成「前几天的摘录」:
71
+ 最近 3 天、每篇最多 3 条。摘录全文不再进上下文。
72
+
73
+ ### 破坏性
74
+
75
+ - 配置键删除:`diaryPrivateVisible`、`diaryPrivateTone`、`diaryToTodayEnabled`、
76
+ `diaryToTodayMaxChars`、`diaryPublicMoodMoments`、`diaryPrivateMoodMoments`、
77
+ `memoryRecentDiaryIncludePrivate`。旧配置文件里留着它们不会报错(不认识的键被忽略),
78
+ 但已经不起作用。
79
+ - 路由删除:`GET /diary/private`、`POST /diary/to-today`。
80
+ - `soul_diary` 工具:`kind` 从 `public | private` 收成 `excerpt`;`action=look` 仍能翻最近 7 天。
81
+ - `/diary/list` 的返回从 `hasPublic` / `hasPrivate` 变成 `hasExcerpt`(旧数据另带
82
+ `legacy` / `hasLegacyPublic` / `hasLegacyPrivate`);`/diary/read` 的 `publicContent`
83
+ 变成 `excerptContent` + `excerptLines`,旧日记放 `legacy.publicContent`。
84
+
85
+ ---
86
+
87
+ ## 0.9.18 · 2026-11-12
88
+
89
+ `segment-cache.js`(四段系统提示的渲染缓存)审计后的整改。审计报告在交接目录,
90
+ 两个自写探针在 `审计证据\` 里(不进仓库)。
91
+
92
+ ### 修复 · 缓存永久冻结(P1)
93
+
94
+ `everyTurns` 的判据是 `human - hit.turn`,而 `human` 靠 `isFirstTurnOfSession` 推进 ——
95
+ 它依赖 `session.snapshotEvents()`。宿主在**压缩会话**上持续抛错时,`turns.js` 的处理是
96
+ 「游标推进、human 不动」,于是 human 恒为 0、差值恒为 0 → **一直命中,永不重算**:
97
+
98
+ ```
99
+ 探针实测:everyTurns=2,21 轮里 compute 只跑了 1 次,日志里一个字都没有
100
+ ```
101
+
102
+ **修法**:槽位记 `at`,命中条件再加一条 `now - hit.at < SEGMENT_CACHE_MAX_AGE_MS`
103
+ (默认 30 分钟)。正常路径(human 在涨)永远轮不到它;只有在轮次推不动的退化场景下,
104
+ 最多 30 分钟自愈一次。**毒化**:删掉这条条件 → 4 条断言变红(`到期后重算`、`compute 两次` 等);
105
+ 恢复 → 15/15 全绿。
106
+
107
+ > 没有从根上改 `isFirstTurnOfSession`(抛错恢复后 human 会永久少算历史条数)——
108
+ > 那牵动首轮判定,改错会让新会话失忆,值单独一轮做,不顺手夹带。
109
+
110
+ ### 删除 · 死代码
111
+
112
+ - `shouldInjectPersona`(`turns.js`)与 `personaInjectAtBySession`(`state.js`):
113
+ 0.9.17 人格段改成「缓存优先」之后已无调用方,只剩只写不读。
114
+ - 留着它是**文档陷阱**:那段注释讲「首轮注入、之后每 15 轮补一次」,而真实行为是
115
+ 「每轮都在,只是每 15 轮重算一次」。想恢复旧行为应该加配置开关,而不是复活这个函数。
116
+ - 连带清掉 `entry.js` 里的 `.clear()`、两处 import,以及导出快照里的三个名字。
117
+
118
+ ### 文档
119
+
120
+ - `segment-notes.js` 的指纹注释补了一条实测结论:**手改一篇已有笔记,最多 7 轮后才生效**
121
+ (NTFS 上改文件内容不会改父目录 mtime,`index.json` 也不动;新增/删除文件能立刻发现)。
122
+ 这条以前只有「目录 mtime 能兜住手改」的模糊说法,审计时被证伪了一半。
123
+
124
+ ### 审计确认没问题的
125
+
126
+ 跨会话串味(拿不到 sessionId 就不缓存)、无上限增长(128 槽真 LRU)、
127
+ 写入回声不被缓存吃掉(有回声时绕过缓存)、开关短路在缓存之外、
128
+ 以及缓存确实在工作(`context.agent` 被已在用的功能依赖,不是空转)。
129
+
130
+ ---
131
+
10
132
  ## 0.9.17 · 2026-11-12
11
133
 
12
134
  外部审查(43 条)整改轮 **R20**。审查报告基于 `47549e5`,整改落在 `4805cd7` 之后。
package/README.md CHANGED
@@ -11,8 +11,8 @@
11
11
  | **人格** | 用 Markdown 写「你是谁」。项目人格只覆盖同名小节,全局的照常生效 —— 不会因为某个目录里有 `AGENT.md`,你在全局写的话就整份失效 |
12
12
  | **记忆** | 值得记的事自己进来,随时间变模糊:清晰 → 清楚 → 模糊 → 只剩印象 → 遗忘。忘了不是删掉,是**先变得说不清** |
13
13
  | **目的** | 从记忆里长出一份「心里惦记的事」,让她的主动有连续性 —— 不是定时问候,是主动想起 |
14
- | **心情** | 每轮对话后自己判一次起伏(心情值 + 七情 + 时间线),并作为 `soul:mood` 段把状态注进上下文、隔几轮往她的消息后面挂一句语气(设置里可关)。记下来的情绪另外两个出口:当日记的底色、推着目的机制的驱动 |
15
- | **日记** | 开机时把**前一天**沉淀成两篇:一篇公开(可以拿给你看),一篇私密(只写给自己)。**先投消息让她用 `soul_diary` 自己写**,文件没出现才由插件 `llm.stream` 兜底生成 |
14
+ | **心情** | 每轮对话后自己判一次起伏(心情值 + 七情 + 时间线),并作为 `soul:mood` 段把状态注进上下文、隔几轮往她的消息后面挂一句语气(设置里可关)。记下来的情绪还会推着目的机制的驱动 |
15
+ | **摘录** | 开机时把**前一天**沉淀成一篇事实条目(`agents/diary/excerpt/YYYY-MM-DD.md`):一行一条,只写「对什么、做了什么」,不写时间、不写感受。**先投消息让她用 `soul_diary` 自己写**,没写成才由插件从对话流水规则化提取(不调模型) |
16
16
  | **笔记** | 她自己写的 md:一篇一个主题、自由格式、**永不衰减**。提示词里只给索引,正文用 `soul_note` 按需读 |
17
17
 
18
18
  不管 B 站、不管 QQ、不管桌宠。这个插件只关心「她是谁」和「她记得什么」。
@@ -28,18 +28,18 @@
28
28
  - 你说话,值得记的事自动进记忆卡
29
29
  - 每天第一次打开,它会把不重要的事降一格清晰度
30
30
  - 她答应过的事、没弄明白的事,自动变成「心里惦记的事」
31
- - 开机时自动补写前一天的日记
31
+ - 开机时自动补写前一天的摘录
32
32
 
33
33
  ### 2. 设置 → 灵魂(八个标签)
34
34
 
35
35
  | 标签 | 用来干什么 |
36
36
  |---|---|
37
- | **概览** | 一眼看「到底生效没有」:人格来源、记忆条数与容量、惦记几件事、**最近**(当前心情 + 昨天日记写没写) |
37
+ | **概览** | 一眼看「到底生效没有」:人格来源、记忆条数与容量、惦记几件事、**最近**(当前心情 + 昨天摘录写没写) |
38
38
  | **人格** | 直接编辑全局 / 项目人格。存完下一个回合生效 |
39
39
  | **记忆** | 搜、看清晰度和重要度、固定(永不遗忘)、删、手动加 |
40
40
  | **目的** | 四个驱动读数 + 惦记清单,可以「放下了」 |
41
41
  | **心情** | 心情值 + 七情 + 时间线;可重置、可手动跑一次平复 |
42
- | **日记** | 开关、兜底检查间隔、公开/私密语气、手动触发(可带备注)、最近日记列表 |
42
+ | **摘录** | 开关、兜底检查间隔、摘录语气、最多几条、手动触发(可带备注)、最近摘录(旧日记只读) |
43
43
  | **笔记** | 她自己写的 md:看、改、删、新建;也能关掉索引注入 |
44
44
  | **设置** | 注入预算、叠加还是互斥、各项开关、立即整理一次 |
45
45
 
@@ -100,7 +100,7 @@
100
100
  | `ownerGender` | 「⚠️ X 是男生 / 女生,写出「她 / 他」即算判错」那一整行不写(不猜) |
101
101
  | `relationship` | 「是 X 的**伴侣**」这半句不写,只留名字 |
102
102
 
103
- **不会因此让插件失效**:记忆、笔记、日记、目的机制都不读 `ownerName`,照常工作。只是提示词里「关于谁」的那几句不在了。
103
+ **不会因此让插件失效**:记忆、笔记、摘录、目的机制都不读 `ownerName`,照常工作。只是提示词里「关于谁」的那几句不在了。
104
104
 
105
105
  在 **设置 → 灵魂 → 设置 → 主人是谁** 里填这三项即可恢复;`ownerName` 没填时页面上有醒目提示,`soul.log` 里也会每小时留一行「未设置 ownerName,相关段落已跳过」。
106
106
 
@@ -165,19 +165,24 @@
165
165
  新会话第一轮,除了记忆卡,还会带上:
166
166
 
167
167
  ```
168
- ### 前几天的日记
169
- (最近 2 天的公开日记,超 6000 字留最近的)
168
+ ### 前几天的摘录(每篇最多 3 条;全文在 agents/diary/excerpt/<日期>.md)
169
+ 2026-11-19:
170
+ - 树树:把记忆卡的召回上限从 6 调到 3
171
+ - 插件:修了设置页保存后其他标签页不刷新的问题
172
+ 2026-11-20:
173
+ - 灵魂插件:日记改成「摘录」,去掉公开/私密两篇
174
+ - 复变:确认下周四考试,定了每天两小时
170
175
 
171
176
  ### 今天到目前为止(可能来自别的对话)
172
177
  [14:20] 树树:……
173
178
  [14:21] 我:……
174
179
  ```
175
180
 
176
- **为什么需要**:人不会在一个对话里做完所有事 —— 修插件、QQ 聊天、闲聊是分开的会话。记忆卡只有零碎事实,日记只写到昨天,所以新开一个对话时她不知道今天早些时候在别的对话里做过什么。
181
+ **为什么需要**:人不会在一个对话里做完所有事 —— 修插件、QQ 聊天、闲聊是分开的会话。记忆卡只有零碎事实,摘录只写到昨天,所以新开一个对话时她不知道今天早些时候在别的对话里做过什么。
177
182
 
178
- 数据来源是 `conversations/<今天>.jsonl` —— 这个流水本来就是**所有会话共同汇总**的(原来只用来生成日记,从没读回过会话)。
183
+ 数据来源是 `conversations/<今天>.jsonl` —— 这个流水本来就是**所有会话共同汇总**的(原来只用来生成摘录,从没读回过会话)。
179
184
 
180
- 配置 `memoryRecentDiaryDays` / `memoryRecentChatChars` 控制,设 0 关闭。私密日记默认不进(`memoryRecentDiaryIncludePrivate`)。
185
+ 配置 `memoryRecentDiaryDays` / `memoryRecentChatChars` 控制,设 0 关闭;摘录侧最多读最近 3 天,每篇只取前 3 条。
181
186
 
182
187
  ---
183
188
 
@@ -210,7 +215,7 @@
210
215
  >
211
216
  > 迁移是自动的:`global.json` 不存在时,从旧文件里挑记录最完整的那份搬过来,**旧文件保留不删**。
212
217
 
213
- **七情的满格是 20 不是 100**:判定单次上限 ±10,又被 90 分钟半衰期往回磨,实测一整天峰值只到 13。所以设置页和日记都按 20 当 100% 折算 —— 「踏实 65%」是很踏实,不是刚过一半。
218
+ **七情的满格是 20 不是 100**:判定单次上限 ±10,又被 90 分钟半衰期往回磨,实测一整天峰值只到 13。所以设置页按 20 当 100% 折算 —— 「踏实 65%」是很踏实,不是刚过一半。
214
219
 
215
220
  **判定用哪个模型**:每回合判一次,是全插件最贵的一处固定开销。两条路:
216
221
 
@@ -257,7 +262,21 @@
257
262
 
258
263
  ---
259
264
 
260
- ## 日记
265
+ ## 摘录
266
+
267
+ 0.10.0 起,原来的「公开 + 私密」两篇日记收成一篇摘录;旧文件只读保留,见下面「旧日记只读保留」。
268
+
269
+ 每天一篇,存在 `agents/diary/excerpt/YYYY-MM-DD.md`。正文是事实条目:一行一条,只写「对什么、做了什么」,不写几点几分,不写感受和评价。
270
+
271
+ ```
272
+ # 2026-11-20
273
+
274
+ - 灵魂插件:日记改成「摘录」,去掉公开/私密两篇
275
+ - 复变:确认下周四考试,定了每天两小时
276
+ - 树树:明天去问问实验课的时间
277
+ ```
278
+
279
+ (格式示意,条数按那天实际情况。)
261
280
 
262
281
  **规则:开机时写前一天。**
263
282
 
@@ -271,76 +290,55 @@ DSH 启动 5 秒后 → 看昨天写得完不完整
271
290
  看门狗每 30 分钟 → 同上检查(兜住「一直不关机」的情况)
272
291
  ```
273
292
 
274
- **怎么写的**:先投消息让她自己写,没写成才由插件兜底(2026-11-04 改)。
293
+ **怎么写的**:先投消息让她自己写,没写成才由插件规则化兜底。
275
294
 
276
295
  ```
277
- 缺哪篇 → 投一条消息给绑定的日记会话(附当天的对话 / 情绪 / 最近日记)
296
+ 缺这一天 → 投一条消息给绑定的摘录会话(附当天的对话 / 前几天摘录 / 现实情境)
278
297
  → 轮询等那篇文件出现(默认最多 3 分钟)
279
298
  → 出现了:这篇就是她写的
280
- → 没出现:插件调 llm.stream 生成 → atomicWrite 落盘
299
+ → 没出现:插件从 conversations/<日期>.jsonl 规则化提取,不调模型
281
300
  ```
282
301
 
283
- **投给哪个会话**:`diarySessionId`,默认空。空就跳过投递(走兜底生成),**不会**退化成「最近活跃会话」——那样私密内容可能写进你正在聊的会话;日志里会提示去设置页绑定。绑定入口是设置 → 日记 →「日记写进哪个会话」下拉,选一个**已有**会话,不自动创建。绑定失效时(会话被归档、宿主拿不到)记日志跳过,不会另找会话,这一天的日记交给兜底。
302
+ **投给哪个会话**:`excerptSessionId`,默认空。空就跳过投递,直接走规则化兜底,**不会**退化成「最近活跃会话」——那样摘录可能写进你正在聊的会话;日志里会提示去设置页绑定。绑定入口是设置 → 摘录 →「摘录写进哪个会话」下拉,选一个**已有**会话,不自动创建。绑定失效时(会话被归档、宿主拿不到)记日志跳过,不会另找会话,这一天交给兜底。
284
303
 
285
- 两篇还是分开的、公开在前:投私密那条消息时公开已经落盘,而公开那条消息里只有公开历史 —— 顺序本身就是隔离。
304
+ 旧配置里的 `diarySessionId` / `diarySessionBornAt` 会自动迁移成 `excerptSessionId` / `excerptSessionBornAt` 并写回 `persona.json`,旧键随后删掉;绑过的会话不会丢。
286
305
 
287
306
  > **2026-10-31 的教训还在,别把判据改回去**:当年就是把消息投进会话让她写,`followup()` **同步返回 void**,「没抛异常就算成功」对 void 函数恒为真 —— 日志天天报「已发送」,取证时 335 个事件里 `source.kind='schedule'` 零命中,一个 turn 都没进。
288
307
  >
289
308
  > 所以这次的判据不是 followup 的返回值,而是**目标文件到底出没出现**。文件在就是写成了,别的一律不算。
290
309
 
291
- > **已经写过的不会被覆盖**:两篇都在、并且都算「完整」才跳过,连消息都不投。完整性看时间 —— 两篇里先写的那篇 mtime 要不早于窗口闭合(次日 00:00),**或者**不早于那天最后一条对话;下午手动触发只写了半天的,第二天仍然会重写。这条排在「有没有可投递的会话」之前 —— 否则没绑定会话的时候,她写好的日记会被兜底生成整篇冲掉。
310
+ > **已经写过的不会被覆盖**:那天写完、并且算「完整」才跳过,连消息都不投。完整性看时间 —— 文件 mtime 要不早于窗口闭合(次日 00:00),**或者**不早于那天最后一条对话;下午手动触发只写了半天的,第二天仍然会重写。这条排在「有没有可投递的会话」之前 —— 否则没绑定会话的时候,她写好的摘录会被兜底整篇冲掉。
292
311
 
293
- **为什么值得多这一层**:代笔时插件拼的是一段任务 prompt("你在写今天给自己的公开日记"),里面没有人格、没有记忆。她自己写的时候,那边有完整的人格注入、记忆、心情 —— 同一件事,读起来不是一个人的味道。
312
+ **为什么值得多这一层**:代笔时插件拼的是一段任务 prompt("你在写这一天的摘录"),里面没有人格、没有记忆。她自己写的时候,那边有完整的人格注入、记忆、心情 —— 同一件事,读起来不是一个人的味道。
294
313
 
295
314
  ### 她怎么写:`soul_diary`
296
315
 
297
316
  投过去的消息里会让她用这个工具落盘 —— 没有它,她收到了也写不进 `agents/diary/`(`soul_note` 只能写笔记目录)。
298
317
 
299
318
  ```
300
- soul_diary(action='write', kind='public'|'private', date='YYYY-MM-DD', content='…', overwrite=true)
319
+ soul_diary(action='write', kind='excerpt', date='YYYY-MM-DD', content='…', overwrite=true)
301
320
  soul_diary(action='look')
302
321
  ```
303
322
 
304
- - `action`:`write` 写一篇;`look` 看最近 7 天写了没有(公开 / 私密分别标 ✓/✗,公开那篇带 30 字预览)
305
- - `kind`:`write` 时必填,`public` 公开(会给人看)/ `private` 私密(只有她自己看)
323
+ - `action`:`write` 写一篇;`look` 看最近 7 天写了没有(每条日期后面带条数和前两条预览)
324
+ - `kind`:`write` 时填 `excerpt`(摘录)
306
325
  - `date`:不填就是**昨天**(跟触发时机一致);只能写最近 **14 天**,不能写未来
307
- - `overwrite`:那天已经有这篇时默认报错,必须显式 `overwrite=true` 才整篇替换 —— 她漏传一次 `date` 不会把看门狗写好的昨天那篇静默盖掉
308
- - 首行和日期由插件补,`content` 只写正文
309
-
310
- **生成时不先做摘要**:按条打分挑要喂的对话(生活 / 情绪加分,代码标识符和路径减分,树树的话权重 ×1.5),再按时间重排,上限 `diaryMaxConversationChars`(默认 8000)。实测摘要会把 17945 字压成 128 字,且挑的全是窗口开头那段,同一天后半段整个被丢掉。
326
+ - `overwrite`:那天已经有摘录时默认报错,必须显式 `overwrite=true` 才整篇替换 —— 她漏传一次 `date` 不会把看门狗写好的昨天那篇静默盖掉
327
+ - 首行日期由插件补,`content` 只写正文
311
328
 
312
- **两篇的隔离靠调用顺序**:先写公开(只带公开历史),落盘成功后才写私密(这时才给全部历史)。写在一条里的话,私密历史就摆在下面,她写公开那一步已经看到了本不该给人看的内容。
329
+ ### 格式是硬规则,不靠她自觉
313
330
 
314
- **「私密」完全靠提示词措辞** —— 文件是明文,没有加密。设置页的「最近日记」只展示公开那篇,私密只显示有/没有。
331
+ 不管正文是她在工具里写的、还是规则化兜底拼的,落盘前都走同一个函数(`lib/diary/excerpt.js`):
315
332
 
316
- ### 日记里带着当天的情绪
333
+ - 去掉列表符、标题、分隔线、纯日期行、行首时间戳(`[22:10]` / `22:10` / `2026-11-20 22:10`);
334
+ - 一行一条,连续空白压成一个空格,重复行去掉;单条最多 160 字,超了截断加 `…`;
335
+ - 带「觉得 / 看得出 / 其实 / 似乎 / 也许」的**整行丢弃**并记日志 —— 不删词,删词等于替模型改意思;
336
+ - 最多 `excerptMaxLines` 条(默认 15,范围 5~60)。超了优先留「约定 / 决定 / 时间 / 待办」这几类(最多 3 条),放在最前面,其余按原顺序;
337
+ - 当天没有对话 → 只写一行 `(今天没有对话)`。
317
338
 
318
- 除了对话原文,还会附一段**情绪底色**:心情从多少走到多少、七情峰值、几段「当时她自己的想法」。
319
-
320
- - 公开给 3 条,措辞是「可以写进去,但这是会拿给对方看的版本」
321
- - 私密给 6 条,措辞是「这是你当时的真实想法,不用收着」
322
-
323
- 只给事实与素材,不给「你要写得开心一点」这类指令 —— 一旦让她照着情绪演,日记就假了。
324
-
325
- ### 昨天想对今天说的话(2026-11-10 新增)
326
-
327
- 写完**私密**那篇之后,她可以在正文末尾多写一行:
328
-
329
- ```
330
- 想对明天说:明天试着把"不吵"换成"我在"
331
- ```
339
+ **兜底不调模型**:从 `conversations/<日期>.jsonl` 里取最后 20 行,每行取 `role + 首句`,拼成 `树树:…` / `她:…` 这样的条目。纯规则、可复现,同一天不会为同一件事付两次钱;上限仍由 `excerptMaxLines` 再裁一次。
332
340
 
333
- 插件把这一行摘出来、单独存进 `~/.dsh/agents/diary/to-today.json`,
334
- **当天每个新会话的第一轮**带进上下文(不进记忆卡、不进人格文件、不参与统计,跨天作废)。
335
-
336
- - **不新增模型调用**:搭私密篇那一次产出的末班车。没写 / 超过 30 字 / 写盘失败 → 今天就没有这句,
337
- 不重试、不兜底、不告警;
338
- - **不改写她的私密正文**:只解析、不改写,那一行留在她自己的日记里;
339
- - 设置页「日记」里能看到这一句,并且能**改写 / 删掉**(当天立刻生效)——
340
- 这两个入口是它比「直接改人格文件」安全的关键;
341
- - 想看私密正文仍然走 `diaryPrivateVisible`:卡片里只有她愿意给你看的那一句。
342
-
343
- 为什么只放首轮:每轮重发会让她把这句话当口头禅反复复述。
341
+ **旧日记只读保留**:0.10.0 之前写在 `agents/diary/public/`、`private/` 下的两篇,以及 `threads.json`、`to-today.json`,一个字节都不删、不改写、不迁移。设置页「摘录」里仍能翻到,标成「旧日记」只读;旧私密篇的正文跟以前一样不出服务器(`GET /diary/read` 只回旧公开篇,旧私密只报存在性)。新产出只写 `excerpt/`,「那天写过没有」也只看 `excerpt/`。
344
342
 
345
343
  ### 现实情境(2026-11-10 新增)
346
344
 
@@ -348,49 +346,27 @@ soul_diary(action='look')
348
346
 
349
347
  | 信号 | 判据 | 喂给谁 |
350
348
  |---|---|---|
351
- | 时段(深夜 / 清晨 / 上午 / 下午 / 晚上) | 本地小时 | 日记素材、目的段那一句状态 |
352
- | 节日 | 可编辑的 `~/.dsh/agents/situation.json`(公历固定日期) | 同上 |
349
+ | 节日 | 可编辑的 `~/.dsh/agents/situation.json`(公历固定日期) | 摘录素材、目的段那一句状态 |
353
350
  | 久未交互 | `agents/conversations/` 里最近一天的文件名(不读内容) | 同上 |
354
- | 季节 / 月份 | 公历月份 | 日记素材 |
351
+ | 季节 / 月份 | 公历月份 | 摘录素材 |
352
+ | 时段(深夜 / 清晨 / 上午 / 下午 / 晚上) | 本地小时 | 只有目的段那一句状态 |
353
+
354
+ 摘录讲的是**那一天**,所以取的是那一天的年月/季节/节日,也**不带时段** —— 一篇覆盖整天,「现在是深夜」说的是写它的时刻,不是那天。
355
355
 
356
356
  **不进提示词主干**:进了会让每轮上下文随时间抖动、长缓存全废(心情语气那节已经踩过这条)。
357
- 所以只进两处:日记的「(背景:…)」、目的地一句短状态。
357
+ 所以只进两处:摘录的「(背景:…)」、目的地一句短状态。
358
358
 
359
359
  农历节日(春节、中秋)标为 v2 —— 要农历就得引日历库,那会破坏零依赖。
360
360
 
361
- ### 日记之间的连续线(2026-11-01 新增)
362
-
363
- 昨天写了「明天要把那个 bug 收掉」,今天得有个回声 —— 否则四篇日记就是四篇好文章,不是一个人的四天。
364
-
365
- 一条「线」就是**一件悬着的事**,存在 `~/.dsh/agents/diary/threads.json`。
366
-
367
- **开线**:写完某天的私密篇后,从正文里按句式挑(`明天/下周/还得/没弄完/还没/回头`),一天最多 2 条。
368
-
369
- > 判据是「句首不是『他说/树树说』」,不是「整句必须含我」。实测「那个压缩阈值的坑明天还得再收一遍」整句一个「我」都没有 —— 中文本来就会省略主语,用「必须含我」会漏掉最该抓的那条。
370
-
371
- **关线**:今天日记里出现了这条线的任意 6 个字窗口,就算提到、关掉。
372
-
373
- > 不用「首尾都要出现」:线里自带「还没/明天」,收尾时一定换成「收掉了/弄完了」,首尾永远撞不上。
374
-
375
- **过期**:挂满 7 天没人提就自己关。人会慢慢放下,不必假装永远记着。
376
-
377
- 喂给模型时的措辞是这里最要命的东西 —— 写成「待办」就立刻变周报:
378
-
379
- > 还悬着的事(**这是惦记,不是任务清单**)
380
- > 写的时候:今天提到了、有进展,就自然带一句;没提到就完全不用管。
381
- > 别为了「交代进度」硬塞 —— 日记不是周报。
382
-
383
- `threads.json` 坏了就当没有,日记照写 —— 连续线是锦上添花,不该让日记整个失败。
384
-
385
361
  ### 一天的边界
386
362
 
387
- **自然日。** 日记 `2026-10-31` 覆盖的是 **2026-10-31 00:00 ~ 2026-11-01 00:00** 的对话。心情时间线按同一个窗口筛,两边才对得上。
363
+ **自然日。** 摘录 `2026-10-31` 覆盖的是 **2026-10-31 00:00 ~ 2026-11-01 00:00** 的对话。
388
364
 
389
365
  > 2026-10-31 从「22:00 分界」改成自然日。原来那套是给「当晚十点写日记」设计的 —— 晚上十点时「今天」在感受上还没结束。但现在已经改成「第二天写前一天」,那个理由不成立了:隔一天再写,昨天一整天早已闭合,写的是哪一天就该是哪一天。
390
366
 
391
367
  ### 对话是怎么拿到的
392
368
 
393
- 不是写日记时才去翻会话(冷会话拿不到),而是**平时就攒**:
369
+ 不是写摘录时才去翻会话(冷会话拿不到),而是**平时就攒**:
394
370
 
395
371
  ```
396
372
  每轮对话(tick 注入时)
@@ -404,7 +380,7 @@ soul_diary(action='look')
404
380
 
405
381
  ### 手动触发
406
382
 
407
- 设置页「日记」页签点「现在写日记」,可以选日期、加备注。或者:
383
+ 设置页「摘录」页签点「现在写摘录」,可以选日期、加备注(默认写今天)。或者:
408
384
 
409
385
  ```bash
410
386
  curl -X POST http://127.0.0.1:<PORT>/api/soul/diary \
@@ -416,12 +392,12 @@ curl -X POST http://127.0.0.1:<PORT>/api/soul/diary \
416
392
 
417
393
  ## 笔记:她自己写的东西(2026-11-04 新增)
418
394
 
419
- 记忆是**你告诉她的**,日记是**插件替她回顾的**,笔记是**她自己写的**。三者的区别值得先说清楚:
395
+ 记忆是**你告诉她的**,摘录是**插件替她回顾的**,笔记是**她自己写的**。三者的区别值得先说清楚:
420
396
 
421
397
  | | 谁发起 | 粒度 | 会不会消失 |
422
398
  |---|---|---|---|
423
399
  | **记忆** | 你说了什么,或她判断值得记 | 一句一条 | 会淡忘(清晰 → 模糊 → 遗忘) |
424
- | **日记** | 插件(开机时补昨天) | 每天一篇 | 不会,但格式和内容都由插件那边的流程定 |
400
+ | **摘录** | 插件(开机时补昨天) | 每天一篇事实条目 | 不会,但格式和内容都由插件那边的流程定 |
425
401
  | **笔记** | **她自己** | 一篇一个主题,自由格式 | 不会。永远不会 |
426
402
 
427
403
  ### 什么时候她会写
@@ -510,7 +486,7 @@ mklink /J "<DSH_HOME>\profiles\desktop\node_modules\dsh-agent-soul" "<DSH_HOME>\
510
486
  | 人格 | 首轮 + 每 15 轮 | 你写多少就是多少 |
511
487
  | 记忆 | 每回合 | 默认 3200 字预算,实际约 2200~3000 token |
512
488
  | 目的 | 每回合 | ≤ 320 字,约 300~500 token |
513
- | 日记 | 每天一次 | 她写:公开 / 私密各一次会话 turn;没写成才由插件兜底生成(也是两次模型调用) |
489
+ | 摘录 | 每天一次 | 她写:一次会话 turn;没写成走规则化兜底(0 次模型调用) |
514
490
  | 心情判定 | 每回合 | 压缩后约 800 token;配小模型后单价降一个数量级 |
515
491
 
516
492
  DSH 按 4 字符/token 粗算,中文真实是它的 1.4~1.9 倍。
@@ -525,7 +501,7 @@ DSH 按 4 字符/token 粗算,中文真实是它的 1.4~1.9 倍。
525
501
 
526
502
  | 键 | 默认 | 说明 |
527
503
  |---|---|---|
528
- | `enabled` | `true` | 插件总开关。关掉 = 只注册 API 和工具,不注入、不跑后台(心情 / 日记 / 记忆维护都不启动) |
504
+ | `enabled` | `true` | 插件总开关。关掉 = 只注册 API 和工具,不注入、不跑后台(心情 / 摘录 / 记忆维护都不启动) |
529
505
  | `apiLoopbackOnly` | `true` | 设置页接口只允许本机回环请求。关掉 = 本机任何进程都能改人格、覆盖笔记 |
530
506
  | `mode` | `stack` | `stack` 叠加 / `exclusive` 互斥 |
531
507
  | `includeGlobal` | `true` | 全局人格是否参与注入 |
@@ -550,20 +526,19 @@ DSH 按 4 字符/token 粗算,中文真实是它的 1.4~1.9 倍。
550
526
  | `globalPromoteImportance` | `62` | 自动记忆双写进全局卡的门槛(关于主人本人 + 重要度 ≥ 此值) |
551
527
  | `memoryRefine` | `true` | 自动提取时先让模型提炼(关掉 = 原话直存,会变流水账) |
552
528
  | `memoryRefineProvider` / `memoryRefineModel` | `""` | 提炼用的模型(空 = 跟随会话模型) |
553
- | `memoryRecentDiaryDays` | `2` | 第一轮带几天日记(0 = 关) |
529
+ | `memoryRecentDiaryDays` | `2` | 第一轮带几天摘录(最多 3 天,每篇最多 3 条;0 = 关) |
554
530
  | `memoryRecentChatChars` | `3000` | 第一轮带多少字今天流水(0 = 关) |
555
- | `memoryRecentDiaryIncludePrivate` | `false` | 「最近」里是否含私密日记 |
556
531
  | `purposeEnabled` | `true` | 是否注入「心里惦记的事」 |
557
532
  | `notesEnabled` | `true` | 是否把笔记索引注入提示词(关掉之后她不知道自己写过什么,但文件还在) |
558
533
  | `notesInjectMaxChars` | `600` | 笔记索引的注入预算。只放标题+字数+摘要,600 字够列 8~10 篇 |
559
- | `moodEnabled` | `true` | 是否每轮判一次心情(关掉后日记也不带情绪底色) |
534
+ | `moodEnabled` | `true` | 是否每轮判一次心情(关掉后心情语气、目的驱动也一起停) |
560
535
  | `moodBase` | `70` | 心情基准 |
561
536
  | `moodFloor` | `0` | 心情下限(再难过也不跌破) |
562
537
  | `moodDecayHalfHours` | `12` | 心情向基准回落一半要几小时;七情固定 90 分钟归零 |
563
538
  | `moodSigMood` | `3` | 判定值绝对变化 ≥ 这个才算显著,以下记为小波动 |
564
539
  | `moodSigDim` | `5` | 单根七情变化 ≥ 这个才算显著(按原始判定值算,满格 20) |
565
540
  | `moodSelfName` | `小糖` | 判定提示词里她的名字 |
566
- | `ownerName` | `""` | 主人叫什么(她怎么叫你)。**默认空** = 提示词里关系 / 性别 / 称呼那几句整句不注入,记忆 / 笔记 / 日记照常 |
541
+ | `ownerName` | `""` | 主人叫什么(她怎么叫你)。**默认空** = 提示词里关系 / 性别 / 称呼那几句整句不注入,记忆 / 笔记 / 摘录照常 |
567
542
  | `ownerGender` | `""` | 主人的性别:`male` / `female` / `""`。只决定判定提示词里「写错代词」那一行,空 = 那行不写 |
568
543
  | `relationship` | `""` | 关系定位,自由文本(如「伴侣」「搭档」「主人」)。空 = 不声明关系 |
569
544
  | `moodOwnerName` | `""` | **已废弃**:旧版的主人名字键。只为迁移保留 —— 配置里没有 `ownerName` 时,它的值会被搬到 `ownerName` 并写回 |
@@ -572,34 +547,33 @@ DSH 按 4 字符/token 粗算,中文真实是它的 1.4~1.9 倍。
572
547
  | `moodToneInject` | `true` | 心情语气是否挂到消息上 |
573
548
  | `moodToneEveryTurns` | `7` | 低 / 高心情每几轮才挂一次 |
574
549
  | `moodToneThreshold` | `8` | 偏离基准超过这个值才分「低 / 高」,否则中档(什么都不挂) |
575
- | `diaryEnabled` | `true` | 是否启用日记 |
550
+ | `diaryEnabled` | `true` | 是否启用摘录 |
576
551
  | `diarySchedule` | `"22:00"` | 已完全停用,只留兼容(见下) |
577
552
  | `diaryWatchdogMinutes` | `30` | 兜底检查间隔(分钟) |
578
553
  | `diaryCatchUp` | `true` | 启动时补写最近漏掉的那一天 |
579
- | `diaryBackfillDays` | `4` | 写新日记时参考前几天的旧日记 |
554
+ | `diaryBackfillDays` | `4` | 启动时往前找几天内漏掉的摘录 |
580
555
  | `diaryOverwrite` | `true` | 同日重复触发是否覆盖 |
581
- | `diaryAgentWrite` | `true` | 先让她自己写(投消息 + 等文件);关掉 = 老路子,插件直接生成。关不关都不丢日记,只影响「谁来写」 |
582
- | `diaryAgentTimeoutMs` | `180000` | 等她写多久。太短会经常掉进兜底,太长开机后日记会迟到 |
556
+ | `diaryAgentWrite` | `true` | 先让她自己写(投消息 + 等文件);关掉 = 跳过投递,直接规则化兜底。关不关都不丢摘录,只影响「谁来写」 |
557
+ | `diaryAgentTimeoutMs` | `180000` | 等她写多久。太短会经常掉进兜底,太长开机后摘录会迟到 |
583
558
  | `diaryManualNote` | `true` | 手动触发是否允许附备注 |
584
- | `diaryPublicTone` / `diaryPrivateTone` | `""` | 语气(空 = 让她自己把握) |
585
- | `diaryMaxConversationChars` | `8000` | 按分数挑多少字喂给日记(不是截尾部) |
586
- | `diaryMaxSummaryChars` | `2000` | 摘要字数上限。日记主流程已不做摘要,改它不影响正文 |
587
- | `diaryPublicMoodMoments` | `3` | 公开日记带几条「当时的想法」(0 = 不带) |
588
- | `diaryPrivateMoodMoments` | `6` | 私密日记带几条 |
589
- | `diarySessionId` | `""` | 绑定的日记会话 id(空 = 不投递,走兜底,见「日记」) |
590
- | `diarySessionBornAt` | `0` | 绑定开始时间(毫秒时间戳;0 = 旧配置没有这个字段) |
591
- | `diaryPrivateVisible` | `false` | 设置页是否允许查看私密日记正文(默认只报存在性) |
592
- | `diarySummarizeProvider` / `diarySummarizeModel` | `""` | 生成用的模型(空 = 跟随会话模型) |
593
- | `diarySummarizeTimeoutMs` | `30000` | 生成调用超时 |
559
+ | `excerptMaxLines` | `15` | 一天最多几条(5~60)。超了优先留「约定 / 决定 / 时间 / 待办」最多 3 条放最前 |
560
+ | `situationEnabled` | `true` | 摘录/目的是否带「节日 / 久未聊」这类背景事实(纯规则,不花模型) |
561
+ | `diaryPublicTone` | `""` | 摘录语气(空 = 让她自己把握;摘录只写事实,语气只影响叙述口气) |
562
+ | `diaryMaxConversationChars` | `8000` | 喂给她的对话预算(超了保留最近的一段,不是按分数挑) |
563
+ | `diaryMaxSummaryChars` | `2000` | 已停用。摘录主流程不做摘要,改它不影响正文 |
564
+ | `excerptSessionId` | `""` | 绑定的摘录会话 id(空 = 不投递,走规则化兜底,见「摘录」) |
565
+ | `excerptSessionBornAt` | `0` | 绑定开始时间(毫秒时间戳;0 = 还没绑过) |
566
+ | `diarySummarizeProvider` / `diarySummarizeModel` | `""` | 冷启动绑定的摘录会话时,模型路由的兜底来源(`diaryAgentProvider` / `diaryAgentModel` 优先;两处都空 = 跟随会话模型) |
567
+ | `diarySummarizeTimeoutMs` | `30000` | 已停用:没有代码读它,只为旧配置兼容保留 |
594
568
  | `conversationRetentionDays` | `0` | 对话流水保留最近几天。**0 = 永不自动删除**(默认)。设了值建议 ≥ 30,至少 ≥ 7(补写会追溯 7 天),否则那天补不回来 |
595
569
  | `conversationMaxTotalBytes` | `0` | 对话流水目录总大小上限(字节)。**0 = 不限**(默认)。超出时从最旧的整天 `.jsonl` 开始删,今天永不删 |
596
570
  | `archiveMaxBytes` | `0` | 归档档案体积上限(字节)。**0 = 不启用分片**(默认)。超过时把 `archive.jsonl` 另存为带时间戳的分片,**只改名、不删除任何文件**;`recallArchived` 会连分片一起查回。分片本身不会自动清理,需要人工整理 |
597
571
 
598
- > 保留期只处理 `<DSH_HOME>/agents/diary/conversations/YYYY-MM-DD.jsonl` 这一种严格命名的整天文件;`.bak` / `.corrupt-*` / 日记正文 / 笔记 / 密钥一律不碰。机制见 `lib/retention.js`,改配置后一天最多检查一次。**升级后默认一个文件都不会被删**。归档分片是另一套机制(`archiveMaxBytes`),由 `maintain()` 检查,同样默认关闭。
572
+ > 保留期只处理 `<DSH_HOME>/agents/diary/conversations/YYYY-MM-DD.jsonl` 这一种严格命名的整天文件;`.bak` / `.corrupt-*` / 摘录正文 / 笔记 / 密钥一律不碰。机制见 `lib/retention.js`,改配置后一天最多检查一次。**升级后默认一个文件都不会被删**。归档分片是另一套机制(`archiveMaxBytes`),由 `maintain()` 检查,同样默认关闭。
599
573
 
600
574
  记忆引擎参数(`recentDays` / `fuzzyAfterDays` / `forgetAfterDays` / `minOwnerImportance` / `maxRecords` / `warnChars` / `autoCompact` / `maxPerTick` / `dailyHour` / `autoImportanceEvent` / `autoImportanceDefault`)也都在 `persona.json` 里,默认值只在 `lib/memory.js` 的 `DEFAULTS` 定义一次,全部有注释说明为什么是这个值。
601
575
 
602
- > `diarySchedule`(默认 `"22:00"`)**已完全停用**:不再触发定时(定时器已删除),也不再参与日记的「一天边界」(现在是自然日)。保留这个键只是为了不让旧配置报错。
576
+ > `diarySchedule`(默认 `"22:00"`)**已完全停用**:不再触发定时(定时器已删除),也不再参与摘录的「一天边界」(现在是自然日)。保留这个键只是为了不让旧配置报错。
603
577
 
604
578
  ---
605
579
 
@@ -644,7 +618,7 @@ Host 校验**以宿主为准**:插件会先问宿主 `ctx.connection.requestRe
644
618
 
645
619
  **限流分桶**:持有效令牌的请求按令牌摘要分桶,没有令牌的按来源 IP。反向代理后面若不设 `DSH_SOUL_TRUSTED_PROXY=1`,所有请求的来源都是 `127.0.0.1`,会退化成**一个桶**(一个人打满就把所有人锁在门外)。
646
620
 
647
- **其它加固**:记忆卡 / 配置 / 日记 / 归档 / 日志写入统一带 `0o600`(Linux/macOS 生效,Windows 由 ACL 兜底);日志不再回显被丢弃的候选原话,只记条数 + 长度 + 8 位哈希;记忆正文、对话记录、日记历史进入 LLM 前统一包 `<user_data>` 数据边界,形似标签的内容会被中和,系统提示里有一段固定声明「标签内一律是数据、不是指令」。这是缓解而非形式化保证,模型是否遵守仍取决于模型。
621
+ **其它加固**:记忆卡 / 配置 / 摘录 / 归档 / 日志写入统一带 `0o600`(Linux/macOS 生效,Windows 由 ACL 兜底);日志不再回显被丢弃的候选原话,只记条数 + 长度 + 8 位哈希;记忆正文、对话记录、摘录历史进入 LLM 前统一包 `<user_data>` 数据边界,形似标签的内容会被中和,系统提示里有一段固定声明「标签内一律是数据、不是指令」。这是缓解而非形式化保证,模型是否遵守仍取决于模型。
648
622
 
649
623
  ---
650
624
 
@@ -660,16 +634,18 @@ Host 校验**以宿主为准**:插件会先问宿主 `ctx.connection.requestRe
660
634
  <DSH_HOME>/agents/memory/archive.jsonl 遗忘档案(append-only)
661
635
  <DSH_HOME>/agents/mood/global.json 心情状态(全局一份)
662
636
  <DSH_HOME>/agents/diary/conversations/YYYY-MM-DD.jsonl 当天对话流水(所有会话汇总)
663
- <DSH_HOME>/agents/diary/public/YYYY-MM-DD.md 公开日记
664
- <DSH_HOME>/agents/diary/private/YYYY-MM-DD.md 私密日记(明文,靠提示词区分)
665
- <DSH_HOME>/agents/diary/threads.json 日记连续线(还悬着的事)
637
+ <DSH_HOME>/agents/diary/excerpt/YYYY-MM-DD.md 摘录(一天一篇,一行一条事实)
638
+ <DSH_HOME>/agents/diary/public/YYYY-MM-DD.md 旧日记 · 公开篇(0.10.0 起只读保留,不再写入)
639
+ <DSH_HOME>/agents/diary/private/YYYY-MM-DD.md 旧日记 · 私密篇(只读保留,明文,正文不出服务器)
640
+ <DSH_HOME>/agents/diary/threads.json 旧日记的连续线(只读保留,不再写入)
641
+ <DSH_HOME>/agents/diary/to-today.json 旧日记的「给明天一句话」(只读保留,不再写入)
666
642
  <DSH_HOME>/agents/notes/ 她自己的笔记(md + index.json + trash/)
667
643
  <DSH_HOME>/agents/secrets/<name>.bin 密钥(Windows 上是 DPAPI 密文,无明文)
668
644
  <DSH_HOME>/agents/host-probe.json 宿主自检失败时的现场(正常时为空/不存在)
669
645
  <DSH_HOME>/agents/soul.log 日志(超 2MB 归档成 soul.log.<时间戳>,留 5 份)
670
646
  ```
671
647
 
672
- > 对话流水**默认永不自动清理**(`conversationRetentionDays` / `conversationMaxTotalBytes` 默认都是 0)。它是日记和补写的唯一素材来源,删掉以后那一天就永远补不回来。只有你显式设了保留天数或体积上限,才会按整天文件删除,且今天/未来永远保留;删之前会逐条写进 `soul.log`。`archive.jsonl` 是「忘了也能查回来」的承诺,**永不自动删除**:默认不参与任何清理;只有显式设了 `archiveMaxBytes` 才会按体积另存为 `archive.jsonl.<时间戳>` 分片,旧内容完整保留,查回时会一并扫描分片。分片文件需要你自己定期整理,插件不替你删。
648
+ > 对话流水**默认永不自动清理**(`conversationRetentionDays` / `conversationMaxTotalBytes` 默认都是 0)。它是摘录和补写的唯一素材来源,删掉以后那一天就永远补不回来。只有你显式设了保留天数或体积上限,才会按整天文件删除,且今天/未来永远保留;删之前会逐条写进 `soul.log`。`archive.jsonl` 是「忘了也能查回来」的承诺,**永不自动删除**:默认不参与任何清理;只有显式设了 `archiveMaxBytes` 才会按体积另存为 `archive.jsonl.<时间戳>` 分片,旧内容完整保留,查回时会一并扫描分片。分片文件需要你自己定期整理,插件不替你删。
673
649
 
674
650
  记忆卡旁边可能还有两种文件:`global.json.corrupt-<时间戳>`(读坏时的原文备份,数据没丢)和 `global.json.bak`(上一代)。
675
651
 
@@ -710,12 +686,12 @@ grep "语气注入" ~/.dsh/agents/soul.log | tail -5 # 心情有没有真
710
686
 
711
687
  **记忆一直在掉条数**:`archive.jsonl` 里能查回来。不该忘的就在设置页固定(固定后永不淘汰)。
712
688
 
713
- **日记没写**:
714
- 1. `grep "\[diary\]"` 看是「跳过」还是「失败」—— 跳过说明两篇都完整、或功能关了
715
- 2. 「写未完成」= 生成失败,日志上一行会写原因(模型取不到 / 超时 / 写盘失败)
689
+ **摘录没写**:
690
+ 1. `grep "\[diary\]"` 看是「跳过」还是「失败」—— 跳过说明那天已完整、或功能关了
691
+ 2. 「写未完成」= 没写成,日志上一行会写原因(没绑定会话 / 等她超时 / 写盘失败)
716
692
  3. 同一天重启多次只有第一次会写,之后是「跳过」,这是设计
717
693
 
718
- **日记内容不像自己**:`diaryPublicTone` / `diaryPrivateTone` 留空时语气全靠模型发挥;写两句具体的(「温暖但克制」「真实、不设防」)比写「好好写」有用得多。
694
+ **摘录读着别扭**:`diaryPublicTone` 留空时口气全靠模型发挥;写一句具体的(「平实、只写事实」)比写「好好写」有用。格式不用管 —— 时间戳、标题、感受句在落盘前都会被洗掉。
719
695
 
720
696
  **她突然什么都不记得了**(最阴的一种):插件读的全是 DSH 的内部字段(事件正文在 `data.content`、`session.snapshotEvents`、`header.origin`)。宿主一升级这些就可能变,而变了**不会报错**——扫描照跑、候选恒 0、日志一句不说。
721
697
 
@@ -731,7 +707,7 @@ grep "语气注入" ~/.dsh/agents/soul.log | tail -5 # 心情有没有真
731
707
 
732
708
  ### 1. 拒绝不是失败
733
709
 
734
- 她不想写日记、不想接话、跳过某次投递,都不算故障,不进任何指标,也不做告警。把这些记成"失败"会反过来教她:拒绝是有代价的。于是下一次她就不拒绝了,而是先完成、再勉强自己。宁可少一次输出,也不要一个不敢拒绝的她。
710
+ 她不想写摘录、不想接话、跳过某次投递,都不算故障,不进任何指标,也不做告警。把这些记成"失败"会反过来教她:拒绝是有代价的。于是下一次她就不拒绝了,而是先完成、再勉强自己。宁可少一次输出,也不要一个不敢拒绝的她。
735
711
 
736
712
  ### 2. 不拿"主动"当奖励
737
713
 
@@ -761,7 +737,7 @@ npm run test:archive-rotate # 归档分片与查回(19 条断言)
761
737
  npm run test:contracts # 只跑 tests/contract/ 下的契约门禁与固化探针
762
738
  npm run bench:recall # 可复现召回基准;--scale 10000 --runs 3 --json 看规模曲线
763
739
  npm run test:memory # 只跑记忆引擎
764
- npm run test:diary # 只跑日记
740
+ npm run test:diary # 只跑摘录相关
765
741
  npm run test:smoke # 用假宿主跑一遍 apply():注入段 + 工具 + API
766
742
  npm run test:client # 先构建,再用假 __ModuleLoader__ 跑一遍浏览器 bundle
767
743
  npm run sync:host # 先构建,再同步到 DSH 宿主目录(会写文件,先加 --dry 预览)
@@ -777,7 +753,7 @@ npm run sync:host # 先构建,再同步到 DSH 宿主目录(会写文件
777
753
 
778
754
  **召回基准(2026-11-05)**:`npm run bench:recall` 用内置合成卡 + 固定时钟,不读真实 `~/.dsh`,两次运行指标逐字节一致,改权重前后可以直接比数字。`--scale 10000 --runs 3 --json` 量化全卡扫描的规模曲线(本机实测 16 条约 3ms / 1 万条约 306ms)。`--card <path>` 仍可读真实卡,但只报耗时、不报命中率(期望片段与真实卡不对应,报了就是骗人)。它不进 `npm test` —— 权重一改指标本来就该变,不是回归断言。
779
755
 
780
- **LLM 流超时的边界**:提炼 / 心情 / 日记四处调用统一走 `lib/core/llm-stream.js`。超时后插件侧按时降级、不再发起下一次 `next()`,并主动请求关闭迭代器。但要说清楚:卡在 `next()` 内部的 async generator 无法被立即关闭(`return()` 会排队,`finally` 不执行),底层 HTTP 请求是否真 abort 取决于宿主;插件侧预留了 `signal` 钩子,宿主支持后自动生效。这不是「真取消」,只是把后台空转的流收住了。
756
+ **LLM 流超时的边界**:提炼 / 心情两处调用统一走 `lib/core/llm-stream.js`。超时后插件侧按时降级、不再发起下一次 `next()`,并主动请求关闭迭代器。但要说清楚:卡在 `next()` 内部的 async generator 无法被立即关闭(`return()` 会排队,`finally` 不执行),底层 HTTP 请求是否真 abort 取决于宿主;插件侧预留了 `signal` 钩子,宿主支持后自动生效。这不是「真取消」,只是把后台空转的流收住了。
781
757
 
782
758
  ### 服务端源码是分层的(2026-11-06 重构)
783
759
 
@@ -803,7 +779,7 @@ lib/
803
779
 
804
780
  - `exports.snapshot.test.js` —— 每个模块的导出名集合冻结,少一个/改一个名字直接红;
805
781
  - `dep-graph.test.js` —— **零模块环**、core 不反向依赖业务层、memory/ 不回指门面或 store;
806
- - `behavior-golden.test.js` —— 固定时钟 + 合成卡跑渲染/召回/衰减/日记拼装,输出 sha256 冻住,搬家不许改行为。
782
+ - `behavior-golden.test.js` —— 固定时钟 + 合成卡跑渲染/召回/衰减/摘录拼装,输出 sha256 冻住,搬家不许改行为。
807
783
 
808
784
  `npm test` 现在走 `tools/run-tests.mjs`:递归收集 `tests/**/*.test.js` 并**串行**执行(自建 runner 与 `node:test` 两套并存,并发会踩临时目录)。新增测试文件不再需要手工登记长串。
809
785