前言¶
在 DeepSeek Harness（DSH）里，一个 Session 可能仍在执行任务，而另一个 Session 或 Agent Team Room 已经需要其中的一部分结论。dsh-sideband 用于在这种场景下做异步上下文交接：先做有边界的捕获，再用独立的无工具 LLM 调用摘要，最后按 quiet 或 wakeup 模式投递。
这是什么¶
dsh-sideband 是一个由 ishuowang 维护的 DeepSeek Harness 插件，许可证为 MIT。它的定位是：Asynchronous, LLM-summarized context handoff between DeepSeek Harness sessions and agent rooms。
它适合在源 Agent 仍在处理、你不希望等待或打断当前 turn 的场景。它不把完整 transcript 当作共享内存，也不替代聊天 UI；它把命令边界内的可见用户文本和可见模型文本投影出来，再形成带 provenance 的上下文包。
核心功能¶
异步处理¶
/sideband 命令在准入后返回 job id。摘要和投递在后台继续，可以查询状态或取消任务。
命令边界捕获¶
捕获发生在命令边界。插件只投影可见用户文本和可见模型文本，并排除以下类型：
- system/developer instructions
- plugin context
- reasoning
- tool calls/results
- attachments
--focus 只用于摘要器，不会发送给 source model。
独立摘要¶
插件使用独立的无工具 LLM 调用处理捕获的 transcript。/sideband 命令本身不是 prompt，它运行在 DSH 的原生命令平面，不进入 source model。
投递模式¶
quiet 是 Session 的默认模式：把上下文留给目标下一轮，不唤醒目标。
wakeup 会安排目标 turn，这可能消耗模型配额。
原生目标选择¶
插件使用 DSH 官方 popupSelect 提供原生 UI 目标选择。输入裸命令可以在 DSH Web 里选择另一个普通 Session。完整命令仍可用于 scope、focus、Room 目标、status 和 cancel。
Room 投递¶
dsh-sideband 支持可选投递到 Agent Team Room。Room 目标需要 Agent Team Room。
provenance¶
投递内容携带 job、时间戳、命令边界、范围、focus 和投递模式等信息，便于目标识别来源。
安装与启用¶
安装前确认环境满足：
- Node.js
^22.19.0 || >=24 - DeepSeek Harness
0.1.0-rc.6
该包尚未发布到 npm registry，当前支持的安装路径是固定 GitHub 版本。
dsh plugin --profile web add github:ishuowang/dsh-sideband#v0.1.0
典型用法¶
先列出当前可见目标：
/sideband targets
捕获最近 16 条可见消息，提取发布决策和未解决风险，并静默投递到另一个 Session：
/sideband send session:<session-id> --last 16 --focus "release decisions and unresolved risks" --delivery quiet
命令会立即返回类似：
Sideband queued: sb-…
查询或取消后台任务：
/sideband status <job-id>
/sideband cancel <job-id>
向 Room 投递聚焦上下文：
/sideband send room:<room-id> --focus "API contract changes"
通用格式：
/sideband send session:<id>|room:<id> [--last N|--all] [--focus "..."] [--delivery quiet|wakeup]
选项说明：
--last N：最近N条可见消息。--all：全部可见历史。--focus "..."：告诉摘要器需要保留哪些信息；不会发送给 source model。--delivery quiet：Session 默认，不唤醒目标。--delivery wakeup：会安排目标 turn，可能消耗模型配额。
兼容别名 --full 存在，但新脚本应使用 --all。
投递内容¶
目标收到的是带 provenance 的上下文包，形式上类似：
[Sideband recalled context]
Sideband job: sb-…
Job created: 2026-08-14T12:34:56.000Z
Delivery option: quiet
Source Session: …
Captured: 2026-08-14T12:34:56.000Z
Source command boundary: 42
Scope: last 16 visible messages
Focus: release decisions and unresolved risks
这里的重点是：投递内容携带 job、时间戳、命令边界、范围、focus 和投递模式等信息。
适用场景与注意¶
适合：
- 源会话仍在运行，不想等待或打断当前 turn。
- 需要把可见对话中的部分结论交给另一个 Session 或 Agent Team Room。
- 需要保留投递 provenance，便于目标区分来源。
注意：
- 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
/sideband不进入 source model。--focus不会发送给 source model。wakeup模式可能消耗模型配额。- Room 目标需要 Agent Team Room。
- 社区目录 listing 是社区发现，不是 DeepSeek 认证或背书。
结尾¶
dsh-sideband 的价值是把“现在需要、但不想打扰源会话”的上下文，以异步、摘要、带来源信息的方式送到另一个 DSH 目标。
目录页：https://awesome-dsh-plugin.com/p/ishuowang/dsh-sideband/
GitHub：https://github.com/ishuowang/dsh-sideband
