在使用 DSH 處理複雜任務時，常會遇到需要即時驗證細節或回答支線問題的情況。如果直接在主會話中打斷，容易導致上下文混亂；若切換窗口，又會中斷心流。dsh-sidenote 插件通過側邊欄機制，允許你 fork 主會話並在不干擾主線的前提下處理支線問題。
插件介紹¶
這是 g-yixuan 維護的 DSH 客戶端插件。它提供“側邊開一岔對話”的能力，通過 fork 主會話成側邊會話，支線問題不打斷主線，並支持結論一鍵迴流。
核心功能¶
- 側邊開一岔對話：fork 主會話成側邊會話。側邊會話是真實 DSH 會話（全量歷史快照），與主會話能力對等。
- 支線問題不打斷主線：繼承歷史默認摺疊成指示卡。摺疊態/滾動位置刷新不丟。
- 結論一鍵迴流：側邊結論一鍵“迴流到主會話”。問答成對（結論 + 它回答的問題）收爲受控 chip 掛在主輸入框上方，隨下一條消息發給主線。
- 劃選留一條註釋：劃選 assistant 回覆 → 浮層 → 註解編輯器，右緣編號角標錨定原文。發送後氣泡收成“批註 ×N”標籤留痕。
- 原生級工具卡：與主對話同一套渲染材質。工具卡、思考預覽、任務卡、模型/權限切換、
@引用、圖片附件均可用。 - 審批/提問在面板內直接答覆：不用跳回主視圖。跑完有 toast 通知。
- 草稿零污染：註釋是受控對象（可預覽、可逐條移除），發送瞬間才序列化爲模型可讀的結構化協議塊。
安裝與啓用¶
安裝命令如下：
dsh plugin --profile web add dsh-sidenote
啓用後，通過以下三個入口進入側邊欄：
* 頂欄「側邊」按鈕
* 右側欄 guide
* 斜槓命令 /side
典型用法¶
- 切入側邊欄：點擊頂欄「側邊」按鈕或輸入
/side，插件會將當前主會話 fork 到右側。 - 處理支線問題：在側邊欄進行多輪對話，主會話保持靜默，不干擾當前上下文。
- 切換焦點：使用
Alt+J快速在主↔側邊焦點間切換。 - 迴流結論：側邊對話得出結論後，點擊迴流，結果會以 chip 形式掛在主輸入框上方。
- 劃選註釋：在主對話中劃選任意回覆文本，可添加註釋。
注意事項與兼容性¶
- 版本兼容：
- DSH ≥ 0.1.5-rc.1：直連 DSH 原生右側邊欄（無需安裝 dsh-better-sidebar）。
- DSH ≤ 0.1.2-rc.x：需配合 dsh-better-sidebar（必需）。
- 共存性：與 dsh-better-sidebar 天然共存，各自注冊、互不依賴。
- 單實例語義：受宿主“page kind 每 pane 單實例”規則約束。同一會話同時只開一個側邊聊天（再次打開/新建 = 聚焦既有 tab；關閉後可經
/side重開恢復原會話）。 - 降級策略：宿主面缺席時插件按能力降級，不崩頁面。
- 發佈機制：發佈走 npm Trusted Publishing（OIDC）。不需要 npm token，不需要 OTP。觸發條件是“發佈一個 GitHub Release”，不是推 tag。
短結尾¶
dsh-sidenote 通過將 fork 會話與主會話隔離，解決了多任務並行處理的上下文切換痛點。對於需要在同一任務流中穿插驗證、調研或細碎提問的開發者，該插件能有效保持列表衛生與工作流連貫。
