<strong>简体中文</strong> · <a href="./README.en.md">English</a>

Workflow One

一句话，把真实 Agent 变成可观察的工作流

Workflow One 是运行在 DeepSeek Harness（dsh） 中的可视化 AI 工作流编排器。只需用自然语言描述需求，AI 会自动规划并创建由真实 dsh agent、脚本、条件分支和 HTTP 节点组成的 DAG；也可在画布中微调后启动流程，实时查看每个节点的输入、输出和产物，失败后从中断处恢复。

为什么需要 Workflow One？

能力	带来的变化
可视化编排	用节点和连线表达串行、并行与条件分支，复杂流程不再藏在提示词里。
真实 dsh Agent	每个智能体节点直接使用 dsh 的模型、工具和 Skill，同一张图可组合不同模型与职责。
运行全透明	实时查看节点状态、实际输入、输出、token、trace 和产物，多次运行可并发且互不干扰。
可恢复执行	节点支持超时、重试、失败继续和断点续跑，不必因单点异常从头执行。
多入口触发	可从画布、对话、Webhook 或 cron 定时启动；AI 助手也能查询、修改和运行工作流。
结果可交付	结果与文档产物可预览、下载，也可通过飞书群聊或私聊推送进度和最终结果。

安装

[!NOTE] 需要 Node.js >= 22.15.0（dsh 本体用到 node:zlib 的 zstd API，22.15 起提供），并已安装 DeepSeek Harness：npm i -g @deepseek-ai/dsh。

npm

dsh plugin --profile web add dsh-ccpg-one
dsh web

Harness Desktop 用户从托盘打开 Open DSH Terminal，执行 dsh plugin add dsh-ccpg-one 后重启 Desktop。不要在 Desktop 中运行 setup.sh，Desktop 会自行管理 profile、Node/pnpm 和随机 loopback 端口。详见 Desktop 安装与排障。

界面依赖说明：Workflow One 在 dsh 官方界面中的「工作流」画布由开源项目 DSH-better-sidebar 提供侧栏与标签页宿主，dsh-ccpg-one 会自动安装并依赖它。未安装或禁用 DSH-better-sidebar 时，官方界面内嵌的「工作流」入口不可用，但独立画布 /wf1/ 仍可访问。

离线包

从 GitHub Releases 下载聚合包，无需仓库源码：

curl -LO https://github.com/chumingjun/harness-one/releases/download/<tag>/dsh-ccpg-plugins-<tag>.tar.gz
tar -xzf dsh-ccpg-plugins-<tag>.tar.gz && cd dsh-plugins
sh setup.sh --one wf1 4021
sh start.sh wf1                         # http://127.0.0.1:4021/

从源码构建

git clone https://github.com/chumingjun/harness-one.git
cd harness-one
npm install
npm --prefix web install
sh dsh-plugins/build-web.sh             # 源码安装必跑，构建产物不入库
sh dsh-plugins/setup.sh --one dev 4021
sh dsh-plugins/start.sh dev

模型和密钥完全由 dsh profile 管理。插件使用 dsh 默认模型栈，也支持在 cordis.patch.yml 或 ~/.dsh/settings.yaml 中追加 provider；本仓库和插件不写死、不存储任何 key。完整安装、配置与开发循环见 dsh-plugins/README.md。

普通 dsh 的 lark-cli 由 setup.sh 或插件自举安装；Desktop 仅在用户明确点击后通过受管 pnpm 安装。

界面与使用方式

Workflow One 嵌在 dsh 官方界面中，推荐从 AI 对话开始创建复杂工作流：左侧用自然语言描述目标和需求，中间画布实时呈现 AI 生成的 DAG。画布主要用于确认结构、微调参数和观察运行，也可以继续手工添加或连接节点。

1. 在 dsh 对话中用自然语言描述要完成的工作流需求，AI 会自行规划流程并创建节点。
2. 需求有变化时，继续在对话中说明，AI 会相应更新工作流。
3. 在画布中确认生成结果，保存后从对话或画布启动运行。
4. 运行期间，对话会以卡片直接展示各节点的进展；也可配置「消息通知」节点，将节点状态实时同步到飞书群聊或私聊。画布节点可查看实际输入与执行详情，右侧「过程 / 成果 / 问题」提供时间线、最终结果和产物。

查看完整分辨率截图

下图展示同一次运行的协同视图：左侧对话持续跟踪进度，中间选中正在执行的节点并查看配置，右侧按拓扑顺序展示每个节点的运行状态。

可导入模板

examples/workflows/ 提供三套可直接导入的工作流：报修工单整理、紧急度分流和多方并行评审。打开「工作流」列表，点击「导入」并选择 .workflow-one.json 文件即可使用。

画布能力

8 种节点类型：输入 / 智能体 / 脚本（QuickJS 沙箱） / 条件分支 / HTTP 请求 / 输出 / 消息通知 / 注释。

…