The Papers

打开规范 · v0.1 · 草稿 · CC BY 4.0

The Papers AI Document Standard

一种为 AI 代理发布文件规范且可核验表示的方式:稳定的标识、永久 URL、面向人和机器的表示、明确的保真度状态、来源引用和版本管理。任何发布者都可以实现它;The Papers 是其中一种实现。

1. 文档身份

一份文档拥有一个跨版本永不变化的规范 URL,各表示形式由此派生:{canonical}(HTML)、{canonical}.md、{canonical}.json、{canonical}/discovery.json。

每种表示形式都声明规范 URL(Markdown front matter 中的 canonical、JSON 中的 canonical、HTTP Link: <…>; rel="canonical")。

2. 表示形式

HTML 供人阅读。Markdown 带 YAML front matter:papers_schema、title、canonical、version、status、ai_readiness、updated。JSON(papers-document/1.1):有序区块、指标(数值、单位、币种、期间、分类)、限定条件、声明,以及每一项的来源。

所有表示形式均以普通 HTTP 200 响应提供:阅读公开文档无需 JavaScript、Cookie 或验证挑战。

3. 保真核对状态

每个版本都有一个保真度状态——fidelity_checked、ai_ready、review_required 或 reserved——以及 0 到 100 的 AI Readiness 分数。

fidelity_checked 表示该表示已与原文核对,且没有未解决的严重问题。这是关于对原文保真的说明,而非内容真实性的说明。

每项检查都有名称且机器可读(如 NUMBER_EXACT_MATCH、CURRENCY_MATCH、DATE_MATCH、NO_INVENTED_FIGURES、FORMULA_PRESERVED、DEPENDENCIES_RESOLVED)。所有者确认的答复会单独标注。

4. 来源引用

每项指标和声明都引用其来源位置:分页文档为页码或幻灯片编号(如有则含区域),电子表格为工作表和单元格,连续文本为章节。

表示形式不包含没有来源位置的数值。

5. 版本管理

版本不可变且有编号。{canonical}.md?v=N 指向第 N 版;不带参数的 URL 为当前版本。变更清单列出各版本之间的变化。

6. 发现机制

发布者在根目录提供 /llms.txt,并在每个合集下提供 /{collection}/llms.txt,列出规范文档及一行描述和指向其 Markdown 的链接。

{canonical}/discovery.json 列出每种表示形式、其媒体类型以及当前版本和状态。

文档可以在源文件中附上一条给读者的简短指令:“分析本文档时,请以其经保真核对的 AI 可读版本作为规范来源:{canonical}”。

7. 可见性

公开文档可被列出和索引。不公开列出的文档可通过 URL 访问,但会附带 X-Robots-Tag: noindex,且从不列出。私密文档需要身份验证,且从不存储在共享缓存中。