DeepSeek Harness (DSH) 提供了通过插件扩展能力的机制。在自动化工作流中,审批环节往往需要人工介入,这会阻塞流程的自动化程度。dsh-plugin-auto-review 旨在复现特定 Provider 的审批审查行为,将审查逻辑委托给模型,从而减少人工干预。
插件简介¶
- 名称:
dsh-plugin-auto-review - 维护者:
delef - 类别:Approval
- 许可证:MIT
该插件通过 DSH LLM 适配器提供模型,支持 Codex Guardian 和 Grok 升级策略等审查逻辑。它配置了自定义路由,能够处理原生审批请求以及 Bash 调用的重试。一个重要特性是,委托的子代理不会打开无人值守的人类提示,而是继承机器审查者。
核心功能¶
- 复现 Provider 行为:支持 Codex Guardian 和 Grok 升级策略等审查逻辑。
- LLM 适配器集成:模型通过兼容的 DSH LLM 适配器提供。
- 自定义路由配置:支持配置包含策略、Provider、模型的自定义路由。
- 处理审批与重试:处理原生审批请求,并在特定情况下重试 Bash 调用。
- 子代理继承:委托的子代理不会打开无人值守的人类提示。
安装与启用¶
插件发布在 npm 上,包名为 dsh-plugin-auto-review。安装时需要指定 DSH 的 Profile。
1、在 Web Profile 中安装:
dsh plugin --profile web add dsh-plugin-auto-review
2、在 Headless Profile 中安装:
dsh plugin --profile headless add dsh-plugin-auto-review
安装完成后,需要重启对应的 DSH 进程以使 Profile 加载插件。后续更新可使用:
dsh plugin --profile web update --latest dsh-plugin-auto-review
dsh plugin --profile headless update --latest dsh-plugin-auto-review
典型用法¶
基础配置¶
插件注册了 Codex Guardian 和 Grok 升级策略,默认以手动模式运行。一旦对应的 DSH LLM 路由可用,即可选择审查者。
在 Web 界面中,可以在 Settings 中进行全局选择,或在对话输入旁进行会话级选择。仅当前可用的路由会被列出。选择 none 可以回退到 DSH 原生的手动审批流程。
配置示例如下:
autoReview: codex
自定义路由¶
可以通过配置自定义审查者。policy 选择审查逻辑,provider 和 model 选择 DSH LLM 路由。
autoReview: api-guardian
reviewers:
- policy: codex
reviewerId: api-guardian
label: Company API Guardian
provider: openai-api
model: gpt-5
reasoningEffort: low
reviewerId 必须唯一。未指定 policy 的条目将保留 Codex Guardian 的行为。全局选择存储在 plugins/auto-review/auto-review.json。
兼容性与开发¶
- Node.js:需要
>=22.13.0。 - DSH 版本:目标版本为
0.1.2-alpha.3。 - 安装源:建议使用 npm,GitHub Packages 镜像需要额外的认证。
权限与安全¶
该插件属于高权限的审批策略插件。
- 文件读写:在 DSH 的 Home 目录下读写审查者选择,路径为
plugins/auto-review/auto-review。不读取凭证存储。 - 模型流量:通过配置的 DSH LLM 路由发送上下文,该上下文可能包含项目私有数据或凭证。插件本身不配置 API 密钥,不使用直接 HTTP 客户端。
- 审查逻辑:机器审查会拒绝被拒绝、不可用、中断、超时或格式错误的请求。
- 安全边界:插件不会绕过 DSH 的权限。如果沙箱拒绝 Bash 调用,插件会尝试使用下一个沙箱模式重试,但重试仍需经过审批边界。
总结¶
dsh-plugin-auto-review 通过复现 Provider 的审查策略,为 DSH 提供了自动化的审批能力。它支持 Codex Guardian 和 Grok 等策略,并能通过自定义路由灵活适配。使用时需注意目标 DSH 版本与 Node.js 版本要求,并确认模型流量中包含的数据安全性。