后台子代理 kenjoe41/dsh-sidecar

dsh-sidecar

在后台启动专注的子代理，给它们起唯一的名字、分配独立的空间，然后按你自己的节奏逐个查看结果——任务、答案、证据链，需要时还能调出完整对话记录。独立插件：与 dsh-autocontinue（续跑/重启）和 dsh-update 更新器不共享任何状态。

命令与工具

/sidecar <task> # auto name (sidecar-1, -2, ...), parent cwd
/sidecar --name alpha <task> # unique name, pinned as the child session title
/sidecar --cwd /tmp/alpha-space <task> # separate working directory
/sidecar --worktree --name wt-fix <task> # isolated git worktree + branch sidecar/wt-fix
/sidecar list # running sidecars: name, id, age, cwd
/sidecar result <id> # read and consume a stored result now
/sidecar log <id> # full child transcript on demand
/sidecar cancel <id> # interrupt one

多个 sidecar 可以并发运行，上限由子代理服务的 maxActiveSubagents 决定，默认 8。每个 sidecar 都有唯一的名字（如果请求的名字已被占用，会加上 -2、-3……后缀）、独立的子会话 id，标题固定为这个名字，这样 GUI 列表里不会混淆。默认与父级共用 cwd；需要独立工作区就用 --cwd，需要真正的文件系统/分支隔离就用 --worktree。worktree 从 HEAD 开始——父级未提交的改动有意不带到那里。

面向模型的工具（父级决定查看结果时使用）：

- sidecar_result — { id } 返回已存储的待查看内容，并从队列中移除。
- sidecar_list — 列出等待查看的已存储结果。

投递方式：发通知，不排用户消息

子代理通过 ctx.subagents.startActivation() 启动，delivery: 'caller'；它的提示词禁止调用 send_message，也禁止继续向下委派。

子代理完成后，插件会：

1. 把完整结果存到 ~/.dsh/sidecar/results/<parent>/<child>.json；
2. 调用 agent.inject(notice)——一条下一步通知，不唤醒。这不是 followup：不会创建排队的用户消息，也不会启动一轮对话。正在运行的父级会在下一步看到它；空闲的父级会在下次运行时看到。通知只说明结果已存储、sidecar_result 会返回它；
3. 绝不把完整结果注入对话记录。父级通过调用 sidecar_result（或用户运行 /sidecar result <id>）查看，结果以工具结果的形式返回，同时消费掉该文件。

存储的待查看内容刻意保持精简：

- sidecar 收到的完整任务（让父级知道这个结果是干什么的），
- 最终答案，
- 精简证据链：按顺序记录每次工具调用及其结果（上限 8 KB），
- 子会话 id，以及指向 sidecar_log 的提示。
子代理的完整会话日志都留在磁盘上，包括工作区指令、推理过程和每一步操作。需要时用 sidecar_log（或 /sidecar log <id>）取回。默认把整份原始日志推给父代理，会让有用的任务和答案淹没在好几页工作区样板文字里，所以这个行为要手动开启。

如果父代理还没看到通知就关闭了，文件会保留下来；下次创建那个父代理时（会话重新打开或恢复），通知会再次注入。如果通知已经被消费或错过了，可以用 sidecar_list 查找。

安装

dsh plugin --profile web add github:kenjoe41/dsh-sidecar
or pin a release
dsh plugin --profile web add github:kenjoe41/dsh-sidecar#v0.4.0

本地检出的话，改用链接方式安装；链接安装需要 node_modules/@deepseek-ai/{dsh-llm,dsh-tools} 垫片，好让配置档的 peer 依赖能解析。安装后重新加载或重启配置档。