📄 FlowText · 工作流文字格式规范

v3.1 正式版2026-08-20 ｜适用:🕹 沙盒画板｜导入入口:顶栏「📝 文本」→ 粘贴即成图

🕹 打开画板试一试 🤖 给AI的生成指引(复制即用) ⚙️ 打开编译器(贴流程出提示词) 📚 通用应用案例库

1 · 概述与设计目标

FlowText 是一种用纯文字描述可视化工作流的格式。同一条工作流有两种等价形态:图形态(画板上的节点、连线、循环框)与文字形态(可存档、可粘贴、可让任何 AI 生成修改的结构化文本)。两者双向转换:画板「📋 生成」导出文字,顶栏「📝 文本」把文字还原成图。

人可徒手写——最少 2 行即为合法工作流;
AI 可稳定生成——语法规则少且明确(见第 8 节的现成指引);
往返无损——导出说明书粘回去,节点/连线/循环全部还原;
容错宽松——名称模糊匹配、缺省自动串联,写错不崩、尽力理解。

2 · 支持的两种格式

格式	是什么	什么时候用
格式A · 执行说明书	画板「📋生成」导出的完整 Markdown(总规则/结构图/逐步骤/循环定义)	存档还原、AI 修改后回贴、跨设备迁移
格式B · FlowText v2	每行一条指令的轻量语法 + `+属性行`(本规范主体)	徒手快写、让 AI 从零生成、把细节写进步骤

导入器自动识别:文本中出现 ### S1 样式标题即按格式A解析,否则按格式B。

3 · 格式B · FlowText v2 语法

3.1 行类型总览

行类型	语法	示例
名称行(可选)	`工作流:<名称>`	`工作流:三只股票批量研究`
步骤行	`S编号名称[:对象/要求] [<- 上游列表]`	`S2 DCF估值: 逐只正反算 <- S1`
循环行	`循环 [L编号] 循环名 = 成员 [引用S编号 \| 清单:项1、项2]`	`循环对每只股票 = S2 S3 引用S1`
注释行	`# 开头,忽略`	`# 这是注释`

3.2 步骤行规则

编号 S1…Sn:步骤唯一标识,供连线与循环引用;
名称:冒号前文字;命中元素库模块名(模糊匹配)自动挂载该模块,继承完整提示词与分类颜色;
对象/要求(可选):第一个冒号后的文字;
上游 <- S1 S2:箭头(<- 或 ←)后列输入来源,写多个=并联汇合;
默认串联:非输入步骤不写 <- 时,自动接上一行步骤之后;
输入节点:名称以 输入 / 开始 / 设定 开头;对象里以 、, 分隔的内容自动拆成列表(可被循环引用)。

3.3 属性行 `+`(v2 新增 · 给上一个步骤加细节)

步骤行下面缩进写 +键: 值,就把这条细节挂到上一个步骤上。全部可选、可重复、可乱序——不写就是最简写法(完全兼容 v1 老文本)。这些属性会原样进入导出的执行说明书,是"导出比你写的更详细"的来源。

属性	作用	示例
`+要求:`	这一步怎么做、约束、标准(→ 说明书「任务要求」)	`+要求: 每个承重数字带来源与日期`
`+产出:`	交付什么、验收标准(→「输出要求」)	`+产出: 一张评分表 + 三句结论`
`+对象:`	补充处理对象(等价于步骤行冒号后的内容)	`+对象: 最近四个季度的公开资料`
`+上游:`	另一种写上游的方式(等价 `<- S1 S2`)	`+上游: S2 S3`
`+工具:`	硬性要求该步实际调用的工具,别名自动归一到 7 个标准工具	`+工具: 联网搜索、代码执行`
`+格式:`	产出必须用的形态(表格/清单/JSON/Markdown…)	`+格式: 表格`
`+模板:`	紧跟 `+格式`,逐行给出表头/骨架(可多行)	`+模板: \| 维度 \| 得分 \| 依据 \|`
`+语言:`	产出语言/口径	`+语言: 中文`
`+限制:`	字数/禁令,用 `;` 分隔可写多条	`+限制: 不超过300字; 不写客套话`
`+自定义:`	其它风格/语气修饰	`+自定义: 用第一人称写`
`+附件:`	参考链接或补充文字(http 开头自动识别为链接)	`+附件: https://example.com/a.pdf`
`+私有`	标记🔐私有方法(对外分享前提醒移除),无冒号	`+私有`
`+隐藏`	🫥隐性步骤:照常执行、产出传下游,但不在最终交付里展示	`+隐藏`

7 个标准工具:联网搜索 / 读取网页·链接 / 代码执行·计算 / 文件生成 / 图像生成 / 子代理(独立agent) / 本地文件读写。写「搜索」「查网页」「算」「画图」「子agent」等别名都能自动认出来。

3.4 循环行规则(含 v2 四种模式)

= 左:循环编号(可省,自动 L1、L2…)与循环名;
= 右:循环体成员(边界内、每轮都执行的步骤)+ 模式;
边界语义:成员每轮/每项各执行一次,非成员整个流程只执行一次——导出说明书会生成「🔁 循环定义(边界必读)」章节写死此规则。

模式	写法	含义
清单式(默认)	`循环逐只 = S2 S3 引用S1` `循环逐维度 = S3 清单:盈利、成长`	对清单里每一项各跑一遍;`引用S1`=清单跟着入口节点变
固定轮数	`循环打磨 = S4 轮数:3`	同一件事重复 N 轮(逐轮改进)
条件循环	`循环磨到达标 = S4 S5 直到:红队无重大反对上限:5`	跑到条件满足为止,必须给上限(刹车)
工作组	`循环取证组 = S3 S4 工作组`	不循环,只把几步锁成一个整体单元
嵌套	行尾加 `嵌套于L1`	总次数 = 外层 × 内层

坑:清单: 后面不能有空格(空格之后的项会被吃掉);直到: 的条件也不要带空格。

3.5 最小示例(2 行)

S1 输入: 一个主题
S2 总结精炼

3.6 完整示例(并联 + 循环 + 属性行)

工作流:三只股票批量研究
S1 输入: NVDA、MSFT、GOOGL
S2 多方案对比评分: 逐只体检 <- S1
  +要求: 五支柱逐条打分,每个承重数字带来源与日期
  +工具: 联网搜索、代码执行
  +格式: 表格
  +模板: | 维度 | 得分 | 依据 | 来源 |
  +产出: 一张评分表 + 三句话结论
S3 总结精炼: 汇总近期要点 <- S1
  +限制: 不超过300字; 不写客套话
S4 多份输入合并整合 <- S2 S3
S5 红队挑错 <- S4
  +要求: 至少一条能推翻结论的实质反对 + 回应
S6 一页纸摘要 <- S5
  +语言: 中文
循环 对每只股票 = S2 S3 引用S1
循环 磨到达标 = S5 直到:红队无重大反对 上限:3

→ 生成 6 节点、6 连线、2 个循环;S2 带上工具硬性要求与表格模板,导出说明书时这些会展开成完整的执行约束。

3.7 多重循环(嵌套)

循环行尾加 嵌套于L1,即声明本循环整体位于 L1 的循环体内——外层每进入一轮/一项,内层完整跑一遍,总执行次数 = 外层 × 内层。画板上内层显示为紫色虚线框(🔁²),导出说明书自动生成嵌套关系声明。

S1 输入: 公司A、公司B、公司C
S2 输入: 盈利质量、成长空间、竞争壁垒
S3 单格分析: 当前公司的当前维度深挖 <- S1 S2
S4 单司汇总 <- S3
循环 对每家公司 = S3 S4 引用S1
循环 对每个维度 = S3 引用S2 嵌套于L1

→ S3 将执行 3×3=9 次,每次专注一格。节点归属最内层循环;嵌套关系在循环组之间声明(画板端:编辑循环组 →「多重循环(嵌套)」选择器)。

4 · 格式A · 执行说明书(往返契约)

要素	识别方式
工作流名	首个 `# …:<名称>` 标题
步骤	`### S<n> 名称【分类】[【🔁循环体·Lx】]` 区块
输入节点	标题含 `【📥 输入】` 或 `【入口】`
连线	每步 `- 输入来源:` 行中的 S 编号(「无上游」=不连)
对象/备注/输出	`- 对象/本步侧重/输入内容…`、`- 任务要求/补充说明…`、`- 输出要求/期望成品…`
模块	`- 指令模块:INS-xx`(专业版)或 `- 这一步做什么:` 反查元素库
循环	`### L<n>「名」— 方式` 区块:清单/轮数/停止条件/成员/引用来源

往返契约:对画板导出的任何说明书,导入后节点数、连线数、名称集合、循环结构与原图一致(已由自动化测试逐板验证)。

5 · 解析与匹配规则

模块模糊匹配:全名命中100分 / 去括号命中85 / 说明片段命中75 / 反向包含65;≥65 挂载最高分模块,否则按自定义步骤处理(不丢内容);专业版出现 INS-数字 直接精确挂载;
防环:构成回路的连线被丢弃(循环请用循环行表达,不要连回路);
自动排列:导入完成自动按阶段拓扑排列并适配视图;
覆盖确认:画板非空时导入先弹确认。

6 · 错误与边界行为

情况	行为
空文本	提示"内容是空的",不动画板
无任何 S 行	提示需要步骤行格式,不动画板
上游编号不存在	该连线忽略,其余正常
模块认不出	按自定义步骤创建(不丢内容)
循环成员含输入节点	输入节点不入循环(它是清单来源,不是循环体)

7 · 三画板差异

	🧰 通用版	🧩 专业版	📖 故事版
元素库	29个通用模块(分析/思维/加工/检查/格式)	仓库指令仓 INS-xx(金融/研究定制)	49个剧情元素(结构/事件/情感/人物/随机/加工)
模块写法	写模块名(如「红队挑错」)	写 `INS-02` 或名称	写元素名(如「转折」「浪漫桥段」)
输入节点	📥 输入(对象或列表)	📥 输入(对象或列表)	🎯 故事设定(题材/主角/世界观)
循环引用输入	✅	✅	清单建议手写

7.5 · v3 新增语法(2026-08-18:闸 / 汇合 / 条件线 / 弱参考)

沙盘画板第 8–10 轮加入的图上能力,v3 起全部有对应文字写法——AI 用纯文字就能编出带质量关卡与关系分型的完整工作流;「📋 生成」导出的说明书也会带上这些语义,粘回画板整图还原。

能力	文字写法	什么时候用
⬡ 验收闸	步骤下写 `+验收闸: 结论有出处且数据可复现`	关键交付物产出之后设质检关卡;标准用「且」分隔、逐条可核验;核验者≠执行者
失败路由	`+失败: 数据问题->S2; 分析问题->分析`	闸不过时按诊断回哪一步返工(可写编号或步骤名;每闸上限3轮)
⊕ 汇合规则	多上游步骤下写 `+汇合: 任一`	默认=等全部上游完成;写「任一」=先到先用
🏷 条件线	`<- S2(只处理波动>5%的)`	走这条线有前提时,条件直接标在线上并写进说明书
┈ 弱参考线	`<~ S1`	只参考它的产出、不构成先后硬依赖、不用等它

并行怎么表达?不需要任何符号——几步共享同一个上游就是并行(线一分叉即并行);多条入线=汇合。这两条规则会作为硬性条款写进执行说明书(3c 条)。配套的「🔎 体检」按钮会在生成说明书前检查:孤岛/断链/闸没标准/循环没停止条件/汇合规则。

7.6 · v3.1 新增(2026-08-20:⑂ 分流 —— 出线的"全走 / 只走一条")

v3 之前只有【入线】有规则(⊕ 汇合:等全部 / 任一),【出线】永远被当成"并行全走"。于是"判断后只走一条路线"这种最常见的路由,画得出来却写不进说明书 —— 导出的文件会一边列着每条线的条件,一边写着"3 路并行,无先后",执行的 AI 大概率三条全跑。v3.1 把缺的那一半补上。

能力	文字写法	什么时候用
⑂ 分流	多下游步骤下写 `+分流: 只走一条`,并给每条出线写条件 `<- S2(简单明确)`	先判断再三选一(路由/分诊/难度分档);不写=几条全走(并行,行为与 v3.0 一致)

写了 +分流: 只走一条 之后,说明书里这一步会变成「完成后【分流·只走一条】(硬性)…没走到的分支这一次完全不执行」并逐条列出触发条件; 下游汇合处会自动改口成「只会收到实际走过的那一条,收到即开工,不要等其余分支」(否则执行者会永远等一条本次根本不会跑的分支)。「🔎 体检」新增两条黄灯:设了只走一条却有出线没写条件 / 出线写了条件却按默认全走导出。

同轮画板侧改动(不影响文字语法):⬡ 验收闸的红色返工线默认就显示(原来要先开 🛡 控制层),线路改成从卡片下方绕回、整条线可用手指点开直接改「诊断词 / 退回哪一步 / 删除」;闸设置面板里返工路线一行一条,目标步骤点选不用打字。

8 · AI 编制指南 v3.1(一键复制 · 唯一权威源)

下面整段=发给任何 AI 的完整编制指南(含语法全集、12 个属性键与别名全表、功能选用决策表、大流程包小流程的方法、质量规则、4 个完整示例(含【例4 全功能总览】——一条流用到全部功能,可原样粘进画板自检))。点「复制」→ 连同你的需求发给任何大模型 → 它只回一段 FlowText → 粘进画板「📝 文本」直接成图。画板的 📝 面板里也有同款「🤖 复制AI编制指南」按钮。

(指南加载中… 若长时间空白,说明 flow-guide.js 未加载)

A129 仓库内更快的做法(免复制粘贴):在 Claude Code 里直接说 画工作流 <要做的事>(或 flowgen <要做的事>、把技能<名>变成工作流), 技能 a129-flowgen 会按本规范写好 FlowText、跑校验(坏引用/成环/循环成员/嵌套父全查), 再直接给一条画板直开链接,点开即成图。命令行同款校验: python3 MetaZero-OS/scripts/flowgen.py make <文件>。

8.5 · 提示词编译器(案例库内置,免开画板)

写好的 FlowText 是源码,不是提示词——直接粘给 AI 只能得到中等结果,因为工具纪律、循环边界、角色、验收标准这些硬约束还没展开。 ⚙️ 独立编译器页(/batch/compile,大屏左右分栏 + 模板起步 + 分享链接)与 📚 案例库页内置的编译器是同一个引擎:任何 FlowText(库里的 145 例,或你自己粘的)一键编译成 4 种成品提示词,并同时给出结构图与提示词完整度体检。

形态	编译出什么	什么时候用
📋 标准执行版	格式A 执行说明书:总规则 + 🧰工具使用总规则 + 🔁循环边界 + mermaid 结构图 + 逐步骤(角色/输入来源/硬性要求/工具/格式模板/验收) + 收尾自检	发给任何 AI 直接跑;也可粘回画板还原成图
🤖 Agents协同版	标准版 + 多agent编排八条硬约束(每步独立agent、文件交接、真并行、真循环、执行者≠验证者、运行卡、工具纪律)	Claude Code 等有子agent能力的环境
🏷 XML结构化版	`<workflow>/<steps>/<step>` 硬结构,每步带 `<role><inputs><tools mandatory><output_format><acceptance>`,末尾 `<self_check>`	Claude / GPT 单次长任务,标签结构比散文更稳
🎯 单步深挖版	把任一步单独变成完整提示词:角色 + 它在全流程的位置 + 上游产出粘贴位 + 下游要拿它做什么 + 硬性要求 + 交付自检	在普通对话框里一步一步手动跑

✍️ 主题替换:编译面板顶部填一句你的主题,入口节点的对象与文中 {{…}} 占位会被自动替换——同一条工作流复用到不同题目上,不必手改文本。

8.6 · 提示词分体检与一键补强

同一页的「🩺 体检」按 8 个维度打 0-100 分:任务说清 15 / 工具绑定 15 / 输出契约 15 / 验收标准 15 / 约束限制 10 / 质量闸 15 / 循环刹车 10 / 解析健康 5。分低通常不是流程画错,而是该写的属性行没写——「🔧 一键补强」按步骤类型自动补 +工具/+格式/+模板/+产出/+限制,条件循环补 上限:N,整条流没有质量闸时补一步红队,并逐条写明为什么补(可自行删改后再用)。

实测基线(2026-08-03,案例库 145 例全量跑):属性行使用率原为 0/145(v2 属性行能力上线后没有任何案例用上),平均提示词分 42.7;一键补强后 145/145 仍零解析错误、结构不丢(步骤/连线/循环均未减少),平均提示词分 68.0。回归命令:python3 MetaZero-OS/scripts/flowtext_crosscheck.py —— 它同时校验浏览器端引擎 flowtext.js 与命令行 flowgen.py 两套解析器在 145 例上逐例一致(防两边行为漂移)。

9 · 版本与变更

v3.1(2026-08-20):新增 +分流: 只走一条(⑂ 出线规则,补齐"入线有汇合、出线没规则"的另一半);§8 指南补上 12 个属性键全表 + 别名表(原先 +对象:/+上游:/+修饰: 解析器认得却没写进手册)与 【例4 全功能总览】;新增机器闸【覆盖率审计】——把解析器真认得的属性键从画板源码里抽出来逐个比对手册,少教一个当场红灯(tests/board.guide.mjs)。画板侧:验收闸红色返工线默认显示且可点改。完全向后兼容 v3.0(不写 +分流 时行为不变)。
v3.0(2026-08-18):新增文字语法——+验收闸:(⬡质检关卡)/+失败: 诊断->步骤(返工路由)/+汇合: 任一(⊕汇合规则)/<- S2(条件)(线上条件)/<~ S1(弱参考线);说明书往返全部保留;§8 AI 编制指南全面重写为 v3(唯一权威源 flow-guide.js,画板📝面板与本页同源一键复制);画板同轮新增双向自动排列、四角快捷按钮、🔎执行体检。完全向后兼容 v2(+验收: 仍是"产出"的别名,闸请用 +验收闸:)。
v2.1(2026-08-03):引擎抽成独立文件 web/terminal/batch/flowtext.js(解析 / 防环建边 / 拓扑分层 / 结构图 / 4 形态编译器 / 体检 / 一键补强),案例库改为结构图 · 提示词 · 体检补强 · 源码四页签,并可粘贴任意 FlowText 现场编译;新增双实现交叉回归脚本。格式语法本身未变,完全兼容 v2.0。
v2.0(2026-08-02):新增 +属性行(要求/产出/对象/上游/工具/格式/模板/语言/限制/自定义/附件/私有/隐藏),把此前只能在画板里点选的节点能力全部变成可手写文本;循环新增三种模式的文本写法(轮数:N、直到:X 上限:N、工作组);顶栏导入按钮由「📄」改为醒目的「📝 文本」。完全向后兼容 v1。
v1.2(2026-08-02):新增仓库侧生成/校验器 flowgen.py 与技能 a129-flowgen(一句话→FlowText→校验→画板直开链接);解析仿真已用案例库 145 例回归对齐。
v1.1(2026-07-22):新增多重嵌套循环(嵌套于Lx 语法+紫色内框+导出嵌套声明,往返保持)。
v1.0(2026-07-22):首个正式版——两种格式、并联/循环/引用输入、默认串联、模糊匹配、往返契约、三画板差异。
规划中(未实现,勿依赖):并联花括号糖 {A|B}、中文序号。