dsh-acp-for-bitfun：让 DeepSeek Harness 通过 ACP 调用 BitFun 子代理

dsh-acp-for-bitfun 是 DeepSeek Harness（DSH）的插件（DSH plugin），由 bobleer 维护，采用 MIT 协议，用于将 BitFun 接入 dsh 作为 subagent。它解决的是在 dsh 会话中无法直接调用 BitFun 能力的问题，通过 Agent Client Protocol (ACP) v1 over stdio 实现通信。核心能力包括：在 dsh 中暴露 subagent_bitfun 工具，将任务委托给 BitFun 执行，并支持配置权限策略、环境变量和启动探测。

dsh-acp-for-bitfun 这个 DSH plugin 如何工作？

该插件复用 dsh 官方的 @deepseek-ai/dsh-subagent-acp 作为 ACP 客户端，每次委托任务时启动一个全新的 bitfun acp 子进程，完成 initialize → session/new → session/prompt 流程，并流式收集 agent_message_chunk。工具通过 @deepseek-ai/dsh-tool-subagent 挂载，模型看到的工具名默认为 subagent_bitfun。任务结束时，插件会关闭子进程 stdin，并依次使用 EOF 宽限 6 秒、SIGTERM、SIGKILL 来终止进程，确保 BitFun 子进程在 SIGTERM 下立即退出，会话数据由 BitFun 自身持久化。

dsh-acp-for-bitfun 怎么安装？

安装前需要满足前置条件：BitFun CLI 已安装且 bitfun acp doctor 通过，dsh 版本不低于 0.1.0-rc.6，以及 pnpm 可用。然后执行以下命令：

dsh plugin --profile web add github:bobleer/dsh-acp-for-bitfun

或者从本地 checkout 安装：

dsh plugin --profile web add ./dsh-acp-for-bitfun

启动 dsh：

dsh web

加载时插件会用 bitfun --version 探测 BitFun CLI，如果不在 PATH 上，启动会直接失败（fail loud），并提示安装 BitFun 或配置绝对路径。

dsh-acp-for-bitfun 支持哪些配置项？

在 profile 的 cordis.patch.yml 中按 id 覆盖配置，主要配置项包括：command（BitFun CLI 路径，默认 bitfun）、providerName（默认 bitfun）、toolName（默认 subagent_bitfun）、permission（默认 reject，可选 allow）、acpArgs（默认 ['acp']）、env（额外环境变量）、checkOnStart（默认 true，加载时探测）。例如：

- id: bitfun-acp
  name: dsh-acp-for-bitfun
  config:
    command: /absolute/path/to/bitfun
    permission: allow

dsh-acp-for-bitfun 如何验证是否正常工作？

验证步骤包括：1) 在 BitFun 侧运行 bitfun acp doctor 自检；2) 在 dsh 配置树中确认插件行，使用 dsh --profile web --dump-config | grep -A 2 bitfun；3) 在 dsh 会话中让模型调用 subagent_bitfun 工具，委托一个简单任务（例如“用 subagent_bitfun 回复 hello”），确认返回 BitFun 的输出。

dsh-acp-for-bitfun 兼容哪些 DeepSeek Harness 版本和平台？

该插件要求 BitFun 版本不低于 0.2.17（支持 ACP v1 server），dsh 版本不低于 0.1.0-rc.6。由于 deepseek-harness 目前处于 developer preview，插件依赖其 rc 版本，升级 dsh 时需同步升级本 bundle。插件由 bobleer 维护，采用 MIT 协议，最近更新于 2026-08-13。

查看更多 DSH 插件，访问 dsh-plugin.org