推荐方式
让 Backchat 管理适配器。
Backchat 已内置 DeepSeek Harness 注册项。标准配置不需要编辑 JSON，也不需要手工添加命令。
- 01
打开智能体设置
启动 Backchat，进入“设置 → 智能体”，在 Registry 顶部找到 DeepSeek Harness。
- 02
安装适配器
点击“安装”。Backchat 会把 @openma/deepseek-harness-acp 安装到托管的 ACP 工具目录并自动启用。
- 03
完成终端配置
点击密钥/配置操作，再选择“打开终端配置”。适配器会运行 dsh-acp login，并把凭据写入 Harness 自己的凭据存储。
- 04
开始真实会话
新建对话，选择项目与 DeepSeek Harness，然后执行 /status，检查当前模型、权限模式和登录状态。
API Key 保存在 DeepSeek Harness 自己的凭据存储中。Backchat 只负责启动适配器，不会把密钥复制进应用设置。
手动安装
希望全局使用 dsh-acp？
当你希望在 Backchat 之外也能调用 dsh-acp 时使用这条路径。当前包要求 Node.js 22.15 或更高版本。安装后返回“设置 → 智能体”并点击“刷新”。
node --version
npm install -g @openma/deepseek-harness-acp
dsh-acp login身份验证
一个凭据存储，三种安全入口。
dsh-acp 复用 $DSH_HOME/.credentials.yaml，也就是 dsh Web UI 使用的 mode-600 文件。你可以通过 Backchat 的终端配置、dsh-acp login，或 dsh web 的“设置 → 模型”保存密钥。
临时环境可通过进程变量传入 DEEPSEEK_API_KEY 和可选的 DEEPSEEK_BASE_URL。不要提交这些值，也不要把它们写进公开命令示例。
已有 DSH 的用户
把 ACP bridge 接入 dsh profile。
如果模型、预设、技能和设置已经放在 dsh 中，可将适配器安装为 profile 插件，再让 Backchat 的自定义智能体指向这个 profile。
npm install -g @deepseek-ai/dsh
dsh web
dsh plugin --profile acp add -w @openma/deepseek-harness-acp然后在“设置 → 智能体”中添加自定义智能体
- ID
deepseek-profile- 名称
DeepSeek Harness (profile)- 命令
dsh- 参数
--profile acp
验证连接
配置完成后应具备的能力
- 流式回答与思考过程
- 带文件差异和终端输出的工具调用
- 只读、工作区写入和完全访问权限模式
- 实时模型与推理强度选择
- 斜杠命令、技能、会话、计划、用量和 MCP 服务
故障排查
多数配置问题都能用四项检查解决。
- 列表中没有 DeepSeek Harness
- 打开“设置 → 智能体”并点击“刷新”。手动安装时，可运行 dsh-acp --help 检查命令是否在 PATH 中。
- 安装提示 Node 版本不支持
- 运行 node --version。当前适配器包要求 Node.js 22.15 或更高版本。
- 列表显示需要登录
- 重新打开配置操作，或运行 dsh-acp login。完成交互式提示后再新建会话。
- dsh profile 无法加载
- 先在终端运行一次 dsh --profile acp，再确认 Backchat 自定义命令是 dsh、参数是 --profile acp，并确保两个进程共用 DSH_HOME。