前言¶
在 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
