DSH Session Folders

中文 | English

为 DeepSeek Harness Web 侧栏添加会话分组（文件夹）：把对话整理进可嵌套、可自定义颜色与图标的文件夹，让长期项目和零散问答不再混在一起。

插件会在会话列表顶部（ui-workspace 的 treeBody）注入一棵文件夹树，像文件管理器一样分层渲染。

• 整理：文件夹支持嵌套、自定义颜色、自定义图标与折叠状态记忆。
• 交互：右键菜单「移动到分组」、把会话拖拽到文件夹、以及批量选择模式。
• 隐藏：已分组的会话从原生列表移除，改为在文件夹内以自有行渲染；点击时通过 ctx.sessions.open 打开。
• 持久化：host 侧提供只读 / 变更 REST API（通过单调递增的 version 做乐观并发控制），数据写入 ~/.dsh/profiles/web/session-folders.json。
• 干净：纯 DOM 注入、零依赖，所有副作用都由 ctx.effect disposer 清理，卸载即净。

快速开始

dsh plugin --profile web add github:wakeup595626-cmyk/dsh-session-folders

该包尚未发布到 npm，请使用上面的 GitHub 安装方式。安装或更新后重启 dsh web。

使用

打开 Web UI，使用会话列表上方的文件夹树：

• 右键会话或文件夹打开操作菜单；
• 把会话拖到目标文件夹即可移动；
• 文件夹可继续嵌套、改色、改图标和折叠；
• 批量选择模式可一次移动多个会话。

REST API 位于 /@dsh-external/dsh-session-folders/api。

环境要求

• 已安装 DeepSeek Harness，并使用 web profile

数据与兼容性

• 分组元数据默认保存在 ~/.dsh/profiles/web/session-folders.json，可用插件配置里的 storagePath 覆盖。
• 插件只管理会话的展示分组，不复制、修改或删除会话正文。
• 写操作带单调递增的 version，并发冲突时返回最新的完整状态，由客户端重试。
• 当前面向 DSH 的 web client。DSH 升级后请回归一次拖拽、嵌套和刷新后的持久化。

第三方声明

无第三方运行时依赖；client 侧是针对 DeepSeek Harness client runtime 的原生 DOM 实现。

详见 THIRD_PARTY_NOTICES.zh.md（English）。

社区与支持

• 通过 GitHub Issues 报告问题与提问。
• 在 awesome-dsh-plugin.com 浏览更广阔的插件生态。

参与贡献

参见 CONTRIBUTING.zh.md（English）。

引用

@misc{dsh-session-folders,
  title={dsh-session-folders},
  author={wakeup595626-cmyk},
  year={2026},
  publisher={GitHub},
  howpublished={\url{https://github.com/wakeup595626-cmyk/dsh-session-folders}},
}

许可证

MIT