FlowText · 工作流文字格式规范 v1.0

> 状态:正式发布｜日期:2026-07-22 ｜适用:A129 三块工作流画板(通用版 flow-board / 专业版 flow-canvas / 故事版 story-board)

> 在线文档:https://metazero-terminal.pages.dev/batch/flow-dsl.html ｜画板导入入口:任一画板 ⋯菜单 → 「📄 文字→画板(导入)」

1. 概述与设计目标

FlowText 是一种用纯文字描述可视化工作流的格式。同一条工作流在系统中有两种等价形态:

图形态:画板上的节点、连线、循环框(手机上拖拖点点编辑);
文字形态:一段结构化文本(可存档、可粘贴、可让任何 AI 生成与修改)。

两者双向可转换:画板「📋 生成」导出文字;「📄 文字→画板」把文字还原成图。设计目标按优先级排序:

1. 人可徒手写——最少 2 行就是合法工作流;

2. AI 可稳定生成——语法规则少且明确,任何大模型照第 8 节指引即可产出;

3. 往返无损——导出的说明书粘回去,节点/连线/循环全部还原;

4. 容错宽松——名称模糊匹配、缺省自动串联,写错不崩、尽力理解。

2. 支持的两种格式

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

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

3. 格式B · FlowText 简易语法

3.1 行类型总览

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

3.2 步骤行详解

S1 输入: NVDA、MSFT、GOOGL

S2 多方案对比评分: 逐只体检 <- S1

S3 总结精炼 <- S1

S4 合并整合 <- S2 S3

S5 红队挑错

逐条规则:

编号 S1…Sn:步骤唯一标识,供连线和循环引用;
名称:冒号前的文字。命中元素库模块名(模糊匹配,见第5节)则自动挂载该模块(继承其完整提示词与分类颜色);
对象/要求(可选):第一个冒号后的文字,写这一步"针对什么/要什么";
上游 <- S1 S2:箭头(<-、← 均可)后列出输入来源。写多个 = 并联汇合(该步等所有上游完成、读取全部产出);
默认串联:非输入步骤若不写 <-,自动接到上一行步骤之后(如上例 S5 自动接 S4);
输入节点:名称以 输入、开始、设定 开头 = 入口/输入节点;其对象里用 、 , 分隔的内容自动拆成列表(每项一行,可被循环引用)。

3.3 循环行详解

循环对每只股票 = S2 S3 引用S1

循环 L2 打磨三轮 = S5 清单:第一轮、第二轮、第三轮

= 左边:循环编号(可省略,自动 L1、L2…)与循环名;
= 右边:循环体成员(哪些步骤在循环边界内,每轮都执行)+ 清单来源,二选一:

- 引用S1——循环清单直接引用某输入节点的列表(列表改动循环自动跟随);

- 清单:甲、乙、丙——手写清单;

- 都不写——循环创建后在画板上手动补(编辑循环组可改为固定次数/条件循环)。

边界语义:成员步骤每轮/每项各执行一次,非成员只执行一次——导出说明书会生成专门的「🔁 循环定义(边界必读)」章节写死这一规则。

3.4 最小合法示例

S1 输入: 一个主题

S2 总结精炼

(2 行 = 输入 → 总结,自动串联。)

3.5 完整示例(并联+循环+引用)

工作流:三只股票批量研究

S1 输入: NVDA、MSFT、GOOGL

S2 多方案对比评分: 逐只体检 <- S1

S3 总结精炼: 汇总近期要点 <- S1

S4 多份输入合并整合 <- S2 S3

S5 红队挑错 <- S4

S6 一页纸摘要 <- S5

循环对每只股票 = S2 S3 引用S1

生成:6 节点、6 连线、1 个循环(S2/S3 在青色虚线循环框内,循环清单=S1 的 3 只股票)。

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

导入器解析导出说明书的以下要素(其余文字忽略):

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

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

5. 解析与匹配规则

模块模糊匹配:步骤名/说明与元素库逐一打分——全名命中100分、去括号命中85分、说明片段命中75分、反向包含65分;≥65 分挂载最高分模块,否则作为自定义步骤(灰色,内容以你写的文字为准);专业版文本中出现 INS-数字 直接精确挂载;
防环:所有连线经环检测,构成回路的连线被丢弃(循环请用循环行表达,不要连回路);
自动排列:导入完成自动按阶段拓扑排列并适配视图;
覆盖确认:画板非空时导入会先弹确认,防误覆盖。

6. 错误与边界行为

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

7. 三画板差异

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

8. 给 AI 的生成指引(可直接复制给任何大模型)

> 请用 FlowText 格式输出一条工作流,规则:每行一步,格式 S编号步骤名:这一步的对象或要求 <- 上游编号;多个上游用空格分隔表示并联汇合;不写 <- 默认接上一行;第一行通常是 S1 输入: <对象或用、分隔的列表>;需要对列表逐项重复的步骤,最后加一行 循环循环名 = 成员编号引用S1;可选首行 工作流:<名称>。只输出 FlowText 文本,不要解释。

把上面这段连同你的需求发给任何 AI,产出直接粘进画板即可成图。

9. 版本与变更

v1.0(2026-07-22):首个正式版。两种格式、并联/循环/引用输入、默认串联、模糊匹配、往返契约、三画板差异。
规划中(未实现,勿依赖):并联花括号糖 {A|B}、中文序号、嵌套循环、分享链接语法。

*本规范由 A129 画板工程组维护;实现与测试见 web/terminal/batch/*.html 及仓库测试脚本。规范正文与实现行为以线上画板实测为准。*