dsh-subagent

使用

在 dsh 会话里让父 agent 调用工具即可,例如:

用 qoder 子代理:在这个仓库里找出所有 TODO 注释并汇总

父 agent 会调用 qoder 工具,插件 spawn qodercli -p ... 并返回子代理的最终文本。qodercn 工具走国内版 CLI。

斜杠指令

输入框里直接敲:

/qoder 统计当前目录每个顶层目录的文件数并汇总
/qodercn 把 README 翻成英文

指令是快捷方式:把任务作为消息交给当前会话,由 agent 调用对应工具发起委派——所以实时进度面板、扣费显示、完成通知与普通工具调用完全一致。指令名跟随 providers 配置自动注册。

进度随时可查(像本地子任务)

• 对话内实时面板:委派工具行显示状态徽章(运行中/已完成/出错)、计时、子代理动作流(思考 ◎、工具调用 ⚙、输出 ▸),点击展开完整过程,运行中每 2 秒刷新;结束后面板给出 qodercli --resume 命令,可在 CLI 回看/继续该子会话。
• 父 agent 查询工具 qoder_subagent_status:随时可查任意委派的进度——省略 run_id 列出最近运行及最新动作,传 run_id(started subagent 里的那个)返回事件转录。问"子代理到哪了"不再得到"我看不到"。

配置

在 profile 里覆盖 dsh-subagent 节点的 config(providers 数组,每项一个后端):

字段	默认	说明
name	必填	提供方名,须与 patch 里 dsh-tool-subagent 的 provider 一致
driver	qoder-json	传输驱动;目前仅实现 qoder-json
binary	自动探测	CLI 绝对路径;内置名(qoder/qodercn)可省略
permissionMode	bypass_permissions	headless 无法弹权限确认,故默认放行
model	沿用 CLI 默认	强制模型 id;留空用 CLI 默认(如免费模型)
reasoningEffort	auto	auto/none/low/medium/high/xhigh/max/ultracode
contextWindow	CLI 默认	正整数 token 数
timeoutSeconds	无上限	单次委派墙钟上限
extraArgs	[]	追加的 CLI 参数

默认 providers 为 [{name:"qoder"},{name:"qodercn"}]。