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。
4. Business / legal
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?
- Writer's Guide —— 写作者
- Developer Reference —— 开发者
- AI/LLM Guide —— AI 集成
- License —— 法务 / 商业
- Resources —— Changelog / Roadmap / Community
- Glossary —— 术语
- Cheatsheet —— 一页 syntax 速查
- Comparison —— vs MDX / MyST / Quarto / etc.
Q: 我有问题没在这里——去哪问?
按问题类型:
- 使用问题 → rho.md/feedback
- Bug 报告 → rho.md/feedback
- 商务 / 法务 → 📧
[email protected] - 安全 vulnerability → 📧
[email protected]subject[SECURITY]
详见 Community。
Q: 我能贡献文档 / 代码吗?
Rho MD 的源码不公开,所以我们没法接收代码贡献。文档修正和例子欢迎通过 rho.md/feedback 发来。详见 Community §贡献文档。
See also
- Glossary — 术语
- Comparison — vs 其他工具
- Cheatsheet — 一页 syntax
- Common pitfalls — 写作常见错
- Roadmap — 协议未来方向