前言¶
DeepSeek Harness (DSH) 的側邊欄通常只回答“哪個會話在哪”，不直接展示當前會話狀態的負載。開發者常需手動翻閱列表來確認剩餘任務。dsh-session-watch 解決這個問題，它作爲儀表盤，在側邊欄底部實時展示六種會話狀態的數量，幫助開發者一眼看清工作負載。
簡介¶
這是 DeepSeek Harness 的一個插件，專注於會話狀態的可視化。由維護者 d0ublecl1ck 開發，類別爲“記憶”。
核心功能¶
- 狀態計數：在側邊欄底部顯示六種會話狀態的計數：運行中、未讀、待處理、閒置、未歸檔、已歸檔。
- 版式切換：提供“膠囊”和“比例條”兩種版式，可根據偏好選擇。
- 靈活配置：可在設置頁逐項開關顯示項，並調整閾值。
- 安全邊界：只讀官方 shell 已發佈的三個快照（
useSessions、useSessionStatus、useWorkspaces），不歸檔、不刪除、不落盤、不聯網，不依賴任何其它插件。
安裝與啓用¶
通過官方命令安裝：
dsh plugin --profile web add dsh-session-watch
安裝後刷新窗口即可生效。
典型用法¶
1. 語音指令調整¶
在對話中直接對 Agent 下達指令，例如：
現在有幾個會話在跑？把「閒置」關掉，只留運行中、未讀、待處理。
Agent 會根據當前設置調整側邊欄的顯示項。
2. 手動配置¶
偏好設置也可以直接寫在 profile 的 cordis.patch.yml 中。注意 row id 即爲設置命名空間：
- id: session-watch
name: dsh-session-watch
config:
threshold: 20
variant: meter
showIdle: false
技術細節¶
- 數據來源：插件只讀取官方 shell 發佈的三個快照，不寫入任何會話或歸檔狀態。
- 解耦設計：與卸載解耦，Host 沒有服務本插件的配置命名空間時，設置行不註冊。
- 計算邏輯：閒置狀態由前幾項派生，四個活動項之和恆等於未歸檔數。
總結¶
dsh-session-watch 爲 DSH 用戶提供了一個輕量級的狀態監控工具，通過側邊欄的直觀展示，減少了對列表的頻繁翻閱。所有功能均在本地計算，不涉及網絡交互或文件寫入，適合需要精細管理會話狀態的場景。
