前言¶

DeepSeek Harness 的 Web Profile 側邊欄目前僅支持工作區與對話列表。當會話數量增多時，查找特定對話會變得困難。該插件通過引入文件夾層級結構來解決這個問題，實現項目 → 文件夾 → 對話的嵌套管理。

核心功能¶

1. 文件夾管理：新建文件夾、重命名、刪除。
2. 對話管理：對話改名、將對話移入或移出文件夾。
3. 內容搜索：在側欄頂部搜索框中按消息內容搜索對話。
4. 會話歸檔：歸檔會話（日誌保留，從側欄隱藏）。

安裝與啓用¶

安裝命令如下：

dsh plugin --profile web add dsh-conversation-folders

該命令會將插件安裝到 ~/.dsh/profiles/web/node_modules/，並自動加入 dsh.profile.bundles。重啓 DSH 後生效。

注意：插件依賴 peerDependencies 版本 >=0.1.0-rc.5，若你的 DSH 版本不同，可能需要調整。

數據模型¶

插件使用 convfolders 域進行數據持久化。每條記錄存儲在一個文件夾中，結構如下：

{
  "id": "f-<id>",
  "workspaceId": "<workspace uuid>",
  "title": "UI",
  "sessionIds": ["session-…"],
  "createdAt": "ISO-8601",
  "updatedAt": "ISO-8601"
}

已知限制¶

1. 側邊欄接管：本插件接管了原生 sidebar.workspaces，因此原生的工作區 Fork、新增、刪除和排序功能未復刻。
2. 歸檔無恢復入口：本插件只提供歸檔（隱藏）功能，未提供已歸檔視圖或恢復入口。需要恢復時請配合其他歸檔管理插件。
3. RPC 方案：相比規範的 @Remote RPC，本方案使用裸 HTTP 路由 POST /folders-rpc，缺少 wire schema 校驗。這是出於最簡實現的考量。
4. 版本依賴：peerDependencies 使用 >=0.1.0-rc.5。

與同類插件對比¶

本插件定位爲項目內手動自由分組的唯一實現，可與 dsh-session-move（跨項目搬運+刪除）共存安裝。

結語¶

該插件爲 DSH 用戶提供了在側邊欄內嵌文件夾層級的能力，適合需要手動組織大量會話的用戶。安裝前請檢查源碼與許可證。

• 目錄頁：https://www.skillhub.cn/plugins/choocoo/conversation-folders-package
• GitHub：https://github.com/choocoo/conversation-folders-package