workflow-code
workflow-code 是一套用 TypeScript 编排、运行和发布工作流的本地与远程工具链。当前实现分成三层:- 核心运行时:
core提供workflow全局 API、节点、executor、KV、文件和 LLM provider。(issue #36) - 桌面 App:
app只打开和执行本地 dev 项目,保存、运行、环境变量都走 Electron 本地逻辑。 - Workflow Server:
server保存上传后的远程项目包,server/web只连接服务器并展示已发布版本、环境变量、入口、Webhook 和执行日志。
阅读路径
- 先看 App 指南,了解本地创建、编辑、运行和发布的日常流程。
- 再看 Server Web 指南,了解发布后的项目管理、入口配置和日志排查。
- 编写 workflow 代码时看“文档”分组,那里对齐了当前 runtime API 和 executor 约束。
- 对接外部系统时看“服务端 API”,OpenAPI 页面会生成可调试的请求面板。
变更来源
本首版文档来自 GitLab issue #32 新增 Mintlify 中文文档站点首版。行为说明还参考了这些已合入变更:server/web 主题与响应式 #17、server/web dev HMR #19、运行附件 #25、GitLab Webhook 兼容 #31。如果后续发现文档与代码行为不一致,优先在 #32 或后续关联 issue 中补充上下文。当前边界
- 文档默认中文,不启用多语言切换。
- 服务端 API 覆盖当前 server 路由的主要请求、响应和鉴权;深层
report结构保留为对象,避免把内部诊断格式写死。 - 本文档只整理用法,不改变
core基础定义、节点 API、executor/provider 类型或 generator skill。 - App、Server Web 和文档站点统一使用
assets/brand/workflow-code-icon.svg派生出的同一份应用图标;Electron window / Dock、系统状态栏 / tray、浏览器 favicon、docs logo 和各端默认项目卡片只保存构建所需副本。