DeepSeek Harness Plugin

在 DeepSeek Harness Desktop 中安装 Busabase Plugin，再选择托管本地、已有服务器或 Cloud 模式。

在 DeepSeek Harness Desktop 中安装 @busabase/dsh-plugin，即可将 DeepSeek Harness 连接到 Busabase Cloud 或本机 Busabase。

首次启动前先选择连接方式

托管本地模式是零配置默认选项。如果 Desktop 或其他应用已经管理本机 Busabase 进程，请选择已有服务器模式；使用托管工作区或需要多设备访问时请选择 Cloud。

1. 在 Desktop 中安装 Plugin

打开 DeepSeek Harness Desktop。
复制插件名称：@busabase/dsh-plugin。
打开 Add plugin，粘贴名称，并选择 Official npm registry。
点击 Install。

已安装的 Plugin 不会自动更新。之后需要更新时，先在 Desktop 中卸载该 Plugin，再重新安装 @busabase/dsh-plugin。

2. 选择服务器模式

托管本地：由 Plugin 管理 Busabase

需要免账号使用和本机私有数据时请选择托管本地模式。无需额外配置：Plugin 默认连接 http://localhost:15419，需要时启动 Busabase，或复用该地址上健康的服务。

当 Busabase Desktop 或其他应用已经内嵌或运行 Busabase 时，请选择已有服务器模式。在插件实际使用的 profile 中，将 baseUrl 设为 loopback 地址，并设置 server.mode: external。下文的文件路径和示例仅适用于 CLI 的 web profile；不要假设 Desktop 使用同一 profile 或路径。请先启动该服务器——Plugin 只会探测配置的地址，绝不会启动或停止它。baseUrl 应使用 localhost、127.0.0.1 或 ::1；非 loopback 地址会进入远程 OAuth 模式。

Cloud：托管与共享工作区

已有 Busabase 账号、需要团队协作或多设备访问时请选择 Cloud。将 baseUrl 设为 https://busabase.com，重启 DeepSeek Harness，并完成一次浏览器 OAuth 授权。DeepSeek Harness 会把授权结果保存到凭据存储中，并在后续启动时复用。请通过每条 Change Request 中包含的正式链接，在 Busabase Cloud 中审核变更。

3. 重启 DeepSeek Harness

安装 Plugin 或修改其配置后，请重启 DeepSeek Harness Desktop——Plugin 与配置的变更不会应用到已经在运行的会话。

接下来的行为取决于所选连接方式：

托管本地： Busabase 会保持停止，直到首次调用 busabase_start。
已有服务器： 先启动 Busabase。busabase_start 只验证服务器并重新连接 MCP 工具，不会启动进程；如果服务器不可用，会直接报告所配置的地址。
Cloud： 默认浏览器会打开 Busabase 登录与授权页。批准后会自动注册 Cloud MCP 工具；Cloud 模式没有 busabase_start。

4. 验证所选连接

在 Desktop 的 Plugin 列表中，确认 @busabase/dsh-plugin 显示为已安装且处于启用状态。

两种本地模式都可以这样开始：

先调用 busabase_start，再列出我的所有 Busabase Base，并概括每个 Base 的内容。

Cloud 模式完成浏览器授权后，可以这样验证：

先调用 auth_verify，再列出我的 Busabase 工作区顶层内容。

所有模式下，Agent 都可以读取已批准数据，并通过 Change Request 提交写入建议。两种本地模式都可以在 Harness 会话内预览和审核；Cloud 模式请通过 Change Request 中的正式 Busabase 链接在云端审核与合并。

Agent 连接权限上限固定为 changeRequest；Agent 不能批准或合并自己的提案。

改用 CLI

DeepSeek Harness 还提供 CLI（dsh），部分场景会单独或配合 Desktop 使用它。以下命令仅适用于 CLI，并不描述 Desktop 界面中的任何内容。

前置条件

Node.js >=24.18.0
pnpm 命令可用

安装、更新或删除

# 安装
npx @deepseek-ai/dsh plugin --profile web add @busabase/dsh-plugin

# 更新
npx @deepseek-ai/dsh plugin --profile web update @busabase/dsh-plugin

# 删除
npx @deepseek-ai/dsh plugin --profile web remove @busabase/dsh-plugin

以上命令作用于 web profile。执行任一命令后都要重启该 profile——新增、更新或删除 Plugin 不会改变正在运行的 profile。

配置已有服务器或 Cloud 连接

创建或编辑 $DSH_HOME/profiles/web/cordis.patch.yml；未设置 DSH_HOME 时默认路径为 ~/.dsh/profiles/web/cordis.patch.yml。

已有服务器：

- id: busabase
  config:
    baseUrl: http://127.0.0.1:15419
    serverName: busabase
    server:
      mode: external

Cloud：

- id: busabase
  config:
    baseUrl: https://busabase.com
    serverName: busabase

如果文件中已有其他配置，请追加该列表项，不要覆盖整个文件。Profile override 会替换匹配 Plugin 的完整 config，因此你需要保留的其他非默认 Busabase 设置也应写在同一个区块中。不要在此文件中填写密码或 token。

通过 CLI 启动与验证

npx @deepseek-ai/dsh --profile web

如果浏览器没有自动打开，请访问 http://127.0.0.1:3080。

npx @deepseek-ai/dsh plugin --profile web list --depth=0
npx @deepseek-ai/dsh --profile web --dump-config

第一条命令的输出应包含 @busabase/dsh-plugin。busabase 配置应显示所选 baseUrl；已有服务器模式还必须在 server 下显示 mode: external。

恢复旧版 CLI 安装

旧版通过 preinstall 脚本要求构建授权。如果遇到 ERR_PNPM_IGNORED_BUILDS，先更新到当前版本，再运行 add；当前包无需构建授权。重启后重新运行两条验证命令。

npx @deepseek-ai/dsh plugin --profile web update @busabase/dsh-plugin
npx @deepseek-ai/dsh plugin --profile web add @busabase/dsh-plugin

将 CLI 切回托管本地

删除 Busabase override，或替换为以下配置，不保留 server.mode: external，然后重启 profile。

- id: busabase
  config:
    baseUrl: http://localhost:15419
    serverName: busabase

已有 Cloud 凭据仍保存在 DSH 凭据存储中，不会复制到本地工作区。

安装失败怎么办

如果 Cloud 登录页没有自动打开，请在终端（CLI）或 Desktop 插件日志中查找授权 URL。首次 OAuth callback 必须能够访问运行 DeepSeek Harness 的同一台电脑；远程或无界面环境可能需要 loopback 端口转发。

如果已有服务器模式提示 Busabase 不可用，请核对 host 和端口，启动负责管理该进程的应用，再次调用 busabase_start。external 模式不会自动回退到托管进程。

Busabase DeepSeek Harness Plugin 源码