前言¶
DeepSeek Harness(DSH)側邊欄已經能區分:哪個 Session 在跑、哪個在等回答、哪個有新消息。它不知道的是你本輪決定推進哪幾條,以及某條 Session 已經擱置多久。工作區一多、文件夾一折疊,這種信息缺口裏任務最容易丟。
dsh-session-focus 補的是這一層:不替代側邊欄、不加懸浮球、也不另開一個要你記得去看的窗口。下面介紹它做什麼、怎麼裝、怎麼用,以及實現上的邊界。
這是什麼¶
- 插件名稱:
dsh-session-focus(社區目錄:fan-sx/dsh-session-focus) - 維護者:Fan-sx
- 分類:工作流
- 許可證:MIT(當前 package 版本 0.1.2)
- 定位:給 DSH 會話列表加上 Focus / Parked 標記,並在工作區摺疊時仍能看到「手上還有幾條」。
目錄頁:SkillHub 插件頁
源碼與說明:GitHub — Fan-sx/dsh-session-focus
DSH 生態是「一切皆插件」;SkillHub 等社區目錄爲獨立站點,與 DeepSeek / 幻方無官方從屬關係。
核心功能¶
一鍵標記,三處同步¶
會話標題前有一個 16px 格子,點擊後在三種狀態間循環:
無 → focus(進行中)→ parked(掛起)→ 無
- Focus:琥珀色豎條,表示你正在推進的 Session。
- Parked:空心環,表示在等外部、或有意先擱在一邊。
同一套循環也出現在 Session 的懸浮卡片,以及對話頂部的膠囊控件上。
摺疊後仍能看到數量¶
把工作區分組收起時,組內 Session 和標記都會隱藏。插件會在文件夾名旁加一個小圓點;鼠標懸停在該行時,圓點會變成條數。側邊欄底部還有一行彙總,例如 ● 6 條在手上,點擊可打開完整列表。
跨工作區總覽頁¶
側邊欄條帶上的面板圖標(README 中以靶心圖標描述)打開跨工作區列表,按狀態分組。其中「等待審批、計劃待審、等待回答、在跑、已完成未讀」等分組直接讀取 DSH 自帶的 useSessionStatus 快照,與側邊欄狀態點的含義一致;你自己打的 Focus / Parked 標記列在這些系統狀態之後。
安裝與啓用¶
官方 README 給出的安裝方式如下(請將 <profile> 換成你的 DSH profile 名):
dsh plugin --profile <profile> add dsh-session-focus
若使用本地目錄(例如自行下載的源碼樹),可用絕對路徑:
dsh plugin --profile <profile> add /absolute/path/to/dsh-session-focus
在 DSH Desktop 中,也可在 Plugins 頁面通過絕對路徑安裝。
引擎要求(來自 package.json):DSH >=0.2.0-rc.2 <0.3.0;客戶端爲 web 注入;Host 側不註冊路由、工具或服務。
插件以當前 DSH 進程的權限運行。安裝前建議瀏覽倉庫源碼與 MIT 許可證,確認符合你的環境策略。
典型用法¶
- 在側邊欄找到本輪要推進的 Session,點標題前的格子,直到出現琥珀豎條(Focus)。
- 等同事或外部流程的 Session,點成空心環(Parked)。
- 工作區很多時,先看文件夾名旁圓點或底部
● N 條在手上,再點底部一行或面板圖標進入完整列表。 - 標錯了再點一格即可撤銷,無需額外配置項。
標記保存在瀏覽器 localStorage,鍵名爲 dsh-focus.marks.v1(包改名後仍保留該鍵,避免丟已有標記);多標籤頁通過 BroadcastChannel 同步。
實現要點與限制¶
純客戶端:Host half 無路由、無工具、無服務,無需鑑權或遷移。
工作區圓點:依賴側邊欄行上的 data-row-key="workspace:<id>" 結構,用樣式表 ::after 掛在行上,而不是注入 DOM 節點(避免 React 重繪時閃爍)。若上游改掉該 hook,圓點可能消失,其餘功能仍可用。
會話歸屬:對話頭沒有 workspaceId,插件通過 Session 的 cwd 與工作區註冊表路徑做歸一化來推斷所屬工作區。
侷限(README Limits):
- 標記按瀏覽器隔離;換機器或換瀏覽器會從空開始。
- 上述
data-row-key若變更,摺疊組上的圓點會失效。
結尾¶
dsh-session-focus 解決的是「多 Session、多工作區時,你自己定的優先級和掛起項」在 UI 裏看不見的問題;它與 DSH 原生 Session 狀態互補,而不是另建一套任務系統。
- 目錄頁:https://www.skillhub.cn/plugins/Fan-sx/dsh-session-focus
- GitHub:https://github.com/Fan-sx/dsh-session-focus