shenkonghui/dsh-llm-acp

@deepseek-ai/dsh-llm-acp

中文 | English

DeepSeek Harness 的 ACP 客户端 LLM 适配器 + ACP 服务设置界面。通过外部 Agent Client Protocol 服务器作为模型提供方接入 harness 的 LLM 层，并提供一个 Web 设置页面用于浏览 ACP 注册表和管理已配置的服务器。

本包是一个双面 dsh 插件：宿主端（lib/index.js）是传输适配器，在 ctx.llm 上注册 provider 路由；客户端（lib/client.js）是浏览器设置页面，让用户从 Web UI 浏览 ACP 注册表并添加/删除 ACP agent 服务器。

界面

ACP注册表添加acp-server

支持acp registry上的所有acp-server[https://agentclientprotocol.com/get-started/registry]

如claude,codex,opencode等

ACP服务管理

使用acp-server进行交互

安装

dsh plugin --profile my-acp add github:shenkonghui/dsh-llm-acp

或从本地目录安装：

dsh plugin --profile my-acp add ./dsh-llm-acp

构建产物（lib/）已提交到仓库，安装时无需运行任何构建脚本。

卸载

dsh plugin --profile my-acp remove @deepseek-ai/dsh-llm-acp

这会从 profile 中移除依赖和 bundle 层。

配置

安装后，在 Web UI 中打开 设置 → ACP 服务。浏览 ACP 注册表，在任意 agent（如 Devin、Codex、Claude Agent）上点击 添加，即可将其配置为 ACP 服务器。每个已配置的服务器会创建一个独立的 provider 路由 acp-<server-id>。

在 我的服务 标签页中，点击任意已配置服务器上的 编辑 按钮，可以：

• 设置环境变量用于认证（如 DEEPSEEK_API_KEY、OPENAI_API_KEY）。每个服务器的环境变量会与插件级 env 合并，服务级优先。
• 选择要启用的模型。从服务器发现的模型目录中多选要暴露的模型，不选则启用全部已发现的模型。

ACP server 不单独保存权限策略。它复用会话输入框中的权限列表：read-only 和 workspace-write 将敏感操作转发到 harness 审批界面，danger-full-access 自动允许。

也可以直接在 settings.yaml 中配置：

llm-acp:
  servers:
    devin:
      command: devin
      args:
        - acp
      name: Devin
      env:
        DEEPSEEK_API_KEY: sk-xxx
      models:
        - deepseek-chat
        - deepseek-reasoner

工作原理

整体流程

1. 插件加载阶段（apply()，src/index.ts）

dsh harness 启动
  └─ apply(ctx, config)
       ├─ 读取 llm-acp 设置命名空间 + 内联 config.servers，合并成服务器列表
       ├─ 对每个服务器 createServer()：
       │    ├─ resolveNpxShortcut()：npx -y <pkg> 若 bin 已在 PATH 则直接用 bin
       │    ├─ new AcpConnection()：spawn 长生命周期子进程（stdin/stdout JSON-RPC）
       │    │    └─ initialize() 握手 → 仅配置了 API key 时才 authenticate()
       │    │       （无 key 直接走 env/缓存登录；session/new 失败才惰性补一次 authenticate；
       │    │         广告多种方式且未选 authMethod 时不猜、不起轮，交给 UI 选择）
       │    ├─ new AcpAdapter()：构造时 discoverModels() 探测模型目录
       │    └─ ctx.llm.registerAdapter(['acp-<server-id>'], adapter)
       └─ reconcileDirectory()：向设置页注册可配置 provider 目录