前言¶
DeepSeek Harness (DSH) 采用插件化架构，旨在通过扩展实现功能集成。在本地开发环境中，开发者通常已经安装了多种代码辅助工具（如 OpenCode、Claude Code 等）。将 DSH 与这些已有的智能体 CLI 工具打通，是提升开发效率的关键。
这是什么¶
dsh-agent-bridge 是一个数据驱动的智能体桥接插件。由维护者 mike-sl-ig 开发，旨在解决 DSH 与现有编程智能体集成困难的问题。
该插件通过 JSON 配置文件（Recipes）描述智能体的行为，而非硬编码厂商逻辑。这意味着添加新智能体或修复配置变更，只需修改数据文件，无需修改插件代码。
核心功能¶
插件提供了以下核心能力：
- 跨平台启动器：支持在不同操作系统上定位和启动本地智能体。
- JSON Recipes：通过 JSON 文件定义智能体的运行参数、输出解析和版本探测。
- 会话头部交互：在 DSH 会话头部提供按钮，用于切换候选智能体池，查看上一次运行结果。
- 工具集：模型可直接调用的三个工具：
agent_list：探测可用智能体，查看位置、成本及支持能力。agent_run：以独立工作者的身份执行智能体，返回答案、会话 ID、耗时、工具调用及运行报告路径。agent_mode：读取或修改按钮当前显示的状态。
- 运行报告：每次运行生成 Markdown 和 JSON 两种格式的报告。
- 向导与自测：提供配方向导和自测功能，辅助配置。
- 注册表导入：支持从社区注册表导入配置。
安装与启用¶
安装前请确保环境满足要求：
- Node.js 版本 >= 20
- 依赖的 DSH 版本：
@deepseek-ai/dsh >=0.2.0-rc.2 <0.3.0
使用以下命令安装插件：
dsh plugin --profile <your-profile> add dsh-agent-bridge
典型用法¶
1. 切换与探测智能体¶
在 DSH 会话的头部，可以通过按钮切换候选智能体池。模型可以使用 agent_list 工具探测当前环境中的可用智能体：
agent_list：用于探测可用智能体，包括位置、成本和支持能力。使用probe: true参数会额外运行版本检测。
2. 执行智能体任务¶
模型可以使用 agent_run 工具将某个智能体作为独立工作者执行任务。该工具会返回答案、会话 ID、执行时间、工具调用记录以及运行报告的文件路径。
3. 读写状态¶
使用 agent_mode 工具可以读取当前智能体的状态，或手动修改按钮显示的配置。
4. 编写配置¶
智能体的行为由 JSON 配置文件定义，文件需放置在 lib/recipes/ 目录下。参考 opencode.json、claude.json 或 workbuddy.json 的示例编写自己的配置。
5. 使用角色模式¶
插件定义了四种角色模式，用于控制智能体的行为策略：
default：标准模式，不附加额外指令。verify：独立验证者，来自不同模型家族，禁止使用工具，执行一次通过。bulk：廉价机械工作流，偏好直接回答，禁止自我工具检查。second：独立第二意见，禁止使用工具，执行一次通过。
注意事项与适用场景¶
- 厂商无关性：插件本身不硬编码任何特定厂商的 CLI，所有厂商逻辑由 Recipes 定义。
- 工具限制：在
verify和second模式下，插件会强制禁止工具调用，以防止非预期的长耗时或死循环。 - 依赖与生命周期：插件无运行时依赖，也无安装时的生命周期钩子。
- 环境检查：使用前请检查源码与许可证（MIT）。
- 适用场景：适合需要跨模型验证、低成本批量任务处理或获取独立第二意见的开发场景。
结尾¶
dsh-agent-bridge 提供了一种标准化的方式将 DSH 与现有的本地智能体工具连接起来。通过 JSON Recipe 机制，它保持了高度的灵活性和可维护性。若需查看完整文档或源码，可参考其目录页或 GitHub 仓库。
