前言¶

在 DSH 里接入外部 CLI 推理能力时，常见需求是把任务委派给独立子代理，同时保留会话续聊、并行执行和工具步骤回传。下面介绍仓库 flg1217/dsh-subagent-codebuddy 中的插件：它把 CodeBuddy Code CLI 注册为 DSH 的独立推理子代理提供方，并暴露 subagent_codebuddy 委派工具。

这是什么¶

flg1217/dsh-subagent-codebuddy 是 MIT 许可证的 DSH 插件，由 flg1217 维护。

它的定位是把 CodeBuddy Code CLI 接入 DSH，使 DSH 可以创建进程内子代理、并行委派任务、继续对话，并接收文本与工具步骤。

核心功能¶

1、注册 codebuddy provider 路由与 subagent_codebuddy 委派工具。

2、进程内子代理会话管理，可并行创建，并用 send_message 续聊。

3、上下文由 DSH 管理；每次调用会把该子代理的完整历史序列化进 prompt。

4、文本与工具步骤在 DSH 会话与 CodeBuddy 进程间双向翻译，工具步骤包括 tool/call 与 tool/result。

5、图片输入会落盘为临时文件，prompt 中提供本地路径。

6、长上下文保护：prompt 超过阈值（26K 字符）时自动写入临时任务文件。

7、动态模型选择：subagent_codebuddy 接受 model 参数；list_codebuddy_models 用于查询模型 id。

安装与启用¶

先确认系统要求：

dsh >= 0.1.0-rc.6
CodeBuddy CLI 已安装并登录

兼容性验证日期为 2026-08-21，验证于 dsh rc.8。子进程会继承 CodeBuddy CLI 登录态。

安装命令如下，使用 web profile：

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

安装后，工具列表中会出现 subagent_codebuddy 与 list_codebuddy_models。

卸载命令：

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

如仍有残留，需要手工清理 profile 配置和 package.json dependencies 中对应的依赖项。

典型用法¶

1、将前端/UI 等设计任务委派给 subagent_codebuddy，可传 model 参数动态指定模型。

2、拆分独立任务到多个 CodeBuddy 子代理并行执行，结果互不干扰。

3、委派前先调用 list_codebuddy_models 查询当前支持的模型 id，再把准确 id 作为 model 参数传入。

4、权限模式默认是 bypassPermissions，子代理工具调用自动放行；如需更保守，可改 acceptEdits 或 plan。

适用场景与注意¶

适合已经在 DSH 中使用 web profile，并希望把 CodeBuddy Code CLI 作为独立子代理提供方接入的用户。插件会运行在 DSH 插件机制内，并继承 DSH 当前进程权限，安装前建议先检查源码与许可证。

需要注意：默认权限模式较宽松，bypassPermissions 会自动放行子代理工具调用。若用于更高权限敏感环境，应改为 acceptEdits 或 plan。

本次资料中名称不完全统一：仓库名为 flg1217/dsh-subagent-codebuddy，README 标题为 dsh-subagent-codebuddy，package.json 包名为 @flg1217/dsh-subagent-codebuddy。本文以仓库地址指代该插件。

结尾¶

这个插件的价值在于把 CodeBuddy Code CLI 作为可委派、可并行、可续聊的子代理接入 DSH，同时把上下文管理和工具步骤回传留在 DSH 会话内。

GitHub 仓库地址：

https://github.com/flg1217/dsh-subagent-codebuddy

目录页链接未在本次已核实资料中提供。