dsh-harness-one

简体中文 · English Workflow One

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

Workflow One 是运行在 DeepSeek Harness（dsh） 中的可视化 AI 工作流编排器。只需用自然语言描述需求，AI 会自动规划并创建由真实 dsh agent、脚本、条件分支和 HTTP 节点组成的 DAG；也可在画布中微调后启动流程，实时查看每个节点的输入、输出和产物，失败后从中断处恢复。 为什么需要 Workflow One？ 安装 [!NOTE] 需要 Node.js >= 22.15.0（dsh 本体用到 node:zlib 的 zstd API，22.15 起提供），并已安装 DeepSeek Harness：npm i -g @deepseek-ai/dsh。 npm v0.5.0 起 Workflow One 合并为单包 dsh-harness-one（旧 dsh-ccpg-one 已停更）。老用户在设置面板「Workflow One → 检查更新」一键迁移，或手动：dsh plugin --profile remove dsh-ccpg-one && dsh plugin --profile add dsh-harness-one && dsh plugin --profile add dsh-better-sidebar。

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

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

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

从源码构建

模型和密钥完全由 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. 运行期间，对话会以卡片直接展示各节点的进展；也可配置「消息通知」节点，将节点状态实时同步到飞书群聊或私聊。画布节点可查看实际输入与执行详情，右侧「过程 / 成果 / 问题」提供时间线、最终结果和产物。

/workflow-one 技能指令：在对话输入框键入 / 打开技能菜单，选择 workflow-one 注入操作指南，之后用自然语言搭建和驾驭长流程——多节点接力、定时触发、跑几十分钟也不用盯着： 「搭一条每天早上汇总三个飞书群消息、提取要点写成日报发回群的工作流」——口述需求即创建：AI 规划多节点接力（抓取 → 分析 → 撰写 → 通知）、配好定时触发，保存后每天自动跑 「现在跑到哪了？卡在哪个节点？」——长流程随时问进度：给出各节点状态与产出，异常节点附错误摘要和下一步建议 「给竞品监控工作流加一个数据异常时转人工确认的分支」——读图、批量改图、lint 校验一次完成 「删掉那个临时拼的爬虫工作流」——确认后删除；有关联运行 / 定时 / webhook 时会拒绝并列出清单

该技能由 orchestrator 安装时种子到 dsh 原生技能根，官方聊天与画布会话共用；画布绑定的会话另有 canvas_* 工具族直接操作当前画布，详见下文「画布 AI 助手」。