FAQ

跨 track 的常见问题。按身份分流——找你的角色直接跳。 Capability 具体问题在 Common pitfalls。


总览

你是 跳到
写作者 / 教师 / 博主 §1 Writers
AI 应用 / prompt 工程师 §2 AI engineers
集成开发者(想在自己项目里加 Rho 渲染) §3 Integrators
商业采购 / 法务 §4 Business / legal
协议实现者(自己写 reader) §5 Protocol implementers
学术研究 §6 Academic

1. Writers

Q: 我是博主 / 老师 / 学生,从哪开始?

→ What is Rho? 5 分钟懂哲学 → 5-minute tour 看全部 15 capability → Your first interactive .md 跟着做复利计算器 → Cheatsheet 一页打印

Q: 我能在哪里渲染我的 Rho 文档?

在 Rho MD 里——免费 app,支持 Windows、macOS、Linux、Android、iPhone 和 iPad(下载)。没有浏览器端编辑器,渲染发生在 app 里。用 Rho MD 发行的文档也可以在浏览器里的 Rho Library 读。渲染器目前还没有以库的形式发布。

详见 Install Rho app。

Q: 我的 .md 文件在 GitHub 上能看吗?

✅ 能 —— Rho 协议保证 plain-text fallback。 GitHub web 渲染:标准 markdown 部分正常 + Rho 块显示为代码块字面量。读者依然能完整理解内容。

Q: 我不想自己装任何东西——能直接用吗?

写可以——任何文本编辑器都行,文件在哪儿都读得成普通 Markdown。要看它跑起来,需要 Rho MD app;你自己的文件没有浏览器版(用 Rho MD 发行的文档可以在 Rho Library 读)。

Q: 我个人 blog 用 Rho——免费吗?

✅ 完全免费。详见 Free use FAQ。

Q: 我做收费的在线课程,能用 Rho 吗?

✅ 能。按服务条款,Rho MD 个人使用和工作使用都免费;格式(AINP)是 CC BY 4.0。详见 Free use FAQ。

Q: 我怎么避免常见错误?

→ Common pitfalls 跨 capability 总览

Q: 我想看更多 demo 抄思路

→ Examples gallery 20+ 完整可复制例子


2. AI engineers

Q: 我做 AI 应用,怎么让 LLM 生成 Rho?

→ AI/LLM Guide overview — 三种集成模式 → Prompt templates — 7 ready-to-use prompts → Schema-aware generation — function calling 高准确率 → Common LLM mistakes & repair — 10 LLM 错误 + 自动修复

Q: 哪种模式最可靠?

production 推荐 function calling + 5-10 few-shot examples + server-side validation。

Q: LLM 输出能直接 render 给 end user 吗?安全吗?

✅ 安全。Rho 协议层禁止任意 JS / 网络 / eval / 副作用。LLM 出错最坏 fallback 为代码块字面量——不能注入恶意代码。 详见 AINP §17。

Q: ChatGPT / Claude / Gemini 我用哪个?

主流 LLM 都支持 function calling / JSON mode。选哪个模型,影响小于工程实践(prompt 设计 + few-shot 选样 + validation pipeline)。选你已有 API integration 的最方便。

Q: 我要 fine-tune 自己的模型——有训练数据吗?

无现成 fine-tune 数据集(社区贡献欢迎)。建议:

  • 收集你 production 中用 schema 生成的高质量样本
  • 至少 500-1000 examples 起 fine-tune
  • 主要 LLM 平台都支持(OpenAI / Anthropic / Together)

3. Integrators

Q: 我有自己的 web 项目想加 Rho 渲染——怎么开始?

Rho MD 背后的渲染器目前还没有以库的形式发布,所以没有东西可装。格式是开放的(CC BY 4.0),你可以自己渲染它:

→ Developer Reference —— 现状说明 → AINP 协议(英文) —— 每种块的语法与行为 → Implementing your own reader —— 实施步骤 walkthrough

Q: 我做 Obsidian / VS Code / Bear 的插件——怎么集成?

从 spec 自己实现这个格式。AINP 是 CC BY 4.0,你的插件用什么 license 由你定 → 详见 Implementing your own reader。


Q: 我公司想用 Rho 集成到产品——需付费吗?

在工作中使用 Rho MD 是免费的。想在你自己的产品里显示 Rho 文档,请照格式(CC BY 4.0)自己实现;app 本身不能捆绑或再分发(服务条款 §2)。Rho Cloud 的付费档是可选的。详见 Free use FAQ。

Q: 怎么询价?

没有需要询价的东西:Rho MD 免费,Rho Cloud 的档位(Rho Pro、Rho Pro Plus、Rho Max)列在 rho.md/#pricing,在 app 里设置 › 账户购买。其他问题:📧 [email protected]。

Q: License 范围是什么?

  • Spec (AINP): CC BY 4.0 —— 任何人 / 任何用途免费
  • Rho MD app: 按服务条款,个人使用和工作使用都免费(不得再分发或捆绑)
  • Rho Cloud: 免费账户;付费档 Rho Pro / Rho Pro Plus / Rho Max —— 见 价格

详见 License overview。

Q: 我们公司有合规需求(GDPR / SOC 2 / ISO 27001)——支持吗?

→ Rho MD 把你的文档作为文件存在你自己的设备上 → Rho Cloud 存什么,写在隐私政策里 → Rho 没有 SOC 2 或 ISO 27001 认证,Rho Cloud 也不用于受 HIPAA 或 PCI 监管的数据

Q: 启动 startup 用得起吗?

✅ Rho MD 个人使用和工作使用都免费;Rho Cloud 的档位 $5/月起。详见 价格。


5. Protocol implementers

Q: 我想做新 reader 实现,从哪开始?

→ AINP 协议文档(v0.9) —— 协议权威定义 → Implementing your own reader —— 实施步骤 walkthrough

Q: 协议 license 是什么?

AINP 是 CC BY 4.0 —— 你可以自由实现,license 你的实现选你定(MIT / Apache / 商业 / 闭源)。我们请你在 docs 里加一行署名("Implements Rho format spec by scos-lab")。

Q: 实现工作量大概多少?

约 13 person-days for Full conformance。详见 Implementing your own reader §Recommended steps。

Q: 怎么声明我的 reader "implements AINP"?

按 AINP §19 声明哪个 level:Full / Static-only / Reader (no animation) / Partial。

Q: 商标 / 命名规则?

✅ "MyReader (implements AINP v0.9)" ✅ "FooMD with AINP support" ❌ "AINP Reader"(协议名 ≠ 实现名) ❌ "Rho Clone"(Rho 是 reference impl 名)

详见 Implementing your own reader §Naming。

Q: 我能加 protocol-外的 capability 吗?

✅ 可以("non-standard extension"),但 MUST:

  • 用不同 lang label / directive name 避免冲突
  • docs 明确标 "non-standard"
  • 在 fallback reader 仍可读

详见 AINP 协议。


6. Academic

Q: 怎么在论文引用 AINP?

@misc{ainp2026,
  title     = {AI-Native Interaction Protocol (AINP), version 0.9},
  author    = {scos-lab},
  year      = {2026},
  publisher = {scos-lab},
  url       = {https://rho.md/docs/en/developer/ainp-protocol.html},
  note      = {CC BY 4.0.}
}

Q: 学术研究用 Rho——免费吗?

✅ 免费——按服务条款,Rho MD 个人使用和工作使用都免费;AINP 是 CC BY 4.0。详见 Free use FAQ。

Q: 协议有 reference implementation 测试集吗?

⏸️ Conformance test pack 计划在 v1.0 stable release 时发布(非 v1 working draft)。当前可用 Examples gallery 作 informal reference。

Q: 跟 markdown / MDX / MyST 的 academic comparison 有现成 paper 吗?

⏸️ 暂无 official paper。社区论文 / blog post welcome —— 可参考 Comparison 作起点。如有发表,欢迎 PR 到 References 章节。


通用问题

Q: AINP 跟 Rho 是什么关系?

  • AINP = 开放协议(CC BY 4.0)
  • Rho = scos-lab 的参考实现:Rho MD app,加上 Rho Cloud 账户服务和读已发行文档的 Rho Library(lib.rho.md)
  • Anyone 可实现自己的 AINP-conformant reader(不一定要叫 Rho)

详见 Glossary §AINP + Glossary §Rho。

Q: 哪里能找到所有 docs 的 index?

Q: 我有问题没在这里——去哪问?

按问题类型:

详见 Community。

Q: 我能贡献文档 / 代码吗?

Rho MD 的源码不公开,所以我们没法接收代码贡献。文档修正和例子欢迎通过 rho.md/feedback 发来。详见 Community §贡献文档。


See also