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 主题与响应式 #17server/web dev HMR #19运行附件 #25GitLab 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 和各端默认项目卡片只保存构建所需副本。