dsh-config-origin-proof:DeepSeek Harness 配置来源所有权证明

前言

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(证明安装包完整性)形成互补,专注于回答“记录中的哪个来源获胜”以及“为什么”。

核心功能

  1. 来源验证:验证 DSH 配置来源的所有权。
  2. 可重现证据:提供可重现的证据收据,确保配置决策的可追溯性。
  3. 安全脱敏:拒绝原始值和敏感字段(如 secret、credential、prompt、message 或 prose 形状的文本),仅报告稳定 ID、SHA-256 摘要和裁决。
  4. 多接口支持:支持 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_inspect
  • dsh_config_origin_verify

MCP 接口

MCP 模式为内联操作,无文件系统、网络、进程或工件写入:

  • config_origin_inspect_inline
  • config_origin_verify_inline

适用场景与注意事项

适用场景:需要严格审计配置来源、防止配置注入攻击、或需要为配置决策生成不可篡改证据的开发环境。

注意事项:
* 权限与安全:插件以当前 DSH 进程的权限运行,安装前建议检查源码与许可证(MIT)。
* 兼容性:DSH 版本需满足 >=0.1.2-alpha.4,Node.js 版本需满足 >=22。
* 验证逻辑:当更高优先级的来源未被观察到时,验证器会失败(fail closed),即直接报错而不继续。
* 模式差异:MCP 模式完全基于内存操作,不涉及文件系统或网络写入。

总结

dsh-config-origin-proof 通过内容寻址的证据机制,让 DeepSeek Harness 的配置管理变得可验证。它不收集实时配置,而是基于可信的记录文件提供审计视角,帮助开发者理清配置来源的优先级和决策依据。更多细节与源码,请参考 GitHub 仓库。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜