前言¶
DeepSeek Harness (DSH) 的配置管理依赖于来源优先级和策略组合。开发者在调试或审计时,常需要确认某个最终生效的配置具体来自哪个源,以及是否存在被更高优先级源覆盖或“影子源”的情况。虽然 DSH 自身的 --dump-config 可以查看组合后的结果,但它不提供关于来源所有权和决策过程的可验证证据。dsh-config-origin-proof 旨在填补这一空白,通过证据层将配置来源的决策过程转化为可重现的收据。
插件介绍¶
dsh-config-origin-proof 是一个为 DeepSeek Harness 提供配置来源所有权证据层的插件。它由用户 dongsheng123132 维护。
该插件的核心作用是将可信生产者(如 DSH composer)产生的结构化记录转化为可重现的证据收据。它不重新实现 DSH composer 或收集实时配置,DSH 自身的 --dump-config 仍是权威来源。它与 dsh-policy-drift-proof(检查策略变更)和 dsh-profile-lock-proof(证明安装包完整性)形成互补,专注于回答“记录中的哪个来源获胜”以及“为什么”。
核心功能¶
- 来源验证:验证 DSH 配置来源的所有权。
- 可重现证据:提供可重现的证据收据,确保配置决策的可追溯性。
- 安全脱敏:拒绝原始值和敏感字段(如 secret、credential、prompt、message 或 prose 形状的文本),仅报告稳定 ID、SHA-256 摘要和裁决。
- 多接口支持:支持 DSH、CLI 和 MCP 三种操作模式。
安装与启用¶
通过以下命令将该插件添加到指定的 DSH profile(例如 web)中:
dsh plugin --profile web add github:dongsheng123132/dsh-config-origin-proof
典型用法¶
根据使用场景的不同,该插件提供了 DSH 接口、CLI 命令和 MCP 内联接口。
CLI 验证¶
在命令行中运行验证命令,指定工作区根目录、记录文件和输出目录:
dsh-config-origin-proof verify --workspace-root examples --recording recording.json --artifact-dir artifacts
DSH 接口¶
在 DSH 运行时环境中,可以调用以下接口:
dsh_config_origin_inspectdsh_config_origin_verify
MCP 接口¶
MCP 模式为内联操作,无文件系统、网络、进程或工件写入:
config_origin_inspect_inlineconfig_origin_verify_inline
适用场景与注意事项¶
适用场景:需要严格审计配置来源、防止配置注入攻击、或需要为配置决策生成不可篡改证据的开发环境。
注意事项:
* 权限与安全:插件以当前 DSH 进程的权限运行,安装前建议检查源码与许可证(MIT)。
* 兼容性:DSH 版本需满足 >=0.1.2-alpha.4,Node.js 版本需满足 >=22。
* 验证逻辑:当更高优先级的来源未被观察到时,验证器会失败(fail closed),即直接报错而不继续。
* 模式差异:MCP 模式完全基于内存操作,不涉及文件系统或网络写入。
总结¶
dsh-config-origin-proof 通过内容寻址的证据机制,让 DeepSeek Harness 的配置管理变得可验证。它不收集实时配置,而是基于可信的记录文件提供审计视角,帮助开发者理清配置来源的优先级和决策依据。更多细节与源码,请参考 GitHub 仓库。