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.
Files changed (121) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/README.md +103 -23
  3. package/USER_GUIDE.md +121 -43
  4. package/dist/adapters/agy.js +1 -1
  5. package/dist/adapters/agy.js.map +1 -1
  6. package/dist/adapters/codex.d.ts +133 -4
  7. package/dist/adapters/codex.js +325 -2
  8. package/dist/adapters/codex.js.map +1 -1
  9. package/dist/backend/defaults.d.ts +31 -0
  10. package/dist/backend/defaults.js +32 -0
  11. package/dist/backend/defaults.js.map +1 -0
  12. package/dist/backend/jev.js +6 -5
  13. package/dist/backend/jev.js.map +1 -1
  14. package/dist/backend/mock.d.ts +12 -1
  15. package/dist/backend/mock.js +34 -0
  16. package/dist/backend/mock.js.map +1 -1
  17. package/dist/backend/simple-jev.js +5 -4
  18. package/dist/backend/simple-jev.js.map +1 -1
  19. package/dist/backend/types.d.ts +34 -0
  20. package/dist/backend/types.js.map +1 -1
  21. package/dist/cli/index.js +5 -3
  22. package/dist/cli/index.js.map +1 -1
  23. package/dist/core/closing.d.ts +90 -0
  24. package/dist/core/closing.js +111 -0
  25. package/dist/core/closing.js.map +1 -0
  26. package/dist/core/evidence.d.ts +119 -0
  27. package/dist/core/evidence.js +209 -0
  28. package/dist/core/evidence.js.map +1 -0
  29. package/dist/core/judge.d.ts +221 -0
  30. package/dist/core/judge.js +251 -0
  31. package/dist/core/judge.js.map +1 -0
  32. package/dist/core/orchestrate-closing.d.ts +237 -0
  33. package/dist/core/orchestrate-closing.js +250 -0
  34. package/dist/core/orchestrate-closing.js.map +1 -0
  35. package/dist/core/orchestrate-correction.d.ts +209 -0
  36. package/dist/core/orchestrate-correction.js +141 -0
  37. package/dist/core/orchestrate-correction.js.map +1 -0
  38. package/dist/core/orchestrate-host.d.ts +225 -0
  39. package/dist/core/orchestrate-host.js +80 -0
  40. package/dist/core/orchestrate-host.js.map +1 -0
  41. package/dist/core/orchestrate-stagnation.d.ts +259 -0
  42. package/dist/core/orchestrate-stagnation.js +270 -0
  43. package/dist/core/orchestrate-stagnation.js.map +1 -0
  44. package/dist/core/orchestrate.d.ts +357 -0
  45. package/dist/core/orchestrate.js +418 -0
  46. package/dist/core/orchestrate.js.map +1 -0
  47. package/dist/core/policy.d.ts +122 -0
  48. package/dist/core/policy.js +102 -0
  49. package/dist/core/policy.js.map +1 -0
  50. package/dist/core/prune-plan.d.ts +141 -0
  51. package/dist/core/prune-plan.js +390 -0
  52. package/dist/core/prune-plan.js.map +1 -0
  53. package/dist/core/score.d.ts +2 -2
  54. package/dist/core/score.js.map +1 -1
  55. package/dist/core/text.d.ts +36 -0
  56. package/dist/core/text.js +66 -0
  57. package/dist/core/text.js.map +1 -0
  58. package/dist/hook/cli.d.ts +9 -0
  59. package/dist/hook/cli.js +52 -0
  60. package/dist/hook/cli.js.map +1 -0
  61. package/dist/hook/contract.d.ts +125 -0
  62. package/dist/hook/contract.js +159 -0
  63. package/dist/hook/contract.js.map +1 -0
  64. package/dist/hook/decision.d.ts +97 -0
  65. package/dist/hook/decision.js +955 -0
  66. package/dist/hook/decision.js.map +1 -0
  67. package/dist/hook/memory-store.d.ts +81 -0
  68. package/dist/hook/memory-store.js +157 -0
  69. package/dist/hook/memory-store.js.map +1 -0
  70. package/dist/hook/payload.d.ts +55 -0
  71. package/dist/hook/payload.js +129 -0
  72. package/dist/hook/payload.js.map +1 -0
  73. package/dist/hook/run.d.ts +48 -0
  74. package/dist/hook/run.js +218 -0
  75. package/dist/hook/run.js.map +1 -0
  76. package/dist/hook/store-port.d.ts +72 -0
  77. package/dist/hook/store-port.js +2 -0
  78. package/dist/hook/store-port.js.map +1 -0
  79. package/dist/index.d.ts +1 -0
  80. package/dist/index.js +1 -0
  81. package/dist/index.js.map +1 -1
  82. package/dist/ports/audit.d.ts +18 -0
  83. package/dist/ports/audit.js +11 -0
  84. package/dist/ports/audit.js.map +1 -0
  85. package/dist/ports/clock.d.ts +14 -0
  86. package/dist/ports/clock.js +11 -0
  87. package/dist/ports/clock.js.map +1 -0
  88. package/dist/ports/decision.d.ts +75 -0
  89. package/dist/ports/decision.js +2 -0
  90. package/dist/ports/decision.js.map +1 -0
  91. package/dist/ports/index.d.ts +14 -0
  92. package/dist/ports/index.js +2 -0
  93. package/dist/ports/index.js.map +1 -0
  94. package/dist/ports/log.d.ts +22 -0
  95. package/dist/ports/log.js +12 -0
  96. package/dist/ports/log.js.map +1 -0
  97. package/dist/ports/state.d.ts +46 -0
  98. package/dist/ports/state.js +13 -0
  99. package/dist/ports/state.js.map +1 -0
  100. package/dist/state/clock.d.ts +40 -0
  101. package/dist/state/clock.js +43 -0
  102. package/dist/state/clock.js.map +1 -0
  103. package/dist/state/file-store.d.ts +340 -0
  104. package/dist/state/file-store.js +849 -0
  105. package/dist/state/file-store.js.map +1 -0
  106. package/dist/state/paths.d.ts +41 -0
  107. package/dist/state/paths.js +73 -0
  108. package/dist/state/paths.js.map +1 -0
  109. package/docs/USER_GUIDE.en.md +79 -36
  110. package/docs/claude-code.md +281 -0
  111. package/docs/design/v0.2.0-harness-plugins.md +381 -0
  112. package/docs/design/v0.3.0-orchestration-unification.md +580 -0
  113. package/docs/dsh-plugin.md +54 -54
  114. package/docs/release-checklist-v0.1.0.md +32 -21
  115. package/docs/release-handbook-porting-notes.md +11 -11
  116. package/docs/release-handbook.md +55 -30
  117. package/docs/release-notes-v0.1.0.md +27 -14
  118. package/docs/release-notes-v0.3.0.md +152 -0
  119. package/docs/research/claude-code-harness.md +607 -0
  120. package/docs/research/pi-harness.md +621 -0
  121. package/package.json +16 -7
@@ -1,7 +1,7 @@
1
1
  # Harness Reflex 发布手册(0.1.0)
2
2
 
3
- > **适用范围**:本仓库 `harness-reflex`(根包)与 `packages/dsh-reflex`(DSH 宿主插件)的 0.1.0 发布。
4
- > **状态**:0.1.0 代码面已收口——两包版本 `0.1.0`、插件改名 `@miuzel/dsh-reflex`、文档统一口径、`release-pack` 27/27。
3
+ > **适用范围**:本仓库 `harness-reflex`(根包)与 `packages/dsh-harness-reflex`(DSH 宿主插件)的 0.1.0 发布。
4
+ > **状态**:0.1.0 代码面已收口——两包版本 `0.1.0`、插件改名 `dsh-harness-reflex`、文档统一口径、`release-pack` 27/27。
5
5
  > **0.1.0 尚未发布**:tag / npm publish / GitHub Release / 商店提交仍为**待负责人**的人工 gate。
6
6
  > **事实基准**:分支 `integration/v0.1.0` @ `9235039` + 本次 0.1.0 改动,核对日期 2026-10-21;环境 Node `v26.7.0`、npm `12.0.2`、pnpm `12.3.4`、dsh `0.2.1-rc.2`。
7
7
  > **移植来源**:`dsh-graph` 的 `docs/release-handbook.md`(388 行)。本手册沿用了它的**章节骨架与门禁思想**,但所有命令、产物、阻塞项均按本仓库重写;差异明细见 [`release-handbook-porting-notes.md`](release-handbook-porting-notes.md)。
@@ -26,10 +26,10 @@
26
26
  当前只完成了“流程与清单落纸”:
27
27
 
28
28
  - ✅ 打包链路、27 项自检、真机 tarball 安装链路已在本仓库实测;
29
- - ✅ 版本号已升到 `0.1.0`(两包 + 常量 + 测试/文档引用),插件包名为 `@miuzel/dsh-reflex`;
29
+ - ✅ 版本号已升到 `0.1.0`(两包 + 常量 + 测试/文档引用),插件包名为 `dsh-harness-reflex`;
30
30
  - ✅ 文档口径已统一为「MCP 8 / DSH 5 可开关(默认 4)/ 自动干预 / `/reflex-ledger`」;
31
31
  - ⏳ tag / npm publish / GitHub Release / 商店均未执行(人工 gate,见 §5/§7);
32
- - ⚠️ npm 发布仍需负责人解决**登录态**(B5)并复核 scoped 包是否已注册。
32
+ - ⚠️ npm 发布仍需负责人解决**登录态**(B5);插件包名 `dsh-harness-reflex` 已在 registry 确认可用(E404)。
33
33
 
34
34
  ---
35
35
 
@@ -39,20 +39,33 @@
39
39
 
40
40
  | # | 阻塞 / 前置项 | 归属 | 状态 | 证据 / 待办 |
41
41
  |---|---|---|---|---|
42
- | B1 | 版本号同步到 `0.1.0` | 本次执行 | ✅ **已完成** | 根 `package.json`、`packages/dsh-reflex/package.json`、`panel-api.ts`、lock、测试/文档引用全部为 `0.1.0` |
42
+ | B1 | 版本号同步到 `0.1.0` | 本次执行 | ✅ **已完成** | 根 `package.json`、`packages/dsh-harness-reflex/package.json`、`panel-api.ts`、lock、测试/文档引用全部为 `0.1.0` |
43
43
  | B2 | 打包与自检链路 | 本仓库 | ✅ **已具备** | `node scripts/release-pack.mjs` 实测 **27/27 checks passed**(2026-10-21,0.1.0) |
44
44
  | B3 | 真机安装 / 启动 / 面板 | 本仓库 | ✅ **已具备(0.1.0)** | 隔离 `DSH_HOME` + tarball `dsh plugin --profile web add --force` 成功;`/dsh-reflex/api/health` 返回 `{"ok":true,"name":"dsh-reflex","version":"0.1.0"}`;`/panel` 可读;`/reflex-ledger` 可执行 |
45
- | B4 | npm 包名 `dsh-reflex` 已被占用 → 改名 | 负责人复核 | ✅ **已决策并落地** | 插件包名改为 `@miuzel/dsh-reflex`;**发布前仍需负责人本机 `npm view @miuzel/dsh-reflex` 复核可用性**(scope 下是否已有同名包) |
45
+ | B4 | npm 插件包名最终定名 | 负责人 | ✅ **已决策并落地** | `dsh-reflex` 已被他人占用(0.3.0);最终采用社区惯例 `dsh-` 前缀 + 项目名,非 scoped 的 `dsh-harness-reflex`。主管已在 registry 确认 `npm view dsh-harness-reflex` 返回 E404(可用)。命名教训见 §1.1 |
46
46
  | B5 | npm 官方 registry 登录态 | 负责人(人工 gate) | ⚠️ **未登录** | `npm config get registry` = `https://registry.npmjs.org/`;`npm whoami` 返回 **E401**。发布前由负责人执行 `npm login` |
47
47
  | B6 | Git remote / tag / 公开仓库 | 负责人 | ⏳ 待办 | 当前 `git remote -v` 为空、`git tag -l` 为空;`gh` 已登录 `miuzel`,但 `miuzel/harness-reflex` 尚不存在(GraphQL Could not resolve) |
48
48
  | B7 | awesome-dsh-plugin / 商店收录 | 负责人(人工 gate) | ⏳ 待办 | `data/plugins/miuzel__harness-reflex.yml` 不存在(404);仓库未建,不满足“仓库 ≥1 天、commits ≥10”的 CI 条件 |
49
- | B8 | `packages/dsh-reflex/client.js` 未入库 | 负责人决策 | ⏳ 待办 | 该文件由 `npm run build:all` 生成、被插件 `files` 白名单收录,但当前分支未跟踪;发布树必须先构建。是否入库由负责人决定 |
50
- | B9 | 既有文档的旧表述 | 本次执行 | ✅ **已完成** | 根/插件 README、`docs/dsh-plugin.md`、`USER_GUIDE.md`、`docs/USER_GUIDE.en.md` 已统一为「MCP 8 / DSH 5(默认 4)/ 自动干预 / `/reflex-ledger`」,并更新 `@miuzel/dsh-reflex` 安装命令 |
49
+ | B8 | `packages/dsh-harness-reflex/client.js` 未入库 | 负责人决策 | ⏳ 待办 | 该文件由 `npm run build:all` 生成、被插件 `files` 白名单收录,但当前分支未跟踪;发布树必须先构建。是否入库由负责人决定 |
50
+ | B9 | 既有文档的旧表述 | 本次执行 | ✅ **已完成** | 根/插件 README、`docs/dsh-plugin.md`、`USER_GUIDE.md`、`docs/USER_GUIDE.en.md` 已统一为「MCP 8 / DSH 5(默认 4)/ 自动干预 / `/reflex-ledger`」,并更新 `dsh-harness-reflex` 安装命令 |
51
51
  | B10 | 平台验证范围 | 本仓库 | ⚠️ 部分 | 本轮只在 Linux/WSL2 实测;原生 Windows / macOS **本版未验证**,发布正文必须如实标注 |
52
- | B11 | `src/release-packaging.test.ts` 固定产物名 | 本次执行 | ✅ **已完成** | 已改为按 `root.version` / `plugin.version` 动态生成,scoped 包名使用 `miuzel-dsh-reflex-<version>.tgz` |
52
+ | B11 | `src/release-packaging.test.ts` 固定产物名 | 本次执行 | ✅ **已完成** | 已改为按 `root.version` / `plugin.version` 动态生成,插件包名使用 `dsh-harness-reflex-<version>.tgz` |
53
53
  | B12 | release notes 发布日期 | 负责人 | ⏳ 待办 | `docs/release-notes-v0.1.0.md` 日期为占位,发布时替换 |
54
54
 
55
- **结论**:0.1.0 可以走“**本地/附件 tarball 直发**”路径,当前无硬阻塞;也可以走 npm registry 发布 `harness-reflex` 与 `@miuzel/dsh-reflex`,前提是负责人先关闭 B5(登录)并复核 scoped 包名(B4)。
55
+ **结论**:0.1.0 可以走“**本地/附件 tarball 直发**”路径,当前无硬阻塞;也可以走 npm registry 发布 `harness-reflex` 与 `dsh-harness-reflex`,前提是负责人先关闭 B5(登录)。
56
+
57
+ ### 1.1 npm 命名教训(403 Package name too similar + 社区命名惯例)
58
+
59
+ 0.1.0 期间插件包名试过多个候选,最终定名 `dsh-harness-reflex`;其中一次候选被 registry 以“**过于相似**”直接拒绝:
60
+
61
+ - npm 不只看**同名**,还会对与既有包**过于相似**的名字直接返回 `E403 Package name too similar to existing package`。被拒的候选是 `dsh-system-one`,registry 上已有 `dsh-systemone`——**两者只差一个连字符**,`npm publish` 当场失败(不是等到发布后才发现)。
62
+ - 候选名规则(缺一不可):
63
+ 1. 先 `npm view <name> version`,**必须得到 404** 才算可用;有版本即被占用;
64
+ 2. 避免与既有包**仅差连字符 / 大小写 / 单复数 / 词序**(`foo-bar` vs `foobar` vs `foo-bar-s` 都算高风险);
65
+ 3. 被 registry 拒过一次的名字**不要反复重试**(同样的 403 会一直复现),直接换名并同步全仓;
66
+ 4. 优先跟社区惯例走:DSH 生态的插件包用 **`dsh-` 前缀 + 项目名**(如 `dsh-graph`),本项目最终即取 `dsh-harness-reflex`;命名风格与生态一致比短名更重要。
67
+ - 落地检查:改名后必须同时核对 `package.json.name`、`cordis.patch.yml` 模块名、client bundle id(由包名派生)、产物 tarball 名、`release/SHA256SUMS`、`release/RELEASE-0.1.0.md` 与全部文档;而 Cordis 插件 `id`、`/dsh-reflex/api/*`、`data-reflex-*`、locale、目录名这些**身份标识不随包名改**。
68
+ - 本仓库历史候选(**均已废弃,不得再用于产物**):`dsh-reflex`(被他人占用)、`dsh-system-one`(E403 过于相似)、`dsh-reflex-kit`(可用,但不符合 `dsh-` 前缀惯例,负责人定案前已弃用)。
56
69
 
57
70
  ---
58
71
 
@@ -60,7 +73,7 @@
60
73
 
61
74
  ### 2.1 当前元数据(核对自仓库)
62
75
 
63
- | 项 | 根包 `harness-reflex` | 插件包 `@miuzel/dsh-reflex` |
76
+ | 项 | 根包 `harness-reflex` | 插件包 `dsh-harness-reflex` |
64
77
  |---|---|---|
65
78
  | 版本 | `0.1.0` | `0.1.0` |
66
79
  | 入口 | `dist/index.js`;`bin.harness-reflex = dist/cli/index.js` | `dist/index.js`;Cordis `apply(ctx, config)` |
@@ -68,7 +81,7 @@
68
81
  | DSH 元数据 | — | `dsh.bundle.patch = ./cordis.patch.yml`;`dsh.client.platform = web`,`external = ['react']` |
69
82
  | 运行时依赖 | 无(`dependencies` 为空) | `@deepseek-ai/schemastery ~3.18.5-alpha.2`、`zod ^4.0.0`;Host 模块走 `peerDependencies`;核心 vendored 进 `dist/vendor/harness-reflex` |
70
83
  | 引擎 | `node >= 18` | `dsh < 0.2.2` |
71
- | 包名可用性 | npm 查询 404(可用) | scoped 名 `@miuzel/dsh-reflex`;未加 scope 的 `dsh-reflex` 已有他人 `0.3.0`(**不可用**) |
84
+ | 包名可用性 | npm 查询 404(可用) | 非 scoped 名 `dsh-harness-reflex`(E404 可用);`dsh-reflex` 已有他人 `0.3.0`(**不可用**) |
72
85
 
73
86
  插件包**不依赖根包的运行时安装**:`dist/vendor/harness-reflex/**` 已内联核心(打包核验的 102 个 entry 可见)。因此两个 tarball 可独立安装;插件仍需要 DSH Host 提供 `@deepseek-ai/*`。
74
87
 
@@ -77,15 +90,15 @@
77
90
  | 文件 | 处理 | 状态 |
78
91
  |---|---|---|
79
92
  | `package.json` | `version` → `0.1.0` | ✅ |
80
- | `packages/dsh-reflex/package.json` | `name` → `@miuzel/dsh-reflex`;`version` → `0.1.0` | ✅ |
81
- | `packages/dsh-reflex/src/panel-api.ts` | `REFLEX_PLUGIN_VERSION = '0.1.0'` | ✅ |
82
- | `packages/dsh-reflex/cordis.patch.yml` | `name` → `'@miuzel/dsh-reflex'`(`id` 保持 `dsh-reflex`) | ✅ |
83
- | `packages/dsh-reflex/src/client-bundle.ts` | `CLIENT_BUNDLE_ID` 从 `package.json.name` 派生(DSH loader 按包名注册) | ✅ |
93
+ | `packages/dsh-harness-reflex/package.json` | `name` → `dsh-harness-reflex`;`version` → `0.1.0` | ✅ |
94
+ | `packages/dsh-harness-reflex/src/panel-api.ts` | `REFLEX_PLUGIN_VERSION = '0.1.0'` | ✅ |
95
+ | `packages/dsh-harness-reflex/cordis.patch.yml` | `name` → `'dsh-harness-reflex'`(`id` 保持 `dsh-reflex`) | ✅ |
96
+ | `packages/dsh-harness-reflex/src/client-bundle.ts` | `CLIENT_BUNDLE_ID` 从 `package.json.name` 派生(DSH loader 按包名注册) | ✅ |
84
97
  | `USER_GUIDE.md` / `docs/USER_GUIDE.en.md` | 版本、包名、工具面、安装命令、路由 | ✅ |
85
- | `packages/dsh-reflex/README.md` / 根 `README.md` / `docs/dsh-plugin.md` | 同上 | ✅ |
86
- | `src/release-packaging.test.ts` | 按 manifest 版本/ scoped 名断言产物 | ✅ |
98
+ | `packages/dsh-harness-reflex/README.md` / 根 `README.md` / `docs/dsh-plugin.md` | 同上 | ✅ |
99
+ | `src/release-packaging.test.ts` | 按 manifest 版本与包名断言产物 | ✅ |
87
100
  | `package-lock.json` | `npm install` 重新生成,根版本 `0.1.0` | ✅ |
88
- | `packages/dsh-reflex/client.js` | `npm run build:all` 重建(bundle id = `@miuzel/dsh-reflex`) | ✅ |
101
+ | `packages/dsh-harness-reflex/client.js` | `npm run build:all` 重建(bundle id = `dsh-harness-reflex`) | ✅ |
89
102
 
90
103
  注意:**不要用 `npm version` 一步到位**——它会自动创建 commit/tag,而 tag 属于负责人 gate。建议 `npm pkg set version=0.1.0`。
91
104
 
@@ -115,7 +128,7 @@ npm run release # test:all + test:mutation + release:pa
115
128
  | 产物 | 说明 |
116
129
  |---|---|
117
130
  | `release/harness-reflex-<version>.tgz` | 根包:核心运行时、CLI、stdio MCP server、适配器、`dist/`、README、USER_GUIDE、`docs/`、`experiments/` 源码 |
118
- | `release/miuzel-dsh-reflex-<version>.tgz` | DSH 插件 `@miuzel/dsh-reflex`(scoped 包命名):`dist/`、内联核心 `dist/vendor/**`、`client.js`、`cordis.patch.yml`、`locale/` |
131
+ | `release/dsh-harness-reflex-<version>.tgz` | DSH 插件 `dsh-harness-reflex`(npm pack 命名):`dist/`、内联核心 `dist/vendor/**`、`client.js`、`cordis.patch.yml`、`locale/` |
119
132
  | `release/SHA256SUMS` | 两个 tarball 的 SHA-256 |
120
133
  | `release/release-report.json` | 逐项核验记录(含 entry 列表、sha256、冒烟结果) |
121
134
  | `release/RELEASE-<version>.md` | 由脚本生成的发布说明(机器产物,不是 release notes 真源) |
@@ -137,7 +150,7 @@ npm run release # test:all + test:mutation + release:pa
137
150
  | 文件 | entry 数 | 体积 |
138
151
  |---|---:|---:|
139
152
  | `harness-reflex-0.1.0.tgz` | 73 | 219 KiB |
140
- | `miuzel-dsh-reflex-0.1.0.tgz` | 102 | 578 KiB |
153
+ | `dsh-harness-reflex-0.1.0.tgz` | 102 | 578 KiB |
141
154
 
142
155
  (2026-10-21 在 `integration/v0.1.0` + 本次 0.1.0 改动上构建。)具体 sha256 由 `release-pack.mjs` 写入 `release/SHA256SUMS` 与 `release/release-report.json`;发布树重跑后以该文件为准。
143
156
 
@@ -165,7 +178,7 @@ npm run release # test:all + test:mutation + release:pa
165
178
  # 负责人执行
166
179
  git checkout main
167
180
  git merge --no-ff integration/v0.1.0
168
- git tag -a v0.1.0 -m "harness-reflex / @miuzel/dsh-reflex v0.1.0"
181
+ git tag -a v0.1.0 -m "harness-reflex / dsh-harness-reflex v0.1.0"
169
182
  git push origin main
170
183
  git push origin v0.1.0
171
184
 
@@ -199,18 +212,26 @@ sha256sum release/*.tgz
199
212
  理由:
200
213
 
201
214
  - 当前实测唯一完整跑通的安装路径是 `dsh plugin --profile <p> add --force <tarball>`;
202
- - 插件已改名 `@miuzel/dsh-reflex`(B4 落地),但 scoped 名是否已注册仍需负责人复核;
215
+ - 插件已改名非 scoped 的 `dsh-harness-reflex`(B4 落地,registry 已确认 E404 可用);
203
216
  - npm 登录态为 E401(B5),没有可用的发布凭据;
204
217
  - tarball 路径能保证“**被测产物 == 发布产物**”,sha256 可直接进 release notes。
205
218
 
206
- 发布方式:把 `release/harness-reflex-0.1.0.tgz`、`release/miuzel-dsh-reflex-0.1.0.tgz`、`release/SHA256SUMS` 作为 GitHub Release 附件;安装文档写 tarball 命令。
219
+ 发布方式:把 `release/harness-reflex-0.1.0.tgz`、`release/dsh-harness-reflex-0.1.0.tgz`、`release/SHA256SUMS` 作为 GitHub Release 附件;安装文档写 tarball 命令。
207
220
 
208
221
  ### 5.2 registry 发布(已就绪,待负责人 gate)
209
222
 
210
223
  - 根包 `harness-reflex`:npm 查询 404,名字可用;受 B5 登录态限制。
211
- - 插件包 `@miuzel/dsh-reflex`:scoped 名已落地(`package.json`、`cordis.patch.yml`、安装命令、文档均已同步)。
212
- 发布前由负责人执行 `npm view @miuzel/dsh-reflex` 复核;若 scope 下已存在同名包,退回只发根包、插件继续 tarball 分发。
213
- - 若发布,建议 `npm publish ./release/<tarball>`(直发已验字节),不要 `cd dist && npm publish`;发布后核对 `npm view <pkg> dist.integrity` 与本地记录。
224
+ - 插件包 `dsh-harness-reflex`:非 scoped 名已落地(`package.json`、`cordis.patch.yml`、安装命令、文档均已同步),registry 已确认 E404 可用。
225
+ 发布前由负责人再执行一次 `npm view dsh-harness-reflex` 复核;若已被占用,退回只发根包、插件继续 tarball 分发。
226
+ - 若发布,直发已验字节的 tarball(不要 `cd dist && npm publish`);`dsh-harness-reflex` 与 `harness-reflex` 都是**非 scoped** 名,**不需要 `--access public`**:
227
+
228
+ ```bash
229
+ npm publish ./release/dsh-harness-reflex-0.1.0.tgz
230
+ npm publish ./release/harness-reflex-0.1.0.tgz
231
+ npm view dsh-harness-reflex dist.integrity # 与 release/SHA256SUMS 对账
232
+ ```
233
+
234
+ - 若 `npm publish` 返回 `E403 Package name too similar`,按 §1.1 直接换名,不要重复重试。
214
235
  - 登录 gate(本次未执行):
215
236
 
216
237
  ```bash
@@ -226,7 +247,7 @@ npm whoami --registry=https://registry.npmjs.org/ # 必须打印用户名
226
247
 
227
248
  ```bash
228
249
  gh release create v0.1.0 -R miuzel/harness-reflex \
229
- release/harness-reflex-0.1.0.tgz release/miuzel-dsh-reflex-0.1.0.tgz release/SHA256SUMS \
250
+ release/harness-reflex-0.1.0.tgz release/dsh-harness-reflex-0.1.0.tgz release/SHA256SUMS \
230
251
  --title "v0.1.0" --notes-file docs/release-notes-v0.1.0.md
231
252
  ```
232
253
 
@@ -254,7 +275,7 @@ export DSH_HOME="$PWD/tmp/dsh-pub-check"
254
275
  rm -rf "$DSH_HOME" && mkdir -p "$DSH_HOME"
255
276
 
256
277
  # 1) 装 tarball;同版本必须 --force
257
- dsh plugin --profile web add --force "$PWD/release/miuzel-dsh-reflex-0.1.0.tgz"
278
+ dsh plugin --profile web add --force "$PWD/release/dsh-harness-reflex-0.1.0.tgz"
258
279
 
259
280
  # 2) profile 组合里出现插件(config: {} 为默认配置)
260
281
  dsh --profile web --dump-config | grep -A2 -- '- id: dsh-reflex'
@@ -328,7 +349,11 @@ description:
328
349
  - [ ] 仓库已打 `dsh-plugin` topic;
329
350
  - [ ] 建议附截图(`data/screenshots.json`)。
330
351
 
331
- **当前状态**:未提交。registry 发布不是上架的硬前提,但商店通常更偏好可 `npm install` 的包;若 B4 未解决,PR 需在描述中说明 tarball 安装方式,并接受维护者可能要求先解决包名问题。
352
+ **当前状态(2026-10-22)**:已提交 PR #8539(awesome-dsh-plugin/awesome-dsh-plugin)。
353
+
354
+ - 条目:`data/plugins/miuzel__harness-reflex--packages-dsh-reflex.yml`(**历史提交名,按旧目录名派生,刻意保留**;目录更名后如重新提交应改为 `--packages-dsh-harness-reflex.yml`),`url` 指向 `tree/main/packages/dsh-harness-reflex`,`name` 为 `miuzel/harness-reflex#dsh-reflex`,`category: tools`,附 `tarball` 指向 v0.1.0 Release 资产;
355
+ - 本地 `check-submission.mjs` 仅剩**仓库年龄**未过(需 1 天,创建于 2026-10-21T15:16Z,约 2026-10-22T15:16Z 自动清除,无需重提);
356
+ - 教训:单仓多包时条目必须指向**声明 `dsh.bundle` 的子包目录**,文件名用 `<owner>__<repo>--packages-<dir>.yml`;指向仓库根会被判为"装了也没有行为"。registry 发布不是上架的硬前提,但商店通常更偏好可 `npm install` 的包;若 B4 未解决,PR 需在描述中说明 tarball 安装方式,并接受维护者可能要求先解决包名问题。
332
357
 
333
358
  ---
334
359
 
@@ -1,9 +1,9 @@
1
- # Harness Reflex v0.1.0 发布记录(草稿)
1
+ # Harness Reflex v0.1.0 发布记录
2
2
 
3
- > **状态:草稿**。发布日期、产物指纹、最终测试计数在发布树实测后填入;正文以本文件为唯一真源。
4
- > 基线:`integration/v0.1.0` @ `9235039` + 本次 0.1.0 改动,2026-10-21。
3
+ > **状态:已发布**(2026-10-21)。正文以本文件为唯一真源;产物指纹见文末。
4
+ > 基线:`main` @ `2d43a42`,tag `v0.1.0`。
5
5
 
6
- ## v0.1.0 — 待定(发布日期由负责人确认)
6
+ ## v0.1.0 — 2026-10-21
7
7
 
8
8
  - **自动干预四能力落地**:`stagnation`、`prune`、`gate`、`closing` 可在**模型没有调用任何工具**时由宿主钩子介入;`off` / `observe` / `active` 三态,每个能力还可单独用 `off` / `observe` / `active` / `inherit` 覆盖。`observe` 只记账不执行,`active` 才会拒绝重复调用、改写超长结果、把失败改写为纠正反馈、在收尾时对证据冲突提出异议。后台作业等待(`job_output` / `job_list`)按结构化形态豁免,不会被误判为停滞。
9
9
  - **System One 逐段剪枝**:超过 `pruneJudgeMinChars`(默认 10 000 字符)的输出会按段交给 System One 判定取舍,而不是只做首尾截断;判定候选低于 `pruneFloorRatio`(默认 0.5)时用首尾上下文补足,并保留判定选中的中间诊断。原文先写入会话日志(`plugin:dsh-reflex/pruned-original`)再替换,替换文本带 `plugin:dsh-reflex/pruned-original#<digest>` 定位符,可用 `readPrunedOriginal()` 逐字节取回;保留失败则不替换、不虚报节省。
@@ -16,35 +16,48 @@
16
16
  ### 安装 / 升级
17
17
 
18
18
  ```bash
19
- # 插件(本版包名 @miuzel/dsh-reflex;scoped 包 tarball 命名为 miuzel-dsh-reflex-0.1.0.tgz)
20
- dsh plugin --profile web add --force ./miuzel-dsh-reflex-0.1.0.tgz
19
+ # 插件(本版包名 dsh-harness-reflex;tarball 命名为 dsh-harness-reflex-0.1.0.tgz)
20
+ dsh plugin --profile web add --force ./release/dsh-harness-reflex-0.1.0.tgz
21
21
  # 根包(MCP 面)
22
22
  npm install ./harness-reflex-0.1.0.tgz
23
23
  ```
24
24
 
25
25
  - **同版本号重装必须 `--force`**;
26
26
  - 本版无数据迁移;账本 JSONL 只追加,旧记录可直接读取;
27
- - 0.1.0 计划两个包都发布:根包 `harness-reflex` 与插件 `@miuzel/dsh-reflex`;也可先走 **tarball / GitHub Release**。
28
- npm 上未加 scope 的 `dsh-reflex` 已被第三方 `onesmash@0.3.0` 占用,因此插件使用 `@miuzel/dsh-reflex`;
29
- 发布前仍需负责人本机 `npm view @miuzel/dsh-reflex` 复核并完成 `npm login`。
27
+ - 0.1.0 计划两个包都发布:根包 `harness-reflex` 与插件 `dsh-harness-reflex`;也可先走 **tarball / GitHub Release**。
28
+ npm 上 `dsh-reflex` 已被第三方 `onesmash@0.3.0` 占用,因此插件改用非 scoped 的 `dsh-harness-reflex`(registry 已确认 E404 可用);
29
+ 发布前仍需负责人完成 `npm login`。
30
30
 
31
31
  ### 验证与产物
32
32
 
33
33
  - **发布产物**(发布树实测;完整 SHA-256 记在 `release/SHA256SUMS` 与 `release/RELEASE-0.1.0.md`):
34
34
  - `harness-reflex-0.1.0.tgz`:**73 entries**,约 **219 KiB**;根包内含本文档,任何文档编辑都会改变其字节,
35
35
  因此不在正文固化 sha256;
36
- - `miuzel-dsh-reflex-0.1.0.tgz`:**102 entries**,约 **578 KiB**;
36
+ - `dsh-harness-reflex-0.1.0.tgz`:**102 entries**,约 **578 KiB**;
37
37
  - `SHA256SUMS` 随 Release 附件发布;连续两次打包 sha256 一致。
38
38
  - **打包核验**:`scripts/release-pack.mjs` **27/27** 通过(结构审计、零死链、零未声明依赖、根包离线安装、`bin`、具名 import、stdio MCP 8 工具、插件 `apply()` 与检索 API)。
39
39
  - **测试**(本次 0.1.0 工作树):根包 113 pass / 0 fail;插件 419 pass / 0 fail;负向对照 51/51 注入故障被抓(50 测试 + 1 编译器);三套 `--noEmit` exit 0。
40
- - **平台真机门禁**:Linux/WSL2 已实测(隔离 `DSH_HOME` + scoped tarball 安装 + `/dsh-reflex/api/health` 返回 `{"ok":true,"name":"dsh-reflex","version":"0.1.0"}` + `/panel` 可读);原生 Windows、macOS **本版未验证**。
40
+ - **平台真机门禁**:Linux/WSL2 已实测(隔离 `DSH_HOME` + tarball 安装 + `/dsh-reflex/api/health` 返回 `{"ok":true,"name":"dsh-reflex","version":"0.1.0"}` + `/panel` 可读);原生 Windows、macOS **本版未验证**。
41
41
  - **发布记录**:详见 [`docs/release-checklist-v0.1.0.md`](release-checklist-v0.1.0.md)。
42
42
  - **可复现性**:同一构建树连续两次打包 sha256 一致;从 tag 发布树重新构建后需重新记录指纹。
43
43
 
44
44
  ### 已知限制
45
45
 
46
- - 未加 scope 的 npm 包名 `dsh-reflex` 已被他人占用(`onesmash@0.3.0`),本版改用 `@miuzel/dsh-reflex`;scoped 名可用性与 `npm login` 仍由负责人在发布前复核。
47
- - 仓库尚未配置 remote、尚未创建公开仓库/tag;商店(awesome-dsh-plugin)未提交。
48
- - `active` 模式下的 14.5K 剪枝已由自动化测试覆盖,但本轮尚未在真实会话手工复验一次;发布前按清单 §5 补做。
46
+ - 未加 scope 的 npm 包名 `dsh-reflex` 已被他人占用(`onesmash@0.3.0`),本版改用 `dsh-harness-reflex`;非 scoped 包名已确认可用(E404),`npm login` 仍由负责人在发布前完成。
47
+ - 公开仓库与 tag 已创建:https://github.com/miuzel/harness-reflex/releases/tag/v0.1.0 ;商店(awesome-dsh-plugin)尚未提交。
48
+ - `active` 模式下的 14.5K 剪枝已在真实会话手工验证过一次(14534 → 6766 字符,省 1942 tokens,定位符可见)。
49
49
  - 根 `README.md`、插件 `README.md`、`docs/dsh-plugin.md`、`USER_GUIDE.md` 及英文版已统一口径:
50
50
  MCP 8 工具 / DSH 5 个可开关(默认 4,`route` 关)/ 剪枝与停滞为自动干预 / 账本用 `/reflex-ledger`。
51
+
52
+ ## 产物指纹
53
+
54
+ | 包 | 文件 |
55
+ |---|---|
56
+ | 插件 | `dsh-harness-reflex-0.1.0.tgz` |
57
+ | 核心/MCP | `harness-reflex-0.1.0.tgz` |
58
+
59
+ 以 `release/SHA256SUMS` 与 GitHub Release 附件说明里的 sha256 为准:文档本身随根包发布,把指纹写进文档会让每次回填都改变产物哈希(自指循环),因此这里不再写死数值。
60
+
61
+ ## 从 0.1.0-alpha.2 升级
62
+
63
+ 插件 npm 包名已改为 `dsh-harness-reflex`。旧的 `dsh-reflex` 安装与新包是**两个不同插件**,配置不会自动迁移:安装新包后需要重新配置一次(System 1 后端与 API Key、干预模式、虚拟 Provider 候选池、工具开关)。
@@ -0,0 +1,152 @@
1
+ # Harness Reflex v0.3.0 发布说明(草稿)
2
+
3
+ > **状态:发布就绪,未发布**。本文件是 GitHub Release 正文的真源;npm publish / tag / push / GitHub Release
4
+ > 均**未执行**,属负责人人工 gate。产物指纹见 `release/SHA256SUMS`。
5
+ > 基线:分支 `0.3.0-harnesses`。
6
+
7
+ ## v0.3.0 — 五个 Harness
8
+
9
+ 0.1.0 只覆盖 Claude Code 与 DSH。0.3.0 把同一套 System One 决策引擎接进了 **Codex CLI、pi、Kimi Code、
10
+ OpenCode** 四个新宿主,并做了一次前置重构;五个宿主包与核心包统一为 `0.3.0`。
11
+
12
+ ### 本次新增的四个 Harness 插件
13
+
14
+ | 包 | 宿主 | 形态 |
15
+ | --- | --- | --- |
16
+ | `packages/codex-reflex/` | Codex CLI 0.163.0+ | 配置包:`hooks.json`(12 个事件)+ `config.toml`(MCP server) |
17
+ | `packages/pi-reflex/` | pi 1.x | 进程内 TypeScript 扩展,零运行时依赖;`pi.extensions` 直接加载 `src/index.ts` |
18
+ | `packages/kimi-reflex/` | Kimi Code CLI | 配置包:`hooks.toml` + `hooks/reflex-stop-exit2.sh` shim + `mcp.json` |
19
+ | `packages/opencode-reflex/` | OpenCode | JS 插件 `plugin/reflex.js` + `opencode.json` |
20
+
21
+ 已有的 `packages/claude-reflex/`(Claude Code)与 `packages/dsh-harness-reflex/`(DSH)随之一起升版。
22
+
23
+ ### 前置重构:`HookDecision` 与 `hook/decision.ts`
24
+
25
+ 四个新宿主的钩子接入暴露出一个问题:宿主之间差异很大(事件名、payload 形状、stdout 契约、能否阻断),
26
+ 而决策规则只有一套。重构把**宿主差异**收进各自的适配层(如 `pi-adapter.ts`、`codex-events.ts`),
27
+ 决策本身收敛在 `src/hook/decision.ts` 的 `HookDecision` 一个类里:
28
+
29
+ - 各宿主只负责把自家 payload 归一化成统一事件、再把统一定策翻译回宿主能读的 stdout;
30
+ - 一条决策规则只在一处修改,所有宿主同时生效(`src/hook/parity.test.ts` 守住这层等价性);
31
+ - `hook/run.ts` 是唯一入口:`harness-reflex hook <event>`,十八个事件共用一个 CLI 子命令。
32
+
33
+ ### 五个 Harness 能力对照表
34
+
35
+ **能力并不对等**:宿主没给出对应钩子时,该能力就是做不到。「✅」只表示在模型侧真实生效。
36
+
37
+ | 能力 | Claude Code | DSH | Codex CLI | pi | Kimi Code | OpenCode |
38
+ |---|---|---|---|---|---|---|
39
+ | `reflex_*` 工具 | ✅ 8 个 MCP | ✅ 5 个可开关(默认 4) | ⚠️ 8 个已声明,本机未进回合内工具清单 | ✅ 进程内 | ⚠️ 8 个已声明,未真机验证 | ⚠️ 8 个已声明,未真机验证 |
40
+ | 停滞拦截 | ✅ 拒绝 | ✅ 自动 | ✅ 拒绝 | ✅ 拒绝 | ✅ 拒绝 | ✅ 抛错拒绝 |
41
+ | 结果剪枝 | ✅ | ✅ 自动 | ⚠️ **仅 MCP 工具输出,shell 输出改不了** | ✅ | ❌ **只记账不生效** | ✅ |
42
+ | 失效纠偏 | ✅ | ✅ 自动 | — | ✅ | ❌ 只记账 | ❌ 宿主无此钩子 |
43
+ | 收尾阻断 | ✅ **真阻断** | ✅ **真阻断** | ✅ 可 block | ⚠️ **只续跑一次,永不阻断**(`closing-degraded-pass`) | ⚠️ 需 exit-2 shim | ❌ **无法拦截** |
44
+ | 接入形态 | hooks + MCP | 进程内 Cordis 插件 | hooks.json + config.toml | 进程内 TS 扩展 | hooks.toml + shim | JS 插件(无 shell 钩子机制) |
45
+
46
+ 四条必须如实说明的例外:
47
+
48
+ 1. **Codex**:`PostToolUse` 只接受 `updatedMCPToolOutput` 一个决定字段,且只对 MCP 工具生效;
49
+ **shell(`exec_command`)的结果无法改写**。这是宿主契约,不是接线缺陷。`reflex_prune` 仍可由模型主动调用。
50
+ 2. **Kimi**:`PostToolUse` / `PostToolUseFailure` / `SubagentStop` 是 observation-only——宿主忽略返回值,
51
+ 判定只写进账本,改变不了模型看到的内容;**剪枝只记账不生效**。`Stop` 需经
52
+ `hooks/reflex-stop-exit2.sh` 把 `decision:"block"` 转成 exit 2 才能阻断。
53
+ 3. **OpenCode**:宿主没有 shell 钩子机制,唯一扩展点是 JS 插件。剪枝与停滞**生效**;但 **Stop 无法拦截**
54
+ (`session.idle` 不带助手文本,也没有插件级否决权,异议只写 `warn` 日志)。
55
+ 4. **pi**:没有任何 API 能拒绝结束回合;`agent_before_settle` 只能请求**一次**续跑。矛盾未被纠正时放行并记
56
+ `closing-degraded-pass`——**pi 永不写 `closing-block`**。
57
+
58
+ ### 已知限制与未验证项(逐条,不省略)
59
+
60
+ **未验证 —— 不得声称已支持:**
61
+
62
+ - **Kimi Code 整机未验证**:本机没有 `kimi` 可执行文件,没有任何钩子被 Kimi 真实触发过。已验证的是配置形状、
63
+ 事件名、payload 归一化与 stdout 契约(离线,`npm run test:kimi-plugin`,12 项)。
64
+ - **OpenCode 整机未验证**:插件加载、`tool.execute.before` 抛错是否真的中止调用、`output.output` 替换是否真的
65
+ 改变模型所见,均未在真实 OpenCode 上观察(离线 14 项)。
66
+ - **Codex 回合内 MCP 工具未验证**:server 定义能被 `codex mcp list --json` 读到,但 MCP 进程从未在本机启动,
67
+ 8 个工具从未进入回合内的工具清单;`tools/list` 是对 `harness-reflex mcp` 直接验证的,属根包契约、不是 Codex 的。
68
+ - **Codex 回合内剪枝未验证**:本机无可用模型端点,`PostToolUse` 的剪枝决定从未被观察到送达真实模型。
69
+ - **Codex 的 Stop 拦截**未对真实模型的完成声明验证过(阻断机制本身已验证)。
70
+ - **平台**:只在 Linux/WSL2 实测;原生 Windows 与 macOS 本版**未验证**。
71
+
72
+ **已知限制:**
73
+
74
+ - Codex 的 `hooks.json` 只从 **`$CODEX_HOME`** 加载;项目内 `hooks.json` 实测不触发(项目级路径未单独复现)。
75
+ - Codex `Stop` 的 `decision:"block"` 会被无可见上限地重试(探针数到 900+ 次),必须在 `stop_hook_active`
76
+ 为 true 时停止阻断——本运行时已遵守。
77
+ - Codex 的 `SessionEnd` 超时被宿主编排钳到 3 秒。
78
+ - Codex / Kimi / OpenCode 的 hooks 里 `args` 字段会被静默丢弃,事件名必须写进 `command` 本身。
79
+ - Kimi Code 只读**用户级** `config.toml`,没有项目级 hook 文件;`[[hooks]]` 只接受四个字段,多一个整份配置加载失败。
80
+ - OpenCode 每次拦截起一个短进程(与命令钩子同代价)。
81
+ - pi 需要 `>= 22.19.0`(根包为 `>= 18`);其 `package.json` 的 `pi.extensions` 指向源码 `./src/index.ts`,
82
+ 即**发布会直接发 TypeScript 源码**,由 pi 自己加载。
83
+
84
+ ### DSH 插件:全新配置默认带一条可用的 JEV 官方连接(g-067)
85
+
86
+ 此前 DSH 插件装上后 System 1 后端是「未配置」:页面列表为空、什么都不连,用户得先手填一条连接。
87
+ 现在**全新的设置文档**出厂就带一条已经激活的连接:
88
+
89
+ | 字段 | 出厂值 | 来源 |
90
+ | --- | --- | --- |
91
+ | 名称 | `JEV official` | 普通连接配置,和用户自己加的一条没有区别 |
92
+ | URL | `https://api.typesafe.ai/v1/systemone` | 项目官方默认(`DEFAULT_SYSTEMONE_ENDPOINT`),不是另抄一份字面量 |
93
+ | 模型 | `jev-latest` | 同上 |
94
+ | 实现 | 显式绑定 `jev` | 不由 `auto` 按环境变量挑选 |
95
+ | 凭据 | 只写变量名 `JEV_API_KEY` | 密钥值永不写入设置文档 |
96
+
97
+ 「实现」这一行是独立评审阻塞后的修正:只写 URL 不够。`auto` 会交给 vendored factory,而它按
98
+ `SYSTEM_ONE_BACKEND` / `REFLEX_BACKEND` 和 `VLLM_BASE_URL` / `OPENAI_BASE_URL` 挑实现——导出两个环境变量,
99
+ 出厂连接就会把 `JEV_API_KEY` 发到一个没人配置过的 vLLM 地址,而页面的「测试连接」仍测官方 URL、显示绿灯。
100
+ 现在出厂连接自带实现选择,环境无法改道;「测试连接」与运行时也改用同一个实现解析(`auto` 才读环境),
101
+ 两者不会再各说各话。顶层显式 `mock` / `vllm` 仍然生效:前者只在进程内作答、不开 socket,后者只说协议。
102
+
103
+ 它由 `Config` 的 schema 默认值提供,而 schemastery 的默认值**只在键缺失时生效**,所以「全新」与
104
+ 「用户说过话」的区分完全由这条规则决定:
105
+
106
+ - **停用/删除**:删掉那一行、或改名换成自己的连接,文档里就有了 `systemOne` 块,默认值不再参与——不会被覆盖回来;
107
+ - **没有 `JEV_API_KEY`**:点名即锁定(g-059),连接报「已点名但变量为空」且**不借用** `SYSTEM_ONE_API_KEY` /
108
+ `VLLM_API_KEY` / `OPENAI_API_KEY`,也不会偷偷回退到本地启发式 mock;
109
+ - **显式清空**:页面从不把 `systemOne.active` 或最后一行写成「unset」——那会让 Host 把整段重建成 `{}`,
110
+ 读起来又变回全新文档、把出厂行复活。清空一律写成显式空值。
111
+
112
+ ### 升级说明(0.1.0 → 0.3.0)
113
+
114
+ - **版本**:根包 `harness-reflex`、`dsh-harness-reflex`、`claude-reflex` 以及新增四包统一 `0.3.0`;
115
+ lockfile 与 `REFLEX_PLUGIN_VERSION` 同步。
116
+ - **0.2.0 未发布**,直接跳到 `0.3.0`:`0.2.0-test` 线上的 Claude Code 接入已随 0.3.0 一并发布。
117
+ - **DSH 插件重装必须 `--force`**(同版本号重装不会静默覆盖)。
118
+ - **无数据迁移**:账本 JSONL 只追加,旧记录可直接读取;配置字段无破坏性变更,`0.1.0` 的配置可继续使用。
119
+ - **新增可选依赖**:四个宿主包各自独立,未安装某个宿主则不受影响。
120
+ - 旧的 `dsh-reflex` 安装(0.1.0-alpha 时期)与新包仍是两个插件,配置不自动迁移。
121
+
122
+ ```bash
123
+ # DSH 插件
124
+ dsh plugin --profile web add --force ./release/dsh-harness-reflex-0.3.0.tgz
125
+ # 根包(MCP 面)
126
+ npm install ./release/harness-reflex-0.3.0.tgz
127
+ ```
128
+
129
+ ### 验证与产物
130
+
131
+ 基线 `91e320a` 上的七个测试套件全绿:root 234 / plugin 423 / claude 8 / codex 5 / pi 25 / kimi 12 /
132
+ opencode 14,mutation 51/51,pi 真机 e2e 10/10。
133
+
134
+ `node scripts/release-pack.mjs` → **53/53 checks passed**,7 个 tarball:
135
+ `harness-reflex-0.3.0.tgz`(147 项)、`dsh-harness-reflex-0.3.0.tgz`(138 项)、
136
+ `harness-reflex-claude-code-0.3.0.tgz`(7)、`harness-reflex-codex-0.3.0.tgz`(4)、
137
+ `pi-reflex-0.3.0.tgz`(106)、`harness-reflex-kimi-code-0.3.0.tgz`(6)、
138
+ `harness-reflex-opencode-0.3.0.tgz`(5)。
139
+
140
+ 指纹以 `release/SHA256SUMS` 为准:文档随根包发布,把哈希写进文档会造成自指循环。
141
+
142
+ ## 产物指纹
143
+
144
+ | 包 | 文件 |
145
+ |---|---|
146
+ | 核心/MCP | `harness-reflex-0.3.0.tgz` |
147
+ | DSH 插件 | `dsh-harness-reflex-0.3.0.tgz` |
148
+ | Claude Code | `harness-reflex-claude-code-0.3.0.tgz` |
149
+ | Codex | `harness-reflex-codex-0.3.0.tgz` |
150
+ | pi | `pi-reflex-0.3.0.tgz` |
151
+ | Kimi Code | `harness-reflex-kimi-code-0.3.0.tgz` |
152
+ | OpenCode | `harness-reflex-opencode-0.3.0.tgz` |