DSH-ACP-ADAPTER
在 DSH 中使用 ACP Agent，沿用原生会话、工具审批和团队协作。
安装
当前插件版本 0.2.1-rc.2.4 兼容 DSH 0.2.1-rc.2。其他版本见 Releases。
推荐： 在 DSH Creator 模式中发送：
请安装并启用 ACP 插件：
@zaimokuza/dsh-acp-adapter@0.2.1-rc.2.4。
按提示确认安装，新插件默认启用。也可打开 插件 → 添加插件，粘贴 @zaimokuza/dsh-acp-adapter@0.2.1-rc.2.4，安装后点 立即启用。
其他安装方式：命令行、Git 与压缩包
命令行：Desktop 使用其自带的 dsh 命令；Web 使用 npx 运行官方 DSH CLI npm 包，无需全局安装。
使用 Desktop CLI 前先完全退出应用，执行后重新打开。更新时将包名后的版本号替换为目标版本，再运行对应命令，无需先卸载。
# Desktop
dsh plugin --profile desktop add @zaimokuza/dsh-acp-adapter@0.2.1-rc.2.4
# Web
npx @deepseek-ai/dsh@0.2.1-rc.2 plugin --profile web add @zaimokuza/dsh-acp-adapter@0.2.1-rc.2.4
Git 与压缩包安装示例：
在插件管理器中，可将下方 Git 地址或 .tgz 包 URL 替换包名粘贴到输入框中。
| 来源 | 示例 |
|---|---|
| Git | git+https://github.com/zaimokuza-yoshiteru/dsh-acp-adapter.git#v0.2.1-rc.2.4 |
| 预构建插件包 .tgz | 下载 0.2.1-rc.2.4 |
此包包含编译产物，与 npm 发布包一致。GitHub 自动生成的 Source code ZIP/TAR.GZ 是源码归档，不是构建后的插件包；未缓存的依赖仍需联网安装。
更新： 插件管理器不会自动更新。使用插件管理器更新时，先卸载旧版，再按上方推荐方式安装新版。卸载插件不会卸载 Agent 或退出账号。安装完成后，为确保加载新版：桌面端请在当前任务结束后完全退出并重新打开 DSH；Web 端请重启 DSH 服务并刷新页面。无需重新登录。
连接 Agent
插件附带一份 ACP 官方 Agent 目录快照，提供安装、登录指引和命令预填；也可手动添加目录外的 ACP Agent。Agent CLI 必须安装并登录在运行 DSH 的主机上。打开 插件 → ACP 适配器，按目录指引添加 Agent 并检查连接，再在新会话选择 Agent 模型。插件不会替你安装 CLI 或登录账号。以下 Agent 已做过实际接入测试：
| Agent | ACP 命令 | 认证 |
|---|---|---|
| Devin | devin acp |
devin auth login |
| CodeBuddy CLI（WorkBuddy） | codebuddy --acp |
codebuddy |
| Antigravity | agy_acp_server.par（官方 raw 1.3.0） |
ACP 独立登录 |
| Claude | claude-agent-acp |
claude |
| Codex | codex-acp |
codex login |
| Kimi | kimi acp |
kimi login |
| Qwen Code | qwen --acp |
qwen |
CodeBuddy CLI 与 WorkBuddy 桌面端使用同一账号积分，无需分别订阅；通过 CodeBuddy CLI 接入 DSH。详见 CodeBuddy 账号与订阅说明及 ACP 命令参考。
测试范围与限制见 E2E 验证说明。
功能预览
更多界面预览
Auto 可自动确认当前会话中 Agent 调用 DSH 工具的申请，不改变 DSH 的沙箱与工具授权。Devin 发出的授权请求仍需按原始选项确认。Ask 在 Agent 请求审批时显示原生审批卡。Agent 自带工具仍由 Agent 控制。Stop 停止当前轮次；按 Enter 可排队输入，支持的 Agent 会在同一 Agent 会话继续。开启 DSH 的实验性 Agent Teams 后，可在主会话查看成员进度并处理审批。
排障与反馈
| 现象 | 先检查 |
|---|---|
| 命令无法启动 | 核对 Agent 可执行文件路径，尝试填写绝对路径。 |
| 登录或认证失败 | 在 Agent CLI 登录，并检查已配置的环境变量。 |
| 旧 subagent 详情无法打开 | 查看原生恢复提示；不兼容的旧详情会保留在本地记录中并显示错误。 |
| 会话提示需要恢复 | 按输入栏提示和 ACP 诊断 操作，不要清空本地数据。 |
在 ACP 诊断中可导出安全摘要 JSON；其中不含消息正文、命令、路径、原始会话 ID 或 ACP 凭据。DSH 原生会话日志 ZIP 可能含提示词、工具参数、文件路径和附件；分享前请检查并移除敏感信息。