dsh-trafficlight 插件介紹

前言¶

DeepSeek Harness (DSH) 的核心能力在於其插件化架構。dsh-trafficlight 是一個宿主插件，它結合了瀏覽器 Web GUI 擴展和 macOS 原生應用，將 DSH 的會話流事件轉化爲直觀的紅/黃/綠三色燈狀態，幫助開發者在多會話開發中實時掌握任務進度。

功能¶

1. macOS 全局懸浮窗：在屏幕右上角顯示訂閱會話的實時狀態。懸浮窗支持拖拽移動、自適應佈局，並在連接斷開或無訂閱時顯示空態。
2. Web GUI 訂閱按鈕：在瀏覽器端會話頭部提供「🚦 訂閱」按鈕，允許用戶選擇關注特定的會話，而非展示所有會話。
3. 狀態顏色映射：
   • 🔴 紅燈：會話處於阻塞狀態（如等待批准、提問）。
   • 🟡 黃燈：會話正在執行中（回合進行中）。
   • 🟢 綠燈：會話已完成。
   • ⚪ 暗燈：空閒或未連接 DSH。
4. 訂閱持久化與交互：訂閱列表保存在本地文件，重啓服務後保留。懸浮窗內每行提供「⊖」按鈕可單獨取消訂閱。

安裝與啓用¶

該插件僅支持 dsh 的 web profile。

1. 安裝：

    dsh plugin --profile web add @chivaskong96/dsh-trafficlight

2. 重啓服務：

    dsh web

3. 前置要求：
   • Node.js 版本 >= 22.19.0
   • dsh 版本 0.1.x（web profile）

使用方法¶

1. 打開任意會話。
2. 在會話頭部的操作行點擊「🚦 訂閱」按鈕。
3. 首次訂閱時，系統會自動拉起 macOS 懸浮窗。
4. 懸浮窗會逐行展示每個訂閱會話的紅黃綠燈狀態。點擊行尾的「⊖」可取消該條訂閱。

注意事項¶

• 版本限制：目前僅支持 dsh 0.1.x 的 web profile。
• 依賴端口：插件內部橋接服務運行在端口 18765，請確保該端口未被佔用。
• 構建依賴：如果從源碼構建 macOS 懸浮窗，Swift 構建時需禁用沙箱（--disable-sandbox）。

總結¶

dsh-trafficlight 通過訂閱制和原生懸浮窗，爲 DSH 用戶提供了輕量級的會話狀態監控方案。它避免了在大量會話中迷失進度，適合需要同時管理多個智能體任務的場景。

GitHub | 插件目錄