前言¶
在 DeepSeek Harness（DSH）里做智能体或插件开发时，同一工作区往往会不断分叉出新会话：试一种 prompt、改一版配置、再开一条对照对话。会话一多，侧边栏会变成一长串平铺条目，找「上一轮改过的那条」要靠滚动和记忆。CompFlow 是维护者 SoyBeanMilkx 发布的客户端插件，把同一工作区内的多个会话收进可折叠、可嵌套的「合成」，用结构代替纯列表。下面介绍它做什么、怎么装、日常怎么用。
这是什么¶
CompFlow（仓库 SoyBeanMilkx/CompFlow）是 DSH 的会话管理插件。官方简介为：Organize DSH sessions into nested, collapsible compositions. README 用中文概括为：把同一工作区里的多个会话收进可折叠的「合成」，让频繁分叉后的会话列表保持清爽。
插件在 package.json 中登记为 dsh-session-comps，面向 web profile 的客户端注入（dsh.client.platform: web），通过 Cordis patch 与 DSH 客户端 UI、会话与工作区相关 API 协作。DeepSeek Harness 生态强调「一切皆插件」；社区目录页在 skillhub.cn，与 DeepSeek / 幻方无官方从属关系，安装前宜自行查看源码与许可证（资料中为 MIT）。
核心功能¶
以下能力均来自项目 README，未在资料中出现的配置项或快捷键不写。
- 创建、重命名、折叠和嵌套合成
- 通过拖拽移动会话与合成
- 从会话菜单快速新建或加入同级合成
- 将会话移回工作区根目录
- 解散合成时保留全部会话
- 删除合成时确认并永久删除整个子树及其中会话
合成仅能管理同一工作区中的会话；跨工作区整理不在插件说明范围内。
安装与启用¶
CompFlow 需安装到 DSH 的 web profile。官方命令如下：
dsh plugin --profile web add github:SoyBeanMilkx/CompFlow
安装完成后重启 DSH。README 还说明：首次安装或 Host 端代码更新后，可能需要完全重启 DSH。
若你在本地开发或 fork 插件，可从目录安装到同一 profile：
dsh plugin --profile web add /path/to/CompFlow
开发构建与自测（供贡献者参考，非普通用户必做步骤）：
npm run build
npm test
典型用法¶
把会话放进合成
- 在目标会话的三点菜单里选择「加入合成」。
- 新建一个合成，或选择当前层级下已有的合成。
调整结构
- 直接拖动会话或合成，改变层级与顺序。
- 右键某个合成：重命名、新建子合成、解散或删除。
解散与删除的区别
- 解散：合成消失，其中的会话全部保留，只是回到可单独管理的状态。
- 删除：会弹出确认；确认后永久删除整个子树以及子树内的会话，操作不可逆，使用前需确认没有仍需要的对话。
需要把某条会话从合成里「拎出来」时，使用 README 提到的移回工作区根目录能力，避免误删。
适用场景与注意¶
适合谁
- 在同一 DSH 工作区里并行多条实验线、频繁分叉，又希望侧边栏按主题或迭代分组的人。
- 依赖 DSH Desktop / web 客户端侧边栏会话列表的使用者（插件分类为客户端）。
使用注意
- 插件随当前 DSH 进程与客户端环境运行，安装前应阅读 GitHub 仓库 源码与 MIT 许可证，确认符合你的安全与合规要求。
- 删除合成会连带删除子树内会话，与「解散」不同；团队共用工作区时更应区分这两种操作。
- 资料中未描述服务端同步规则或跨设备合并行为，多机使用时以你当前 DSH 版本实际表现为准。
结尾¶
CompFlow 不替你做对话内容，只改变同一工作区内会话在 UI 上的编组方式：嵌套、折叠、拖拽与菜单快捷操作，对应 README 里「合成视图」所展示的目标——在分叉变多时仍保持列表可读。若要安装或提 issue，可访问目录页 skillhub.cn/plugins/SoyBeanMilkx/CompFlow 与 GitHub SoyBeanMilkx/CompFlow。
