LiveBook Format Specification

1 准入标准

一项出版物要被称为 LiveBook Format，必须同时满足以下条件：

• 双层俱全：同时拥有一个已定稿的 Print Layer（纸质书或等效的固定格式版本）和一个持续维护的 Living Layer（可长期访问的数字空间）。
• 独立自足：Print Layer 的内容必须在没有 Living Layer 的情况下依然完整、可读、自洽——网站只做延展，不做缺失内容的补全。
• 持久入口：至少发布一个遵循 URL Persistence 规则的永久地址，指向该作品的 Living Layer。
• 编号登记：在 2Peanuts Press 的 LiveBook ID 注册表中拥有唯一编号。

不满足以上任一条的作品——例如仅附带勘误表下载、或仅在书末印一个普通宣传网址的书——属于传统出版模式，不适用本规范。

2 Print Layer / Living Layer 职责边界

简言之：Print Layer 回答"是什么"，Living Layer 回答"现在怎样"。两者冲突时，以 Print Layer 定稿时的表述为准，Living Layer 的任何偏离都需要在勘误记录中说明原因。

3 URL Persistence

• 永久路由：每本 LiveBook 在 livebook.press/<slug> 下拥有一个永久基础路径，作为固定的物理锚点——印在纸面上的地址。
• 路由与实体分离：livebook.press/<slug> 本身只是一个跳转中枢，实际内容可以托管在任意域名（如 above-the-clouds.2peanuts.com）。实体内容可以迁移，但印在纸上的 slug 不能变——纸已经印出去了，墨迹无法修改。
• 一经分配，永不回收：slug 一旦随某本书首次印刷发布，即被永久保留，即使该书绝版或项目终止，也不会被重新分配给其他作品。

4 Chapter Anchors

• 格式：livebook.press/<slug>/<chapter-id>，例如 livebook.press/clouds/ch04。
• 对应关系：chapter-id 必须与印刷版目录中的章节编号一一对应，并在该版本印刷后冻结，不随后续改版重新编号。
• 失效回退：若某个章节锚点在 Living Layer 中尚未提供内容或已下线，访问时应回退到该书的 slug 根页面，而不是返回 404。

5 Revisions & Errata

• Living Layer 可修订，但留痕：代码、补充章节等内容可以更新，但每次实质性修订都需附带可见的变更记录（日期 + 简述）。
• Print Layer 的错误不静默修改：如果事后发现纸质内容有误，不通过网站偷偷"纠正"事实，而是建立独立的 Errata（勘误）页面，公开列出原文、问题与更正说明。
• 版本号：Living Layer 的代码类更新遵循语义化版本（如 v1.2.0）；文本类补充内容按日期标注（如 2026-10）。

6 Media Assets

• 归档底线：音频不低于 256kbps，图像保留长边不小于 2000px 的版本或原始扫描文件，不仅存放用于网页展示的压缩版。
• 本地可控：核心媒体资产必须有 2Peanuts Press 自持的备份，不完全依赖第三方平台（YouTube、网盘等）的持久性。
• 元数据：每个媒体文件需标注所属章节、创作背景的一句话说明。

7 Code & Version Updates

适用于以「动态服务」（Dynamic Tech）为主要应用模式的 LiveBook：

• 环境声明：每个代码仓库需标注对应的框架版本（如 PyTorch、vLLM）与验证过的硬件环境。
• 只扩展，不颠覆：代码更新可以适配新框架、新硬件，但不能改变 Print Layer 中已阐述的底层数学与架构原理——那是 Print Layer 的职责，Living Layer 只负责实现层面的演进。

8 Archival Policy

• 最低维护承诺：自作品首次印刷之日起，Living Layer 至少维护 5 年。
• 终止前的告知义务：若确需终止某个 Living Layer，需提前在该 slug 的页面上公示至少 90 天，并说明后续访问方式。
• 静态快照留存：项目终止时，须将 Living Layer 的核心内容导出为静态快照，由 2Peanuts Press 长期保留，哪怕不再更新。

9 LiveBook ID

• 当前格式：LB-NNN，三位数顺序编号（如 LB-001）。
• 分配规则：按作品首次公开发布的时间顺序分配，编号一旦分配不可回收或重新用于其他作品，即使该作品后续绝版。
• 未来扩展：当年度发布量显著增加时，编号格式可升级为 LB-YYYY-NNN（如 LB-2027-001），已分配的 LB-NNN 编号保持不变，不做追溯重命名。
• 当前注册表：见首页 旗舰示范项目 目录。

· Changelog