dsh-agent-soul 0.9.10 → 0.9.12
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 +60 -0
- package/docs/HANDOFF.md +28 -30
- package/docs/KNOWN-ISSUES.md +40 -15
- package/lib/diary/agent.js +166 -0
- package/lib/diary/compose.js +8 -435
- package/lib/diary/deliver.js +147 -0
- package/lib/diary/history.js +84 -0
- package/lib/diary/llm.js +246 -0
- package/lib/diary/scheduler.js +6 -231
- package/lib/diary.js +48 -45
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -7,6 +7,66 @@
|
|
|
7
7
|
|
|
8
8
|
---
|
|
9
9
|
|
|
10
|
+
## 0.9.12 · 2026-11-10
|
|
11
|
+
|
|
12
|
+
外部复检轮 **R17(最后一个大文件)**,2 个提交 / 8 文件 / +353 −241。**对外行为零变化**:
|
|
13
|
+
89 测试 / 11 契约 / lint / bundle 零 diff 全绿;四个搬迁函数的**函数体在旧新位置逐字一致**。
|
|
14
|
+
|
|
15
|
+
### 重构
|
|
16
|
+
|
|
17
|
+
- **`diary/scheduler.js`(779 行五职责)拆分**(#26):
|
|
18
|
+
- `diary/deliver.js`(新)—— 投递与回执判定:`shouldAskAgain` / `askAgentToWrite` / `mtimeMsOf`
|
|
19
|
+
- `diary/agent.js` —— `diaryAgent` 并入(与 R16 移进来的 `composeDiarySetup` 同属「会话获取 / 冷启动」)
|
|
20
|
+
- `diary/scheduler.js` —— 只留定时器 / 双层锁 / 主流程 / `regenerateDiary` / `runCatchUp`(779 → 551 行)
|
|
21
|
+
- 函数体由脚本按段落切分,**逐字未改**;`askAgentToWrite` 因跨模块调用由私有改导出(已披露)。
|
|
22
|
+
- `lib/diary.js` 门面导出名集合(29 个)不变,`diaryAgent` 改从 `agent.js` re-export。
|
|
23
|
+
|
|
24
|
+
### 测试
|
|
25
|
+
|
|
26
|
+
- 新增 `tests/r17-deliver-feature.test.js`(11 断言),**先于拆分提交**且在旧代码上全绿:
|
|
27
|
+
补上了 `shouldAskAgain` 这块**零直接覆盖**的判定矩阵(force / 不存在 / since=0 老行为 /
|
|
28
|
+
旧文件重写 / 新文件不重问 / mtime 被拨老),以及 `since` 语义的端到端验证 ——
|
|
29
|
+
那就是 P1-D3「看门狗每 30 分钟空转、日志却写『日记完成』」那条事故的判据。
|
|
30
|
+
- 既有 `tests/r05-diary-state.test.js` 只改了 import 路径与调用点,**断言一字未动**(已逐行核对)。
|
|
31
|
+
|
|
32
|
+
### 变更
|
|
33
|
+
|
|
34
|
+
- 契约快照走正规通道:`deliver.js` 新增 `askAgentToWrite` / `shouldAskAgain`,
|
|
35
|
+
`agent.js` +`diaryAgent`,`scheduler.js` −2。理由已记入 `SNAPSHOT_CHANGES.md`
|
|
36
|
+
(其中「R16 #26」是交付方的笔误,发布时更正为 R17)。
|
|
37
|
+
- **至此 `docs/KNOWN-ISSUES.md` 只剩 #23**(错误边界需宿主暴露 `React.Component`)。
|
|
38
|
+
|
|
39
|
+
---
|
|
40
|
+
|
|
41
|
+
## 0.9.11 · 2026-11-10
|
|
42
|
+
|
|
43
|
+
外部复检轮 **R16(重构轮)**,2 个提交 / 9 文件 / +583 −443。**对外行为零变化**:
|
|
44
|
+
88 测试 / 11 契约 / lint / bundle 零 diff 全绿;复核时逐个函数比对,**10 个函数体在新旧位置逐字一致**。
|
|
45
|
+
|
|
46
|
+
### 重构
|
|
47
|
+
|
|
48
|
+
- **`diary/compose.js`(644 行四职责)按职责切四块**(#27):
|
|
49
|
+
- `diary/llm.js` —— `describeFinishReason` / `summarizeConversations` / `composeDiaryText`(246 行)
|
|
50
|
+
- `diary/history.js` —— `readRecentDiaries` / `digestDiaries`(84 行)
|
|
51
|
+
- `diary/agent.js` —— `composeDiarySetup`(76 行,**移正到 HANDOFF 建议的位置**:它全是宿主服务交互,与拼 prompt 无关)
|
|
52
|
+
- `diary/compose.js` —— 只剩 prompt 组装:`diaryWindowOf` / `buildMoodBlocks` / `composePublicMessage` / `composePrivateMessage`(217 行)
|
|
53
|
+
- 函数体由脚本按段落切分,**逐字未改**;事故注释随代码搬家;顺手删掉两段孤儿 docblock
|
|
54
|
+
(`diaryAgent` 的注释,函数本体 2026-11-06 已迁 `scheduler.js`,注释被遗留在 compose.js)。
|
|
55
|
+
- `lib/diary.js` 门面导出名集合(29 个)前后**完全一致**,只是改由 `llm` / `history` / `compose` 三处分发。
|
|
56
|
+
|
|
57
|
+
### 测试
|
|
58
|
+
|
|
59
|
+
- 新增 `tests/r16-compose-feature.test.js`(11 断言),**先于拆分提交**且在旧代码上全绿。
|
|
60
|
+
它补上了此前**零直接覆盖**的两个函数:`buildMoodBlocks` 与 `composeDiarySetup`
|
|
61
|
+
(后者含 2026-11-05 那次事故修的行为:会话不活跃时从落盘日志回读 preset)。
|
|
62
|
+
|
|
63
|
+
### 变更
|
|
64
|
+
|
|
65
|
+
- 契约快照走正规通道:新增 `diary/agent.js`、`diary/history.js`、`diary/llm.js` 三个模块,
|
|
66
|
+
`compose.js` 移出 5 个导出;理由已记入 `SNAPSHOT_CHANGES.md`。
|
|
67
|
+
|
|
68
|
+
---
|
|
69
|
+
|
|
10
70
|
## 0.9.10 · 2026-11-09
|
|
11
71
|
|
|
12
72
|
外部复检轮 **R15(重构轮)**,3 个提交 / 13 文件 / +451 −137。**对外行为零变化**,
|
package/docs/HANDOFF.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
# 交接文档 · dsh-agent-soul `0.9.
|
|
1
|
+
# 交接文档 · dsh-agent-soul `0.9.12`
|
|
2
2
|
|
|
3
3
|
> 给接手的人(或 AI)。读完这一份就能开工,不需要翻聊天记录。
|
|
4
|
-
> 写作时间:2026-11-08(0.9.
|
|
4
|
+
> 写作时间:2026-11-08(0.9.12 于 2026-11-10 更新)· tag `v0.9.12` · npm `latest = 0.9.12`
|
|
5
5
|
|
|
6
6
|
---
|
|
7
7
|
|
|
@@ -33,7 +33,7 @@
|
|
|
33
33
|
|
|
34
34
|
| 指标 | 数值 |
|
|
35
35
|
|---|---|
|
|
36
|
-
| 测试 | **
|
|
36
|
+
| 测试 | **89** 个测试文件 / 0 失败;契约 **11** / 0 |
|
|
37
37
|
| 代码量 | `lib/` 97 个文件 / ~19.9k 行 |
|
|
38
38
|
| 运行时依赖 | **零**(`dependencies` 为空,刻意如此) |
|
|
39
39
|
| 支持 | Node ≥ 22.19;CI 跑 Node 22 + 24 + Windows |
|
|
@@ -191,28 +191,23 @@ git switch -c fix/your-topic main # 从干净 main 拉
|
|
|
191
191
|
|
|
192
192
|
---
|
|
193
193
|
|
|
194
|
-
## 5. 当前遗留(
|
|
194
|
+
## 5. 当前遗留(1 条)
|
|
195
195
|
|
|
196
196
|
> 完整版在 [`docs/KNOWN-ISSUES.md`](KNOWN-ISSUES.md),每条带代码位置、影响、建议改法、验证程度(A 实测 / B 读代码 / C 仅归档)。
|
|
197
197
|
>
|
|
198
|
-
> **`0.9.
|
|
198
|
+
> **`0.9.12` 之后,功能类 / 清理类 / 重构类已知问题全部清零。** 只剩这一条,而且**做不了**。
|
|
199
199
|
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
| # | 问题 | 位置 | 建议 |
|
|
200
|
+
| # | 问题 | 位置 | 为什么现在做不了 |
|
|
203
201
|
|---|---|---|---|
|
|
204
|
-
| **23** | 「错误边界」接不住**渲染期**异常 → 白屏 | `lib/client/app.js` | 需要 `React.Component` 基类;本 bundle
|
|
205
|
-
|
|
206
|
-
### 大文件重构(2 条,有依赖顺序,别反过来)
|
|
207
|
-
|
|
208
|
-
| # | 问题 | 建议 |
|
|
209
|
-
|---|---|---|
|
|
210
|
-
| **27** | `diary/compose.js` 591 行四类职责,`composeDiarySetup` 放错位置 | 先把 `composeDiarySetup` 移回 `scheduler` 或新建 `diary/agent.js`,再按职责切四块 |
|
|
211
|
-
| **26** | `diary/scheduler.js` 687 行混五种职责 | 拆 `diary/agent.js` + `diary/deliver.js`。**必须最后做**:它依赖 #27 的产物 |
|
|
202
|
+
| **23** | 「错误边界」接不住**渲染期**异常 → 白屏 | `lib/client/app.js` | 需要 `React.Component` 基类;本 bundle 的作用域里只有 `h` 与几个 hook,没有 `Component`。**等宿主暴露**,别自欺欺人地改成 `try/catch`(渲染发生在 React 内部,抓不到) |
|
|
212
203
|
|
|
213
|
-
>
|
|
214
|
-
> #
|
|
215
|
-
> `
|
|
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 }`。
|
|
216
211
|
|
|
217
212
|
### 明确「不修」的(想清楚了,别捡起来)
|
|
218
213
|
|
|
@@ -231,23 +226,26 @@ git switch -c fix/your-topic main # 从干净 main 拉
|
|
|
231
226
|
|
|
232
227
|
---
|
|
233
228
|
|
|
234
|
-
## 6.
|
|
229
|
+
## 6. 下一轮该做什么(0.9.12 后)
|
|
230
|
+
|
|
231
|
+
**代码层面的待修项已经清零。** 剩下的都不是「改代码」:
|
|
235
232
|
|
|
236
|
-
|
|
233
|
+
1. **`#23`** —— 等宿主暴露 `React.Component`。在那之前别动:`try/catch` 包不住渲染期异常
|
|
234
|
+
(渲染发生在 React 内部),改了只会得到一个假的错误边界。
|
|
235
|
+
2. **两条「待确认」**(见 §5 之后的第六节)—— 都需要**真实环境**:压缩会话的 `snapshotEvents`
|
|
236
|
+
会不会抛、反代 + 非默认端口下的 `Origin`/`Host` 形态。谁遇到谁先留日志。
|
|
237
237
|
|
|
238
|
-
|
|
239
|
-
或新建的 `diary/agent.js`,再按职责切四块。
|
|
240
|
-
2. **`#26 diary/scheduler.js`(687 行五职责)** —— 拆 `diary/agent.js` + `diary/deliver.js`。
|
|
241
|
-
**必须放最后**:它依赖 #27 的产物,先拆它会把 compose 的边界搞得更乱。
|
|
242
|
-
3. **`#23`** —— 除非宿主文档明确暴露了 `React.Component`,否则不要动。
|
|
238
|
+
如果还想继续改,方向应该是**新需求**,不是还债。
|
|
243
239
|
|
|
244
|
-
>
|
|
240
|
+
> 三条重构纪律(R15 / R16 / R17 三轮验证有效,照抄):
|
|
245
241
|
> **先补特征测试钉住当下行为 → 再拆 → 特征测试一条不改必须全绿 → 毒化一次证明测试网有效。**
|
|
246
242
|
>
|
|
247
|
-
>
|
|
243
|
+
> 三个实践细节值得学:
|
|
248
244
|
> ① 特征测试**单独一个提交**、并且要在**拆分之前**就在旧代码上全绿 —— 否则它可能断言的是实现;
|
|
249
|
-
> ②
|
|
250
|
-
>
|
|
245
|
+
> ② 拆分用**脚本按段落切分**,别手抄(R16 的做法)—— 手抄一定会少一个空格或漏一行;
|
|
246
|
+
> ③ 毒化点/毒化写法要选对:R15 第一版选了确定性路径(重算字节相同 → 不红),
|
|
247
|
+
> R16 第一版把条件写成 `A || B && false`(优先级让毒化失效)——
|
|
248
|
+
> **两次都是毒化写错,不是测试无效**。毒化不红时先怀疑毒化本身。
|
|
251
249
|
|
|
252
250
|
---
|
|
253
251
|
|
package/docs/KNOWN-ISSUES.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# 已知问题清单(截至 0.9.
|
|
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 批次一~五)。
|
|
@@ -10,7 +10,19 @@
|
|
|
10
10
|
> #28 的 `text()` 拆成三个文件私有函数(无新导出,契约只多了 #33 的 `revOf`);
|
|
11
11
|
> 特征测试 `tests/r15-segment-feature.test.js`(13 断言)**先于拆分提交**,拆分后一条不改全绿。
|
|
12
12
|
> #35 是**真问题**:preview 的 CSS 确实已经漂移到旧类名,现在是逐字符比对的硬门禁。
|
|
13
|
-
>
|
|
13
|
+
>
|
|
14
|
+
> **2026-11-10 R16 轮(0.9.11,重构)**:划掉 **#27**。`compose.js`(644 行)按职责切四块:
|
|
15
|
+
> `llm.js` / `history.js` / `agent.js`(`composeDiarySetup` 移正)/ `compose.js` 只留 prompt 组装。
|
|
16
|
+
> 特征测试 `tests/r16-compose-feature.test.js`(11 断言)先于拆分提交;复核时逐个函数比对,
|
|
17
|
+
> **10 个函数体在新旧位置逐字一致**,门面导出 29 个名字前后完全相同。
|
|
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`)与第五、六节(明确不修 / 待确认)。**
|
|
14
26
|
>
|
|
15
27
|
> **2026-11-08 复核补丁(0.9.8)**:R13 的 #1(`/diary/list` 只读头部 400 字节)按字节切 UTF-8,
|
|
16
28
|
> 中文预览末尾会出现 `�`(U+FFFD)—— 400 % 3 ≠ 0,边界必然落在汉字中间。
|
|
@@ -80,8 +92,8 @@
|
|
|
80
92
|
|
|
81
93
|
| # | 问题 | 影响 | 建议 |
|
|
82
94
|
|---|---|---|---|
|
|
83
|
-
| 26 | `diary/scheduler.js`
|
|
84
|
-
| 27 | `diary/compose.js`
|
|
95
|
+
| ~~26~~ ✅已修(2026-11-10 R17) | `diary/scheduler.js` 779 行混五种职责 | 改一处要读整文件 | 拆出 `diary/deliver.js`(投递与回执判定)+ `diaryAgent` 并入 `diary/agent.js`;scheduler 留定时器/双层锁/主流程(551 行);函数体逐字未改 |
|
|
96
|
+
| ~~27~~ ✅已修(2026-11-10 R16) | `diary/compose.js` 644 行四类职责,`composeDiarySetup` 放错位置 | 同上 | 已切四块:`llm.js`(LLM 调用)/ `history.js`(最近日记)/ `agent.js`(`composeDiarySetup` 移正)/ `compose.js` 只留 prompt 组装(217 行);10 个函数体逐字未改 |
|
|
85
97
|
| ~~28~~ ✅已修(2026-11-08 R15) | `host/runtime/segment-memory.js` 的 `text()` 约 150 行、8 种职责的上帝函数 | 难以单测 | 拆 `collectDiaryMaterial` / `memoryBudgetPlan` / `computeRecallText`(均文件私有,无新导出) |
|
|
86
98
|
| ~~29~~ ✅已修(2026-11-08 R13) | `index.js` 顶部注释的注入顺序漏了 `soul:data-policy` | 文档与代码漂移 | 补一句 |
|
|
87
99
|
| ~~30~~ ✅已修(2026-11-08 R13) | `extract` 游标对「无 id 会话」统一用 `'default'` 键 | 两个会话互吃扫描窗口 | 用会话对象身份做键 |
|
|
@@ -112,21 +124,34 @@
|
|
|
112
124
|
|
|
113
125
|
---
|
|
114
126
|
|
|
115
|
-
##
|
|
127
|
+
## 七、下一轮该做什么(0.9.12 后更新)
|
|
128
|
+
|
|
129
|
+
**代码层面的待修项已经清零。** 剩下的只有两类,都不是「改代码」:
|
|
130
|
+
|
|
131
|
+
1. **#23(渲染期白屏)** —— 需要宿主的 `React.Component`。**先等等**:如果哪天 DSH 文档里
|
|
132
|
+
明确暴露了基类,再做;否则做了也是假的(当前这个「错误边界」只能接住 window 错误与
|
|
133
|
+
unhandledrejection,接不住渲染期异常)。
|
|
134
|
+
2. **两条「待确认」**(见第六节)—— 都需要**真实环境**才能验:压缩会话的 `snapshotEvents`
|
|
135
|
+
会不会抛、反代 + 非默认端口下的 `Origin`/`Host` 形态。谁遇到谁先记日志。
|
|
136
|
+
|
|
137
|
+
如果还想继续改,方向应该是「新需求」而不是「还债」了。
|
|
116
138
|
|
|
117
|
-
|
|
139
|
+
### 留给下一个重构者的话
|
|
118
140
|
|
|
119
|
-
|
|
120
|
-
`diary/agent.js`,再按职责切四块。
|
|
121
|
-
2. **#26 `diary/scheduler.js`(687 行五职责)** —— **必须最后做**:它依赖前一步的产物,
|
|
122
|
-
先拆它会把 compose 的边界搞得更乱。
|
|
123
|
-
3. **#23(渲染期白屏)** —— 除非宿主文档明确暴露了 `React.Component`,否则不要动。
|
|
141
|
+
R15 / R16 / R17 三轮把三个大文件拆完了,过程中验证有效的六条做法,写在这里免得重走弯路:
|
|
124
142
|
|
|
125
|
-
|
|
126
|
-
|
|
143
|
+
- **先补特征测试**,单独一个提交,且要在**拆分之前**就在旧代码上全绿 —— 否则它可能断言的是实现;
|
|
144
|
+
- 拆分用**脚本按段落切分**(R16 / R17 的做法),别手抄 —— 手抄一定会少一个空格或漏一行;
|
|
145
|
+
- 拆完特征测试**一条不改**必须全绿;
|
|
146
|
+
- **毒化一次**证明测试网有效。毒化不红时先怀疑毒化点或毒化写法:
|
|
147
|
+
R15 第一版选了确定性路径(重算字节相同 → 不红),R16 第一版把条件写成 `A || B && false`
|
|
148
|
+
(运算符优先级让毒化失效)—— **两次都是毒化写错,不是测试无效**;
|
|
149
|
+
- 复核方会**逐个函数比对**「函数体在新旧位置是否逐字一致」,这是纯移动的唯一硬证据;
|
|
150
|
+
- 函数跨模块移动时,**既有测试的 import 路径与调用点必须跟着改**,但**断言一个字符都不许动**
|
|
151
|
+
—— R16、R17 都这么做的,diff 里能一眼看清。
|
|
127
152
|
|
|
128
|
-
>
|
|
129
|
-
>
|
|
153
|
+
> 这三轮之后,**功能类、清理类、重构类已知问题全部清零**。
|
|
154
|
+
> 代码结构不再是「改一处要读整文件」的状态了。
|
|
130
155
|
|
|
131
156
|
---
|
|
132
157
|
|
|
@@ -0,0 +1,166 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 日记 · agent.js(2026-11-10 KNOWN-ISSUES #27:由 compose.js 按职责拆出)
|
|
3
|
+
* 会话 preset 组装修复:composeDiarySetup。函数体逐字未改。
|
|
4
|
+
* 它全是「宿主服务交互」(agentPresets / sessions / 落盘日志),与 compose 的
|
|
5
|
+
* 「拼 prompt」无关 —— 上一轮拆分时留错了地方,本轮按 HANDOFF #27 的建议移正。
|
|
6
|
+
* 另:原文件里还有两段 diaryAgent 的孤儿 docblock(函数本体 2026-11-06 已迁到
|
|
7
|
+
* scheduler.js),本轮一并删除。
|
|
8
|
+
*/
|
|
9
|
+
import { note, serviceOf } from '../env.js'
|
|
10
|
+
import { loadConfig } from '../store.js'
|
|
11
|
+
import { readSessionMeta } from '../session-title.js'
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
/**
|
|
15
|
+
* 按会话记录里的 preset 组装 setup(2026-11-03)。
|
|
16
|
+
*
|
|
17
|
+
* ── 为什么需要它 ──
|
|
18
|
+
* `agents.resume` 只恢复会话,**不会自动把 preset 挂回来**。
|
|
19
|
+
* 不传 setup 冷启动出来的 agent 没有 preset,工具只剩全局插件那一层:
|
|
20
|
+
* qq_* / soul_* / screen_* / session_* 都在,但 read / write / glob / grep / pwsh /
|
|
21
|
+
* job_* / subagent 全没了。现象是「日记会话突然干不了活」,而且不会报错。
|
|
22
|
+
*
|
|
23
|
+
* 那次事故的现场(2026-11-03 早上):这个会话第 76 轮还有 57 个工具,
|
|
24
|
+
* 第 83 轮掉到 27 个,掉掉的正好是 preset 里的那 30 个。原因就是开机时
|
|
25
|
+
* 日记会话没开着,走了这条冷启动路径,而那时它没带 setup。
|
|
26
|
+
*
|
|
27
|
+
* ── 做的事和 UI 打开会话时一致 ──
|
|
28
|
+
* resolve(presetId) 拿到预设,再 mount 到新 agent 的 ctx 上。
|
|
29
|
+
*
|
|
30
|
+
* @returns {Function|undefined} 可直接传给 agents.resume 的 setup;拿不到就等于没传
|
|
31
|
+
*/
|
|
32
|
+
export async function composeDiarySetup(ctx, sessionId) {
|
|
33
|
+
const presets = serviceOf(ctx, 'agentPresets')
|
|
34
|
+
const sessions = serviceOf(ctx, 'sessions')
|
|
35
|
+
if (
|
|
36
|
+
presets === undefined || presets === null ||
|
|
37
|
+
typeof presets.resolve !== 'function' || typeof presets.mount !== 'function'
|
|
38
|
+
) {
|
|
39
|
+
note('diary', 'agentPresets 服务不可用:冷启动的日记会话将没有 preset(工具会缺一大批)')
|
|
40
|
+
return undefined
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
let presetId
|
|
44
|
+
try {
|
|
45
|
+
const session = sessions !== undefined && sessions !== null && typeof sessions.get === 'function'
|
|
46
|
+
? sessions.get(sessionId)
|
|
47
|
+
: undefined
|
|
48
|
+
presetId = session?.header?.agentPreset
|
|
49
|
+
} catch (error) {
|
|
50
|
+
note('diary', `读日记会话的 preset 失败:${error instanceof Error ? error.message : error}`)
|
|
51
|
+
}
|
|
52
|
+
// 2026-11-05 修:会话不活跃时 sessions.get() 返回空,**不能因此认为它没有 preset**。
|
|
53
|
+
// preset 一直在落盘日志第一行里({"type":"session",...,"agentPreset":"standard"})。
|
|
54
|
+
// 读不到才真的没有 —— 那次线上事故就是这么来的:拿不到 preset 就没挂模型,
|
|
55
|
+
// 每轮装配都报 prompt variable "{{model}}" has no value,日记一个字写不出来。
|
|
56
|
+
if (typeof presetId !== 'string' || presetId === '') {
|
|
57
|
+
const meta = readSessionMeta(sessionId)
|
|
58
|
+
if (meta !== null && meta.agentPreset !== '') {
|
|
59
|
+
presetId = meta.agentPreset
|
|
60
|
+
note('diary', `日记会话不活跃,从落盘日志里读到 preset:${presetId}`)
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
if (typeof presetId !== 'string' || presetId === '') {
|
|
64
|
+
note('diary', `日记会话 ${sessionId} 真的没有 agentPreset(live 和落盘都读不到),冷启动将不带 preset`)
|
|
65
|
+
return undefined
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
try {
|
|
69
|
+
const resolved = await presets.resolve(presetId)
|
|
70
|
+
return async (agentCtx) => {
|
|
71
|
+
await presets.mount(agentCtx, resolved.id)
|
|
72
|
+
}
|
|
73
|
+
} catch (error) {
|
|
74
|
+
note('diary', `组装修复 setup 失败:${error instanceof Error ? error.message : error}`)
|
|
75
|
+
return undefined
|
|
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
|
+
}
|