@feng0531/dsh-execution-bus 0.11.2 → 0.11.3

package/README.md

@@ -4,7 +4,7 @@
 
 “萧何”是产品与模式显示名，执行总线是其技术功能；不新增人物 Agent，不进行角色扮演。仓库 dsh-execution-bus、npm 包名、execution_bus 工具名及 execution-bus-test 预设 ID 保持不变。历史版本发布说明保留当时名称。
 
-DSH 独立插件：`@feng0531/dsh-execution-bus` · 当前版本 **0.11.2**
+DSH 独立插件：`@feng0531/dsh-execution-bus` · 当前版本 **0.11.3**
 
 > 萧何模式从宿主已声明的 PTC 组合派生，保留日常工具，再叠加可选执行总线。已验证隔离的真实 Node PTC → 原 read + 总线调用，以及脚本模型内存会话；真实模型、桌面界面与实际沙箱仍未验收。**不支持重启后恢复任务。**
 
@@ -130,7 +130,7 @@ flowchart TD
 2. 在你选定的隔离 DSH 配置依赖目录安装固定版本，不要在 DSH 程序安装目录执行：
 
    ```powershell
-   npm install --ignore-scripts @feng0531/dsh-execution-bus@0.11.2
+   npm install --ignore-scripts @feng0531/dsh-execution-bus@0.11.3
    ```
 
    这是 npm 目录示例。若目标配置使用 pnpm，应沿用其包管理器，不混用锁文件。遇到宿主 peer 版本冲突就停止，不用强制安装绕过。
@@ -280,7 +280,7 @@ npm run test:install    # 临时目录安装，不操作日常 DSH
 
 - [协议和投递语义](<docs/protocol.md>)：字段、状态、重复处理与取消规则。
 - [宿主兼容性与源码调用链](<docs/host-compatibility.md>)：为什么可以等待，为什么不能跨重启恢复。
-- [验证记录](<docs/validation.md>)、[0.11.2 发布说明](<docs/releases/0.11.2.md>)：已验证与未验证范围。
+- [验证记录](<docs/validation.md>)、[0.11.3 发布说明](<docs/releases/0.11.3.md>)：已验证与未验证范围。
 - [同类项目源码整合](<docs/INTEGRATION.md>)：固定来源、采用范围、许可与验证边界。
 - [维护者发布流程](<docs/RELEASING.md>)：标签 CI、安装包校验与正式发布门禁。
 

package/docs/releases/0.11.3.md

@@ -0,0 +1,30 @@
+# 萧何 / Xiao He 0.11.3
+
+## 证据补记：收益导向 vs 总线优先 A/B 对照
+
+本版只补记验证证据与文档，不改变行为、协议或提示。
+
+- **背景**：0.11.0 起默认采用收益导向触发。为验证“总线优先”是否值得作为第二预设，用同一版本（0.11.2）、同一模型、同一组 5 类任务、各 5 个全新子代理会话做**指引级对照**：A 臂=当前可选触发，B 臂=在任务前加“超过约 10 秒或需跨步骤就优先走总线”的总线优先指引。
+- **结果（来自会话日志统计）**：
+
+| 任务 | A 臂（可选/收益导向） | B 臂（总线优先） |
+|---|---|---|
+| 一次性 40s 长命令 | 0/2 用总线（直接 pwsh，40.9s） | 1/1 用总线（多一层包装，无协调收益） |
+| 70s 跨预算取回 | 2/2 用总线（约 71s） | 1/1 用总线（106.3s，含约 19s 排队延迟） |
+| 45s 跨步骤 | 1 用总线分离重附着、1 用宿主后台 Job | 1/1 用总线（4 次调用） |
+| 普通 grep 快任务 | 0/2 用总线 | 0/1 用总线 |
+| 同一逻辑重复提交 | 1/1 用总线，2 次 reused:true | 1/1 用总线，3 次 reused:true |
+
+  总线调用总数：A 臂 11 次 / 5 会话；B 臂 18 次 / 5 会话。
+
+- **结论**：收益导向的可选触发是更好的默认；总线优先会提高采用率，但提升部分主要是一次性长命令等无收益场景，并可能因总线并发/排队增加延迟。因此不把 bus-first 作为默认，也暂不发布为正式第二预设。
+- **边界**：这是指引级对照（非预设级）；并发子代理、单机、小样本，非统计显著；轮次/耗时/成功率的大样本 A/B 仍未完成。预设级对照需要 GUI 手工创建两种预设的会话，本轮未做。
+- 附带验证了幂等契约：只读 Handler 终态复用返回 reused:true（毫秒级）、有副作用 Handler 终态重发返回 MUTATING_REUSE_DENIED、同 requestId 换参数 REQUEST_CONFLICT、新 requestId 才重新执行。
+
+## 升级说明
+
+只有文档与证据更新；无代码、协议、提示或 Handler 行为变化。不自动安装、重写日常配置或重启 DSH。
+
+## 验证与限制
+
+本地全量 110 项测试通过。证据边界见 `docs/validation.md`；真实模型/桌面 UI/实际沙箱仍未完整验收。

package/docs/validation.md

@@ -1,6 +1,6 @@
 # 验证范围与使用限制
 
-本文说明当前版本的证据边界，不是生产环境认证。当前能力基线为 **v0.11.2**，在 0.5.0 的会话准入/排队、0.7.0 的宿主工具转发、0.8.0 的搜索/命令 Handler、0.9.0 的预算分离等待与 0.10.0 的采用面改造上，收紧为收益导向触发并加入简化调用、复用标记与本地采用率统计；0.11.1 仅补充跨步骤取回的正确姿势说明；预设沿用 v0.3.0 的宿主 PTC 声明派生方式。验证环境为 Windows、Node.js 24.21.0，宿主组件锁定 DSH 0.2.1-rc.2、Cordis 4.0.4。
+本文说明当前版本的证据边界，不是生产环境认证。当前能力基线为 **v0.11.3**，在 0.5.0 的会话准入/排队、0.7.0 的宿主工具转发、0.8.0 的搜索/命令 Handler、0.9.0 的预算分离等待与 0.10.0 的采用面改造上，收紧为收益导向触发并加入简化调用、复用标记与本地采用率统计；0.11.1 补充跨步骤取回姿势，0.11.3 补记收益导向 vs 总线优先的指引级 A/B 证据；预设沿用 v0.3.0 的宿主 PTC 声明派生方式。验证环境为 Windows、Node.js 24.21.0，宿主组件锁定 DSH 0.2.1-rc.2、Cordis 4.0.4。
 
 ## 已验证什么？
 
@@ -11,11 +11,14 @@
 | 真实会话循环 | AgentLoop、AgentRegistry、SessionStore；脚本模型适配器 | 内存会话中原工具结果只提交一次，完成后再进入下一次适配器调用 |
 | PTC 预算分离等待 | 真实 Node PTC `run_code` 以 2 秒预算等待 5 秒总线执行：预算到期后执行继续、宿主 Job 保留、同 requestId 取回结果；外部中断仍取消执行 | 在 DSH 0.2.1-rc.2 实际中断原因下成立；固定字符串不是跨版本契约 |
 | 简化调用与复用标记 | 简化请求/控制、完整 v1 消息兼容、终态与运行中复用返回 `reused:true`、非法形状拒绝 | 组件级测试确认；不改变 wire 语义与副作用边界 |
+| 采用策略 A/B（指引级） | 同一版本 0.11.2、同一模型、5 类任务各 5 个全新子会话：可选触发 vs 总线优先指引，统计总线调用/复用/耗时 | 指出可选触发更优（总线优先把一次性长命令也包装、并有约 19s 排队延迟）；非预设级、并发单机小样本，非统计显著 |
 | 预设隔离 | AgentPresetRegistry 与 Loader | 派生预设可激活；源 ptc 声明不变、普通 Agent 不可见总线；原 write/edit/Job 工具保留，宿主前置策略拒绝仍有效 |
 | 故障注入 | 克隆失败、观察者拒绝、Job 等待/清理异常、先行移除与卸载交错 | 指定故障下的回归约束；不证明所有故障组合都已覆盖 |
 | 候选包 | 严格文件白名单、临时目录生产依赖安装、入口注册 | 包可安装和加载；安装验证使用简化宿主夹具，不是桌面插件管理器验收 |
 
-2026-10-18 采用率 pilot（0.10.0，4 个全新队友会话）：符合条件的长命令/跨预算任务 **2/3** 真实调用了总线；1 个一次性 40 秒命令属于无收益包装，1 个跨步骤任务改用宿主后台 Job。样本小、非 A/B，0.11.0 收紧触发后需复测。
+2026-10-18 采用率 pilot（0.10.0，4 个全新队友会话）：符合条件的长命令/跨预算任务 **2/3** 真实调用了总线；1 个一次性 40 秒命令属于无收益包装，1 个跨步骤任务改用宿主后台 Job。
+
+2026-10-18 指引级 A/B（0.11.2，两臂各 5 个新子会话）：A 臂可选触发 11 次总线、B 臂总线优先 18 次；B 臂把一次性 40 秒命令也吸入总线，跨预算场景出现约 19s 排队延迟（106.3s vs 71s）。结论：收益导向可选触发是更好的默认，bus-first 不发布为正式第二预设。样本小、并发单机、非预设级，不替代统计意义上的效果对照。
 
 此前 v0.3.0 本地回归为 **51/51 通过**；本轮新增生命周期与多会话压力回归，最新数量以命令输出为准。测试项数量是用例数量，不是全部产品验收条数。当前结果请重新运行下述命令；文档测试数不应代替实际输出。
 
@@ -48,7 +51,7 @@ eb95b4e51675f5f1821275e0812ef4dd4984b1aba45a52fbc6bab3518bbf6f38
 | 从真实 tgz 经宿主插件管理器加载预设、卸载与回滚 | 未完成完整桌面流程；源码工作区的 Loader 测试不能替代 |
 | 真实 glob/grep/pwsh 工具实现 | 未在测试环境启用：真实搜索工具依赖打包 ripgrep 与 subprocess 服务，真实 pwsh 依赖 shell/sandbox/审批组合；本版只验证按 handler 名转发、输入校验、幂等分流与失败固定码 |
 | 跨版本 PTC 中断原因 | 分离等待只识别 DSH 0.2.1-rc.2 实际使用的固定中断原因字符串；宿主升级后未知原因保守按取消处理，需复核 |
-| 模式采用率与效果 | 未完成 A/B。0.10.0 pilot 显示采用面改造能让总线被真实使用（2/3 符合条件任务），但样本小、任务由本仓库构造；0.11.0 收益导向收紧后的采用率与轮次/耗时收益仍未知，需两臂复测，不能由 schema 或单元测试推断 |
+| 模式采用率与效果 | 已完成指引级 A/B（可选触发 vs 总线优先），但非预设级、并发单机小样本，不具统计显著性；轮次/耗时/成功率的大样本对照仍未完成，不能由 schema 或单元测试推断 |
 | 磁盘会话结果提交及重启恢复原调用 | 未验收磁盘提交；本插件不支持跨重启恢复 |
 | 减少真实模型轮次、状态查询或总耗时的对照 | 未验证，不给提升比例 |
 | 长期运行、所有卸载/服务故障组合 | 未穷尽；持续故障仍有清理限制 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feng0531/dsh-execution-bus",
-  "version": "0.11.2",
+  "version": "0.11.3",
   "type": "module",
   "private": false,
   "license": "SEE LICENSE IN LICENSE",