CF Fieldbook 是面向个人开发者、独立创作者与协作 agent 的持续参考。它围绕 Cloudflare 服务的用途、可选路线、验证方法与使用边界组织内容，提供阅读站、可检查的离线例子和版本化出版工具。
这是独立编辑的资料。比较可以包含其他 provider、本机方案、已有 VPS 或维持现状；平台名称不预设选择结论。当前运行和出版状态见当前状态。
阅读结构#
读者可以从用途、服务、真实实践或带日期的观察进入，再沿链接到比较、实施参考与代码。正文以中文为主，产品名、命令和字段保留原文。
| 材料 | 回答的问题 | 编辑源 |
|---|---|---|
| 服务说明 | 能力、输入输出、开放条件与费用单位是什么 | 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/。组件关系见架构。
内容关联与证据#
catalog/entries.json 使用稳定 ID。depends_on 表示修改后需要考虑的影响；related 只用于发现相关内容。tools/fieldbook.py impact 返回候选范围，编辑者核对解释与条件后再修改。历史报告是传播终点，只进入勘误候选。
impact-source 从已登记正文中的来源引用与 JSON sources 字段找到直接使用点，再复用相同传播规则；直接使用点也归入当前、历史或非活动候选。它是离线只读查询，来源书目、代码、注释与附录不计为正文使用点。API／SDK 指南与合成操作例子解释调用路线、结果完整性、期限和未知写结果。
项目判断可从上游变化或项目目标、运行位置、功能变化触发。项目既有文档持有当前路线、采用理由、实现证据、替代路线和重评条件，本书提供稳定参考和任务单。输出区分命中、已查范围未发现、未知，带检查范围与下一项验证；不会从产品关联自动推导采用、修改或通知。公共仓库不保存私人项目配置、运行证据或跨项目当前状态。
公告时间、事实生效时间、实际核验时间、作品出版时间分别记录。内容的 current 状态表示当前阅读位置；它不保证所有引用刚刚核验。来源审阅、离线运行、云端实验与视觉检查表达不同证据，不能互相替代。未知价格保留未知，上游公告不等于每个账号均已开放。
实践记录公开匿名重构的机制与历史观察，不分发私人原始记录、真实账号配置或内部项目身份。编辑时查阅的官方文档用于说明机制，不替代历史系统的验收；本地测试和新云端实验另行记录。
例子与网络边界#
公共例子使用合成输入，默认离线，不依赖真实凭据或私人运行数据。每个例子说明输入、运行命令、预期现象、失败路径、证据范围和清理方式。三份文档的小资料架提供完整静态阅读与下载；手册中的数据库、权限与云端索引是另行实施的扩展路线。网页恢复演示展示已生成的模型结果，不连接任务系统；模型中的外部副作用崩溃窗口仍需独立的幂等或核对机制。
云端实验需要单独明确目标、资源、网络调用、预算与清理方法。站点部署仅发布静态阅读文件，不执行示例。内容构建不会调用模型、刷新来源网页或启动定时维护。
出版与撤下#
当前维护页与历史出版物有各自的生命周期。版次冻结固定内容、数据、图示、样式和渲染代码；后续实时数据不会进入旧报告。字体与系统排版环境仍可能改变输出几何，不保证跨平台 PDF 逐字节一致。
阅读站明确选择分发内容与附件。current 例子可分发列出的源码；archived / superseded 保留正文与状态，但停止分发执行附件；draft 不进入默认目录；withdrawn 只保留安全说明，不分发原正文、搜索内容或下载。
撤下既有发布还需要处理远端站点、缓存和附件；本地状态变更不会清除已经流出的副本。具体命令见出版和阅读站。
视觉与权利#
冷白默认、暖纸可选，青橙色与青猫看日出的原创母题构成视觉语言。主题选择只保存在读者浏览器；无 JavaScript 时保持冷白。图示的节点和箭头承担技术含义，装饰不承担状态或权限含义。网页优先保证行长、字号、目录、代码、表格和移动端阅读。排版参数与资产归属见内容设计。
作者署名为 Faye & Cove。原创功能代码采用 SUL-1.0；原创正文和独立图形采用 CC BY-NC-SA 4.0，第三方权利单独保留，详见许可范围。Cloudflare 产品名称用于说明研究对象，不表示官方关系或背书。
