# CF Fieldbook · 产品与内容规范

CF Fieldbook 是面向个人开发者、独立创作者与协作 agent 的持续参考。它围绕 Cloudflare 服务的用途、可选路线、验证方法与使用边界组织内容，提供阅读站、可检查的离线例子和版本化出版工具。

这是独立编辑的资料。比较可以包含其他 provider、本机方案、已有 VPS 或维持现状；平台名称不预设选择结论。当前运行和出版状态见[当前状态](docs/current-state.md)。

## 阅读结构

读者可以从用途、服务、真实实践或带日期的观察进入，再沿链接到比较、实施参考与代码。正文以中文为主，产品名、命令和字段保留原文。

| 材料 | 回答的问题 | 编辑源 |
|---|---|---|
| 服务说明 | 能力、输入输出、开放条件与费用单位是什么 | `services/` |
| 实践记录 | 实际系统如何组合服务、遇到什么故障、当时验证到哪一步 | `practice/` |
| 用例 | 约束下有哪些路线，何时升级或退出 | `use-cases/` |
| 比较 | 哪些条件会改变选择 | `comparisons/` |
| 例子 | 如何观察一个机制及其失败路径 | `examples/` |
| 实施参考 | 命令、字段、接口与恢复步骤是什么 | `reference/` |
| 当期观察 | 截止某日出现了哪些变化 | `reports/` |
| 连贯手册 | 如何把概念、选择与实践接起来 | `guides/` |

阅读站提供目录、按问题检索的小节搜索、术语就地解释、链接去向提示、Markdown 下载与公开例子附件。恢复演示可切换合成场景、移动时间与回放；其状态由离线例子实际执行生成。正文、词表、来源与静态步骤无需 JavaScript 也可阅读；没有在线模型推理、账号登录或云资源操作入口。

## 编辑源与生成物

- **Markdown** 拥有解释、条件、判断和章节结构。
- **docs/glossary.md** 的词条首段拥有短定义，网页和出版物读取同一源；读者工单放在 `templates/`，贡献者合同仍由 `AGENTS.md` 管理。
- **catalog** 拥有内容索引、来源登记和跨页复用的精确数据。
- **catalog/publications.json** 拥有各作品的源条目、封面与编排；Markdown 的稳定 chapter 标记拥有章节身份，可见编号仅表达阅读顺序。网页与出版工具使用同一个读取模块。
- **examples** 拥有请求、费用估算和状态转换等可执行行为。
- **tools/recovery_demo.py** 调用任务模型生成合成场景；浏览器不另写状态机。问题搜索从正文小节生成索引，少量别名与排序由 `styles/search.js` 管理。
- **diagrams/src** 拥有 Mermaid 图的结构；SVG 由工具生成。装饰资产在 `assets/motifs/`；技术图与装饰分别维护。

网站和出版物读取这些源，不成为第二份编辑源。决策模型的显式 fact blocks 由 `tools/content.py sync` 更新；`check` 检测漂移。构建不改写源文件、核验日期或历史报告。

网站唯一入口为 `tools/build_site.py`，输出位于 `.build/site`。三册出版唯一入口为 `tools/editions.py freeze/build/check`，从快照内的 renderer 构建。固定历史出版物位于 `dist/`。组件关系见[架构](docs/architecture.md)。

## 内容关联与证据

`catalog/entries.json` 使用稳定 ID。`depends_on` 表示修改后需要考虑的影响；`related` 只用于发现相关内容。`tools/fieldbook.py impact` 返回候选范围，编辑者核对解释与条件后再修改。历史报告是传播终点，只进入勘误候选。

`impact-source` 从已登记正文中的来源引用与 JSON `sources` 字段找到直接使用点，再复用相同传播规则；直接使用点也归入当前、历史或非活动候选。它是离线只读查询，来源书目、代码、注释与附录不计为正文使用点。API／SDK 指南与合成操作例子解释调用路线、结果完整性、期限和未知写结果。

项目判断可从上游变化或项目目标、运行位置、功能变化触发。项目既有文档持有当前路线、采用理由、实现证据、替代路线和重评条件，本书提供稳定参考和任务单。输出区分命中、已查范围未发现、未知，带检查范围与下一项验证；不会从产品关联自动推导采用、修改或通知。公共仓库不保存私人项目配置、运行证据或跨项目当前状态。

公告时间、事实生效时间、实际核验时间、作品出版时间分别记录。内容的 `current` 状态表示当前阅读位置；它不保证所有引用刚刚核验。来源审阅、离线运行、云端实验与视觉检查表达不同证据，不能互相替代。未知价格保留未知，上游公告不等于每个账号均已开放。

实践记录公开匿名重构的机制与历史观察，不分发私人原始记录、真实账号配置或内部项目身份。编辑时查阅的官方文档用于说明机制，不替代历史系统的验收；本地测试和新云端实验另行记录。

状态与退役规则见[生命周期](docs/lifecycle.md)，初始资料的核验范围见[来源说明](docs/provenance.md)。

## 例子与网络边界

公共例子使用合成输入，默认离线，不依赖真实凭据或私人运行数据。每个例子说明输入、运行命令、预期现象、失败路径、证据范围和清理方式。三份文档的小资料架提供完整静态阅读与下载；手册中的数据库、权限与云端索引是另行实施的扩展路线。网页恢复演示展示已生成的模型结果，不连接任务系统；模型中的外部副作用崩溃窗口仍需独立的幂等或核对机制。

云端实验需要单独明确目标、资源、网络调用、预算与清理方法。站点部署仅发布静态阅读文件，不执行示例。内容构建不会调用模型、刷新来源网页或启动定时维护。

## 出版与撤下

当前维护页与历史出版物有各自的生命周期。版次冻结固定内容、数据、图示、样式和渲染代码；后续实时数据不会进入旧报告。字体与系统排版环境仍可能改变输出几何，不保证跨平台 PDF 逐字节一致。

阅读站明确选择分发内容与附件。`current` 例子可分发列出的源码；`archived` / `superseded` 保留正文与状态，但停止分发执行附件；`draft` 不进入默认目录；`withdrawn` 只保留安全说明，不分发原正文、搜索内容或下载。

撤下既有发布还需要处理远端站点、缓存和附件；本地状态变更不会清除已经流出的副本。具体命令见[出版](docs/publication.md)和[阅读站](docs/reading-site.md)。

## 视觉与权利

冷白默认、暖纸可选，青橙色与青猫看日出的原创母题构成视觉语言。主题选择只保存在读者浏览器；无 JavaScript 时保持冷白。图示的节点和箭头承担技术含义，装饰不承担状态或权限含义。网页优先保证行长、字号、目录、代码、表格和移动端阅读。排版参数与资产归属见[内容设计](docs/content-design.md)。

作者署名为 Faye & Cove。原创功能代码采用 SUL-1.0；原创正文和独立图形采用 CC BY-NC-SA 4.0，第三方权利单独保留，详见[许可范围](LICENSE-STATUS.md)。Cloudflare 产品名称用于说明研究对象，不表示官方关系或背书。

---

GitHub · [github.com/IndelibleVivi](https://github.com/IndelibleVivi)  
*made by Faye & Cove*