参考
给 AI 读取文档
使用每页 Markdown、llms.txt 和 llms-full.txt 获取与网页相同的权威开发内容。
Oho 的人类文档和 AI 文档来自同一批 MDX 文件,不维护第二套容易过期的摘要。
可用入口
| 入口 | 用途 |
|---|---|
/developers/llms.txt | 文档发现索引,包含标题、说明和 Markdown 链接 |
/developers/llms-full.txt | 把当前全部文档合并为一个 Markdown 上下文 |
/developers/<page>.md | 获取单个页面的 Markdown,例如 /developers/getting-started/create-first-plugin.md |
llms.txt 是新兴约定,不是权限控制或正式 Web 标准。robots.txt、访问控制、Canonical URL 和页面权限仍应独立处理。
推荐给编码 Agent 的提示
先读取 <OHO_SITE_ORIGIN>/developers/llms.txt。
只打开与任务相关的 .md 页面;需要离线完整上下文时再读取 llms-full.txt。
以“当前限制”页面为能力边界,不要把目标模型或路线图当作已上线功能。
修改 Plugin 后,通过真实 Agent Run 验证,不要只根据市场卡片判断成功。为什么不立即加入 Ask AI
文档内聊天会产生模型调用、成本、Trace 和隐私边界。当前阶段先提供确定性静态入口;它们更易缓存、审查和在任意 AI 工具中复用。等内容和检索质量稳定后,再按 Oho AI Platform 标准接入问答。
后续 MCP
文档 MCP 可以在静态源稳定后提供 search 与 read 资源。它应复用同一内容索引,并只暴露已发布内容;当前版本没有宣称已提供 Docs MCP Server。