DeepSeek Harness (DSH) 生态强调“一切皆插件”的理念。在开发智能体工作流时，有时需要直接调用底层的 DevOps 工具而非编写通用插件。ddtcorex/dsh-maestro-govard 旨在解决 Govard 工具与 DSH 会话之间的集成问题，它不嵌入 Go 代码，而是作为一个轻量级桥接层，将 Govard 工作区/项目的工具注册为 DSH 的可调用工具。
插件定位¶
这是一个由 ddtcorex 维护的 DSH 插件，属于 Maestro Harness 套件的一部分。它本身不包含 Govard 的核心引擎代码，仅作为桥接层，将 Govard 的功能暴露给 DSH 会话。
核心能力¶
- Shell 调用工具注册：插件通过调用
govard二进制文件注册了一系列工具，支持环境启停、容器内命令执行、数据库导入导出以及调试配置。这些工具使用schemastery-typed参数，保证了参数校验的准确性。 - 只读部署检查：提供
govard_deploy_plan和govard_deploy_check两个工具。前者生成机器可读的kind: "plan"文档，后者在部署前对目标进行预检。这两个工具不需要建立远程连接即可获取部分信息。 - 路径解析：工具的路径解析逻辑与 Maestro 套件保持一致，确保上下文识别准确。
安装与前置条件¶
安装插件需要使用官方命令。安装前请确保 govard 二进制文件已构建并可用。
dsh plugin --profile web add @ddtcorex/dsh-maestro-govard
前置条件说明：
1. Govard 引擎是一个独立的 Go 代码库，需单独构建（通常在 govard 仓库中执行 make build）。
2. 该桥接插件期望 govard 二进制文件在系统的 PATH 中，或在配置的路径下可用。
使用示例¶
插件提供了两类主要命令，均支持 projectPath 参数，参数缺失时会依次回退到配置的根目录或当前会话的工作区。
- 查看部署计划：
govard_deploy_plan，用于获取远程项目的解析后管道，并以机器可读的 plan 文档形式返回。 - 部署前检查：
govard_deploy_check，在向目标发送修改命令前，执行预检流程。
适用场景与注意事项¶
- 权限风险：插件以当前 DSH 进程的权限运行。修改部署等操作依然在终端中执行，但建议在将功能交付给智能体前，先在真实的 Govard 管理项目上进行验证。
- 依赖分离：请勿混淆 Govard 引擎与该插件。该插件仅作为桥接，不嵌入 Go 代码。
- 源码审查：安装前请检查源码与许可证（MIT）。
总结¶
该插件通过轻量级桥接的方式，将 Govard 的丰富工具能力引入 DSH 生态，适合需要精细控制基础设施和部署流程的场景。
