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 实现:
- 声明你支持的 spec 版本(
v0.5+/v0.6+/v1.0+) - 不识别的 DSL 块显示为代码块字面量(plain-text fallback——参考 Plain-text fallback principle)
- 遇到 spec 不熟的 modifier忽略(向前兼容)
- 跑 spec 自带的 conformance test(计划在 v1.0 发布——目前手工对照)
See also
- Implementing your own reader — 照规范自己实现 reader 的 walkthrough
- Writer's Guide — capability 的"how to use"角度
- AINP 协议(v0.9) — 全文,就在本站