dsh-subagent-codebuddy

> CodeBuddy Code CLI 子代理插件 — DeepSeek Harness (dsh) 的独立推理子代理提供方 > 把腾讯 CodeBuddy CLI 接入 dsh：每个子代理是 dsh 进程内的独立会话（可并行、可续聊），每次 LLM 调用经适配器 spawn CodeBuddy 执行。完全遵循 dsh 官方扩展机制，零源码改动。

一、这是什么

dsh-subagent-codebuddy 以 LLM 适配器架构（对齐 dsh-llm-agy）把 CodeBuddy 注册为 dsh 子代理提供方：

能力	说明
独立推理子代理	注册 `codebuddy` provider 路由与 `subagent_codebuddy` 委派工具
进程内会话管理	每个子代理是 dsh 内 child agent——可并行创建、`send_message` 续聊，互不干扰
上下文由 dsh 管理	每次调用把该子代理的完整历史序列化进 prompt，不依赖 CodeBuddy 存储
工具步骤回传	文本与工具步骤（`tool/call` + `tool/result`）在 dsh 会话与 CodeBuddy 进程间双向翻译

与"ACP 直接子代理"方案的区别：子代理是 dsh 进程内 agent，上下文连续性由 dsh 会话管理，不存在 CodeBuddy 按 cwd 自动续上下文造成的跨任务串味（实测 codebuddy --acp 按工作目录自动续上一会话、参数无法隔离，故本插件不走 ACP）。

二、核心功能

1. 子代理提供方（provider 路由 `codebuddy`）

subagent_codebuddy 工具 → dsh 子代理 → CodebuddyLlmAdapter → codebuddy -p --output-format stream-json。CodeBuddy 拥有自己的系统提示词、工具面、模型与权限执行；dsh 负责子代理生命周期与上下文。

2. 图片输入（粘贴/引用 → 本地路径）

用户消息里的图片块由序列化层落盘为临时文件，prompt 中给出本地路径，CodeBuddy 自行读取看图。

3. 长上下文保护（Windows 命令行 32K 限制）

prompt 超过阈值（26K 字符）自动写入临时任务文件，命令行只给短引用，CodeBuddy 完整读取任务描述。

三、快速开始

系统要求

dsh >= 0.1.0-rc.6(兼容性验证日期:2026-08-21,验证于 dsh rc.8)
CodeBuddy CLI 已安装并登录(子进程继承登录态)

安装插件

方式一（推荐，lib/ 已随仓库提交，免构建）：

node scripts/link-profile.mjs            # 默认装配进 web profile
# 或等价于:dsh plugin --profile web add <本仓库目录>

方式二（发布仓库安装）：

dsh plugin --profile web add https://github.com/flg1217/dsh-subagent-codebuddy

插件行由插件自带的 cordis.patch.yml(bundle patch)自动注入,默认配置开箱即用。需要覆盖默认值时,在 profile 的 cordis.patch.yml 用同 id 覆盖即可:

- id: subagent-codebuddy
  config:
    model: <其他模型>   # 默认 deepseek-v4-flash

完成后重启 dsh web，重开会话，工具列表出现 subagent_codebuddy 与 list_codebuddy_models。

卸载插件

dsh plugin --profile web remove @flg1217/dsh-subagent-codebuddy

如残留，手工清理：移除 profile（~/.dsh/profiles/web）的 cordis.patch.yml 中 subagent-codebuddy 的 - insert 块，以及 package.json dependencies 中对应的 @flg1217/dsh-subagent-codebuddy 行。卸载后重启 dsh web 即完全移除（CodeBuddy CLI 本身不受影响）。

动态模型选择

subagent_codebuddy 接受可选参数 model：主代理可传入模型 id 覆盖插件默认模型（不传则用配置的 model）。
list_codebuddy_models 从 codebuddy --help 实时解析当前支持的模型 id 列表，主代理可先查询再传入准确 id。

配置项

键	默认	含义
`command`	`codebuddy`	可执行文件（Windows 自动解析 npm cmd-shim → `node <真实CLI>`）
`model`	`deepseek-v4-flash`	CodeBuddy 模型 ID（`--model <id>`）
`permissionMode`	`bypassPermissions`	`--permission-mode`：子代理工具调用自动放行
`extraArgs`	`[]`	追加的 CodeBuddy 参数
`providerName`	`codebuddy`	LLM provider 路由名
`toolName`	`subagent_codebuddy`	模型可见工具名
`registerSubagentTools`	`true`	是否注册委派工具

四、典型用法

委派设计任务：主代理把前端/UI 任务委派给 subagent_codebuddy（continuable，可复用作图长线会话），可用 model 参数动态指定模型。
并行调研：拆分独立任务到多个 CodeBuddy 子代理并行执行，结果互不干扰。
模型选择：委派前先调 list_codebuddy_models 查询当前支持的模型 id，再以 model 参数传入。
保守权限：默认 bypassPermissions 全自动；如要更保守，改 acceptEdits 或 plan。

五、工作原理

tool-subagent(provider: spawn, backgroundMode: continuable)
  └─ 子代理 = dsh 进程内 child agent(会话可常驻,send_message 可续聊)
       └─ 每次 LLM 调用 → CodebuddyLlmAdapter → spawn `codebuddy -p --output-format stream-json`
            └─ 翻译文本与工具步骤(tool/call + tool/result)回 dsh 会话

子代理会话生命周期由 dsh 提供；每次调用把该子代理自己的完整历史序列化进 prompt。
CodeBuddy 的模型、网络与配额由 CodeBuddy 侧负责，插件只做 LLM 适配桥接。

六、参与开发

pnpm install        # 安装 typescript + vitest
pnpm build          # tsc 编译 → lib/(产物随仓库提交,免构建安装)
pnpm test           # vitest 单元测试(serialize 等)
pnpm typecheck      # tsc --noEmit

提交前检查：git status 无遗留文件；lib/ 与测试同步更新。发布仅 git push（不做 npm publish）：

git add -A && git commit -m "feat/fix: ..." && git push origin master

七、许可证

MIT

来源信息

安装

检查来源文件