dsh-review-format-guard

DSH Review Format Guard

给 DeepSeek Harness（DSH）的原生自动审查增加返回格式检查与有限重试。

English · 安装与卸载 · 排查问题 · 技术实现 · 测试范围

这是一个社区实验插件。它处理部分模型服务未按约定返回审批结果、导致工具无法执行的问题。当前已验证 DSH 0.2.1-rc.3，插件 0.1.0。

我遇到的问题适合用它吗？

如果你在“自动审查”模式下，工具尚未执行就遇到以下错误，可以了解这个插件：

Auto review of tool "working_directory" failed; its body was not executed
Unexpected token ... is not valid JSON
REVIEW_JSON_INVALID
Review response is not one complete JSON object

JSON 是一种固定字段的数据格式。DSH 要的是“风险等级、允许或拒绝”这样的审批结果；模型有时却返回普通说明、工具调用标记，或者不完整、互相冲突的结果。

本插件会检查完整返回，清理少量可明确识别的包装，并对不合格结果有限重试。合法拒绝不会为了得到允许而重试；多次不合格仍然报错。

账号认证失败、服务持续不可用、工具执行后报错、模型已经明确拒绝，分别需要按其原因处理。参见排查说明。

新手怎么使用？

1. 打开本仓库的 Releases（版本发布），选择 v0.1.0，下载 dsh-review-format-guard-0.1.0.tgz。
2. 按安装指南通过 DSH 正常插件流程安装。Windows 桌面版可以使用 DSH 自带的命令入口，无需为本插件另外安装 Node.js。
3. 重启，确认插件已启用，会话底部仍为“自动审查”。先用“只查看当前工作目录，不修改文件”这样的简单请求试用。

.tgz 是可安装的插件包。GitHub 自动生成的 Source code ZIP 供阅读和开发使用，新手优先下载上述 .tgz 文件。

它会改变什么？

• 默认不限制商家、服务入口或模型名称，只处理与已核对原生政策及请求结构相符的审查请求。
• 保留原系统提示词与全部待审数据，在末尾重申完全相同的原生政策，提醒模型只返回审查结果。
• 完整接收返回后再检查，只清理包住整个结论的 JSON 代码框、外围空白、开头 BOM，以及已核对的思考过程外围空白差异。
• 缺失、冲突、重复字段、格式错误和部分临时服务错误，默认最多重试两次，含首次共三次。每次默认最多等待 60 秒。
• 结果仍交给 DSH 原有审查组件，失败不构成放行例外。插件没有执行工具的入口。

插件通过正式扩展接口挂载，不替换内置审查组件，不修改服务地址、密钥或权限政策。正常安装会登记插件依赖和挂载信息。它不启动单独的网络代理；重试仍由 DSH 请求原先选定的服务。

兼容范围和限制

项目	当前情况
已验证宿主	DSH 0.2.1-rc.3 的原生自动审查
插件版本	0.1.0，首次公开测试版本
已验证桌面环境	Windows；其他部署环境需要自行验证
模型入口	不按名称限制；本机配置的 17 个文字模型入口共 67 个虚构样例通过
其他审批插件	不负责修复其自定义审批流程
未知版本的原生政策	交回原生处理，需要重新核对兼容性

格式正确不等于模型判断正确。 当前样例通过率不能当作所有模型、服务或风险场景的保证。生图入口不在文字审查验证范围。测试条件与模型名称来源见 COMPATIBILITY.md。

重试会增加耗时、请求次数以及可能的费用。本插件自己的日志不保存会话原文、密钥或原始回答；DSH 和服务端各自的日志行为由它们负责。

停止使用

通过 DSH 插件开关停用，或按卸载步骤移除后重启。停用生效后恢复原生处理，在途请求取消；原服务的格式问题可能再次出现。卸载不会移除 DSH 内置自动审查。

给开发者和复核者

生产代码仅使用 Node.js 标准库，无运行时第三方依赖和安装后脚本。

• 技术实现：接入、原政策重申、完整返回校验、重试与边界。
• 贡献与验证：在源码目录运行 npm test，可离线执行 51 项测试，不需要 DSH、密钥或远端模型。
• 已有 7 组本机真实宿主接入检查通过。GitHub 自动检查只运行离线测试，首次上传后的实际结果需查看 Actions 页面。

通过 Issues（问题反馈） 提交版本、复现条件与脱敏错误。不要公开密钥、认证请求头、Cookie 或完整会话。高风险情况只提供虚构描述，在独立进程中分类验证，不绑定工具执行器。

许可

MIT。测试快照包含 DeepSeek 的 MIT 许可内容，声明保留在 fixtures/LICENSE.deepseek。