计划审批选项 FFFengMJL/dsh-plan-execute

dsh-plan-execute

同一 DSH 会话中的计划审批与执行选项扩展。保留原生计划预览和批准流程，并在计划审核动作区提供模型选择、思考等级，以及「保留上下文」或「压缩较早历史后执行」选项。

功能与安全边界 | Features and safety

- 只处理带有原生 plan-review intent 的单题审核；实际执行仍由原生批准选项决定。
- Host 只有在暂存设置后收到唯一、精确的批准答案时才继续准备；拒绝、取消、过期请求或校验失败都不会由插件放行。未暂存设置时保留 DSH 原生批准行为。
- 压缩通过当前 Agent 的 compactRegion() 执行，只选择待批准工具批次之前、工具配对平衡的历史前缀。若没有满足阈值的安全范围，操作会失败关闭，不会静默改为不压缩。
- 压缩结果会核对 shadowedSeqs，并确认待批准批次仍在活动 surface 上。最终计划和待处理的审批工具批次不应被所选范围覆盖。
- 执行模型及其思考等级来自 Host 的模型目录；插件不硬编码模型能力。目录加载中、空目录、部分 provider 失败、请求失败和超时都有独立状态，可重试，失败时不阻止「沿用当前模型」。
- 思考等级按模型记忆在当前审核表单内；只有用户显式选择时才提交 reasoningEffort，「使用模型默认值」表示省略该字段。切换回某模型时，仅当该档位仍受最新目录支持才恢复。
- 执行选项面板通过 portal 挂载到页面浮层，不修改原生审批卡片样式；面板受视口约束并可在内部滚动，支持关闭按钮、Escape、外部点击关闭和焦点返回。
- 进度和暂存设置是进程内状态；插件卸载或进程重启后不会自动恢复或继续执行。用户需要重新呈现/审核计划。
- 压缩一旦提交便不能回滚；若之后模型选择失败，计划仍不会获批，但压缩后的上下文会保留。
- 暂存的设置与进度只在进程内有效。插件卸载或进程重启后不会恢复，计划必须重新提交并审核。
- 压缩一旦提交就无法回滚。如果之后模型选择失败，计划不会获批，但压缩后的上下文仍然保留。

安装与使用 | Installation and use

从 GitHub Releases 下载 tarball，然后安装到指定配置档：

dsh plugin --profile web add /path/to/dsh-plan-execute-0.1.0.tgz

本地开发时先构建，再用 link 安装：

cd /path/to/dsh-plan-execute
pnpm install --frozen-lockfile
pnpm build
dsh plugin --profile web add link:/path/to/dsh-plan-execute

移除插件：

dsh plugin --profile web remove dsh-plan-execute

dsh plugin 只负责登记配置档的依赖与 bundle。运行中的 DSH 是否加载新客户端代码，取决于它的重载机制；没有开发 watcher 时，需要重新加载或重启对应配置档。依赖已登记，并不代表运行中的实例已经加载。

在计划审核卡片中打开「执行选项」：

1. 选择「沿用当前模型」或一个具体模型；选择具体模型后，可设置该模型支持的思考等级。
2. 选择「保留上下文直接执行」或「压缩较早历史后执行」。
3. 点击「保存本次设置」。未保存的修改不会生效，批准时使用上一次已保存的设置。
4. 点击下方原生「批准」按钮。插件在原生批准返回前完成压缩和模型选择；任何准备失败都不会放行计划。

从 GitHub Releases 下载 tarball，然后安装到配置档：

dsh plugin --profile web add /path/to/dsh-plan-execute-0.1.0.tgz

本地开发时先构建，再 link 检出目录：

cd /path/to/dsh-plan-execute
pnpm install --frozen-lockfile
pnpm build
dsh plugin --profile web add link:/path/to/dsh-plan-execute

移除插件：

dsh plugin --profile web remove dsh-plan-execute

dsh plugin 管理配置档的依赖与 bundle 登记。运行中的 DSH 是否加载新客户端代码，取决于它的重载机制；没有开发 watcher 时，重新加载或重启配置档。依赖已登记，并不能证明运行中的实例已经加载。

在计划审核卡片中打开「执行选项」：选择当前模型或一个具体模型（再选它支持的某个思考等级），选择上下文处理方式，点击「保存本次设置」，最后使用原生批准按钮。未保存的修改永远不会生效，任何准备失败都会阻止批准。

模型选择影响 | Model-selection effect

自定义模型和思考等级通过 DSH RC5 的公开 sessionController.selectModel() API 选择。该 API 会为当前会话安装选择，并异步尝试保存 Host 默认模型；默认值保存失败只会记录日志，因此不保证默认值一定改变。选择「沿用当前模型」不会触发这次更新。自定义选择在本会话中保持有效，直到你通过 DSH 原生模型选择器更改。

自定义模型和思考等级通过 DSH RC5 的公开 sessionController.selectModel() API 选择。该 API 会为当前会话安装选择，并异步尝试保存 Host 默认模型；默认值保存失败只会记录日志，因此不保证默认值一定改变。选择「沿用当前模型」不会触发这次更新。自定义选择在本会话中保持有效，直到你通过 DSH 原生模型选择器更改。

兼容性与发布状态 | Compatibility and release status

首版按 DSH 0.2.1-rc.5 的 Host、Typert、Compaction、Session 和 Web client API 实现，依赖版本在 package.json 中固定。其他 Host 版本尚未验证。

发布与分发

本仓库公开发布于 FFFengMJL/dsh-plan-execute：采用 MIT 许可证，CI 在 push/PR 上运行 pnpm verify、显式的 headless Chromium 布局回归，并检查可交付 tarball；tag 驱动的 Release workflow 会从精确 tag commit 构建 .tgz 与 .sha256，校验 tag/版本与 checksum 后创建 GitHub draft Release，由维护者人工发布。相关 CI workflow 不需要写权限。仓库已配置规则保护 v* tags，禁止强制更新或删除。

package.json 保留 private: true，这是为了禁止 npm 发布；它不妨碍公开 GitHub 仓库或 GitHub Release tarball。配置的分发渠道是 GitHub Release，不会自动发布到 npm。Release workflow 仅在推送与 package.json 版本相符的 v<version> tag 后触发。

本地开发与验证

pnpm install --frozen-lockfile
pnpm typecheck
pnpm test # unit, real-dependency contract, React/jsdom behavior
pnpm test:browser # headless Chromium layout regression (builds the fixture first)
pnpm build
pnpm verify # typecheck → build → Vitest → package inspection
pnpm package:check
pnpm release:pack

首次运行浏览器测试前需要安装 headless shell；完整 Chromium 不是必需：

pnpm exec playwright install --only-shell chromium

pnpm verify 运行类型检查、Host/client 构建、Vitest（含 jsdom 组件测试）和 tarball 文件清单检查，不包含浏览器回归；pnpm test:browser 单独运行 Playwright 布局回归。CI 与 Release 会依次执行 pnpm verify 和 pnpm test:browser。pnpm package:check 单独复查 package 文件集；pnpm release:pack 会生成 .release/ 下的 .tgz 和 .sha256，并在本地核对文件名与摘要。release:pack 需要先执行 pnpm build，缺少 lib/ 入口时会明确失败。

测试层级与证据边界：
- Vitest 覆盖审批门控、失败关闭、取消、生命周期、模型目录纯函数、真实 RC5 Session + Compaction 工具配对，以及完整审批场景（真实会话、真实范围计算、可控摘要替身）。
- jsdom + Testing Library 覆盖模型目录状态、按模型思考等级、保存请求、非终态轮询、portal 与关闭/焦点行为。
- Playwright fixture 在真实 Chromium 中复现 overflow:hidden 审批容器，验证面板不被裁剪、受视口约束、短视口可滚动、窄屏无横向溢出。fixture 使用模拟 remote，不代表真实 DSH GUI 已验证。
- 真实 DSH Web GUI、正式 Compaction 摘要后端和真实服务商模型调用没有在自动测试中运行；这些仍需单独的人工或隔离配置档验收。

pnpm verify 运行类型检查、Host/client 构建、Vitest（含 jsdom 组件测试）和 tarball 文件清单检查；它不包含浏览器回归。pnpm test:browser 单独运行 Playwright 布局回归，CI/Release 会运行这两条命令。pnpm package:check 单独检查包文件集合；pnpm release:pack 在 .release/ 下写出 .tgz 和 .sha256，并在本地校验校验和与 basename。release:pack 需要先执行 pnpm build，lib/ 入口缺失时会明确报错。

首次运行浏览器测试前，先安装 headless shell（不需要完整 Chromium）：

pnpm exec playwright install --only-shell chromium

证据边界：

- Vitest 覆盖审批门控、失败关闭路径、取消、生命周期、目录辅助函数、真实 RC5 Session + Compaction 配对辅助函数，以及完整审批场景（真实 Session、真实范围计算、可控摘要替身）。
- jsdom + Testing Library 覆盖目录状态、按模型思考等级、保存请求、非终态轮询，以及 portal/关闭/焦点行为。
- Playwright fixture 在 headless Chromium 中复现 overflow:hidden 审批容器，验证面板逃出裁剪、留在视口内、短视口可滚动、不横向溢出。它使用模拟 remote，不是真实 DSH GUI 验证；这些布局与焦点检查不需要完整 Chromium。
- 真实 DSH Web GUI、正式 Compaction 摘要器和真实服务商模型调用没有在自动测试中运行；它们仍需单独的人工或隔离配置档验收。