前言¶
DSH 通過插件擴展客戶端能力。原生 Workspace 適合直接進入單個工作目錄，但 Workspace 和會話增多後，目錄選擇、會話列表和歸檔內容會變得不好找。
dsh-projects 是一個 DSH 插件，由 WenhongPan 維護，目標是把零散的 Workspace 和會話整理成清晰、可搜索的項目工作流。它繼續使用 DSH 自己的 Workspace 和 Session 數據，基礎模式不建立第二套項目數據庫。
當前版本爲 0.3.0-alpha.2，屬於 Alpha 版本，許可證爲 MIT。
這是什麼¶
dsh-projects 提供項目入口、項目側邊欄、全局搜索、歸檔查看和目錄選擇能力。適合使用 DSH Desktop 或 DSH Web UI，並希望按項目組織 Workspace 和會話的用戶。
它兼容 DSH 0.1.0-rc.6 和 0.1.1-rc.2。DSH Desktop 2.0.3 的 Windows 官方目錄窗口已完成實際界面驗收。
核心功能¶
項目與側邊欄¶
- 選擇項目、創建項目、整理側邊欄。
- 側邊欄可按項目或單列表顯示，提供最近、置頂、收藏、拖動排序。
- 待處理摘要支持關閉、簡潔數字或展開列表三種模式。
全局搜索¶
全局搜索的結果按項目分組，可搜索項目、標題；啓用 DSH 索引後，還可以搜索聊天正文。
多文件夾項目¶
可以把多個現有 Workspace 組合爲一個項目，並明確指定新會話使用的主文件夾。
歸檔與項目管理¶
項目管理包括：
- 重命名
- 在文件管理器中打開
- 歸檔聊天
- 移除項目註冊
歸檔中心用於集中查看已歸檔聊天；恢復能力取決於 DSH 是否公開取消歸檔接口。
目錄窗口¶
DSH Desktop 2.0.3 及以後優先使用 Desktop 官方 Windows 目錄窗口。
遠程 Web UI 使用 Host 端應用內目錄瀏覽器，不打開遠程機器的系統窗口。
安裝與啓用¶
Desktop 和 Web 是兩個獨立 profile，需要分別安裝。源碼安裝要求 node >=20。
DSH Desktop¶
dsh plugin --profile desktop add https://github.com/WenhongPan/dsh-projects/releases/download/v0.3.0-alpha.2/dsh-projects-0.3.0-alpha.2.tgz
DSH Web UI¶
dsh plugin --profile web add https://github.com/WenhongPan/dsh-projects/releases/download/v0.3.0-alpha.2/dsh-projects-0.3.0-alpha.2.tgz
安裝或升級後，完整退出並重新啓動對應的 DSH profile。
源碼安裝¶
git clone https://github.com/WenhongPan/dsh-projects.git
cd dsh-projects
npm install
npm run verify
dsh plugin --profile desktop add link:/absolute/path/to/dsh-projects
典型用法¶
不選擇項目直接聊天¶
普通聊天會自動獲得獨立任務目錄：
~/Documents/DSH-Default/YYYY-MM-DD/new-chat[-N]
啓用聊天正文搜索¶
聊天正文搜索需要在目標 profile 的 cordis.patch.yml 中啓用 DSH 會話索引。配置項如下：
- id: session-query-sqlite
config:
path: dshHomePath('session-search.sqlite')
openAt: first-search
聊天正文索引包含由聊天內容派生的數據，應與原始會話數據採用同等隱私保護。
遠程 Web UI¶
遠程 Web UI 下，目錄選擇使用 Host 端應用內目錄瀏覽器，不打開遠程機器的系統窗口。
注意¶
- 這是 Alpha 版本，使用時應按 Alpha 版本對待。
- macOS Apple Silicon 和 macOS/Linux 本機 Web UI 的部分驗證待人工確認。
- 顯示偏好保存在瀏覽器
localStorage；清除站點數據會拆分本地組合，但不影響 DSH Workspace、聊天或項目文件。 - 基礎模式不建立第二套項目數據庫，也不會在卸載時刪除項目文件夾或會話記錄。
- 歸檔恢復能力取決於 DSH 是否公開取消歸檔接口。
- 插件會以當前 DSH 進程權限運行；安裝前應檢查源碼和 MIT 許可證。
結尾¶
dsh-projects 的價值在於把現有 Workspace 和 Session 整理成項目視圖：側邊欄可按項目組織，搜索可按項目分組，歸檔和目錄選擇也有了統一入口。
GitHub：
https://github.com/WenhongPan/dsh-projects
