前言¶

在 DeepSeek Harness（DSH）里让 Agent 执行多步任务时，工作流往往散落在对话记录或零散文件里：步骤边界不清、分支条件难以核对、改一处要翻多处 Markdown。纯文本能版本管理，但拓扑关系不直观；纯画布又容易和源文件脱节。

DeepSeek Flow（kanghelyu/dsh-deepseek-flow）是面向 DSH Web UI 的可视化、Markdown 优先的工作流编辑器。它以 WORKFLOW.md 与各步骤 STEP.md 为单一事实来源，在 Harness 里提供可编辑的流程图，并与 Markdown 双向同步。插件有意只做编辑器，不做工作流运行时；设计、检查、改进流程在 Studio 完成，实际执行仍由当前 Session 的 Agent 承担。

这是什么¶

DeepSeek Flow 由 kanghelyu 维护，MIT 许可证，npm 包名 deepseek-flow，当前版本 0.4.2。项目在 GitHub 约有 50 stars、4 forks。官方站点：deepseekflow.kanghelyu.org。

一句话定位：把 WORKFLOW.md 及步骤级 STEP.md 转成 Harness 内可编辑的流程图；内置 Skill 让当前 Session 通过工具创建和维护工作流，画布与 Markdown 保持同步且可移植。

核心功能¶

下面按 README 与 package.json 已核实的能力归纳。

Markdown 为源、画布可编辑¶

• 主文档 WORKFLOW.md，每个步骤一个目录，内含 STEP.md。
• 在画布上创建、移动、连接、重连、标注、删除节点与箭头。
• 画布与 Markdown 编辑器双向同步，修改写回工作流文件。

典型目录结构如下：

my-workflow/
├── WORKFLOW.md
├── 01-input/
│   └── STEP.md
├── 02-research/
│   └── STEP.md
├── 03-quality-check/
│   └── STEP.md
└── 04-output/
    └── STEP.md

拓扑变更与审查语义¶

• 人在画布上改拓扑：校验图结构后，由当前 Session Agent 审查，再原子保存新版本。
• Agent 或直接改文件驱动的拓扑：可走确定性 finalize 路径，避免同一 Session 重复审查；Agent 应调用 flow_finalize_canvas，若未调用，Studio 会检测无画布编辑事件并自动执行同等 finalize。

可执行门语义与 Agent 工具¶

导出的契约包含公式、操作数、谓词及确定性布尔结果，无需运行 Agent 步骤即可评估门逻辑。插件随附 Agent Skill，文档覆盖各工作流工具，并含可执行的 IF/ELSE 与布尔门示例。

Session 隔离、导航与持久化¶

• 每个 Harness Session 维护独立工作流，可选共享模板；工具栏可删除当前工作流或共享模板（需确认，托管工作区进回收站可恢复）。
• 侧栏可折叠、可调整大小；支持平移、缩放、适应视图、节点聚焦动画；大图拖拽在指针释放时提交，后台轮询轻量修订。
• 界面跟随 Harness 明暗主题与 WebUI 语言。
• 逻辑校验结果、AI 提案、未应用画布草稿持久化到磁盘；切换文档、Session 或重启 dsh web 不丢失，仅显式丢弃或成功提交后清除。
• 未变更文档不重写；后台轮询可取消；子 Agent 默认超时 10 分钟。

手动与后台 AI 辅助¶

可在界面触发逻辑校验、单文档优化（带审查）或完整工作流优化。切换文档、视图或 Session 不中断已接受的后台任务；返回时恢复文档提案。

安装与启用¶

插件通过 DSH 的 Web profile 从 GitHub 安装。安装后需重启 dsh web，在 Session 中选择 DeepSeek Flow 标签页。

dsh plugin --profile web add "github:kanghelyu/dsh-deepseek-flow#main"

确认插件已挂载：

dsh web --dump-config | grep deepseek-flow

说明：DSH 生态奉行「一切皆插件」；SkillHub 目录页 为社区站点，与 DeepSeek / 幻方无官方从属关系。安装前请自行查看源码与 MIT 许可证；插件以当前 dsh 进程权限运行。

典型用法¶

第一个工作流¶

1. 在 Session 中让 Agent build a workflow 或 import a workflow；内置 deepseek-flow Skill 会引导使用 flow_create 或 flow_put。
2. 打开 DeepSeek Flow，插件会脚手架主文档、步骤文档与视觉布局。
3. 让 Session Agent 改工作流文件，或在 Studio 里选中文档直接编辑 Markdown。
4. 经 Session/文件驱动的拓扑更新由 finalize 路径完成，无需再次主 Session 审查。
5. 若在画布上增删改连节点，点击 Apply changes：校验 → Agent 审查 → 再校验 → 原子保存。
6. 需要执行时回到 Session，由 Agent 按工作流运行。

跨 Session 与活动工作流¶

Studio 工具栏下拉列表按来源分组：当前 Session、其他 Session、共享模板。切换到其他 Session 的工作流时，会将该工作区的文档副本导入当前 Session（外部自定义 docRoot 仅引用不复制）；共享模板切换时也会复制到当前 Session 托管空间，避免污染共享原件。每个 Session 在 sessions/<id>.json 持久化 activeFlowId，重开 Studio 自动选中上次工作流。

适用场景与注意¶

适合谁

• 需要在 DSH 里设计、审查、迭代多步 Agent 工作流，且希望 Markdown 可版本管理、可移植的开发者。
• 需要可视化核对分支与布尔门逻辑，又不想把执行引擎绑死在编辑器里的团队。
• 已通过对话让 Agent 建流程，但希望用画布与文件双向编辑统一维护的场景。

务必注意

• 这是编辑器，不是运行时；执行仍在当前 Session。
• 人改画布拓扑会触发 Agent 审查；改文件则应配合 flow_finalize_canvas 或依赖 Studio 自动 finalize。
• 安装插件即授予其与 dsh 相同的文件与网络访问能力，请从可信源安装并阅读源码。

小结¶

DeepSeek Flow 把 WORKFLOW.md / STEP.md 与 Harness 内可编辑流程图绑在一起：Markdown 便携、画布直观、拓扑变更有明确审查或 finalize 路径，并附带完整 Agent 工具与 Skill。若你已在用 DSH Web UI 编排多步任务，可从目录页或 GitHub 查看文档与示例，按官方命令安装后在 Session 中创建第一个工作流。

• 目录页：https://www.skillhub.cn/plugins/kanghelyu/dsh-deepseek-flow
• GitHub：https://github.com/kanghelyu/dsh-deepseek-flow