前言¶
在 DeepSeek Harness（DSH）裏同時開多個 Agent 會話時，某個會話可能在後臺等你審批工具、回答提問或確認計劃，而當前焦點在別的會話上。側邊欄裏逐條看狀態容易漏掉。下面介紹社區插件 dsh-traffic-light：在 Web UI 側邊欄左下角用三顆燈彙總全部會話的運行與等待情況，並在進入紅燈或（可配置的）黃燈時蜂鳴提醒。
這是什麼¶
dsh-traffic-light 由維護者 juntaoqian 發佈，分類爲客戶端插件。它是純前端實現：無第三方 npm 依賴、無構建步驟，不申請文件、網絡或工具類 Host 權限。配色使用 DSH 主題 token，淺色與深色主題自動適配。作者在 DSH 0.2.1-rc.5（桌面版）上驗證通過。
核心功能¶
三燈含義¶
- 綠燈：有會話在運行（默認「任一會話運行即綠燈」，可在設置裏改爲「全部會話都運行才綠燈」）。
- 紅燈：任一會話存在待你處理的交互（
pendingInteraction非空，例如審批請求、ask_user_question、計劃確認）。紅燈那顆帶呼吸閃爍。 - 黃燈：沒有會話在運行，也沒有會話在等待。
界面與彙總¶
左下角控件位於側邊欄底部、Settings 按鈕上方，三顆燈橫向排列，當前狀態對應那顆點亮。插件彙總當前頁面可見的會話集合（與側邊欄會話列表一致，含子會話）。紅燈時可在燈旁顯示等待數量角標；懸停可查看運行中、等待選擇、會話總數。側邊欄展開時可顯示狀態文字；摺疊成窄欄時只保留三顆燈。Windows 標題欄模式下若摺疊側邊欄導致 DSH 隱藏整個側欄腳部，燈會不可見，但蜂鳴仍工作。
蜂鳴與音效¶
狀態切換時纔會響，不會因重渲染或改設置重複響；頁面剛打開時若已是紅/黃，不會補響。進入紅燈必響；紅燈期間又多一個會話開始等待也會響（受總開關控制）。進入黃燈是否響由「回到空閒時也蜂鳴」控制，默認開。提供 6 種音效（經典蜂鳴、清脆鈴音、短促提示、警報雙響、低沉提示、上升三連音），切換時可試聽；音量、時長、重複次數共用。瀏覽器要求至少一次用戶手勢後才能播放聲音，點一下頁面或按鍵後即可解鎖。
設置頁¶
安裝後在 Settings → 紅綠燈 可配置：顯示控件、蜂鳴總開關、空閒時蜂鳴、音效、音量（默認 60%）、時長（默認 160 ms）、次數、綠燈判定、狀態文字、等待角標等；另有試聽與恢復默認。選項保存在瀏覽器 localStorage 的 dsh.traffic-light.options.v1，改動立即生效，重啓後保留。界面文案跟隨 DSH 語言（中英）。
安裝與啓用¶
前置環境爲 DeepSeek Harness 桌面版或 dsh web，並依賴 DSH 的 Client slot 機制。
圖形界面（推薦）¶
- 側邊欄打開 Plugins。
- 選擇 Add plugin → Install a third-party plugin。
- 在包名處填寫：
git+https://github.com/juntaoqian/dsh-traffic-light.git
- 點擊 Install，確認 bundle 已 enabled。
- 查看側邊欄左下角；Settings 中應出現「紅綠燈」頁。
通過 Agent 安裝¶
在 DSH 會話中說明使用 plugin_manager 的 install_bundle，target 爲：
git+https://github.com/juntaoqian/dsh-traffic-light.git
卸載¶
在 Plugins 中找到 dsh-traffic-light 並 Remove，或使用 plugin_manager 的 remove_bundle。
若從 GitHub 安裝時出現連接超時，README 建議重試、在 profile 的 cordis.patch.yml 中調大 pluginManager.githubConnectionTimeoutMs，或改用本地目錄的 install_bundle（link 方式）安裝；細節見倉庫 README。
典型用法¶
安裝並啓用後無需額外命令：多會話並行時看左下角燈色即可。需要靜音或改判定規則時進入 Settings → 紅綠燈 調整。多窗口之間設置通過 storage 事件同步；同一頁面兩個座位共享同一 store。
狀態與蜂鳴對應關係可概括爲：
| 燈 | 何時亮 | 蜂鳴 |
|---|---|---|
| 紅 | 任一會話有待處理交互 | 進入紅燈響；紅燈期間等待數增加也響（總開關） |
| 黃 | 無運行且無等待 | 進入黃燈時響（「回到空閒時也蜂鳴」，默認開） |
| 綠 | 有會話在運行（規則可配置） | 無 |
適用場景與注意¶
適合經常開多個 DSH 會話、希望一眼看到「有沒有在跑、有沒有在等我點選」的開發者。插件只通過宿主提供的 useSessionStatus 等標準 hook 讀狀態，不掃 DOM、不訂閱私有事件。
安裝前建議瀏覽 GitHub 倉庫 源碼與 MIT 許可證；客戶端插件隨 DSH Web UI 運行，權限模型以當前 DSH 進程與瀏覽器環境爲準。若 DSH 大版本調整 slot 或 hook 名稱（如 sidebar.footer.action、settings.section、shell.overlay、useSessionStatus），插件可能需要適配。社區目錄 SkillHub 插件頁 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-traffic-light 把多會話運行與等待狀態收到側邊欄左下角，並用可配置的蜂鳴減少漏審。目錄頁：https://www.skillhub.cn/plugins/juntaoqian/dsh-traffic-light；源碼與完整說明：https://github.com/juntaoqian/dsh-traffic-light。
