前言¶
在 DeepSeek Harness（DSH）里長期開多個工作區、多層會話時，側欄導航往往和主聊天窗口綁在同一塊區域。需要對照路徑、分組和活動狀態時，側欄空間容易顯得緊；若把 DSH 主窗口挪到副屏，導航仍可能擠在側欄裏，不便單獨擺放。
社區插件 dsh-workspace-detached（維護者 liushimu）走另一條路：不修改 DSH 主程序，通過公開插件接口，把「工作區與會話導航」從側欄分離到可獨立移動、調整大小的 Windows 原生窗口。主窗口繼續負責聊天與會話動作；獨立窗口只做導航與呈現。它是第三方獨立插件，不是 DSH 官方功能，也不是 Better Workspace 補丁；卸載 Better Workspace 後仍可單獨使用本插件。
這是什麼¶
dsh-workspace-detached 當前發行版本爲 0.2.3 預覽版（MIT 許可證）。分類上屬於 DSH 客戶端類插件：在 Windows x64 上配合 DSH 宿主運行，不能脫離 DSH 單獨當作完整應用使用。
目錄頁：SkillHub — liushimu/dsh-workspace-detached
源碼與說明：GitHub — liushimu/dsh-workspace-detached
核心功能¶
下面能力均來自項目 README 與 package 聲明，安裝前請以 Releases 頁實際包爲準。
獨立導航窗口¶
側欄提供 「彈出工作區」：導航進入獨立窗口，可放到另一塊屏幕或桌面位置；需要時用 「收回側欄」 結束獨立顯示，「定位導航窗口」 可找回已有窗口。彈出不會新建 Agent，也不是第二個聊天后端。
層級、總覽與聚焦¶
保留工作區、路徑嵌套、名稱分組和會話層級；支持 總覽（多工作區卡片）和 聚焦某一工作區（上方聚焦內容、下方預覽其他工作區）。搜索與摺疊、可拖動上下分區、默認標題字號區分、顯式自定義外觀，以及六格活躍點陣（系統要求減少動態效果時可停用點陣動畫）。
邏輯拖放與排序¶
可調整導航父級及同級順序，支持按內容活動或手動排序。邏輯拖放不搬動磁盤目錄；菜單中的「移至工作區」會改變會話運行目錄，並在需要時提示確認。
沿用 DSH 會話動作¶
選擇、重命名、歸檔、移動等由主窗口對應服務完成；菜單是否可用取決於宿主能力與會話狀態。複製項複製的是 Session ID，不是聊天內容。歸檔可在插件側執行；恢復已歸檔會話需使用 DSH 主窗口或設置裏宿主提供的歸檔入口。
系統要求¶
- 操作系統：Windows x64（其他操作系統暫無原生窗口支持）。
- .NET Framework：4.6.2 或以上。
- Microsoft Edge WebView2 Evergreen Runtime：需系統或用戶自行安裝，插件不會自動安裝該運行時。
- DSH：聲明兼容起點 0.2.1-rc.3；宿主需提供公開的 Connection、webServer、subprocess、sessionProjections 及相關客戶端槽位。
- Node.js：22.19 或以上（與 package
engines一致）。
普通安裝不需要 C# 編譯器、Python、dotnet SDK 或 DSH 源碼。
安裝與啓用¶
1、從 Releases 下載 dsh-workspace-detached-0.2.3.tgz。不要把 GitHub 自動生成的 Source code 壓縮包當作安裝包，也不必解壓 tgz。
2、若已啓用 Better Workspace，先在 DSH 中停用它。兩個插件佔用同一側欄位置，不應同時啓用。
3、在 DSH 插件管理入口添加下載的本地 tgz，並啓用 dsh-workspace-detached。不同宿主版本的入口文字可能不同，以實際界面爲準。
4、回到工作區側欄，點擊 「彈出工作區」。若新安裝尚未被客戶端加載，按宿主提示重新加載客戶端。
宿主已停止時，也可通過官方 CLI 安裝（將 profile 名與 tgz 路徑換成你的實際值）：
dsh plugin --profile desktop add ./dsh-workspace-detached-0.2.3.tgz
不要在宿主或獨立窗口運行時直接覆蓋其 node_modules、EXE 或 DLL；不要雙擊包內顯示程序代替插件啓動。
典型用法¶
彈出與收回：彈出後側欄仍保留導航窗口狀態入口；收回側欄即結束該窗口的獨立顯示。
總覽與聚焦：進入某一工作區後上方爲聚焦內容，下方預覽其他工作區，可返回總覽。
調整上下分區：拖動中間手柄；焦點在手柄時可用上下鍵微調，Shift 加快，Home/End 到邊界，雙擊或 Enter 恢復默認。分區比例保存在當前窗口文檔，新窗口恢復默認。
活動時間排序：以用戶內容和非空助手回覆爲依據，不把工具事件、標題修改等管理動作當作新內容；部分歷史會話的活動時間可能尚未補齊。
適用場景與注意¶
適合誰：主要在 Windows 上使用 DSH、工作區與會話較多、希望導航窗口與主聊天窗口分屏或分桌面擺放的用戶。
與 Better Workspace 的關係：分組及側欄邏輯改編自 KannaKuron/dsh-better-workspace；本插件不讀取 Better Workspace 的運行時 store/DOM，也不構成對其運行依賴。公開包名由內部開發名 dsh-workspace-navigator 改爲 dsh-workspace-detached；切換時勿同時啓用新舊包，遇 entry id 衝突應通過官方管理器移除舊包。
安全與權限：插件以當前 DSH 進程權限運行；安裝前應自行查看源碼與 MIT 許可證。原生顯示程序當前未做代碼簽名，企業策略可能限制運行。插件只提供導航與呈現，不創建第二套會話後端；原生程序僅加載包內固定 HTML/JS/CSS，通過受限消息協議與主窗口通信。
數據位置：原生數據默認位於當前 DSH profile 的 data/workspace-navigator；窗口幾何偏好位於其 window-state 子目錄。卸載前先收回窗口，再用宿主插件管理器停用或卸載；插件不會刪除工作區目錄、會話或主動清掃偏好數據。
已知邊界：無跨所有 DSH 版本、屏幕布局與安全策略的保證；DOM 自動化不等於真實 WebView2 下全部 GUI 組合的驗收。反饋問題請提供 DSH/插件版本、Windows 與 WebView2 版本及復現步驟，並脫敏截圖與路徑。
結尾¶
dsh-workspace-detached 把 DSH 工作區與會話導航放進獨立 Windows 窗口，保留層級、總覽聚焦與邏輯排序，同時仍通過主窗口執行會話管理。需要預覽版安裝包與更新說明時，見 Releases；社區目錄入口見 SkillHub 插件頁。
