FAQ
跨 track 的常见问题。按身份分流——找你的角色直接跳。 Capability 具体问题在 Common pitfalls。
总览
| 你是 | 跳到 |
|---|---|
| 写作者 / 教师 / 博主 | §1 Writers |
| AI 应用 / prompt 工程师 | §2 AI engineers |
| 集成开发者（用 @rho/md 库） | §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、Linux 和 Android（下载）。没有浏览器端编辑器，渲染发生在 app 里。渲染器也以库的形式存在、可嵌入你自己的网站，但目前还没有发布到 npm。
详见 Install Rho app。
Q: 我的 .md 文件在 GitHub 上能看吗？
✅ 能 —— Rho 协议保证 plain-text fallback。 GitHub web 渲染：标准 markdown 部分正常 + Rho 块显示为代码块字面量。读者依然能完整理解内容。
Q: 我不想自己装任何东西——能直接用吗？
写可以——任何文本编辑器都行，文件在哪儿都读得成普通 Markdown。要看它跑起来，需要 Rho MD app；没有浏览器版。
Q: 我个人 blog 用 Rho——免费吗？
✅ 完全免费。详见 Free use FAQ。
Q: 我做收费的在线课程，能用 Rho 吗？
⚠️ 商业用需 commercial license。Spec 自实现路径完全免费。详见 Free use FAQ + Commercial licensing。
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: 哪种模式准确率最高？
Raw prompt: ~80%
Few-shot examples: ~90%
Function calling / JSON: ~99%
Fine-tuning: 99.5%+
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 我用哪个？
3 大 LLM 都支持 function calling / JSON mode。准确率 (5-shot examples + function calling) 大致：
- Claude Sonnet 4.6+: ~99%
- GPT-4 Turbo / GPT-4o: ~98%
- Gemini 2.5 Pro: ~97%
差异小于工程实践（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 渲染——怎么开始？
→ Developer Reference Quick start — 30 行 unified pipeline 集成 → Install — npm install + 依赖 → API reference — 全 API surface
Q: React / Vue / Svelte 怎么集成？
→ Quick start framework section —— 各 framework 集成 pattern
Q: 我做 Obsidian / VS Code / Bear 的插件——怎么集成？
两种选择：
- 用 @rho/md 库：JS 项目直接 npm install
- 从 spec 自实现：避开 PolyForm Noncommercial license 限制 → 详见 Implementing your own reader
Q: SSR + hydration 怎么做？
Q: 我做服务端渲染（不在浏览器），可以吗？
✅ Build-time pipeline 完全可在 Node 跑（生成 HTML）。 ⚠️ Hydration 必须在浏览器跑。SSR + client hydration pattern。
Q: CSS 怎么定制？
→ CSS theming — CSS variables + class hooks + Tailwind / Emotion 集成
Q: 嵌套 DSL 不工作——怎么办？
99% 概率是忘了 registerAllInnerPlugins()。详见 Inner processor §debugging。
Q: package 名字 stl-md 还是 @rho/md？
这个库目前还没有发布到 npm——stl-md 和 @rho/md 今天在 registry 上都解析不到。所有 import path 文档用 @rho/md 作 forward-looking 参考。
4. Business / legal
Q: 我公司想用 Rho 集成到产品——需付费吗？
详见 Free use FAQ 决策矩阵。
简化：
- For-profit 公司用
@rho/md库到生产 → ✅ 需 commercial license - 自己实现 reader（不用 @rho/md）→ ❌ 完全免费（spec 是 CC BY 4.0）
Q: 怎么询价？
📧 [email protected] —— 24h 内回复。详见 Commercial licensing。
Q: License 范围是什么？
- Spec (AINP): CC BY 4.0 —— 任何人 / 任何用途免费
@rho/md库: PolyForm Noncommercial 1.0 —— 商业需付费- Rho desktop app: 个人免费 / 商业需 license
- cloud.rho.md: SaaS 订阅（free + pro / team / enterprise）
详见 License & Commercial overview。
Q: 我们公司有合规需求（GDPR / SOC 2 / ISO 27001）——支持吗？
→ DPA (Data Processing Agreement) 可签 → SOC 2 / ISO 27001 计划 2026-Q4 完成 → HIPAA / PCI 当前不支持
详见 Commercial licensing §Legal/合规。
Q: 启动 startup 用得起吗？
✅ Startup 友好定价（< 10 人 + pre-Series-B → 30-50% off）。详见 Commercial licensing §Pricing/折扣。
5. Protocol implementers
Q: 我想做新 reader 实现，从哪开始？
→ AINP v1 protocol document —— 协议权威定义 → Implementing your own reader —— 实施步骤 walkthrough
Q: 协议 license 是什么？
AINP 是 CC BY 4.0 —— 你可以自由实现，license 你的实现选你定（MIT / Apache / 商业 / 闭源）。只需在 docs 保留 attribution。
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 v1)" ✅ "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) v1},
author = {scos-lab},
year = {2026},
publisher = {scos-lab},
url = {https://rho.md/protocol/RENDER_IR_v1.md},
note = {Working Draft. CC BY 4.0.}
}
Q: 学术研究用 Rho 库——免费吗？
✅ 学术 research / 教学用免费（PolyForm NC 明确包含）。详见 Free use FAQ §Academic。
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 的参考实现（npm:
@rho/md、桌面 app、cloud SaaS） - Anyone 可实现自己的 AINP-conformant reader（不一定要叫 Rho）
详见 Glossary §AINP + Glossary §Rho。
Q: 哪里能找到所有 docs 的 index？
- Writer's Guide —— 写作者
- Developer Reference —— 开发者
- AI/LLM Guide —— AI 集成
- License & Commercial —— 法务 / 商业
- Resources —— Changelog / Roadmap / Community
- Glossary —— 术语
- Cheatsheet —— 一页 syntax 速查
- Comparison —— vs MDX / MyST / Quarto / etc.
Q: 我有问题没在这里——去哪问？
按问题类型：
- 使用问题 → GitHub Issues
- Bug 报告 → GitHub Issues
- 商业 / 法务 → 📧
[email protected] - 安全 vulnerability → 📧
[email protected]subject[SECURITY]
详见 Community。
Q: 我能贡献文档 / 代码吗？
✅ 欢迎。详见 Community §Contributing。
See also
- Glossary — 术语
- Comparison — vs 其他工具
- Cheatsheet — 一页 syntax
- Common pitfalls — 写作常见错
- Roadmap — 协议未来方向