前言¶
DSH 的擴展通常通過插件完成。如果 dsh 的 Web profile 中會話越來越多，需要在側邊欄裏按分類組織會話，可以考慮 ht719/dsh-session-categories。它把用戶可管理的分類樹加入 dsh 側邊欄，並且讓每個 Workspace 維護自己的分類。
下面介紹它的定位、能力、安裝命令、典型用法，以及升級和權限方面的注意事項。
這是什麼¶
dsh-session-categories 是 ht719 維護的 DSH 插件，定位爲：
Durable Workspace-scoped Session categories for the DeepSeek Harness
它面向當前 dsh 預發佈插件 API，並用於未修改的 dsh 安裝。安裝後，dsh 側邊欄可以按 Workspace 顯示分類、會話和層級關係，用戶可以對分類和會話做創建、重命名、移動、歸檔等管理操作。
核心功能¶
該插件提供以下能力：
- 在 dsh 側邊欄中新增用戶可管理的分類樹。
- 每個 Workspace 維護自己的分類。
- 每個會話最多屬於一個分類。
- 可在分類內直接創建會話。
- 可展開或摺疊分類，且保留層級。
- 可將會話拖拽到另一個分類。
- 可從 Workspace 操作菜單創建頂級分類。
- 可從分類操作菜單創建子分類、重命名或刪除當前分類。
- 可通過“Move to category”操作移動會話。
- 刪除分類會遞歸歸檔其會話，但不會刪除持久日誌。
行爲與約束¶
插件對變更操作有一組限制：
- 拒絕過期修訂。
- 拒絕跨 Workspace 會話 ID。
- 拒絕後代移動。
- 拒絕分配到未知分類。
刪除分類時，其下屬會話會被遞歸歸檔；持久日誌不會被刪除。
安裝與啓用¶
先確認 dsh 命令可在 shell 中執行。對普通安裝，執行下面的命令安裝預構建包，然後啓動 dsh Web profile：
dsh plugin --profile web add dsh-session-categories
dsh --profile web
如果你是從源碼運行 dsh，使用對應的 package launcher：
pnpm dsh plugin --profile web add dsh-session-categories
pnpm dsh --profile web
如果需要使用未發佈的 GitHub 版本，可以直接安裝倉庫版本：
dsh plugin --profile web add github:ht719/dsh-session-categories
典型用法¶
下面是一個常見的分類管理流程：
- 進入目標 Workspace。
- 從 Workspace 操作菜單創建一個頂級分類。
- 在該分類內創建會話，或將已有會話拖拽到該分類。
- 在分類操作菜單中創建子分類。
- 需要調整時，使用分類操作菜單重命名或刪除當前分類。
- 需要移動已有會話時，使用“Move to category”操作。
經過上面的步驟，會話會按你設定的層級顯示在 dsh 側邊欄中。刪除某個分類時，注意它只會遞歸歸檔會話，不會刪除會話的持久日誌。
適用場景與注意¶
適合以下情況：
- 你在 dsh Web profile 中管理多個 Workspace 會話。
- 你希望按 Workspace 維護一套分類樹。
- 你希望用拖拽、展開、摺疊、重命名和移動分類來組織會話。
- 你使用未修改的 dsh 安裝，並願意隨 dsh 版本同步升級插件。
需要注意：
- 該插件面向當前 dsh 預發佈插件 API。
- dsh 不承諾預發佈版本間的兼容性。
- 升級時應同時更新 dsh 和本插件。
- 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
- 已覈實資料未提供許可證信息，不能默認其許可證適合你的使用場景。
- 刪除分類會遞歸歸檔會話，但不會刪除持久日誌。
鏈接¶
GitHub 倉庫：
https://github.com/ht719/dsh-session-categories
已覈實資料未提供目錄頁 URL。
