了解 FractalPark 中的 FRM

此兼容性表描述 Classic-compatible Editor 和导入路径。规范的已发布 Standard Definition 使用单独版本化的 FRM-like v1 parser、类型化 IR、standard32 backend 和固定的 Safety Envelope。

规范 FRM-like v1 与当前 Classic Editor 示例都具有命名公式以及 init、loop 和 bailout 的概念，但它们的完整语法不同。在 v1 中，语义 directive 和可选的类型化 parameters section 也是 Definition 的一部分。

这些区段名是语法结构而非注释；缺少或拼错任何一个都会产生诊断信息。

两种界面都刻意保持精简。下列摘要是共享概念；请使用已发布 Formula Record 的 Source 操作查看规范 directive 和类型化 parameter，并使用 Editor diagnostics 处理 Classic 源码。

声明与区段

用大括号包住一个具名公式，并依次编写 init:、loop: 和 bailout:。

数值与变量

可以使用 0.15 这样的实数、(0.05, -0.02) 这样的复数对、内置轨道值，或自行赋值的变量。

表达式

可以组合算术、乘方、比较、逻辑、单目运算、|z| 模长语法，以及经过测试的复函数。

控制流

当轨道更新取决于条件时，可使用 if、elseif、else 和 endif；所有分支块必须完整闭合。

内置名称

核心名称包括 z、c、pixel、zPrev、p1–p5、pi、e、maxit、ismand、fn1–fn4，以及编译器测试覆盖的函数。

注释与指令

分号注释用于说明源码。已识别的 @ 指令配置 FractalPark native 行为；未知指令不会被静默忽略。

FractalPark 从不将源码文本直接粘贴进 shader。规范 v1 源码经由其类型化 parser 和 CPU/GLSL backend；Classic Editor 源码经由其 scanner、selected-entry frontend、canonical formula model 和 plugin compiler。

1. 1

   FRM 源码

   来自编辑器、粘贴或本地文件的原始文本，是编译流程的权威输入。

2. 2

   词法单元

   词法分析器识别名称、数字、运算符、区段标记、注释和指令，同时保留源码位置。

3. 3

   解析后的 AST

   解析器构建结构化公式树，并报告格式错误的声明、表达式和控制流块。

4. 4

   校验与规范形式

   校验器检查名称、类型、区段和受支持语义，通过后才建立规范化公式。

5. 5

   GLSL 与源码映射

   代码生成器输出着色器函数，并记录生成 GLSL 到原始 FRM 位置的映射。

6. 6

   公式插件

   编译成功后，公式会转成渲染器和着色器组装系统共同使用的标准插件契约。

这些是 Classic-compatible Editor 示例，不是规范 FRM-like v1 Definition。它们从小型二次公式逐步扩展到 parameters 和有状态反馈；每个源码块均来自共享 Editor registry，并在测试期间编译。

StarterBrot {
init:
  z = 0
loop:
  z = z^2 + c
bailout:
  |z| < 4
}

ParameterDrift {
init:
  z = 0
loop:
  z = z^2 + c + p1 * 0.15 + p2 * (0.05, -0.02)
bailout:
  cabs(z) < 8
}

OrbitEcho {
init:
  z = pixel
loop:
  z = sqr(z) + zPrev * (0.30, -0.12) + pixel * (0.85, 0.0)
bailout:
  |z| < 48
}

独立 FRM Editor 通过稳定 ID 打开这些 Classic-compatible、经过编译检查的示例。公式源码会留在当前标签页，直到你将它保存到云库，且绝不会嵌入 URL。这不会启用规范 v1 导入或写入器。

编译会在最早出现不安全状态的阶段停止，并提供面向源码的错误信息。被拒绝的语法不会被改写成一个只是看起来相似的结果。

修复错误时应从第一条信息开始；后续诊断往往只是同一个缺失符号或无效表达式引发的连锁结果。

你写的公式默认是私有的，除非你明确选择分享。公式有三种流转方式——每一种都由你显式触发，没有静默发生。

• 默认私有

  公式保存在你的云端库中，仅自己可见。保存的作品会把公式源码副本存进草稿里，所以作品打开时永远是你离开时的样子。

• 下载 .frm 文件

  你的公式是纯文本。随时从「我的公式」下载，自己留一份——不需要导出申请，不需要等待。

• 发布作品，分享源码

  发布使用了自定义公式的作品，会以 MIT 许可证公开公式源码：任何人都可以阅读、复制并在其上继续创作。社区页面会展示来自元数据的公式名，并提供源码下载。对已发布的作品而言，这一步不可撤销。

完整的 MIT 许可证文本见 opensource.org。