前言¶
dsh-route-certificate 是 DeepSeek Harness 开发者预览版的一个实验性插件。它用于观察 durable 的 turn/end 会话事件,生成独立的 RouteCertificate 回执。插件不负责改写或隐藏 Harness 的原始结果,默认自带验证器即可使用。
安装与启用¶
先选择现有的 Harness Profile,使用官方命令从固定公开 Commit 安装:
PROFILE=tui
PACKAGE_SPEC=git+https://github.com/runyuan-wang/dsh-route-certificate.git#<fixed-public-commit>
dsh plugin --profile "$PROFILE" add "$PACKAGE_SPEC"
dsh --profile "$PROFILE" --dump-config
安装后,插件默认在 Profile 目录下生成回执:
$DSH_HOME/profiles/<profile>/.route-certificate/receipts/
如需移除,使用以下命令:
dsh plugin --profile "$PROFILE" remove -w dsh-route-certificate
核心功能¶
该插件提供以下能力:
- 结构化判断:根据终端状态和信封完整性,输出
pass(完整正常)、fail(明确错误)或indeterminate(中断/未知)。 - 零构建直接安装:无需 clone、build 或自行编写 validator。
- 请求与产物溯源:将请求、执行前缀、终止事件、结果范围和产物指纹绑定。
- 旁路观察模式:默认为 advisory 模式,即使验证器或回执写入失败,也不会替换或阻断原始 Harness 结果。
注意事项¶
- 功能边界:它不判断答案真伪、语义正确性、输出质量、安全性或任务成功与否。
- 环境要求:需要 Node.js >= 22.19.0。支持 @deepseek-ai/dsh@0.1.0-rc.7 和 session format 0。
- 组件关系:它不会添加或替换官方的 @deepseek-ai/* 组件。
- 数据可见性:插件以 DSH 进程权限运行,敏感任务内容应视为可见。
- 平台验证:目前仅验证了 macOS 环境,Linux 和 Windows 的运行行为未经验证。