前言¶
DeepSeek Harness (DSH) 插件系統允許開發者通過擴展功能來增強客戶端體驗。在會話中編寫代碼時，頻繁切換窗口查看項目結構會打斷開發思路。dsh-workspace-dir 插件通過在會話頭部增加“目錄”按鈕，在 DSH 界面內直接展示當前工作目錄的文件列表，解決這一痛點。該插件由 DDSG-X 維護。
核心功能¶
該插件提供以下功能：
* 會話頭部按鈕：在會話標題旁顯示“目錄”按鈕。
* 浮動面板：點擊按鈕彈出可拖動的目錄面板。
* 透明度調節：支持 0%-100% 背景透明度調節，默認爲 20%。
* 狀態記憶：面板的位置、透明度、打開/關閉狀態會自動保存，重啓 Harness 後恢復。
* 目錄瀏覽：顯示當前會話的工作目錄及其文件和子目錄列表。
* 層級導航：支持點擊進入子目錄。
* 系統打開：支持點擊文件夾旁的按鈕，在系統文件管理器中打開當前或指定子目錄。
* 會話跟隨：切換會話時，目錄面板會自動跟隨新會話的工作目錄。
安裝與啓用¶
安裝需要使用源碼運行的 Harness。由於 peer 依賴可能不完整，npm 安裝版可能無法正常工作。
pnpm dsh plugin --profile web add github:DDSG-X/dsh-workspace-dir
安裝完成後必須重啓 Harness 才能生效。
典型用法¶
- 打開任意會話，在標題旁點擊“目錄”按鈕，彈出目錄面板。
- 拖動面板標題欄移動位置。
- 使用滑桿調整面板背景的透明度。
- 點擊目錄列表中的子目錄或文件夾旁的“↗”按鈕，在系統文件管理器中打開對應路徑。
注意事項¶
- 本項目未發佈到 npm，不要使用包名安裝。
- 需要源碼運行的 Harness，npm 安裝版可能因 peer 依賴缺失無法安裝。
- 安裝完成後必須重啓 Harness 才能生效。
- 插件自帶構建產物（
lib/），無需重新構建。
