前言¶
DeepSeek Harness(DSH)跑久了,側欄裏會堆出大量跨工作區的會話。宿主本身能列出、搜索、歸檔,卻沒法在一條會話上標記「這是客戶交付物」或「週五再回來」,也沒法按這類標記把會話整批找回來。下面介紹社區插件 dsh-sidebar-tags(維護者 ysefu):在側欄會話行上增加彩色標籤,並提供獨立面板做篩選與管理。插件歸類爲社區目錄中的「趣味換裝」,當前 GitHub 星標爲 1;數據僅存瀏覽器端,不改動宿主文件、不增加面向模型的內容。
這是什麼¶
dsh-sidebar-tags 的定位是:爲 DeepSeek Harness 側欄提供帶顏色的會話標籤。你可以在某條會話自己的行上打標籤,一眼看到標記,並在側欄 Session tags 面板裏按標籤過濾整段歷史。
它是純客戶端插件:不註冊宿主路由、不在瀏覽器外寫文件、不修改任何隨 Harness 分發的文件。標籤與備註存在 localStorage,可隨時導出 JSON 備份。許可證爲 MIT(見倉庫 README)。
核心功能¶
README 中歸納的能力如下,插件只加這一層,不做別的:
| 能力 | 說明 |
|---|---|
| 行首色點 | 會話行開頭顯示彩色圓點(多標籤時帶 +n) |
| 從行上打標 | 行內 … 菜單項 Tag this session…,以及懸停時的標籤按鈕,均爲一鍵選擇器 |
| 懸停卡片 | 懸停時會話卡片列出該會話的標籤與 note |
| 標籤面板 | 側欄 Session tags:各標籤會話數、一鍵過濾、對標題與 note 的全文搜索、跳轉到會話、創建/重命名/改色/刪除標籤、導出/導入備份 |
內置六個默認標籤:To do、Doing、Important、Reference、Archivable、Idea;均可重命名、改色或刪除,也可在面板中新建。
插件通過 ctx.slots.inject 掛到宿主聲明的 seat 上(如 sidebar.panellist、sidebar.session.row.leading、sidebar.session.row.hover 等)。若某版 Harness 沒有對應 seat,該功能靜默缺失,不應拖垮啓動。
面板側的數據來自 Harness 自帶的 Cordis 存儲(如 sessions.list、uiSession.sessionStatus、workspaces.list),經 getSnapshot() / subscribe() 讀取,與官方側欄同源,無額外輪詢或 RPC。
安裝與啓用¶
安裝前請自行查看 GitHub 倉庫 源碼與 MIT 許可證;插件在當前 DSH / 瀏覽器配置對應的權限與存儲策略下運行,標籤數據跟瀏覽器配置綁定。
官方 README 給出的安裝方式:
# from npm (once published)
dsh plugin --profile <profile> add dsh-sidebar-tags
# from a checkout of this repository
dsh plugin --profile <profile> add link:/absolute/path/to/dsh-sidebar-tags
安裝後重啓該 profile,或重新加載 Web GUI。側欄會出現 Session tags 入口。
卸載:
dsh plugin --profile <profile> remove dsh-sidebar-tags
package.json 中聲明的 DSH 引擎要求爲 >=0.2.0-rc.1;README 寫明在 0.2.0-rc.2 上做過測試,0.2.0-rc.1 預期兼容(同一套 slot 契約)。更舊的 Harness 行上插件保持 dormant,所需 seat 不存在時不會刷日誌。
典型用法¶
按 README 的可復現步驟:
- 將鼠標懸停在會話行上,點標籤按鈕;或打開該行 … 菜單,選 Tag this session…。
- 選一個或多個標籤;行首會立刻出現彩色圓點。
- 在側欄打開 Session tags,查看各標籤數量、過濾列表、搜索標題與 note,並管理標籤集合本身。
- 標籤按瀏覽器 profile 存儲。在面板中用 Export a backup 留副本,用 Import a backup 遷到其他瀏覽器。
適用場景與注意¶
適合誰:長期在本機 Harness Web GUI 裏維護大量會話、需要輕量分類(待辦、進行中、重要、歸檔等)且希望側欄一眼能辨的開發者。
已知限制(來自 README「Known limits」):
- 行首色點是空閒態標記。宿主僅在行主狀態爲 idle 時渲染
sidebar.session.row.leading;運行中、等待批准或未讀完成等狀態會由宿主自己的狀態點佔位。標籤仍可在懸停卡片、行菜單和麪板中看到。 localStorage按瀏覽器 profile。清除站點數據會清空標籤;隱私窗口從空開始。若需保留,請定期導出備份。- 在 Harness 外刪除的會話可能留下記錄;下次打開面板時會 prune 宿主已不再列出的會話。
- 面板列出當前頁面已知的會話,以及仍被記住標題、但已不在列表中的已打標會話。
生態說明:DSH 社區插件目錄(如 SkillHub 上的條目)是獨立站點,與 DeepSeek / 幻方無官方從屬關係;安裝插件屬於在本機 profile 中加載第三方代碼,請按團隊規範審閱後再用。
小結¶
dsh-sidebar-tags 在側欄會話行與 Session tags 面板之間補了一層本地標籤與過濾,適合把 Harness 歷史按項目或狀態拆開看。更多信息見社區目錄頁 ysefu/dsh-sidebar-tags 與源碼倉庫 github.com/ysefu/dsh-sidebar-tags。