Rho format spec

Rho format 的完整规范文档——给 implementer 看的精确定义(不是给写作者 / 集成方)。


完整规范

→ AINP 协议(v0.9)——就托管在 rho.md 上,整份文档一页看完(英文)

涵盖:

  • markdown 载体与静态结构块(提示框、卡片布局、时间轴、标注、STL、mermaid)
  • 每种互动块的语法:chart、interact、直接操纵(:drag、pick)、image、标签页 / 分步 / 弹窗、table / media / quiz / branch、graph
  • 图表与互动图的文字替代(alt = / summary =)
  • 组合、命名空间与共享状态
  • 写作指南:决策树、常见模式、反模式、给语言模型作者的规则
  • 安全模型、出错时的表现、在其他阅读器里的回退、一致性等级
  • 表达式小语言(完整语法与内置函数)和一页速查表

License: spec 是 CC BY 4.0 —— 任何人都能基于它实现 reader(不需要 commercial license)。


历史版本

版本 发布日期 主要变化
v0.0 2026-01-15 初版:5 静态 + 7 交互 = 12 capability
v0.1 2026-01-28 spec 形式化、HTML 输出标准化
v0.2 2026-02-10 namespace 共享 state
v0.3 2026-02-25 nested DSL inner processor
v0.4 2026-03-15 computed 派生值
v0.5 2026-04-22 timer 自动播放动画
v0.6 2026-05-08 SVG scenes
v0.7 2026-06-14 table / media / quiz / branch
v0.8 2026-08-03 graph 网络图 / 星盘块
v0.9 2026-09-20 图表与互动图的文字替代 alt = / summary =(当前最新)

版本

规范还在 1.0 之前:新版本仍可能改变已有 capability 的行为。请声明你的 reader 支持哪个版本(见下),升级时对照上面的历史版本。


实现 reader 时的兼容性建议

如果你做自己的 reader 实现:

  1. 声明你支持的 spec 版本(v0.5+ / v0.6+ / v1.0+)
  2. 不识别的 DSL 块显示为代码块字面量(plain-text fallback——参考 Plain-text fallback principle)
  3. 遇到 spec 不熟的 modifier忽略(向前兼容)
  4. 跑 spec 自带的 conformance test(计划在 v1.0 发布——目前手工对照)

See also