前言¶
在 DeepSeek Harness 裏，會話往往按工作區分散在側欄列表中。當你同時開着多個工作區、或有任務在後臺運行、等待你點選操作時，要在各工作區之間來回切換才能看清「誰在跑、誰需要你點一下、誰剛跑完還沒看」。原生列表按工作區組織，缺少一張跨工作區的「活動總覽」。下面介紹社區客戶端插件 dsh-session-filter（倉庫 Shane0315/dsh-session-filter），它在工作區標題行增加入口，在側欄原會話列表區域切換爲跨工作區活動視圖，數據來自宿主名冊與會話狀態 API，不讀會話正文。
這是什麼¶
dsh-session-filter 由維護者 Shane0315 發佈，分類爲客戶端插件。一句話定位：爲 DeepSeek Harness 提供跨工作區的 Activity 側欄，依據 sessions.list / workspaces.list 與會話狀態，彙總需關注、最近活動及可選分組，並支持搜索、本地已讀跟蹤與經確認的批量歸檔。插件不修改宿主或其他插件；許可證爲 MIT（見倉庫 README）。
核心功能¶
入口與切換¶
在工作區標題行顯示鈴鐺圖標。點擊後，側欄原有會話列表區域改爲活動視圖；再次點擊、按 Escape，或使用快捷鍵 ⌘⌥U 可返回原列表。關閉視圖或禁用插件時會恢復原列表。
活動分組與數據來源¶
活動按以下方式展示（部分分組默認關閉，可在菜單中打開）：
- 需關注：運行中、等待操作、完成但未讀等需跟進的會話。
- 置頂（默認關閉）。
- 定時任務（默認關閉）：通過 DSH
schedule.catalog()的最近實際交付記錄及其sessionId展示關聯會話並訂閱變更；讀取失敗可重試，不影響其他活動。 - 最近活動：本地日曆近七天內，按今天、昨天及星期分組；初始顯示 10 條，可按 10 條加載更多。
關閉「需關注」分組時，超過七天但仍需關注的會話會出現在「更早」。歸檔會話、子會話和空閒空白會話不列出；摺疊工作區內的會話仍會出現在列表中。點擊條目走 DSH 官方跨工作區導航。
名冊來自 sessions.list / workspaces.list；運行、等待操作和完成未讀來自 uiSession.sessionStatus。插件不讀取會話正文，不外傳數據。工作區歸屬、歸檔和子會話由宿主名冊判斷，不通過行圖標猜測。
搜索與菜單¶
支持按標題、工作區和路徑搜索。
菜單提供：顯示選項、恢復默認、全部標爲已讀、清理已讀；對當前「需關注」分組還可發起批量歸檔——確認框逐項列出範圍，運行中或等待操作的會話須明確選擇「停止並歸檔」。
本地已讀與限制¶
插件在本機 localStorage 保存已觀察到的完成未讀和已讀確認，重建頁面後仍保留待查看結果。批量已讀隻影響插件視圖，不會修改 DSH 原生未讀狀態；運行或等待操作不會因標記已讀而從列表消失。清理已讀會移除不再需要關注的快照條目。
插件保留的活動輪次只能依據宿主狀態變化和更新時間識別；若應用在完全關閉期間發生多次變化且最終狀態與時間完全一致，無法區分這些輪次。DSH 沒有 Codex 的 Work/Chat 來源區分；同一會話也可能包含普通對話，DSH 不提供可直接區分獨立執行結果會話的合同。
安裝與啓用¶
推薦從 GitHub Release 安裝預構建包，無需在安裝時構建：
dsh plugin add https://github.com/Shane0315/dsh-session-filter/releases/latest/download/dsh-session-filter.tgz
也可從源碼倉庫安裝（倉庫內含預構建產物）：
dsh plugin add github:Shane0315/dsh-session-filter
桌面端請在插件管理或插件市場選擇安裝來源；desktop profile 由 Electron 管理，不應在應用運行時強行改寫配置。安裝後按宿主提示重載。更新可從發佈頁獲取新包並使用宿主的更新功能；收錄插件市場不保證與未來宿主版本兼容。
package.json 中聲明宿主引擎爲 dsh >=0.2.1-rc.2；README 寫明本版本已在 DSH Desktop 0.2.1-rc.5 驗證。插件通過官方客戶端服務注入，並依賴宿主工作區標題和列表容器定位；DSH 界面改版可能需要適配，定位失敗時界面會提示。
典型用法¶
- 安裝並重載 DSH 後，在工作區標題行找到鈴鐺，點擊進入活動側欄。
- 在「需關注」中查看運行中、待交互或完成未讀的跨工作區會話；用搜索框按標題、工作區或路徑過濾。
- 處理完畢後，在菜單中使用「全部標爲已讀」或「清理已讀」整理插件視圖（不改變 DSH 原生未讀）。
- 需要收尾時，在菜單對「需關注」發起批量歸檔，按確認框選擇範圍；對仍在運行或等待操作的會話選擇「停止並歸檔」。
- 若使用定時任務，在顯示選項中打開「定時任務」分組，查看
schedule.catalog()關聯的最近交付與會話。 - 按
⌘⌥U、Escape 或再次點擊鈴鐺返回原會話列表。
適用場景與注意¶
適合誰：經常在 DSH 中並行多個工作區、依賴後臺運行或定時交付、希望在一屏內看到「該點哪裏」的開發者。
運行權限：插件以當前 DSH 進程權限運行；安裝前應自行查看倉庫源碼與 MIT 許可證，確認符合你的環境策略。
隱私與同步：已讀狀態和顯示偏好僅存在本機 localStorage，不與 DSH 原生批量已讀同步。
生態說明：DeepSeek Harness 採用「一切皆插件」的擴展方式；社區目錄頁（如 skillhub.cn）爲獨立站點，與 DeepSeek / 幻方無官方從屬關係，本文安裝方式以 GitHub README 爲準。
本地開發（僅供貢獻者）：需 Node.js 20+，執行 npm ci 與 npm run check；React 由 DSH 宿主提供，發佈包可直接安裝，不依賴本地構建。
結尾¶
dsh-session-filter 把跨工作區的運行、待操作與完成未讀集中到側欄活動視圖，配合搜索、本地已讀和經確認的歸檔，減少在多工作區間盲找會話的成本。目錄與詳情可參考 SkillHub 插件頁，源碼與安裝說明見 GitHub：Shane0315/dsh-session-filter。
