harness-reflex 0.1.0 → 0.3.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.
- package/CHANGELOG.md +20 -0
- package/README.md +103 -23
- package/USER_GUIDE.md +121 -43
- package/dist/adapters/agy.js +1 -1
- package/dist/adapters/agy.js.map +1 -1
- package/dist/adapters/codex.d.ts +133 -4
- package/dist/adapters/codex.js +325 -2
- package/dist/adapters/codex.js.map +1 -1
- package/dist/backend/defaults.d.ts +31 -0
- package/dist/backend/defaults.js +32 -0
- package/dist/backend/defaults.js.map +1 -0
- package/dist/backend/jev.js +6 -5
- package/dist/backend/jev.js.map +1 -1
- package/dist/backend/mock.d.ts +12 -1
- package/dist/backend/mock.js +34 -0
- package/dist/backend/mock.js.map +1 -1
- package/dist/backend/simple-jev.js +5 -4
- package/dist/backend/simple-jev.js.map +1 -1
- package/dist/backend/types.d.ts +34 -0
- package/dist/backend/types.js.map +1 -1
- package/dist/cli/index.js +5 -3
- package/dist/cli/index.js.map +1 -1
- package/dist/core/closing.d.ts +90 -0
- package/dist/core/closing.js +111 -0
- package/dist/core/closing.js.map +1 -0
- package/dist/core/evidence.d.ts +119 -0
- package/dist/core/evidence.js +209 -0
- package/dist/core/evidence.js.map +1 -0
- package/dist/core/judge.d.ts +221 -0
- package/dist/core/judge.js +251 -0
- package/dist/core/judge.js.map +1 -0
- package/dist/core/orchestrate-closing.d.ts +237 -0
- package/dist/core/orchestrate-closing.js +250 -0
- package/dist/core/orchestrate-closing.js.map +1 -0
- package/dist/core/orchestrate-correction.d.ts +209 -0
- package/dist/core/orchestrate-correction.js +141 -0
- package/dist/core/orchestrate-correction.js.map +1 -0
- package/dist/core/orchestrate-host.d.ts +225 -0
- package/dist/core/orchestrate-host.js +80 -0
- package/dist/core/orchestrate-host.js.map +1 -0
- package/dist/core/orchestrate-stagnation.d.ts +259 -0
- package/dist/core/orchestrate-stagnation.js +270 -0
- package/dist/core/orchestrate-stagnation.js.map +1 -0
- package/dist/core/orchestrate.d.ts +357 -0
- package/dist/core/orchestrate.js +418 -0
- package/dist/core/orchestrate.js.map +1 -0
- package/dist/core/policy.d.ts +122 -0
- package/dist/core/policy.js +102 -0
- package/dist/core/policy.js.map +1 -0
- package/dist/core/prune-plan.d.ts +141 -0
- package/dist/core/prune-plan.js +390 -0
- package/dist/core/prune-plan.js.map +1 -0
- package/dist/core/score.d.ts +2 -2
- package/dist/core/score.js.map +1 -1
- package/dist/core/text.d.ts +36 -0
- package/dist/core/text.js +66 -0
- package/dist/core/text.js.map +1 -0
- package/dist/hook/cli.d.ts +9 -0
- package/dist/hook/cli.js +52 -0
- package/dist/hook/cli.js.map +1 -0
- package/dist/hook/contract.d.ts +125 -0
- package/dist/hook/contract.js +159 -0
- package/dist/hook/contract.js.map +1 -0
- package/dist/hook/decision.d.ts +97 -0
- package/dist/hook/decision.js +955 -0
- package/dist/hook/decision.js.map +1 -0
- package/dist/hook/memory-store.d.ts +81 -0
- package/dist/hook/memory-store.js +157 -0
- package/dist/hook/memory-store.js.map +1 -0
- package/dist/hook/payload.d.ts +55 -0
- package/dist/hook/payload.js +129 -0
- package/dist/hook/payload.js.map +1 -0
- package/dist/hook/run.d.ts +48 -0
- package/dist/hook/run.js +218 -0
- package/dist/hook/run.js.map +1 -0
- package/dist/hook/store-port.d.ts +72 -0
- package/dist/hook/store-port.js +2 -0
- package/dist/hook/store-port.js.map +1 -0
- package/dist/index.d.ts +1 -0
- package/dist/index.js +1 -0
- package/dist/index.js.map +1 -1
- package/dist/ports/audit.d.ts +18 -0
- package/dist/ports/audit.js +11 -0
- package/dist/ports/audit.js.map +1 -0
- package/dist/ports/clock.d.ts +14 -0
- package/dist/ports/clock.js +11 -0
- package/dist/ports/clock.js.map +1 -0
- package/dist/ports/decision.d.ts +75 -0
- package/dist/ports/decision.js +2 -0
- package/dist/ports/decision.js.map +1 -0
- package/dist/ports/index.d.ts +14 -0
- package/dist/ports/index.js +2 -0
- package/dist/ports/index.js.map +1 -0
- package/dist/ports/log.d.ts +22 -0
- package/dist/ports/log.js +12 -0
- package/dist/ports/log.js.map +1 -0
- package/dist/ports/state.d.ts +46 -0
- package/dist/ports/state.js +13 -0
- package/dist/ports/state.js.map +1 -0
- package/dist/state/clock.d.ts +40 -0
- package/dist/state/clock.js +43 -0
- package/dist/state/clock.js.map +1 -0
- package/dist/state/file-store.d.ts +340 -0
- package/dist/state/file-store.js +849 -0
- package/dist/state/file-store.js.map +1 -0
- package/dist/state/paths.d.ts +41 -0
- package/dist/state/paths.js +73 -0
- package/dist/state/paths.js.map +1 -0
- package/docs/USER_GUIDE.en.md +79 -36
- package/docs/claude-code.md +281 -0
- package/docs/design/v0.2.0-harness-plugins.md +381 -0
- package/docs/design/v0.3.0-orchestration-unification.md +580 -0
- package/docs/dsh-plugin.md +54 -54
- package/docs/release-checklist-v0.1.0.md +32 -21
- package/docs/release-handbook-porting-notes.md +11 -11
- package/docs/release-handbook.md +55 -30
- package/docs/release-notes-v0.1.0.md +27 -14
- package/docs/release-notes-v0.3.0.md +152 -0
- package/docs/research/claude-code-harness.md +607 -0
- package/docs/research/pi-harness.md +621 -0
- package/package.json +16 -7
package/docs/dsh-plugin.md
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
|
-
# DSH Host
|
|
1
|
+
# DSH Host 插件:`dsh-harness-reflex` 工程说明
|
|
2
2
|
|
|
3
3
|
> 本文记录「把 Harness Reflex 的 System One 能力以 DSH Cordis Host 插件形式集成」这一目标的实现方式、
|
|
4
|
-
> 验收对照与验证证据。插件源码在 [`packages/dsh-reflex/`](../packages/dsh-reflex/)。
|
|
4
|
+
> 验收对照与验证证据。插件源码在 [`packages/dsh-harness-reflex/`](../packages/dsh-harness-reflex/)。
|
|
5
5
|
>
|
|
6
|
-
> **现行口径(0.1.0)**:npm 包名
|
|
6
|
+
> **现行口径(0.1.0)**:npm 包名 `dsh-harness-reflex`(Cordis 插件 id 仍是 `dsh-reflex`)
|
|
7
7
|
> - MCP 面(根包 stdio server):**8 个工具**,含 `reflex_prune`/`reflex_detect_stagnation`/`reflex_status_ledger`
|
|
8
8
|
> - DSH 面(本插件):**5 个可开关工具**(默认 4 个,`route` 关);剪枝/停滞/收尾是自动干预;账本用 `/reflex-ledger`
|
|
9
9
|
> - 面板与 API:`/dsh-reflex/api/*` 与 `data-reflex-*` 不随包名变化
|
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
|
|
13
13
|
## 1. 交付形态
|
|
14
14
|
|
|
15
|
-
- 新增 workspace 包
|
|
15
|
+
- 新增 workspace 包 **`dsh-harness-reflex`**(`packages/dsh-harness-reflex/`),TS 源码 + 插件元数据入库,`dist/` 为构建产物。
|
|
16
16
|
- 仓库根包 `harness-reflex` 对插件暴露一个新增的共享投影模块 `src/core/score.ts`,并让 ledger 支持
|
|
17
17
|
「纯内存」模式(`new DecisionLedger(null)`),使 Host 内嵌场景不写用户项目。
|
|
18
18
|
- 不改动已发布的对外 MCP 行为;stdio MCP 仍是 8 个 `reflex_*` 工具;DSH 面是 5 个可开关工具(默认 4 个)。
|
|
@@ -27,15 +27,15 @@
|
|
|
27
27
|
|
|
28
28
|
- 新增**客户端设置面板**(g-004):插件声明 `dsh.client`(`platform: 'web'` + 消费的客户端能力 + `external: ['react']`)
|
|
29
29
|
与 `exports['./client']`,产出单一浏览器包 `client.js`;面板注册到 `settings.section` 槽位(id `reflex`、`order 55`),
|
|
30
|
-
提供
|
|
31
|
-
|
|
32
|
-
决策账本(近 N 条 + 一键清空)/ **使用说明**(内嵌中英文用户手册)。Host 半边新增 `src/panel-api.ts`(投影 + loopback 路由)与
|
|
30
|
+
提供 8 个 tab(`PANEL_TABS`):概览(实时决策指标)/ 虚拟 Provider 池(增删候选、绑定物理 provider/model、标签、上下移)/
|
|
31
|
+
推理强度(单一 Reflex(自适应)开关、兜底档、置信度下限)/ System 1 后端(backend、baseUrl、model、API key 环境变量、超时)/
|
|
32
|
+
自动干预(模式与四能力)/ 工具开关(5 个可开关工具)/ 决策账本(近 N 条 + 一键清空)/ **使用说明**(内嵌中英文用户手册)。Host 半边新增 `src/panel-api.ts`(投影 + loopback 路由)与
|
|
33
33
|
`src/panel-mount.ts`(挂载),浏览器半边在 `src/client/**`。设计 token 全部走 `--dsw-alias-*`(带兜底值),
|
|
34
34
|
zh/en 文案齐备,**不引入任何新的外部重量级依赖**(bundle 的 externals 只有 `react`,它是 GUI 自身的 seed)。
|
|
35
35
|
|
|
36
36
|
- 新增**内嵌使用说明与双语查看**(g-005):仓库文档 [`USER_GUIDE.md`](../USER_GUIDE.md)(中文)与
|
|
37
37
|
[`docs/USER_GUIDE.en.md`](./USER_GUIDE.en.md)(English)经 `scripts/embed-user-guide.mjs` 生成为
|
|
38
|
-
`packages/dsh-reflex/src/client/guide.generated.ts`(构建产物,已 gitignore),随浏览器半边打进 `client.js`,
|
|
38
|
+
`packages/dsh-harness-reflex/src/client/guide.generated.ts`(构建产物,已 gitignore),随浏览器半边打进 `client.js`,
|
|
39
39
|
在设置页「使用说明 / Guide」tab 内渲染,并显示文档来源与内容摘要(digest)以便核对版本。
|
|
40
40
|
- 新增**发布打包与核验**:`scripts/release-pack.mjs`(`npm run release:pack` / `npm run release`)把根包与插件包
|
|
41
41
|
打进 `release/`,逐项核验真实 entry 列表(必需文件、零死链、零未声明运行时依赖、无临时/绝对路径),
|
|
@@ -45,17 +45,17 @@
|
|
|
45
45
|
|
|
46
46
|
| 判据 | 实现 | 证据 |
|
|
47
47
|
| --- | --- | --- |
|
|
48
|
-
| ① 符合 DSH Cordis Host 插件规范 | `package.json`(`name:
|
|
48
|
+
| ① 符合 DSH Cordis Host 插件规范 | `package.json`(`name: dsh-harness-reflex`、`exports`、`dsh.bundle.patch`、peerDependencies)→ [`packages/dsh-harness-reflex/package.json`](../packages/dsh-harness-reflex/package.json);`cordis.patch.yml` 经 YAML 解析得 `[{insert:[{id:dsh-reflex,name:'dsh-harness-reflex'}]}]`;`locale/{zh,en}.json` 均含 `meta.title/description`;`src/index.ts` 导出 `name`/`inject = ['tools', 'llm', 'commands']`/`Config`/`apply(ctx, config)` | `plugin module satisfies the Cordis Host plugin contract`、`Config is a schemastery schema that carries the deployment defaults`;`node -e "yaml.parse(...)"` 校验通过 |
|
|
49
49
|
| ② 原生工具注入 + 严格参数校验 + 可调用 | `src/tools.ts` 用 `defineTool` 声明 **5 个可开关工具**(默认 4 个,`route` 关;必填/类型/枚举/嵌套 `additionalProperties: false`),并补一道顶层未声明参数拦截;`src/bridge.ts` 的 `ReflexRuntime` 提供全部实现;prune/stagnation 由 `src/interventions.ts` 自动执行 | `apply registers every enabled tool with a model-visible description`、5 个能力各自的行为测试、`every tool rejects undeclared, missing, mistyped, and out-of-enum arguments`(18 个反例 + 1 个成功对照) |
|
|
50
50
|
| ③ 生命周期完全可逆 | 注册/观察/释放收在单个 `ctx.effect`:卸载时摘除 `tools/change` 观察者 → 逆序注销已注册工具(默认 4、最多 5)→ `/reflex-ledger` 注销 → `runtime.dispose()`(幂等、内存台账清空) | `disposing the context unregisters every tool and disposes the runtime`、`unloading the plugin fiber releases tools, the observer, and the runtime`、`the runtime a Host receives is disposable exactly once and fully`、`a second activation after a full unload rebuilds a working surface`、`two activations on one context own disjoint surfaces and release in any order` |
|
|
51
51
|
| ④ `npm run build` 成功 + 新旧测试全绿 | 根包脚本新增 `build:all` / `test:plugin` / `test:all` / `test:mutation`;`scripts/link-dsh-deps.mjs` 负责离线依赖链接 | `npm run build:all` exit 0;`npm test` = 113/113;`npm run test:plugin` = 419/419;`npm run test:mutation` = 51/51 故障被抓(50 测试 + 1 编译器);`npm run release:pack` = 27/27 |
|
|
52
|
-
| 包名与路由稳定 | npm 包名
|
|
52
|
+
| 包名与路由稳定 | npm 包名 `dsh-harness-reflex`;Cordis id `dsh-reflex`;patch `name: 'dsh-harness-reflex'`;`/dsh-reflex/api/*` 与 `data-reflex-*` 不变 | `grep -rn "dsh-harness-reflex" packages/dsh-harness-reflex/package.json packages/dsh-harness-reflex/cordis.patch.yml`;路由测试断言旧路径仍通过 |
|
|
53
53
|
|
|
54
54
|
## 3. 架构
|
|
55
55
|
|
|
56
56
|
```
|
|
57
57
|
DSH Host (cordis)
|
|
58
|
-
└─ ctx.plugin(
|
|
58
|
+
└─ ctx.plugin(dsh-harness-reflex, config)
|
|
59
59
|
└─ apply(ctx, config) ── ctx.effect(build → cleanup)
|
|
60
60
|
├─ defineReflexTools(runtime, config) → 5 × ctx.tools.register(defineTool(...))(默认 4,route 关)
|
|
61
61
|
├─ installInterventions(...) → prune / stagnation / gate / closing 自动钩子(不是工具)
|
|
@@ -121,7 +121,7 @@ agent/request ─ next() 得到调用配置 → 路由决策(若配置了候
|
|
|
121
121
|
|
|
122
122
|
```
|
|
123
123
|
DSH Web GUI (loader)
|
|
124
|
-
└─ window.__ModuleLoader__.load({ id:'
|
|
124
|
+
└─ window.__ModuleLoader__.load({ id:'dsh-harness-reflex', factory }) ── client.js(构建产物,模块内联)
|
|
125
125
|
# id 由 package.json name 派生:DSH loader 按包名注册并校验
|
|
126
126
|
├─ exports.inject = ['slots','locale']
|
|
127
127
|
├─ ctx.locale.register('dsh-reflex.panel', {zh, en}) # 面板文案(跟随 Host 语言)
|
|
@@ -245,8 +245,8 @@ DSH Web GUI (loader)
|
|
|
245
245
|
28. **面板挂在 `settings.section` 槽位,且只在 Host 半边在时出现**:槽位注册(`id:'reflex'`、`order:55`、
|
|
246
246
|
`label` 取自 locale 的 `title`)与 locale 字典都在 `ctx.slots.inject` 的 effect 里;只有当前命名空间
|
|
247
247
|
真的被 serve(`whileServed` 回调触发)时才注册,所以「Host 半边没装」不会留下一张空页面。
|
|
248
|
-
文案 zh/en 双份齐备,页面跟随 Host 语言。面板主体是
|
|
249
|
-
System 1 后端 / 决策账本 / 使用说明。
|
|
248
|
+
文案 zh/en 双份齐备,页面跟随 Host 语言。面板主体是 8 个 tab:概览 / 虚拟 Provider / 推理强度 /
|
|
249
|
+
System 1 后端 / 自动干预 / 工具开关 / 决策账本 / 使用说明。
|
|
250
250
|
|
|
251
251
|
### 内嵌使用说明与双语查看(g-005)
|
|
252
252
|
|
|
@@ -260,7 +260,7 @@ DSH Web GUI (loader)
|
|
|
260
260
|
HTML 字符串——`renderInline` 把内联代码、粗体、链接变成真实元素,其余标记一律当文本,**没有
|
|
261
261
|
`dangerouslySetInnerHTML`,所以文档里的尖括号不可能变成注入面**。表格解析要求每行单元格数与表头一致,
|
|
262
262
|
不齐的行不会被拼成错位的表。
|
|
263
|
-
31. **「使用说明」是设置页的第
|
|
263
|
+
31. **「使用说明」是设置页的第 8 个 tab,而不是外链**:`PANEL_TABS` 增加 `'guide'`,`GuideTab` 渲染标题/
|
|
264
264
|
导语/提示/来源摘要 + 解析后的正文;tab 文案 `使用说明` / `Guide` 随 Host 语言切换,正文也随语言切换
|
|
265
265
|
(中文界面读 `USER_GUIDE.md`,英文界面读 `docs/USER_GUIDE.en.md`)。面板自身仍然只走 loopback 路由,
|
|
266
266
|
文档内容随 `client.js` 一起加载,**离线可用、不新增任何运行时依赖**。
|
|
@@ -291,21 +291,21 @@ DSH Web GUI (loader)
|
|
|
291
291
|
|
|
292
292
|
```bash
|
|
293
293
|
npm run build:all # 根包 tsc → 链接 DSH 依赖 → 插件 tsc → 生成内嵌文档 → 客户端 tsc + 打包 exit 0
|
|
294
|
-
# 末步产出 packages/dsh-reflex/client.js
|
|
294
|
+
# 末步产出 packages/dsh-harness-reflex/client.js
|
|
295
295
|
# (295019 bytes, 9 modules, externals: react)
|
|
296
296
|
npm test # 根包测试:tests 113 pass 113 fail 0
|
|
297
297
|
npm run test:plugin # 插件测试:tests 419 pass 419 fail 0
|
|
298
298
|
npm run test:mutation # 负向对照:51/51 注入故障被抓(50 由测试、1 由编译器)
|
|
299
299
|
npm run release:pack # 打包 release/:27/27 核验通过,两份 tarball + SHA256SUMS + 报告
|
|
300
300
|
# harness-reflex-0.1.0.tgz (73 entries, 218 KiB)
|
|
301
|
-
#
|
|
301
|
+
# dsh-harness-reflex-0.1.0.tgz (102 entries, 578 KiB)
|
|
302
302
|
```
|
|
303
303
|
|
|
304
304
|
`client.js` 是**入库的构建产物**(`files` 白名单包含它),因此「改客户端源码 → 重新打包」是发布步骤的一部分;
|
|
305
305
|
客户端半边的四套测试都按 DSH loader 的方式读这个产物,源码改了但没重新打包会被 `client-contract.test.ts`
|
|
306
306
|
(版本号/说明符/注入 id/语言包)与 `client-page.test.ts`(整页行为)直接报出来。
|
|
307
307
|
|
|
308
|
-
思考等级的决策质量(意图表与断言见 `packages/dsh-reflex/src/effort.test.ts`,18 条带标签的任务文本;
|
|
308
|
+
思考等级的决策质量(意图表与断言见 `packages/dsh-harness-reflex/src/effort.test.ts`,18 条带标签的任务文本;
|
|
309
309
|
两条路径的命中数都被测试钉死,漂移会在 `npm run test:plugin` 里报出每一条 miss):
|
|
310
310
|
|
|
311
311
|
```
|
|
@@ -315,8 +315,8 @@ interceptor hits: 18/18 = 1.0000 # System 1 优先 + 兜底(16 条走 Sys
|
|
|
315
315
|
|
|
316
316
|
单次决策耗时:mock backend 下取整为 0 ms(亚毫秒级,无网络、无生成),测试断言 `< 50 ms`。
|
|
317
317
|
|
|
318
|
-
负向对照(`packages/dsh-reflex/scripts/mutation-check.mjs`)在 gitignore 的
|
|
319
|
-
`packages/dsh-reflex/tmp/mutation/` 里复制源码(含 `package.json` / `client.js` / `tsconfig.client.json`),
|
|
318
|
+
负向对照(`packages/dsh-harness-reflex/scripts/mutation-check.mjs`)在 gitignore 的
|
|
319
|
+
`packages/dsh-harness-reflex/tmp/mutation/` 里复制源码(含 `package.json` / `client.js` / `tsconfig.client.json`),
|
|
320
320
|
先确认副本基线为绿(186 passed),再逐条注入故障。副本会**重建客户端产物**,因此注入到 `src/client/**`
|
|
321
321
|
的故障和注入到 Host 半边的一样能被测试抓住(否则测试只会读到未受影响的旧 bundle):
|
|
322
322
|
|
|
@@ -383,7 +383,7 @@ interceptor hits: 18/18 = 1.0000 # System 1 优先 + 兜底(16 条走 Sys
|
|
|
383
383
|
- **进程内所有权 WeakMap**:同一 `LlmRuntime` 上首个激活拥有虚拟路由;若该激活被卸载,路由会释放,
|
|
384
384
|
其余激活的路由拦截仍在但没有虚拟 provider(会在下一次请求时表现为 provider 不存在)。
|
|
385
385
|
|
|
386
|
-
- **npm 发布仍是人工 gate**:0.1.0 的两个包都已具备打包条件(根包 `harness-reflex`、插件
|
|
386
|
+
- **npm 发布仍是人工 gate**:0.1.0 的两个包都已具备打包条件(根包 `harness-reflex`、插件 `dsh-harness-reflex`),
|
|
387
387
|
但 `npm login` / `npm publish` / tag / 商店上架由负责人执行;本仓库只提供可安装的 tarball。
|
|
388
388
|
- **跨表面一致性**:`reflex_score` 在两套测试里各自与同一投影函数 `scoreStatement` 做深比较(等价于
|
|
389
389
|
「MCP 表面 = 插件表面 = core」);`choice`/`screen`/`gate` 与可选的 `route` 在两套表面分别有行为测试,
|
|
@@ -391,7 +391,7 @@ interceptor hits: 18/18 = 1.0000 # System 1 优先 + 兜底(16 条走 Sys
|
|
|
391
391
|
- **`auto` backend 依赖环境变量**:无任何环境变量时落到离线 mock(确定性、无网络);`jev`/`vllm` 需要
|
|
392
392
|
API key / base url,否则调用期报错(属既有 backend 行为)。
|
|
393
393
|
- **真实 `dsh` 冒烟(0.1.0)**:隔离 `DSH_HOME` 下 `dsh plugin --profile web add --force <tarball>` 成功,
|
|
394
|
-
`--dump-config` 出现 `id: dsh-reflex / name: '
|
|
394
|
+
`--dump-config` 出现 `id: dsh-reflex / name: 'dsh-harness-reflex'`,`/dsh-reflex/api/health` 返回
|
|
395
395
|
`{"ok":true,"name":"dsh-reflex","version":"0.1.0"}`,`/panel` 可读且 `tools.active` 为默认 4 个;
|
|
396
396
|
`/reflex-ledger` 由 `command.test.ts` 覆盖(headless 入口不能执行斜杠命令)。
|
|
397
397
|
- **历史分支状态**:本目标当时以工作区文件形式落地;0.1.0 工作已在 `integration/v0.1.0` 上提交,
|
|
@@ -443,28 +443,28 @@ interceptor hits: 18/18 = 1.0000 # System 1 优先 + 兜底(16 条走 Sys
|
|
|
443
443
|
|
|
444
444
|
新增:
|
|
445
445
|
|
|
446
|
-
- `packages/dsh-reflex/`(`package.json`、`cordis.patch.yml`、`locale/{zh,en}.json`、`tsconfig.json`、
|
|
446
|
+
- `packages/dsh-harness-reflex/`(`package.json`、`cordis.patch.yml`、`locale/{zh,en}.json`、`tsconfig.json`、
|
|
447
447
|
`README.md`、`scripts/mutation-check.mjs`、`src/{index,config,bridge,tools,testing}.ts`、
|
|
448
448
|
`src/{plugin,tools,lifecycle}.test.ts`)
|
|
449
|
-
- `packages/dsh-reflex/src/router.ts`(`VirtualModelRouter`:池校验、System 1 决策、降级、审计)
|
|
450
|
-
- `packages/dsh-reflex/src/virtual-adapter.ts`(`ReflexVirtualAdapter`:虚拟 provider 的适配器表面 + 派发层兜底)
|
|
451
|
-
- `packages/dsh-reflex/src/routing.ts`(`installModelRouting`:注册虚拟路由 + `agent/pre-step`/`agent/request` 拦截)
|
|
452
|
-
- `packages/dsh-reflex/src/{router,routing}.test.ts`(17 + 19 个新测试)
|
|
453
|
-
- `packages/dsh-reflex/src/effort.ts`(`EffortInterceptor`:触发判定、System 1 决策、线索投票、投影、状态)
|
|
454
|
-
- `packages/dsh-reflex/src/session-audit.ts`(`plugin:dsh-reflex/effort` 记录的写入与回读)
|
|
455
|
-
- `packages/dsh-reflex/src/{effort,effort-routing}.test.ts`(17 + 12 个新测试)
|
|
456
|
-
- `packages/dsh-reflex/src/panel-api.ts`(面板的 Host 投影与路由:快照投影、loopback 边界、HEAD/405/400/204 语义)
|
|
457
|
-
- `packages/dsh-reflex/src/panel-mount.ts`(`mountReflexPanel`:把面板路由挂进 `ctx.webServer`,单所有者 + 可逆)
|
|
458
|
-
- `packages/dsh-reflex/src/panel-api.test.ts` + `panel-mount.test.ts`(22 + 12 个新测试)
|
|
459
|
-
- `packages/dsh-reflex/src/plugin.test.ts`(+2:System 1 连接块的默认值/校验、api key 只按环境变量名解析)
|
|
460
|
-
- `packages/dsh-reflex/src/client/{index,locale,panel,store,view}.ts`(浏览器半边:槽位注册、zh/en 文案、
|
|
449
|
+
- `packages/dsh-harness-reflex/src/router.ts`(`VirtualModelRouter`:池校验、System 1 决策、降级、审计)
|
|
450
|
+
- `packages/dsh-harness-reflex/src/virtual-adapter.ts`(`ReflexVirtualAdapter`:虚拟 provider 的适配器表面 + 派发层兜底)
|
|
451
|
+
- `packages/dsh-harness-reflex/src/routing.ts`(`installModelRouting`:注册虚拟路由 + `agent/pre-step`/`agent/request` 拦截)
|
|
452
|
+
- `packages/dsh-harness-reflex/src/{router,routing}.test.ts`(17 + 19 个新测试)
|
|
453
|
+
- `packages/dsh-harness-reflex/src/effort.ts`(`EffortInterceptor`:触发判定、System 1 决策、线索投票、投影、状态)
|
|
454
|
+
- `packages/dsh-harness-reflex/src/session-audit.ts`(`plugin:dsh-reflex/effort` 记录的写入与回读)
|
|
455
|
+
- `packages/dsh-harness-reflex/src/{effort,effort-routing}.test.ts`(17 + 12 个新测试)
|
|
456
|
+
- `packages/dsh-harness-reflex/src/panel-api.ts`(面板的 Host 投影与路由:快照投影、loopback 边界、HEAD/405/400/204 语义)
|
|
457
|
+
- `packages/dsh-harness-reflex/src/panel-mount.ts`(`mountReflexPanel`:把面板路由挂进 `ctx.webServer`,单所有者 + 可逆)
|
|
458
|
+
- `packages/dsh-harness-reflex/src/panel-api.test.ts` + `panel-mount.test.ts`(22 + 12 个新测试)
|
|
459
|
+
- `packages/dsh-harness-reflex/src/plugin.test.ts`(+2:System 1 连接块的默认值/校验、api key 只按环境变量名解析)
|
|
460
|
+
- `packages/dsh-harness-reflex/src/client/{index,locale,panel,store,view}.ts`(浏览器半边:槽位注册、zh/en 文案、
|
|
461
461
|
纯视图模型、轮询+提交、设计 token 渲染)
|
|
462
|
-
- `packages/dsh-reflex/src/client-bundle.ts`(`tokenize`/`collectRequires`/`buildBundle`/`verifyClientPackage`:
|
|
462
|
+
- `packages/dsh-harness-reflex/src/client-bundle.ts`(`tokenize`/`collectRequires`/`buildBundle`/`verifyClientPackage`:
|
|
463
463
|
把 `dist-client/**` 打成单一 `window.__ModuleLoader__` 包并核对 externals)
|
|
464
|
-
- `packages/dsh-reflex/src/client-bundle.test.ts` + `client-page.test.ts` + `client-contract.test.ts`
|
|
464
|
+
- `packages/dsh-harness-reflex/src/client-bundle.test.ts` + `client-page.test.ts` + `client-contract.test.ts`
|
|
465
465
|
(7 + 16 + 7 个新测试:打包器单元测试、VM 内整页端到端、清单/产物/注入 id 契约)
|
|
466
|
-
- `packages/dsh-reflex/client.js`(构建产物,入库)
|
|
467
|
-
- `packages/dsh-reflex/tsconfig.client.json`
|
|
466
|
+
- `packages/dsh-harness-reflex/client.js`(构建产物,入库)
|
|
467
|
+
- `packages/dsh-harness-reflex/tsconfig.client.json`
|
|
468
468
|
- `scripts/link-dsh-deps.mjs`
|
|
469
469
|
- `docs/dsh-plugin.md`(本文)
|
|
470
470
|
- `src/core/score.ts`、`src/core/ledger.test.ts`、`src/core/score.test.ts`、`src/mcp/server.test.ts`
|
|
@@ -473,12 +473,12 @@ interceptor hits: 18/18 = 1.0000 # System 1 优先 + 兜底(16 条走 Sys
|
|
|
473
473
|
|
|
474
474
|
- `package.json`(`build:all` / `test` glob 修正 / `test:plugin` / `test:all` / `test:mutation`)
|
|
475
475
|
- `.gitignore`(新增 `tmp/`、`dist-client/`)
|
|
476
|
-
- `packages/dsh-reflex/package.json`(`exports` 增加 `./client`/`./locale/*.json`,`files` 增加 `client.js`,
|
|
476
|
+
- `packages/dsh-harness-reflex/package.json`(`exports` 增加 `./client`/`./locale/*.json`,`files` 增加 `client.js`,
|
|
477
477
|
新增 `dsh.client` 与 `build:client` 脚本)
|
|
478
|
-
- `packages/dsh-reflex/src/index.ts`(`apply` 的 effect 里增加 `mountReflexPanel`,卸载时一并摘除)
|
|
479
|
-
- `packages/dsh-reflex/src/config.ts`(`systemOne` 块:`backend/baseUrl/model/apiKeyEnv/timeoutMs` +
|
|
478
|
+
- `packages/dsh-harness-reflex/src/index.ts`(`apply` 的 effect 里增加 `mountReflexPanel`,卸载时一并摘除)
|
|
479
|
+
- `packages/dsh-harness-reflex/src/config.ts`(`systemOne` 块:`backend/baseUrl/model/apiKeyEnv/timeoutMs` +
|
|
480
480
|
`resolveSystemOneConfig`/`resolveApiKey`,供面板的「System 1 后端」页读写)
|
|
481
|
-
- `packages/dsh-reflex/scripts/mutation-check.mjs`(基线 95 → 161;scratch 副本补 `package.json`/`client.js`/
|
|
481
|
+
- `packages/dsh-harness-reflex/scripts/mutation-check.mjs`(基线 95 → 161;scratch 副本补 `package.json`/`client.js`/
|
|
482
482
|
`tsconfig.client.json` 并重建客户端产物,使 `src/client/**` 的故障也能被测试抓住;新增 6 条故障:5 条 panel + 1 条 System 1 连接参数)
|
|
483
483
|
- `package.json`(`build:all` 末尾追加 `build:plugin-client`)
|
|
484
484
|
- `src/core/ledger.ts`(`customPath === null` = 纯内存 + `getLogPath()`;`LedgerEntry.type` 增加 `'model-route'` 与 `'effort-decision'`)
|
|
@@ -501,17 +501,17 @@ g-006(路由上下文感知与会话粘性)增量:
|
|
|
501
501
|
- `src/backend/types.ts`(`RouteRequest` 增加 `state`/`instructions`,候选增加可选 `current`)
|
|
502
502
|
- `src/backend/{jev,simple-jev}.ts`(Jev 把 `state`/`instructions`/`context` 当数据发;logits 后端把上下文渲染进 prompt)
|
|
503
503
|
- `src/core/route.ts`(`selectBest` 的 options 与 `CandidateItem` 透传新增字段)
|
|
504
|
-
- `packages/dsh-reflex/src/router.ts`(`estimateContextTokens`/`buildCacheAffinityInstruction`/`CONTEXT_CHARS_PER_TOKEN`/
|
|
504
|
+
- `packages/dsh-harness-reflex/src/router.ts`(`estimateContextTokens`/`buildCacheAffinityInstruction`/`CONTEXT_CHARS_PER_TOKEN`/
|
|
505
505
|
`DEFAULT_STICKY_MARGIN`/`CURRENT_MODEL_NOTE`、`stickyMargin` 选项、`#preferIncumbent` 粘性闸门、
|
|
506
506
|
`RouteDecision` 的 `currentModel/switched/contextTokens/contextChars`、台账与降级路径的新字段)
|
|
507
|
-
- `packages/dsh-reflex/src/routing.ts`(`AgentRoutingFacts` 逐 agent 记上下文规模与当前物理模型、
|
|
507
|
+
- `packages/dsh-harness-reflex/src/routing.ts`(`AgentRoutingFacts` 逐 agent 记上下文规模与当前物理模型、
|
|
508
508
|
`measureMessages`/`rememberStep`/`rememberTarget`/`recallFacts`,`agent/request` 带上 `state`/`instructions`)
|
|
509
|
-
- `packages/dsh-reflex/src/bridge.ts`(决策 seam 透传 `input`)
|
|
510
|
-
- `packages/dsh-reflex/src/panel-api.ts`(`PanelLedgerRow` 投影 `currentModel`/`switched`/`contextTokens`)
|
|
511
|
-
- `packages/dsh-reflex/src/{router,routing,panel-api,tools}.test.ts`、`src/mcp/server.test.ts`
|
|
509
|
+
- `packages/dsh-harness-reflex/src/bridge.ts`(决策 seam 透传 `input`)
|
|
510
|
+
- `packages/dsh-harness-reflex/src/panel-api.ts`(`PanelLedgerRow` 投影 `currentModel`/`switched`/`contextTokens`)
|
|
511
|
+
- `packages/dsh-harness-reflex/src/{router,routing,panel-api,tools}.test.ts`、`src/mcp/server.test.ts`
|
|
512
512
|
(新增 11 + 4 + 2 条测试;后两者把两处独立计时字段的比较改为「钉住数值、只校验类型」,消除既有的
|
|
513
513
|
负载敏感抖动)
|
|
514
|
-
- `packages/dsh-reflex/scripts/mutation-check.mjs`(基线 161 → 186;新增 7 条故障:上下文规模、亲和策略、
|
|
514
|
+
- `packages/dsh-harness-reflex/scripts/mutation-check.mjs`(基线 161 → 186;新增 7 条故障:上下文规模、亲和策略、
|
|
515
515
|
粘性闸门、台账字段、跨轮记忆、路由上报上下文、面板 switch 投影)
|
|
516
516
|
- `USER_GUIDE.md` / `docs/USER_GUIDE.en.md`(虚拟 Provider 一节补「上下文感知与会话粘性」小节)
|
|
517
517
|
- `docs/dsh-plugin.md`(本文:§4 第 32–36 条、§5 计数、§6 边界、§12 验收对照)
|
|
@@ -530,17 +530,17 @@ g-006(路由上下文感知与会话粘性)增量:
|
|
|
530
530
|
|
|
531
531
|
| 判据 | 实现 | 证据 |
|
|
532
532
|
| --- | --- | --- |
|
|
533
|
-
| ① 详尽使用说明(插件架构 / 虚拟 Provider 模型池 / 自适应思考等级 / System 1 后端 / MCP↔原生工具对照) | [`USER_GUIDE.md`](../USER_GUIDE.md)(中文,13 节)与 [`docs/USER_GUIDE.en.md`](./USER_GUIDE.en.md)(English,同构 13 节):架构图、安装与构建、`SYSTEM_ONE_BACKEND` 接入、虚拟 Provider 与模型池配置、`
|
|
533
|
+
| ① 详尽使用说明(插件架构 / 虚拟 Provider 模型池 / 自适应思考等级 / System 1 后端 / MCP↔原生工具对照) | [`USER_GUIDE.md`](../USER_GUIDE.md)(中文,13 节)与 [`docs/USER_GUIDE.en.md`](./USER_GUIDE.en.md)(English,同构 13 节):架构图、安装与构建、`SYSTEM_ONE_BACKEND` 接入、虚拟 Provider 与模型池配置、`Reflex(自适应)` 单一思考策略(`auto` 仅为兼容别名)、设置面板说明、MCP 8 工具 ↔ DSH 5 可开关能力对照表、决策账本、测试与发布、FAQ、版本兼容 | `guide.test.ts`:两份文档摘要与产物一致、节号齐全、各自包含 `npm run build:all` / `dsh plugin --profile web add` / `settings.section` / `client.js` / `SYSTEM_ONE_BACKEND` / `virtualProvider` / `reasoningEffort` / `reflex-auto` 与 8 个工具名;两份文档都能被渲染器解析出 ≥13 个标题、≥3 张表(无空/错位单元格)、≥6 个带语言标注的代码块 |
|
|
534
534
|
| ② 设置页 UI 内可查看说明(独立 Tab + 中英双语) | `src/client/store.ts` 的 `PANEL_TABS` 增加 `'guide'`;`src/client/view.ts` 的 `GuideTab` 渲染标题/导语/来源摘要 + `renderMarkdown(t('guideBody'))`;`locale.ts` zh `使用说明` / en `Guide`,正文随 Host 语言切换 | `client-page.test.ts`:`the guide page renders the shipped user guide inside the panel`(探针 `Harness Reflex 使用说明`、`1. Harness Reflex 是什么`、`虚拟 Provider 与模型池`、`npm run build:all`、`reflex_detect_stagnation`,并断言渲染出 h1/h2/table/pre/li 与 `/文档来源 USER_GUIDE\.md · 摘要 [0-9a-f]{12}/`)、`the guide page follows the Host language`(en 界面读英文文档)、tab 文案断言包含 `使用说明` / `Guide` |
|
|
535
535
|
| ③ 文档与查看功能在构建/打包产物中完整生效 | `build:plugin-client` 与插件 `build:client` 都先跑 `scripts/embed-user-guide.mjs`;`client.js` 内联两份文档与摘要;根包 `files` 白名单新增 `USER_GUIDE.md`(`docs/**/*.md` 已覆盖英文版) | `npm run build:all` exit 0(`client-bundle: wrote …/client.js (172049 bytes, 8 modules, externals: react)`);`npm run release:pack`:`plugin: the shipped guide is the repository revision`、`root: the shipped guide is the repository revision`(比对 release tarball 内文档与仓库文档的 sha256)、`plugin: the browser half is one self-contained artifact` |
|
|
536
|
-
| ④ 补齐相关自动化测试 | 新增 `packages/dsh-reflex/src/guide.test.ts`(5 条)、扩展 `client-page.test.ts`(+2 条)、新增根包 `src/release-packaging.test.ts`(6 条打包清单测试) | `npm run test:plugin` = 419/419;`npm test` = 113/113;`the plugin manifest ships the browser half and the guide it renders`、`the plugin declares every host package its build imports`、`the root files allow-list ships the release promises and nothing else` |
|
|
537
|
-
| ⑤ 最终集成验收与 release tarball | `scripts/release-pack.mjs`:真实 `npm pack` 两份包 → 解压核验(必需文件 / 禁运测试产物与临时目录 / 无本地绝对路径 / 零死链 / 零未声明运行时依赖 / bin 可执行位)→ 根包离线 `npm install` 冒烟(`bin --help`、具名 import、stdio MCP `tools/list` 八个工具)→
|
|
536
|
+
| ④ 补齐相关自动化测试 | 新增 `packages/dsh-harness-reflex/src/guide.test.ts`(5 条)、扩展 `client-page.test.ts`(+2 条)、新增根包 `src/release-packaging.test.ts`(6 条打包清单测试) | `npm run test:plugin` = 419/419;`npm test` = 113/113;`the plugin manifest ships the browser half and the guide it renders`、`the plugin declares every host package its build imports`、`the root files allow-list ships the release promises and nothing else` |
|
|
537
|
+
| ⑤ 最终集成验收与 release tarball | `scripts/release-pack.mjs`:真实 `npm pack` 两份包 → 解压核验(必需文件 / 禁运测试产物与临时目录 / 无本地绝对路径 / 零死链 / 零未声明运行时依赖 / bin 可执行位)→ 根包离线 `npm install` 冒烟(`bin --help`、具名 import、stdio MCP `tools/list` 八个工具)→ 插件按包名(node_modules/dsh-harness-reflex)解压后 `import` 冒烟 → `SHA256SUMS` + `release-report.json` + `RELEASE-<version>.md` | `npm run release:pack` 27/27 通过:`release/harness-reflex-0.1.0.tgz`(73 entries)、`release/dsh-harness-reflex-0.1.0.tgz`(102 entries);`smoke: the extracted plugin resolves and exposes apply()`;`a packed release directory is internally consistent`(重算 SHA256SUMS) |
|
|
538
538
|
|
|
539
539
|
## 12. 路由上下文感知与会话粘性验收对照(g-006)
|
|
540
540
|
|
|
541
541
|
| 判据 | 实现 | 证据 |
|
|
542
542
|
| --- | --- | --- |
|
|
543
|
-
| ① System 1 路由请求带上会话累积上下文规模与当前物理模型 | `packages/dsh-reflex/src/routing.ts`:`AgentRoutingFacts` 按 agent 累计 `agent/pre-step` 观测到的字符数(`measureMessages`,上限 64 个 agent),`recallFacts` 在 `agent/request` 里取回,`estimateContextTokens(chars) = ceil(chars/4)`;`RouteDecisionInput` 作为决策 seam 的第 4 个参数透传到 `RouteRequest.state.{currentModel,contextTokens,contextChars}`,`src/core/route.ts` 与 `src/bridge.ts` 只做透传 | `the decision request carries the session context size and current model`(`state.currentModel='deepseek:chat'`、`contextChars=12000`、`contextTokens=3000`)、`an explicit token count wins over the estimate from characters`、`estimateContextTokens rounds characters up at the documented ratio`、`each session defends its own model and its own context size`(两个 agent 各自上报自己的 `contextChars`,tokens = `ceil(chars/4)`)、`selectBest forwards the session facts and the policy to the backend`、`routing-reports-no-context` 变异对照 |
|
|
543
|
+
| ① System 1 路由请求带上会话累积上下文规模与当前物理模型 | `packages/dsh-harness-reflex/src/routing.ts`:`AgentRoutingFacts` 按 agent 累计 `agent/pre-step` 观测到的字符数(`measureMessages`,上限 64 个 agent),`recallFacts` 在 `agent/request` 里取回,`estimateContextTokens(chars) = ceil(chars/4)`;`RouteDecisionInput` 作为决策 seam 的第 4 个参数透传到 `RouteRequest.state.{currentModel,contextTokens,contextChars}`,`src/core/route.ts` 与 `src/bridge.ts` 只做透传 | `the decision request carries the session context size and current model`(`state.currentModel='deepseek:chat'`、`contextChars=12000`、`contextTokens=3000`)、`an explicit token count wins over the estimate from characters`、`estimateContextTokens rounds characters up at the documented ratio`、`each session defends its own model and its own context size`(两个 agent 各自上报自己的 `contextChars`,tokens = `ceil(chars/4)`)、`selectBest forwards the session facts and the policy to the backend`、`routing-reports-no-context` 变异对照 |
|
|
544
544
|
| ② 决策提示词注入「保留当前模型可省缓存、非必要不切」的偏好 | `router.ts` 的 `buildCacheAffinityInstruction(facts)`(无当前模型 / 当前模型不在池里 / 建议保留 三种措辞)→ `RouteRequest.instructions`;`state` 给结构化后端;候选描述追加 `CURRENT_MODEL_NOTE = '[current model — keeping it preserves the prompt cache]'` 且带 `current: true`;`src/backend/route-prompt.ts` 是唯一渲染点,`system-one-logits` 渲染进 prompt、`JevDecisionBackend` 发 `state`/`instructions`/`context` | `the incumbent candidate is marked for the decision, in both readings`、`buildCacheAffinityInstruction states the policy, not a verdict`、`the logits backend puts the affinity facts and policy in the prompt it scores`、`the Jev gateway is handed the same facts as data, policy and rendered context`、`a request without affinity renders exactly the historical context block` + `a request without affinity posts exactly the historical Jev body`(无亲和性时请求逐字段与历史一致)、`affinity-policy-not-stated` / `affinity-drops-token-estimate` 变异对照 |
|
|
545
545
|
| ③ 当前模型尚可胜任时稳定保留,只有明显超出才切换 | `#preferIncumbent`:挑战者须 `score > 当前分` **且** `score >= 当前分 × (1 + stickyMargin)`(`DEFAULT_STICKY_MARGIN = 0.15`,相对门槛以兼容 mock/概率/logit 三种量纲)才算「明显更合适」;否则守住当前模型并把 `reason` 记为 `sticky-affinity`;当前模型不在池内时不阻拦,按名次走 | `a session is not switched for a marginal score difference`(0.5 vs 0.45 → 守住 `deepseek:chat`,`reason='sticky-affinity'`)、`a challenger that only ties the incumbent never displaces it`、`a clearly better candidate still displaces the current model`(0.95 vs 0.2 → `switched=true`)、`stickyMargin=0 switches on any strict improvement`、`a current model outside the pool is reported but cannot be defended`、集成测试 `a second turn keeps the physical model the session already warmed`(真实 waterfall + 真实 mock backend:第二轮并列分不再退回配置顺序)、`each session defends its own model and its own context size`、`sticky-gate-always-switches` / `routing-forgets-routed-model` 变异对照 |
|
|
546
546
|
| ④ `model-route` 台账记录 `currentModel` / `switched` / `contextTokens` 与原因 | `routeModel` 的台账 `details` 增加 `currentModel`(首轮为 `null`,字段恒在)、`switched`(`formatTargetName(target) !== decision.currentModel`)、`contextTokens`、`contextChars`,保留 `reason`(`matched` / `sticky-affinity` / `degraded`…);降级路径 `#degrade` 同样写这四个字段;`panel-api` 的 `projectRow` 把三者投影给面板(`currentModel` 为 `null` 时不投影) | `a first decision has no incumbent and no switch to report`(`currentModel=null`、`switched=false`、`contextTokens=0`)、`a degraded decision still reports the session facts and the switch it caused`、`a session is not switched…` 与 `a clearly better candidate…` 对台账字段的断言、`a routing decision projects its cache-affinity audit fields`、`a first decision with no incumbent projects no currentModel`、`affinity-audit-loses-current-model` / `panel-drops-switched-flag` 变异对照 |
|
|
@@ -556,7 +556,7 @@ g-006(路由上下文感知与会话粘性)增量:
|
|
|
556
556
|
| S2 虚拟路由下不再逐步注入 `[model changed: …; the session continues with reflex/*]` | `src/routing.ts`:`isVirtualModelSwitchNotice`(认 `<from> → <to>` 摘要、`continues with <to>` 正文、`reflex/…` 前缀、池内模型名)与 `filterVirtualSwitchNotices`(不改原对象、无命中时返回同一引用);`ensureVirtualSwitchFilter` 在该 agent 自己的 ctx 上以 `prepend` 后注册,成为 `installModelSelection` 通知层的**外层**包装,因此能删掉已追加的假通知;仅针对虚拟目标,物理↔物理切换通知保留 | `virtual-switch-notice.test.ts`(4 条):认领矩阵(含 `form:'selection'`、纯文本引用、无目标一律拒收)、单次决策过滤(仅假通知被删、物理通知逐字保留、入参不被改动、无命中返回同一引用)、真实 waterfall 集成(第 1 步仍播报一次 → 第 2 步起为 0、任务文本存活、物理通知仍送达、安装后覆盖后续所有步)、无 `agent.ctx` 的 agent 不被打断(通知原样通过而非抛错) |
|
|
557
557
|
| S3 + P9 先定目标模型、读其声明档位、**在声明集合内**自适应,不常态化 `snapped`;纯逐字复述深度关键词须判 `off`/`low` | `src/effort.ts`:#decideTurn 对逐字复述轮次**先短路**(不咨询 System 1,理由写进台账)、`#askSystemOne` 在置信度地板之后追加「必须超过 `1/候选数` 均分基线」的否决、`buildEffortChoiceOptions(efforts?)` 按目标模型声明的档位收敛候选(邻居吸附)、`VERBATIM_INSTRUCTION` 扩到 `原样发给我/原样发给/原样输出/原文照抄/照抄` | `effort-model-levels.test.ts`:中文深度轮次读 System 1 词汇(`source==='system-one'`、`confidence > 1/3`、`high`)而非坍缩到首候选;「只与均分持平」的答案在任何候选数下都不被信任(GPT/FULL/DEEPSEEK → `cue-fallback`,reason 命中 `/floor|baseline/`;对照组 0.5 → `system-one` + `low`);简报点名的每种复述措辞都保住低成本档(`cleaned.verbatim === true`,`off|low`,`outcome 'supported'`) |
|
|
558
558
|
| S4 有思考能力的物理模型与虚拟模型都在模型选择器里提供 `reflex` 自适应档;无思考能力模型不显示;固定物理模型只调档位不改路由;策略跨切换/恢复保持且不覆盖显式档位 | `src/routing.ts` 的 `installAdaptiveEffortSurface` 包装 `resolveModelInfo`(只在**已声明 reasoning** 的模型前面插入 `{id:'reflex', name:'Reflex (Auto)'}`,`defaultEffort` 保持适配器原值)、`resolveCallConfig`/`prepareCall`(把标记还原成目标模型声明集合内的档位);`src/virtual-adapter.ts` 的虚拟模型声明 `reflex` 选择且**不带** `defaultEffort`(带上的话会打断 `markAgentLoopRequest` 的请求同一性);`model/selection` 回放:日志里是 `reflex` 则重新武装自适应,是具体等级则解除 | `adaptive-effort-surface.test.ts`(7 条):思考路由首位是 `Reflex (Auto)` 且既有档位与默认值存活、无 reasoning 的路由完全不出现档位、未激活时不发明 `reasoningEffort`、显式物理选择不被改写、`prepareCall` 后请求同一性保持 |
|
|
559
|
-
| 接口一致性 / 版本 / 序列化 / 打包 / 真机 | `reflex_detect_stagnation` 增加可选 `history`(`MAX_HISTORY=30`,`mergeHistory`);版本 `0.1.0`;DeepSeek/GPT 序列化载荷结构化验证;四套命令全绿;`release/` 只留 0.1.0 产物 | `npm run build:all` exit 0(`client.js (295986 bytes, 9 modules, externals: react)`);`npm test` = 113/113;`npm run test:plugin` = 419/419;`npm run release:pack` = 27/27(`harness-reflex-0.1.0.tgz` 73 entries、`
|
|
559
|
+
| 接口一致性 / 版本 / 序列化 / 打包 / 真机 | `reflex_detect_stagnation` 增加可选 `history`(`MAX_HISTORY=30`,`mergeHistory`);版本 `0.1.0`;DeepSeek/GPT 序列化载荷结构化验证;四套命令全绿;`release/` 只留 0.1.0 产物 | `npm run build:all` exit 0(`client.js (295986 bytes, 9 modules, externals: react)`);`npm test` = 113/113;`npm run test:plugin` = 419/419;`npm run release:pack` = 27/27(`harness-reflex-0.1.0.tgz` 73 entries、`dsh-harness-reflex-0.1.0.tgz` 102 entries);`provider-serialization.test.ts`(4 条,缺失 SDK 时按 NT 跳过并显式声明);**真机**:隔离 `DSH_HOME` 装 0.1.0 tarball 起 `dsh web`,面板显示 `v0.1.0`、`/dsh-reflex/api/health` 返回 `{"ok":true,"name":"dsh-reflex","version":"0.1.0"}`、配置池后模型选择器出现「Reflex (System 1 router) → reflex-auto」、插件页状态条 `激活·reflex·mock-heuristic-v1`、池 `reflex-auto 2 候选`(截图 `tmp/e2e-reflex-panel-3099.png`);有意保留的取舍:固定物理模型下需在选择器里选 `reflex` 才进入自适应,选具体等级即钉死 |
|
|
560
560
|
|
|
561
561
|
## 14. 能力开关设置面与插件侧工具面收敛(g-009)
|
|
562
562
|
|
|
@@ -20,40 +20,42 @@ V=0.1.0
|
|
|
20
20
|
|
|
21
21
|
```bash
|
|
22
22
|
npm pkg set version="$V"
|
|
23
|
-
(cd packages/dsh-reflex && npm pkg set version="$V")
|
|
24
|
-
node -p "require('./package.json').version + ' / ' + require('./packages/dsh-reflex/package.json').version"
|
|
23
|
+
(cd packages/dsh-harness-reflex && npm pkg set version="$V")
|
|
24
|
+
node -p "require('./package.json').version + ' / ' + require('./packages/dsh-harness-reflex/package.json').version"
|
|
25
25
|
# 期望:0.1.0 / 0.1.0
|
|
26
26
|
```
|
|
27
27
|
|
|
28
28
|
- [x] 版本常量与测试引用同步(执行记录):
|
|
29
29
|
|
|
30
|
-
- `packages/dsh-reflex/src/panel-api.ts` → `REFLEX_PLUGIN_VERSION = '0.1.0'`
|
|
31
|
-
- `src/release-packaging.test.ts` 产物名改为按 manifest
|
|
32
|
-
- `packages/dsh-reflex/package.json` → `name:
|
|
33
|
-
- `USER_GUIDE.md`、`docs/USER_GUIDE.en.md`、`packages/dsh-reflex/README.md` 的当前版本声明
|
|
30
|
+
- `packages/dsh-harness-reflex/src/panel-api.ts` → `REFLEX_PLUGIN_VERSION = '0.1.0'`
|
|
31
|
+
- `src/release-packaging.test.ts` 产物名改为按 manifest 版本动态生成(插件包为 `dsh-harness-reflex-<version>.tgz`)
|
|
32
|
+
- `packages/dsh-harness-reflex/package.json` → `name: dsh-harness-reflex`、`cordis.patch.yml` 的 `name` 同步(`id` 不变)
|
|
33
|
+
- `USER_GUIDE.md`、`docs/USER_GUIDE.en.md`、`packages/dsh-harness-reflex/README.md` 的当前版本声明
|
|
34
34
|
- `package-lock.json`:`npm install --package-lock-only --ignore-scripts`
|
|
35
35
|
|
|
36
36
|
- [x] 当前版本引用不再有 alpha.2 残留(只查会随版本变化的文件,发布文档本身可保留历史引用):
|
|
37
37
|
|
|
38
38
|
```bash
|
|
39
39
|
grep -n "0\.1\.0-alpha\.2" \
|
|
40
|
-
package.json packages/dsh-reflex/package.json \
|
|
41
|
-
packages/dsh-reflex/src/panel-api.ts src/release-packaging.test.ts \
|
|
42
|
-
USER_GUIDE.md docs/USER_GUIDE.en.md packages/dsh-reflex/README.md
|
|
40
|
+
package.json packages/dsh-harness-reflex/package.json \
|
|
41
|
+
packages/dsh-harness-reflex/src/panel-api.ts src/release-packaging.test.ts \
|
|
42
|
+
USER_GUIDE.md docs/USER_GUIDE.en.md packages/dsh-harness-reflex/README.md
|
|
43
43
|
# 期望:无输出
|
|
44
44
|
```
|
|
45
45
|
|
|
46
46
|
通过判据:上述文件无 alpha.2;`docs/dsh-plugin.md` 的历史章节、本发布文档中的历史引用不计入。
|
|
47
47
|
|
|
48
|
-
- [
|
|
48
|
+
- [x] 包名/渠道现状复核(**已完成 2026-10-22**):
|
|
49
49
|
|
|
50
50
|
```bash
|
|
51
|
-
npm view
|
|
52
|
-
npm view harness-reflex version #
|
|
51
|
+
npm view dsh-harness-reflex version # 已占名并发布 0.1.0(维护者 miuzel)
|
|
52
|
+
npm view harness-reflex version # 已发布 0.1.0
|
|
53
53
|
npm whoami # 期望打印用户名;E401 即未登录
|
|
54
54
|
```
|
|
55
55
|
|
|
56
|
-
|
|
56
|
+
通过判据:负责人已复核插件包名并明确 0.1.0 的发布渠道(tarball 直发 / registry)。
|
|
57
|
+
|
|
58
|
+
> **实测结果(2026-10-22)**:`dsh-harness-reflex@0.1.0` 与 `harness-reflex@0.1.0` 均已发布到 npm;旧名 `@miuzel/dsh-reflex@0.1.0` 与占位版 `0.0.0-stage` 保留并建议 deprecate。上游发布的插件 tarball 与本仓库 `release/dsh-harness-reflex-0.1.0.tgz` **逐文件内容一致**(file-list 与 per-file sha256 均为 0 差异);根包 0.1.0 早于最终改名发布,仅文档内的包名不同,负责人已确认不重发。
|
|
57
59
|
|
|
58
60
|
---
|
|
59
61
|
|
|
@@ -65,7 +67,7 @@ V=0.1.0
|
|
|
65
67
|
npm run build:all
|
|
66
68
|
```
|
|
67
69
|
|
|
68
|
-
通过判据:exit 0;`packages/dsh-reflex/client.js` 生成且 >100 000 字节。
|
|
70
|
+
通过判据:exit 0;`packages/dsh-harness-reflex/client.js` 生成且 >100 000 字节。
|
|
69
71
|
|
|
70
72
|
- [ ] 根包测试:
|
|
71
73
|
|
|
@@ -103,7 +105,7 @@ V=0.1.0
|
|
|
103
105
|
mkdir -p tmp/release-archive
|
|
104
106
|
cp -a release/harness-reflex-0.1.0-alpha.2.tgz release/dsh-reflex-0.1.0-alpha.2.tgz \
|
|
105
107
|
release/SHA256SUMS tmp/release-archive/ 2>/dev/null || true
|
|
106
|
-
# 0.1.0
|
|
108
|
+
# 0.1.0 的插件产物名是 dsh-harness-reflex-0.1.0.tgz
|
|
107
109
|
(cd tmp/release-archive && sha256sum -c SHA256SUMS 2>/dev/null || true)
|
|
108
110
|
```
|
|
109
111
|
|
|
@@ -134,7 +136,7 @@ V=0.1.0
|
|
|
134
136
|
sha256sum release/*.tgz
|
|
135
137
|
(cd release && sha256sum -c SHA256SUMS)
|
|
136
138
|
tar -tzf release/harness-reflex-$V.tgz | wc -l
|
|
137
|
-
tar -tzf release/
|
|
139
|
+
tar -tzf release/dsh-harness-reflex-$V.tgz | wc -l
|
|
138
140
|
```
|
|
139
141
|
|
|
140
142
|
通过判据:`sha256sum -c` 两行 OK;把两个字节数、entry 数、sha256 抄进 release notes 与发布记录。**alpha.2 的旧指纹不得复用**。
|
|
@@ -151,10 +153,10 @@ rm -rf "$DSH_HOME" && mkdir -p "$DSH_HOME"
|
|
|
151
153
|
- [ ] 用 tarball 安装(同版本必须 `--force`):
|
|
152
154
|
|
|
153
155
|
```bash
|
|
154
|
-
dsh plugin --profile web add --force "$PWD/release/
|
|
156
|
+
dsh plugin --profile web add --force "$PWD/release/dsh-harness-reflex-$V.tgz"
|
|
155
157
|
```
|
|
156
158
|
|
|
157
|
-
通过判据:pnpm 安装成功;`dsh plugin` 输出 `+
|
|
159
|
+
通过判据:pnpm 安装成功;`dsh plugin` 输出 `+ dsh-harness-reflex 0.1.0`(或等价的 file: 链接)。
|
|
158
160
|
|
|
159
161
|
- [ ] 组合树里出现插件:
|
|
160
162
|
|
|
@@ -246,7 +248,7 @@ rm -rf "$DSH_HOME" && mkdir -p "$DSH_HOME"
|
|
|
246
248
|
```bash
|
|
247
249
|
git checkout main
|
|
248
250
|
git merge --no-ff integration/v0.1.0
|
|
249
|
-
git tag -a v0.1.0 -m "harness-reflex /
|
|
251
|
+
git tag -a v0.1.0 -m "harness-reflex / dsh-harness-reflex v0.1.0"
|
|
250
252
|
git push origin main && git push origin v0.1.0
|
|
251
253
|
```
|
|
252
254
|
|
|
@@ -265,7 +267,7 @@ rm -rf "$DSH_HOME" && mkdir -p "$DSH_HOME"
|
|
|
265
267
|
|
|
266
268
|
```bash
|
|
267
269
|
gh release create v0.1.0 -R miuzel/harness-reflex \
|
|
268
|
-
release/harness-reflex-0.1.0.tgz release/
|
|
270
|
+
release/harness-reflex-0.1.0.tgz release/dsh-harness-reflex-0.1.0.tgz release/SHA256SUMS \
|
|
269
271
|
--title "v0.1.0" --notes-file docs/release-notes-v0.1.0.md
|
|
270
272
|
diff <(gh release view v0.1.0 -R miuzel/harness-reflex --json body --jq .body) \
|
|
271
273
|
docs/release-notes-v0.1.0.md
|
|
@@ -273,7 +275,16 @@ rm -rf "$DSH_HOME" && mkdir -p "$DSH_HOME"
|
|
|
273
275
|
|
|
274
276
|
通过判据:release 创建成功;正文与真源逐字一致(仅末尾换行归一化)。
|
|
275
277
|
|
|
276
|
-
- [ ] registry(仅当 B4/B5 已关闭,**负责人 gate**):`npm login` → `npm whoami` 打印用户名 →
|
|
278
|
+
- [ ] registry(仅当 B4/B5 已关闭,**负责人 gate**):`npm login` → `npm whoami` 打印用户名 → 发布两个已验 tarball(非 scoped,**不加 `--access public`**):
|
|
279
|
+
|
|
280
|
+
```bash
|
|
281
|
+
npm publish ./release/dsh-harness-reflex-0.1.0.tgz
|
|
282
|
+
npm publish ./release/harness-reflex-0.1.0.tgz
|
|
283
|
+
npm view dsh-harness-reflex version # 期望 0.1.0
|
|
284
|
+
npm view dsh-harness-reflex dist.integrity # 与 release/SHA256SUMS 对账
|
|
285
|
+
```
|
|
286
|
+
|
|
287
|
+
通过判据:两条 `npm view` 与本地记录一致;若返回 `E403 Package name too similar`,按手册 §1.1 换名,不要重试。未关闭 B5 则**明确记录“本版不发布到 registry”**,不得含糊。
|
|
277
288
|
|
|
278
289
|
- [ ] awesome-dsh-plugin PR:按手册 §9 提交 `data/plugins/miuzel__harness-reflex.yml` 与重生成的 README;通过判据:PR 模板清单全部勾选,CI(仓库年龄/commits)通过。
|
|
279
290
|
|
|
@@ -21,19 +21,19 @@
|
|
|
21
21
|
|
|
22
22
|
| 主题 | dsh-graph | 本仓库(已核对) |
|
|
23
23
|
|---|---|---|
|
|
24
|
-
| 包结构 | 单包(`dsh-graph`,host/client 合并) | **双包**:根 `harness-reflex`(core + stdio MCP + CLI)+ `packages/dsh-reflex`(DSH 插件 + 客户端面板) |
|
|
24
|
+
| 包结构 | 单包(`dsh-graph`,host/client 合并) | **双包**:根 `harness-reflex`(core + stdio MCP + CLI)+ `packages/dsh-harness-reflex`(DSH 插件 + 客户端面板) |
|
|
25
25
|
| 打包入口 | `bash scripts/build.sh` + `dist/` + `pnpm pack/publish` | **`node scripts/release-pack.mjs`**(`npm run release:pack`),产物直接落 `release/*.tgz` |
|
|
26
|
-
| 产物 | `dsh-graph-<v>.tgz` 单包 | `release/harness-reflex-<v>.tgz` + `release/
|
|
26
|
+
| 产物 | `dsh-graph-<v>.tgz` 单包 | `release/harness-reflex-<v>.tgz` + `release/dsh-harness-reflex-<v>.tgz`(npm pack 命名)+ `SHA256SUMS` + `release-report.json` + `RELEASE-<v>.md` |
|
|
27
27
|
| 自检 | 冻结验收脚本 / dist freshness 测试 | **27 项自检**(构建新鲜度 2、产物/版本 4、结构审计 10、内容断言 4、安装冒烟 7) |
|
|
28
28
|
| 测试 | `scripts/run-tests.mjs` 等 | `npm test`(当前 113)、`npm run test:plugin`(当前 419)、`npm run test:mutation`(51/51) |
|
|
29
|
-
| 安装 | `dsh plugin --profile web add dsh-graph` | `dsh plugin --profile <p> add --force <tarball>`;同版本必须 `--force`(插件包名
|
|
29
|
+
| 安装 | `dsh plugin --profile web add dsh-graph` | `dsh plugin --profile <p> add --force <tarball>`;同版本必须 `--force`(插件包名 `dsh-harness-reflex`) |
|
|
30
30
|
| 健康检查 | `/api/dsh-graph` | `/dsh-reflex/api/health`(插件身份)+ `/dsh-reflex/api/panel`(快照:`systemOne` / `interventions` / `tools` 等) |
|
|
31
31
|
| 账本 | 看板/工具 | DSH 侧 `/reflex-ledger` 命令;MCP 侧 `reflex_status_ledger` 工具 |
|
|
32
32
|
| 工具面 | 单套 14 工具 | **两套**:MCP 8 工具;DSH 5 个可开关(默认 4,`route` 关),无 `reflex_prune` |
|
|
33
33
|
| 插件核心依赖 | 包内 `core/` 副本经 sync 脚本同步 | 插件 `dist/vendor/harness-reflex/**` 内联核心;tarball 安装**不依赖根包**(仅 zod/schemastery + Host peers) |
|
|
34
34
|
| 版本同步 | 单包 version + 常量 + 文档 | 已完成:根包/插件 `package.json`、`REFLEX_PLUGIN_VERSION`、两份指南、插件 README、`src/release-packaging.test.ts`、`package-lock.json`、重建 `client.js` |
|
|
35
|
-
| registry 现状 | 官方 registry 已发布过,仅登录态问题 | 根包名 `harness-reflex` 可用(404);**插件名 `dsh-reflex` 已被他人占用(0.3.0)** → 本版改用
|
|
36
|
-
| 推荐渠道 | 单包 registry 发布 | 0.1.0 两包都可发布到 npm;也可先走 **tarball / GitHub Release 直发**,registry
|
|
35
|
+
| registry 现状 | 官方 registry 已发布过,仅登录态问题 | 根包名 `harness-reflex` 可用(404);**插件名 `dsh-reflex` 已被他人占用(0.3.0)** → 本版改用 `dsh-harness-reflex`;登录态待负责人处理;包名 `dsh-harness-reflex` 已确认可用 |
|
|
36
|
+
| 推荐渠道 | 单包 registry 发布 | 0.1.0 两包都可发布到 npm;也可先走 **tarball / GitHub Release 直发**,registry 待负责人登录 |
|
|
37
37
|
| 发布正文模板 | 平台门禁指向 `docs/platform-gate.md` | 本仓库无该文件;平台结论直接写进 notes(Linux/WSL2 实测、Windows/macOS 未验证) |
|
|
38
38
|
| 商店前置 | 已有公开 repo / topic | 仓库尚未创建、无 remote/tag、无 awesome 条目;gh 已登录 `miuzel` |
|
|
39
39
|
|
|
@@ -70,14 +70,14 @@
|
|
|
70
70
|
| 文件 | 需要处理的引用 |
|
|
71
71
|
|---|---|
|
|
72
72
|
| `package.json` | ✅ `"version": "0.1.0"` |
|
|
73
|
-
| `packages/dsh-reflex/package.json` | ✅ `name:
|
|
74
|
-
| `packages/dsh-reflex/src/panel-api.ts` | ✅ `REFLEX_PLUGIN_VERSION = '0.1.0'` |
|
|
73
|
+
| `packages/dsh-harness-reflex/package.json` | ✅ `name: dsh-harness-reflex`、`version: 0.1.0` |
|
|
74
|
+
| `packages/dsh-harness-reflex/src/panel-api.ts` | ✅ `REFLEX_PLUGIN_VERSION = '0.1.0'` |
|
|
75
75
|
| `USER_GUIDE.md` | ✅ 标题、§13、安装命令、包名与工具面 |
|
|
76
76
|
| `docs/USER_GUIDE.en.md` | ✅ 同中文版;已 `npm run build:all` 重新内嵌 |
|
|
77
|
-
| `packages/dsh-reflex/README.md` | ✅ 包名、vendor 说明、安装命令 |
|
|
77
|
+
| `packages/dsh-harness-reflex/README.md` | ✅ 包名、vendor 说明、安装命令 |
|
|
78
78
|
| `src/release-packaging.test.ts` | ✅ 产物名按 manifest 版本动态生成 |
|
|
79
79
|
| `package-lock.json` | ✅ `npm install` 重新生成,根版本 `0.1.0` |
|
|
80
|
-
| `packages/dsh-reflex/client.js` | ✅ `npm run build:all` 重建(bundle id =
|
|
80
|
+
| `packages/dsh-harness-reflex/client.js` | ✅ `npm run build:all` 重建(bundle id = `dsh-harness-reflex`) |
|
|
81
81
|
| `docs/dsh-plugin.md` | ✅ 顶部现行口径 + 历史章节标注 + 版本/产物/路由更新 |
|
|
82
82
|
|
|
83
83
|
> 不存在的文件:本仓库没有 `pnpm-lock.yaml`(根用 `package-lock.json`,插件无独立 lock);没有 `CHANGELOG.md`;没有 `LICENSE` 文件(`package.json` 声明 MIT,发布前是否补 LICENSE 由负责人决定)。
|
|
@@ -89,7 +89,7 @@
|
|
|
89
89
|
| 文件 | entries | 体积 |
|
|
90
90
|
|---|---:|---:|
|
|
91
91
|
| `harness-reflex-0.1.0.tgz` | 73 | 219 KiB |
|
|
92
|
-
| `
|
|
92
|
+
| `dsh-harness-reflex-0.1.0.tgz` | 102 | 578 KiB |
|
|
93
93
|
|
|
94
94
|
根包 entry 数从 69 变为 73,是因为本次新增的 4 份 `docs/release-*.md` 会按 `files: ["docs/**/*.md"]` 进入根包;插件包不含这些文档,条目数不变。具体 sha256 见 `release/SHA256SUMS`。**不在文档里固化根包 hash**:文档本身在根包内,任何后续编辑都会改变它;0.1.0 以发布树实测为准。
|
|
95
95
|
|
|
@@ -102,5 +102,5 @@
|
|
|
102
102
|
2. ✅ 插件 `README.md` 已改为「运行时零 `harness-reflex` 依赖,核心 vendored 进 `dist/vendor`」。
|
|
103
103
|
3. ✅ `docs/dsh-plugin.md` 顶部新增现行口径,历史章节保留并标注以现行口径为准。
|
|
104
104
|
4. ✅ `package-lock.json` 已由 `npm install` 重新生成,根版本 `0.1.0`。
|
|
105
|
-
5. 仍待负责人决定:`packages/dsh-reflex/client.js` 是否入库(当前分支未跟踪,发布树必须先构建)。
|
|
105
|
+
5. 仍待负责人决定:`packages/dsh-harness-reflex/client.js` 是否入库(当前分支未跟踪,发布树必须先构建)。
|
|
106
106
|
6. ✅ `USER_GUIDE.md` §2 架构表已改为「5 个可开关工具,默认 4 个」。
|