前言¶

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