在 DeepSeek Harness (DSH) 生态中，系统会在启动时生成官方默认的工具架构目录。现有的工具如 dsh-mcp-lens 已经提供了大型 MCP 目录压缩和架构预算检查功能。此插件不做这些。它验证部署特定的、显式记录的信封：例如，在升级后，所有者/原生表面和读取器/原生表面是否仍完全暴露批准的工具身份和架构。
功能¶
此插件生成离线内容寻址的证据，证明实际记录的模型可见工具表面符合批准的锁定，跨代理范围、权限模式和呈现模式。
核心能力包括：
* 验证部署特定的、显式记录的信封。
* 检测漂移：缺失或意外的表面、范围/权限/呈现不匹配、工具添加或移除、架构变更、顺序漂移、过时或未来观察、重复身份和版本不匹配。
* 通过 DSH bundle 暴露 dsh_tool_surface_inspect 和 dsh_tool_surface_verify。
* 提供基于 MCP 服务器的内联、无文件系统等效方案。
用法¶
CLI 提供两个主要子命令。
检查工具表面：
dsh-tool-surface-proof inspect --manifest surface.json
验证工具表面：
dsh-tool-surface-proof verify --workspace-root . --manifest surface.json --artifact-dir artifacts
验证器读取一个工作区相对的正则文件，拒绝符号链接和遍历，不进行网络请求或子进程。它将一个内容寻址的 JSON 报告写入明确指定的 artifact 目录。
限制与注意事项¶
此插件不捕获实时运行时状态，授予或拒绝权限，执行命令，连接到 MCP 服务器，或证明记录器诚实。它依赖于受信任的部署特定记录器来创建观察信封。
报告仅包含 SHA-256 身份、计数和漂移类别。它们从不返回工具名称、描述、架构或原始业务内容。
技术规格¶
- 许可证： MIT
- 兼容性： DSH >= 0.1.2-alpha.4, Node >= 22
- 安装： 官方安装命令未提供。请参考 GitHub 仓库获取源代码。
总结¶
对于需要证明部署特定的工具表面符合批准的锁定，而不暴露工具名称或业务逻辑的团队，此插件提供了一种机制。它关注部署范围的一致性，而不是运行时权限或执行。
