前言¶
DeepSeek Harness (DSH) 采用插件化架构，旨在通过扩展组件增强功能。对于希望在 DSH 会话 UI 中直接使用 Agent Client Protocol (ACP) Agent 的用户，dsh-acp-adapter 插件提供了集成方案。它允许在 DSH 环境中继承原生会话、工具审批和团队协作能力，同时保持对 ACP Agent 的控制。
安装¶
安装前需确认运行 DSH 的主机上已安装并登录对应的 Agent CLI。根据运行环境选择对应的安装命令：
Desktop 环境：
dsh plugin --profile desktop add @zaimokuza/dsh-acp-adapter@next
Web 环境：
npx @deepseek-ai/dsh@0.2.0-rc.2 plugin --profile web add @zaimokuza/dsh-acp-adapter@next
安装完成后，需手动在插件管理器中点击“立即启用”。启用后，请完全退出并重新打开 DSH 以确保插件加载生效。
使用步骤¶
- 连接 Agent： 打开 DSH 的 插件 → ACP adapter 面板。插件内置了 ACP 官方 Agent 目录快照，可直接添加；也可手动添加目录外的 Agent。
- 验证连接： 添加 Agent 后，检查连接状态，确保 Agent CLI 已正确登录。
- 发起会话： 在新会话中，从模型选择器中切换到已配置的 Agent 模型。
- 执行命令： 在会话中直接使用 Agent 的 ACP 命令，例如
devin acp或codebuddy --acp。
核心功能¶
- 原生集成： 在 DSH 会话 UI 中直接使用 AI Agent，继承原生会话管理、工具审批和团队协作机制。
- 自动批准： 自动批准当前会话的 DSH 原生工具请求，减少人工干预。
- 原生审批卡： 当 Agent 请求审批时，显示 DSH 原生审批卡片，保持界面一致性。
- 会话控制： 支持停止当前轮次，按 Enter 可排队输入，支持 Agent 在同一会话中继续。
- 子代理查看： 提供子代理的只读详情视图，便于监控 Agent 行为。
- 诊断导出： 支持 ACP 诊断记录的导出功能，用于排查问题。
注意事项¶
- 更新与卸载： 插件管理器不会自动更新。卸载插件不会移除已安装的 Agent CLI 或退出账号。
- 前置依赖： Agent CLI 必须在运行 DSH 的主机上安装并登录。
- 工具控制权： Agent 自带工具仍由 Agent 本身控制，插件不干预这些工具的执行逻辑。
- 安全分享： 在导出 ACP 诊断记录或 DSH 原生会话日志时，请检查并移除敏感信息（如提示词、文件路径、凭证等）。
