@hugesb/dsh-stream-agent 0.3.1 → 0.3.2
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 +125 -0
- package/README.en.md +3 -3
- package/README.md +3 -3
- package/dist/entry/loop.js +332 -21
- package/dist/entry/mock-provider.js +20 -7
- package/dist/kernel/parser.js +488 -39
- package/dist/kernel/render.js +25 -3
- package/dist/version.js +1 -1
- package/package.json +2 -2
- package/scripts/release.mjs +20 -7
- package/scripts/repair-session-logs.mjs +105 -10
- package/src/entry/loop.ts +332 -21
- package/src/entry/mock-provider.ts +20 -7
- package/src/kernel/parser.ts +488 -39
- package/src/kernel/render.ts +25 -3
- package/src/version.ts +1 -1
- package/test/host-conformance.test.ts +418 -0
- package/test/kernel/parser.test.ts +3 -2
- package/test/v032-conflict.test.ts +191 -0
- package/test/v032-truncation.test.ts +291 -0
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,131 @@
|
|
|
2
2
|
|
|
3
3
|
本项目遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/) 与 [语义化版本](https://semver.org/lang/zh-CN/)。
|
|
4
4
|
|
|
5
|
+
## [0.3.2] - 2026-11-21
|
|
6
|
+
|
|
7
|
+
**宿主一致性补丁 + 会话中途截断修复(v0.3.2 发布版)。** 本条目合并三个批次的修复:
|
|
8
|
+
宿主一致性两案(2026-11-18)、会话中途截断四根因(真机 `session-e4b9a89c`)、以及
|
|
9
|
+
对照 GitHub 上游 `deepseek-ai/deepseek-harness` 源码后的宿主契约冲突修复
|
|
10
|
+
(真机 `session-8f22c7a0`,2026-11-20——"修复后截断仍发生"的最后一层根因)。
|
|
11
|
+
|
|
12
|
+
### Fixed(宿主契约冲突 —— 对照 GitHub 上游源码定位,真机 `session-8f22c7a0`)
|
|
13
|
+
|
|
14
|
+
**现象**:截断修复后的会话(23:31)仍然中断:缓存命中已到 88%,1 轮 6 步、1 分 51 秒
|
|
15
|
+
结束,最终答案是一句"我将重写实现文件"的意图陈述,任务没做。逐事件解码日志 + 对照
|
|
16
|
+
上游 `packages/llm/llm/src/index.ts`(master)后确认四个**独立**因素叠加:
|
|
17
|
+
|
|
18
|
+
- **assistant 线消息缺 `source`(崩溃主因)**:宿主 `LlmRuntime.forAdapter` 对请求里的
|
|
19
|
+
每条 assistant 消息读 `message.source.replayState`(上游 master 与 rc.1 均无防护)——
|
|
20
|
+
"正文落追加区"用 role:'assistant' 但不带 source,**正文首次落史后的下一请求必崩**
|
|
21
|
+
(TypeError: Cannot read properties of undefined (reading 'replayState'),日志 seq 121),
|
|
22
|
+
流以 error finish 收场 → 回合 blocked。现在 assistant 历史块与线消息一律携带
|
|
23
|
+
`source = {kind:'model', provider, model}`(`RenderMessage.source` / `modelSource()`;
|
|
24
|
+
replayState 可选,缺失按"无原生回放"处理——上游 `validateReplay` 契约)。
|
|
25
|
+
- **nudge 一次性预算误杀生产性回合**:nudge 在"写文件步"被消耗后,任何后续无注入的
|
|
26
|
+
步骤(纯写步不产生观测注入)直接 `nudgeExhausted` → blocked——即使模型正在干活。
|
|
27
|
+
现在改为**进度感知**:nudge 后有新 ok 命令即不算提示失效(继续给机会),只有零产出的
|
|
28
|
+
连续 nudge(真打转)才收束;整体仍由 maxReentries / O5 预算兜底(C3 零产出语义不变)。
|
|
29
|
+
- **XML 实体未解码**:模型带 XML 习惯写属性——`cmd="... Write-Output "EXIT=1""`
|
|
30
|
+
的实体原样进 PowerShell,命令解析报错,白烧一步。属性值统一解码有界实体集
|
|
31
|
+
(lt/gt/quot/apos/amp + 数字引用;单遍替换,`"` 不二次展开)。
|
|
32
|
+
- **DSML 内联属性 invoke 走 body 模式吞包装残片**:带内联属性的 invoke 此前走
|
|
33
|
+
`parseDsmlHeader` 进 body 模式,非正文命令把 parameter/invoke/closes 包装残片整体
|
|
34
|
+
吞到流末才以 malformed 露出(日志 seq 33-35 三条)。现在全部 invoke 统一走块缓冲
|
|
35
|
+
(内联属性与 parameter 合并,parameter 覆盖同名键);非正文命令的恢复边界纳入 DSML
|
|
36
|
+
标签(残片立即露出,不再吞到流末);块以命令自身配对闭合终止时剥掉尾部闭合标签。
|
|
37
|
+
|
|
38
|
+
### Fixed(宿主一致性 —— 历史加载失败 + 工具调用"卡住",真机 `session-1da5f8fc`)
|
|
39
|
+
|
|
40
|
+
两案同源:插件的 duck-type 面缺了宿主侧的形状/事件契约,与 0.3.0 的"工具生命周期"案同类。
|
|
41
|
+
|
|
42
|
+
- **历史加载失败(`message must have model source`)**:assistant/message 的 source 只有
|
|
43
|
+
`{kind:'model'}`,缺宿主校验器要求的非空 `provider`/`model`——日志读取时整条判 corrupt。
|
|
44
|
+
现在 source 携带实时 provider/model(无路由信息时落 'unknown' 兜底);存量损坏日志用
|
|
45
|
+
`node scripts/repair-session-logs.mjs --write` 修复(写前备份)。
|
|
46
|
+
- **回合结束后 UI 永远转圈**:`StreamLoopAgent` 从不发 `agent/status`——桌面端收不到
|
|
47
|
+
idle 转换。状态转换统一走 `#setStatus`(镜像内建 setPhase 语义),factory 从 `ctx.emit`
|
|
48
|
+
接线 `emitStatus`。
|
|
49
|
+
- **改审批策略命令报 `agent.inject is not a function`**:新增 `inject(message)`(落盘 +
|
|
50
|
+
并入下一请求装配,不唤醒空闲 agent)。
|
|
51
|
+
|
|
52
|
+
### Fixed(会话中途截断 —— v0.3.2 补丁,真机 `session-e4b9a89c`)
|
|
53
|
+
|
|
54
|
+
**现象**:任务做到一半,模型在思考区写下 "The history is truncated. I don't see the plan
|
|
55
|
+
content",随后反复重读同一文件、用占位 final 收场;桌面端最终答案只剩
|
|
56
|
+
`I'll start by inspecting the workspace. / README.md r10 / Get-ChildItem ... b902` 这类残片。
|
|
57
|
+
9 步、9 次请求后回合以 `blocked(重入次数达到上限 8)` 结束,用户侧看到的就是"输出被截断、
|
|
58
|
+
不完整"。
|
|
59
|
+
|
|
60
|
+
**四条根因(逐条修复)**:
|
|
61
|
+
|
|
62
|
+
- **请求之间没有会话记忆(主因)**:0.3.x 的追加区只放任务与句柄目录行——模型自己的
|
|
63
|
+
正文、命令、命令结果从不落历史;观测只在"易变尾"注入一次(`#reportedObservations`
|
|
64
|
+
永不重放),易变尾又每请求整块重建。于是第 3 个请求的提示只剩 system + 任务 + 句柄目录
|
|
65
|
+
(真机 step 3 `inputTokens=343`,对比 step 2 的 1613),模型如实报告"history is truncated"。
|
|
66
|
+
现在每步结束把**正文 + 命令摘要**(id/命令/目标/状态/句柄/字符数)落进追加区,已发出的
|
|
67
|
+
易变尾在下一请求装配后**转正为历史**(只允许事实类块:observation/peek/tool-result/replay;
|
|
68
|
+
nudge/degraded/error 等瞬态指令不转正)。对齐内建 `dsh-agent-loop` 的
|
|
69
|
+
`session.deriveMessages()` 语义:历史累积、只追加,前缀单调不变(新增回归断言逐条比对)。
|
|
70
|
+
- **DSML 参数式调用被当噪声(正文残片的直接来源)**:模型原生调用还有一种形态——
|
|
71
|
+
`<||DSML|| invoke name="tf-read">` 后跟
|
|
72
|
+
`<||DSML|| parameter name="path">README.md</||DSML|| parameter>`。0.3.1 只认
|
|
73
|
+
"invoke 头部内联属性",parameter 子标签逐条判 malformed,**标签之间的值作为 prose 漏进正文**
|
|
74
|
+
(`README.md r10` / `Get-ChildItem ... b902` 就是 path/id/cmd 的值),命令本身却没执行。
|
|
75
|
+
现在整个 invoke 块缓冲到闭合,按 parameter 归集成属性后一次性发命令;块内文本不再透传。
|
|
76
|
+
块未闭合即流终止时:非正文命令(属性已齐)照常发(能救则救),正文命令按 truncated 丢弃
|
|
77
|
+
(绝不写半截文件)。
|
|
78
|
+
- **非正文命令少写 `/` 吞掉后续输出**:`<tf-read ...>` 进入 body 模式后会一直吞到流末尾,
|
|
79
|
+
0.3.1 只在流末记一条 truncated,后续命令与正文全部消失。现在遇到下一个 `<tf-` / `</tf-`
|
|
80
|
+
即视为闭合(命令照发、后续照解析),流末仍未闭合也发命令并把剩余文本归还 prose。
|
|
81
|
+
- **截断没有任何续写事由**:`finish=max-tokens` / 命令体未闭合时,0.3.1 只记台账,回合
|
|
82
|
+
"安静地"结束在半截输出上。现在强制一次续写注入(`[tf-stream:truncated]`,带已生成内容
|
|
83
|
+
尾部 ≤800 字符便于从断点续写),回合级上限 `MAX_TRUNCATION_RETRIES=4`,超限如实 blocked。
|
|
84
|
+
- **计划门槛拒绝时不给计划内容**:模型看不到验收项就无法补 `accepts`,final 会被永久拒绝
|
|
85
|
+
直到重入上限。现在拒绝注入附带计划快照(id + 原文 + 状态)。
|
|
86
|
+
|
|
87
|
+
**涉及文件**:`src/kernel/parser.ts`(DSML 参数式块 / 非正文命令恢复)、
|
|
88
|
+
`src/entry/loop.ts`(步骤摘要、易变尾转正、截断续写、计划快照)、
|
|
89
|
+
`src/entry/mock-provider.ts`(剧本选择改为"最新 marker 优先"——历史持久后旧 marker 仍在,
|
|
90
|
+
首匹配会让同一剧本无限重演)。
|
|
91
|
+
**回归**:`test/v032-truncation.test.ts` 8 例(T1/T1b/T1c 解析器 DSML 三态、T3/T3b 非正文
|
|
92
|
+
命令恢复、T2 三请求历史保留 + 前缀逐条不变、T4 max-tokens 续写落盘、T5 计划快照);
|
|
93
|
+
全量 314/314 通过。
|
|
94
|
+
|
|
95
|
+
### Fixed
|
|
96
|
+
|
|
97
|
+
- **历史加载失败(`message must have model source`)**:0.3.1 及更早版本写
|
|
98
|
+
assistant/message 时 source 只有 `{kind:'model'}`,缺宿主校验器
|
|
99
|
+
(dsh-session `assertMessageEventShape` → `hasProviderModel`)要求的非空
|
|
100
|
+
`provider`/`model`——日志在读取时整条被判 corrupt,桌面端报"历史加载失败"。
|
|
101
|
+
现在 `makeAssistantMessage` 携带实时 provider/model(`createSessionEventWriter` 新增
|
|
102
|
+
`modelInfo` 写入时回调;驱动器 `modelSource()` 随 `applySelection` 运行时换模而动,
|
|
103
|
+
不缓存);无路由信息(离线/缺省)时落 `'unknown'` 兜底,形状仍过校验,不谎报模型。
|
|
104
|
+
**存量损坏日志**:`node scripts/repair-session-logs.mjs --write`(0.3.0 修复脚本扩展:
|
|
105
|
+
新增 model source 补齐类目 + 本地消息形状复核,`--model-provider`/`--model` 可指定,
|
|
106
|
+
缺省 deepseek-account / deepseek-flash;写前备份、写后清投影缓存的纪律不变)。
|
|
107
|
+
- **回合结束后 UI 永远转圈**:`StreamLoopAgent` 从不发 `agent/status`——桌面端
|
|
108
|
+
dsh-api-session-controller 靠它转发 `api-session/status` 收起"运行中"指示,不发 =
|
|
109
|
+
回合早已结束、UI 仍在"正在分析请求"。现在状态转换统一走 `#setStatus`(镜像内建
|
|
110
|
+
dsh-agent-loop `setPhase` 语义:只在 idle↔running 真正变化时发;发射异常 fail-open
|
|
111
|
+
告警不静默),factory 从宿主事件总线(`ctx.emit`)接线 `emitStatus`。
|
|
112
|
+
- **改审批策略命令报 `agent.inject is not a function`**:桌面端 approval/policy 命令路径
|
|
113
|
+
调 `agent.inject`(dsh-user-approval `setPolicy:127`),duck-type 面缺这个方法。
|
|
114
|
+
新增 `inject(message)`:落盘 user/message + 并入下一请求装配,**不唤醒空闲 agent**
|
|
115
|
+
(镜像内建 `send(input,'next-step', false)`;pendingSteers 在 runTurn 每次请求前消费,
|
|
116
|
+
含下一回合首请求,下一请求必然可见)。
|
|
117
|
+
|
|
118
|
+
### 测试
|
|
119
|
+
|
|
120
|
+
- 新增 `test/host-conformance.test.ts`(8 用例):宿主同款消息形状校验(整条日志逐事件
|
|
121
|
+
过 `assertMessageEventShape`/`hasProviderModel` 本地镜像)、换模实时 source、unknown
|
|
122
|
+
兜底、agent/status 转换序列精确性(不重复不遗漏)、发射异常熔断、inject 三态
|
|
123
|
+
(空闲/运行中/dispose 后)。
|
|
124
|
+
- 新增 `test/v032-conflict.test.ts`(4 用例):W1 assistant 线消息携带 source(forAdapter
|
|
125
|
+
契约,崩溃主因)、W2 nudge 后继续产出不中断(进度感知护栏)、W3 属性值 XML 实体解码
|
|
126
|
+
(`&quot;` 不二次展开)、W4 DSML 内联属性 + parameter 混合形态整体缓冲。
|
|
127
|
+
- 截断修复批次:`test/v032-truncation.test.ts`(8 用例,并行批次交付)。
|
|
128
|
+
- 全量 318/318 通过(0 skip;离线 mock 全链路,零 API 调用)。
|
|
129
|
+
|
|
5
130
|
## [0.3.1] - 2026-11-18
|
|
6
131
|
|
|
7
132
|
**桌面端思考过程显示修复 + 任务半途截断修复 + 第三方评审反馈修复合集。** 三部分内容并入
|
package/README.en.md
CHANGED
|
@@ -22,7 +22,7 @@ earlier batch — the two are not comparable; see the honest note in
|
|
|
22
22
|
| ----- | ----- |
|
|
23
23
|
| Host | DeepSeek Harness `0.2.2-rc.1` (type anchor) / `rc.3` (runtime-tested) |
|
|
24
24
|
| Dependencies | Zero npm dependencies; Node ≥ 22.18 (native type stripping) |
|
|
25
|
-
| Tests |
|
|
25
|
+
| Tests | 318 cases green, zero API calls (mock full-chain + 20 scenarios + activation/desktop/new-capability/session-format/host-conformance regressions) |
|
|
26
26
|
| Shape | Single bundle + **dedicated profile** (`profiles/stream` template); `dsh plugin remove` unwinds the whole layer and restores the host loop atomically |
|
|
27
27
|
| Control bar | `dsh-stream-agent bar`: four modes + zh/en + intent triage, onboarding banner on load |
|
|
28
28
|
| Desktop page | Left-rail **Control bar**: status + four mode cards + zh/en switch, **without touching the Electron shell** |
|
|
@@ -300,13 +300,13 @@ dsh-stream-agent/
|
|
|
300
300
|
│ # disabled-lines-audit / v0.4.0-plan / TEST-PROPOSITIONS
|
|
301
301
|
├── scripts/ # build / check-consistency / gate / install-check / install-cycle /
|
|
302
302
|
│ # repair-session-logs / release
|
|
303
|
-
└── test/ #
|
|
303
|
+
└── test/ # 318 cases (2 kernel + 21 entry suites + 20 mock scenarios; zero API)
|
|
304
304
|
```
|
|
305
305
|
|
|
306
306
|
## 10. Development
|
|
307
307
|
|
|
308
308
|
```bash
|
|
309
|
-
npm test #
|
|
309
|
+
npm test # 318/318, zero API calls
|
|
310
310
|
npm run build # emits dist/ (25 files) + smoke imports + desktop-page build gates
|
|
311
311
|
npm run check # R2: assembly & doc consistency (4 checks)
|
|
312
312
|
npm run gate # R4: release gate (6 items; real-machine items marked honestly)
|
package/README.md
CHANGED
|
@@ -20,7 +20,7 @@ R3 重跑后以同批双臂复算为准。
|
|
|
20
20
|
| ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
21
21
|
| 宿主 | DeepSeek Harness `0.2.2-rc.1`(类型锚点)/ `rc.3`(运行时实测) |
|
|
22
22
|
| 依赖 | 零 npm 依赖;Node ≥ 22.18(原生类型擦除) |
|
|
23
|
-
| 测试 |
|
|
23
|
+
| 测试 | 318 用例全绿,零 API 调用(mock 全链路 + 20 个场景 + 装载/桌面页/新能力/会话格式/宿主一致性/截断与宿主契约冲突回归) |
|
|
24
24
|
| 形态 | 单 bundle 包 + **专用 profile**(`profiles/stream` 模板);`dsh plugin remove` 整层消失、宿主 loop 原子恢复 |
|
|
25
25
|
| 控制栏 | `dsh-stream-agent bar`:四模式 + 中英切换 + 意图核对,装载时自动打印上手引导 |
|
|
26
26
|
| 桌面页 | 客户端左侧栏「控制栏 / Control bar」:状态 + 四模式 + 中英切换,**不改 Electron 壳** |
|
|
@@ -254,13 +254,13 @@ dsh-stream-agent/
|
|
|
254
254
|
│ # disabled-lines-audit / v0.4.0-plan / TEST-PROPOSITIONS
|
|
255
255
|
├── scripts/ # build / check-consistency / gate / install-check / install-cycle /
|
|
256
256
|
│ # repair-session-logs / release
|
|
257
|
-
└── test/ #
|
|
257
|
+
└── test/ # 318 用例(kernel 2 套 + entry 21 套 + 20 mock 场景;零 API)
|
|
258
258
|
```
|
|
259
259
|
|
|
260
260
|
## 10. 开发
|
|
261
261
|
|
|
262
262
|
```bash
|
|
263
|
-
npm test #
|
|
263
|
+
npm test # 318/318,零 API 调用
|
|
264
264
|
npm run build # 产出 dist/ 25 个文件 + 全量 smoke import + 桌面页构建闸门
|
|
265
265
|
npm run check # R2:装配与文档一致性 4 项
|
|
266
266
|
npm run gate # R4:发布门禁 6 项(真机项如实标待复测)
|