前言¶
DeepSeek Harness(DSH)裏會話一多,側欄往往只剩時間和自動標題,很難按項目或任務分組,也不容易一眼看出哪條在等工具、哪條在等你點批准。手動重命名可以,但容易被後續自動標題覆蓋;多工作區並行時,更需要一種和官方 rename 同路徑、又能持久保留「分類 + 標題」格式的做法。
下面介紹社區插件 dsh-session-organizer(維護者 xanderVIA):在側欄增加「整理」入口,用 |分類|標題 命名、顏色標籤、釘住保護、運行狀態徽章,以及可選的搶焦點與 AI 總結。DSH 生態主張「一切皆插件」;SkillHub 等目錄站由社區維護,與 DeepSeek / 幻方無官方從屬關係。
這是什麼¶
dsh-session-organizer 是給 DSH 會話側欄用的客戶端插件(package 版本 1.0.0,MIT 許可證)。它在「工作區」區頭增加整理面板,把分類、改名、顏色、排序和狀態展示集中在一處,並通過官方 sessions.using(id) → binding.session.rename(title) 寫標題,避免與側欄重命名行爲不一致。
聲明兼容 DSH >=0.2.0-rc.1 <0.3.0-0;README 註明在 DSH 0.2.0-rc.2 上實測。
核心功能¶
分類與標題¶
每條會話有分類下拉框,寫入標題格式 |分類|標題,走官方 rename,持久且不會被自動標題覆蓋。面板裏可「+ 新增」自定義分類;雙擊分類名就地改名(顏色與會話跟隨);用 × 刪除分類時,用到該分類的會話回落「未分類」。
顏色與側欄¶
每個分類可設顏色:拖動取色、輸入 #RRGGBB、或使用「標準黑」等預設;新建分類默認無顏色,近黑會自動吸附成純黑。側欄可把分類顏色畫到標題上(只改內聯 color,可一鍵還原)。分類列表、顏色、排序等存在瀏覽器 localStorage(鍵前綴 dsh-session-organizer:*),換瀏覽器或清緩存會丟失;釘住列表在磁盤上,不受影響。
釘住與批量操作¶
釘住(📌)的會話在批量整理、AI 總結、修剪名字時會被跳過,除非先解開。
一鍵自動整理與 AI 總結¶
「⚡ 一鍵自動整理」按關鍵詞、首句、所屬工作區打分判分類,再重判一次並寫入;手選過的分類會保留。
「✨ AI 精確總結」調用 dsh-session-titler 的 POST /session-titler/propose,讀取整段會話重新起名。未安裝該可選依賴時,按鈕會報錯提示。
排序、歸檔與狀態¶
支持按最近活躍、最早活躍、分類、名字、工作區排序,釘住的排前面;歸檔會話默認隱藏。
標題前顯示狀態徽章,例如 ⟳ 已用時、! 待回覆、✓ 剛跑完。判定「在跑」時會看 sessionStats.openStep、sessionStats.pendingCalls、subagentTiming.pendingTurnStart 等字段;連續兩輪輪詢確認後才判完成,避免只認 openStep 把等工具/等子代理誤判爲已完成。
搶焦點¶
有會話開始等你答題或批准時,可自動把 DSH 窗口前置並跳到該會話(強度可配置)。右下角通知點擊直接跳到會話,桌面版需按 docs/notify-focus.md 給 dsh-notify-windows 的 launcher 打補丁;不打補丁時插件其餘功能不受影響。
安裝與啓用¶
插件以當前 DSH 進程權限運行,安裝前應自行查看 GitHub 源碼與 MIT 許可證。
從 GitHub 安裝(README 推薦寫法):
dsh plugin --profile <你的 profile> add github:<你的用戶名>/dsh-session-organizer
本地鏈接(開發):
dsh plugin --profile <你的 profile> add link:E:/path/to/dsh-session-organizer
桌面版若 profile 由應用獨佔,請在應用內「插件」頁安裝,或安裝後重啓 DSH(宿主半是進程內模塊,只刷新頁面不夠)。
裝好後,左側「工作區」區頭會出現 🗂 圖標按鈕,點開即爲整理面板。
卸載:
dsh plugin --profile <你的 profile> remove dsh-session-organizer
再刪除 <DSH_HOME>\session-organizer\ 目錄可清掉釘住與搶焦點配置。
典型用法¶
- 打開整理面板,爲常用項目「+ 新增」分類並設顏色。
- 在會話行選擇分類,或寫滿
|分類|標題後由插件經rename持久化。 - 對暫時不要參與批量改名的會話點釘住。
- 需要批量歸類時,用「一鍵自動整理」;需要讀全對話起名時,先裝好
dsh-session-titler,再用「AI 精確總結」。 - 若希望只在等你答題/勾選時搶焦點,保持默認;若要擴展策略或關閉,編輯
<DSH_HOME>\session-organizer\settings.json。
settings.json 示例:
{ "autoFocus": "question", "staleMs": 25000, "gapMs": 15000 }
autoFocus:question(默認,只在等你答題/勾選時搶焦點)/all(再加上工具調用卡住超過staleMs且審批策略是 ask)/offgapMs:兩次搶焦點的最小間隔
釘住列表路徑:<DSH_HOME>\session-organizer\locked.json。
適用場景與注意¶
適合長期在 DSH 裏開多條智能體會話、按項目或工作區做側欄管理的開發者。區頭按鈕、狀態徽章、側欄上色通過 DOM 注入實現,上游 UI 改版後可能需要插件跟進;側欄結構認不出時會靜默跳過,不影響 DSH 本身。狀態徽章依賴投影緩存字段名,跨大版本可能需要更新。「跳轉到會話」依賴 uiWorkspace 服務;沒有側欄面板的宿主只會前置窗口,不跳轉。
結尾¶
dsh-session-organizer 把分類命名、顏色、釘住、運行態和可選搶焦點收進側欄整理面板,並與官方重命名路徑對齊。目錄頁:https://www.skillhub.cn/plugins/xanderVIA/dsh-session-organizer;源碼與完整說明:https://github.com/xanderVIA/dsh-session-organizer。