# 变更记录

## 2026-10-08 · API 维护与项目判断

- 新增 API／SDK 维护指南，区分 CLI、REST、SDK 与 binding 的职责；固定 Go `v7.12.0` 的默认值与迁移证据，不泛化到其他语言。
- 新增只读 `impact-source`，从登记正文引用与 JSON `sources` 字段定位直接使用点，再复用依赖查询；直接引用纳入候选，历史条目继续作为传播终点。
- 新增项目判断指南与可复制任务单，保存项目拥有的采用理由、暂缓原因与重评条件，输出命中、已查范围未发现或未知；以合成场景说明迁移、发布性能和静态官网的工作上下文。
- 新增第五个离线例子，演示完整分页、总期限、部分失败、有限读重试与结果未知的写后核对；源码附件遵循 current／撤下规则。新增页接入首页、目录、问题搜索和 Markdown 下载。
- 定向查阅 S118–S122 与复看 S117；没有新增 SDK 安装、云端执行、账户操作、定时监控或 PDF Release，原报告与固定出版物保持。

## 2026-10-05 · PDF 原生预览兼容

- PDF renderer 把 identity CID CFF 的原字体数据按 `CIDFontType0C` 嵌入，处理本机 PingFang SC 在 PDFKit / Quick Look 的正文缺字与错字形；保持原字形、正文、分页、链接与书签。
- 首发三册生成独立 r4 本地兼容候选，正文和事实日期保留。macOS 原生预览与 Poppler 检查通过；读者确认 iPhone 微信中 r4 专题正文显示正常，其他分册与合订本未逐页手机验收。旧冻结版与 `dist/` 不覆盖，没有新 PDF Release。

## 2026-10-05 · 首发选编

- 新发布观察采用完整的 2026.10 首发选编：保留 10 月 2 日报告主题，按章整合 Observability、PiHarness、Web Search API 与 Protected Quick Tunnel；两份日期报告与固定 r3 文件继续保留。
- 手册与实施参考补充严格 Service Token、Tunnel 私网路由／连接查询迁移，以及 Artifacts 组合示例中的 Sandbox v0 与 1.0 接口区别。仅这些条款定向核验于 10 月 5 日，没有全书刷新日期或新的云端实测。
- 三部作品可按首发选择冻结独立 PDF 候选；公开版本索引仍只发布已登记的文件，本次没有新 PDF Release。

## 2026-10-03 · 内容与出版编排

- 新增 Observability、PiHarness、Web Search API 与 Protected Quick Tunnels 当前主题和 10 月 3 日观察；保留官方来源冲突、开放状态与未来费用生效日期，旧观察不自动更新。
- 新增三份合成文档的小资料架：可离线阅读、下载并从原件重建；手册沿它解释版本、权限、任务与检索，补充更新／撤下机制图。Clef / Jev 开篇提供完整有限决策输入；基础术语增至十四项。
- 作品编排共源，章节身份与编号分离；出版工具支持独立作品候选，冻结所需正文与引用，PDF 保留同册跳转及公开阅读去向。新候选没有发布为 Release，固定 r3 文件不变。
- 恢复观察台将当前事件说明移到控制区内，移动端操作后可以就近读反馈。当前来源说明移除无关材料致谢；私人原始材料与工作接续不分发。
- 作品版本页的版面样式只作用于正文，避免双层留白挤窄标题；320px 窄屏导航换行，入口文字保持间距。

## 2026-10-03 · 篇类母题与篇尾印记

- 文章题头母题按篇类分开：新增天平（比较）、出发窗口（用途）、任务循环（例子）、台账（实施参考）四张原创几何装饰，服务改用边缘路径母题，实践与带日期报告沿用记录页，手册与其余资料沿用书页；同一篇类不再全站共用同一张插图。
- 每篇文章结尾加盖一枚日出篇尾小印，正文分节线改为两侧细线夹一枚橙点；首页书架列表加上斜体衬线序号，目录分组标记在青橙之间轮换。
- 题头母题带缓慢浮动动画（遵循系统减弱动态设置），打印时隐藏篇尾印；新母题均为透明背景，暖纸与冷白两主题直接印在纸面上。
- 改动限于站点呈现与原创装饰：正文事实、核验日期、概念图与冻结 PDF 出版物不变。

## 2026-10-03 · 暖纸主题与版面柔化

- 阅读站新增暖纸 / 冷白双主题：冷白保持原有配色为默认，暖纸为暖米纸面与暖沙层次；页首切换，选择只存在读者浏览器本地，无 JavaScript 时保持冷白。
- 两档主题共享柔化版面：路径与实践卡片、文章题头、表格、代码块改为圆角与柔和投影，目录当前章为圆角色条，主按钮改为胶囊形；青橙品牌色、母题插画、阅读结构与全部交互行为不变。
- 母题与概念图去掉硬白底，改为透明背景，图表在正文中收入圆角画框卡片；装饰提到区块层级：服务路径区改为整幅渐变「草地」带，页面铺一层极淡的方格纸纹理，插画以透明线稿直接印在纸面上；`tools/figures.py` 同步更新并重新生成导出图与 README 横幅。
- 版面加入呼吸感：主题切换全站色彩平滑过渡，切换按钮的 ◐ 图标随主题旋转；首页题句带荧光笔痕，封面插画衬以缓慢呼吸的日出光晕；正文首段为衬线题记排版，章节号为斜体衬线并在章节线上加橙色刻痕；动画均遵循系统减弱动态设置。
- `styles/fieldbook-tokens.json` 记录两套色板；打印样式、冻结 PDF 出版物、正文事实与核验日期不受影响。

## 2026-10-03 · 仓库首页

- GitHub README 增加青猫与日出的项目横幅，链接到正式阅读站；横幅复用站点原母题生成，网站页面沿用自己的题头，不重复展示仓库横幅。

## 2026-10-03 · 实践记录与阅读站更新

- 新增私有资料阅读站、Access/PWA 重连、Tunnel 私有状态页三篇匿名实践；区分历史观察、官方机制与读者自己的验证步骤，接入首页、导航、目录、搜索和 Markdown 下载。
- 首页沿着原版几何猫与日出 SVG 补充云和连接线，增加手册主入口、阅读路径与实践选读；书页、记录与节点图形延伸到文章、实践、目录与来源页。文章使用独立题头、无衬线章节标题和稳定阅读列，保留手机目录、局部表格滚动、释义与键盘定位。
- 移除手册、报告、实施参考中的旧教程承接与编辑过程叙述，社区材料致谢归入来源说明；原产品事实、核验日期和固定历史出版物保持。
- 新增 14 条实践机制文档查阅记录。没有重新运行案例里的云端系统，也未发布新的 PDF edition。

## 2026-10-03 · 阅读页排版

- 重排报告、手册与参考页的题头、章节、目录、正文、表格和代码；目录随滚动显示当前章节，手机使用紧凑的目录与工具区，以及独立标题断行。
- 键盘定位改为内部底色、下划线与控件状态，不使用外围焦点框。
- 修复维护注释被显示为尖括号文本并进入搜索的问题；保留代码示例中的注释，受控图示标记仍生成图示。
- 可见署名集中在公共页脚，来源编号简化为小注释；作者元数据、法律归属与 Markdown 下载保持完整。
- 没有修改历史事实、核验日期或冻结的 PDF 出版物。

## 2026-10-02 · 阅读辅助与任务恢复观察台

- 搜索按正文小节定位，支持任务重复、中断恢复、Tunnel 外网访问等问法，优先呈现直接解释机制的段落。
- 新增八个就地解释的术语、链接去向提示和理解题；README 与例子入口说明任务及预期产出，并提供可直接交给 agent 的离线恢复工单。
- 新增任务恢复观察台，场景与时间变化来自实际 SQLite 模型执行；五种合成路径包括迟到结果拒绝、`uncertain` 停止重放，以及本地 `done` 仍可能发生重复外部动作的反例。
- 为入口路线和任务状态提供手机布局；同版词义随冻结出版物保存，网页词表更新不会改变旧版附录。
- 演示遵循 current 内容分发边界；撤下或归档后不继续分发交互代码与场景。网站增强不改变原有事实核验日期，不调用云服务，也未发布新版 PDF Release。

## 2026-10-02 · 正式阅读站

[CF Fieldbook](https://indeliblevivi.github.io/cf-fieldbook/) 在 GitHub Pages 上线，主分支通过检查后自动部署。

- 新增按问题组织的服务阅读索引，八条路径连接实践手册的具体章节。
- 保留青猫、日出与青橙色，补充原创云与边缘节点线稿、favicon 和独立站商标说明。
- 提供 canonical 地址、站点地图和可从深层地址返回目录的 404 页面。
- 整理项目规范、来源范围与维护指南，使公开说明集中服务于阅读和使用。
- 修复手册进入草稿、撤下、归档或被替代状态时的产品索引与导航；停止默认推荐不再适用的章节。

网站上线不改变正文事实核验日期，也不执行云端例子或分发新的 PDF edition。

## 2026-10-02 · 首次公开源仓库

CF Fieldbook 首次公开于 GitHub，提供持续编辑的 Cloudflare 用途、选择与实践参考。

- 静态阅读站提供三条阅读入口、目录与本地全文搜索、Markdown 下载和公开例子附件。
- 决策模型路线、选择器、价格与费用估算在维护页之间共源；历史报告保留自己的内容与来源定义。
- 冻结版次工具固定正文、数据、样式与渲染代码；保留 r3 历史出版物。
- 三个离线例子包括可观察的任务中断、租约接管、迟到结果隔离与 uncertain 停止重试。
- 原创功能代码采用 SUL-1.0，原创内容与独立图形采用 CC BY-NC-SA 4.0；范围与第三方例外见 [许可说明](LICENSE-STATUS.md)。

本次公开的是源仓库，没有部署阅读站或发布新的 PDF release；未执行云端实验。当前实现和后续状态见 [当前状态](docs/current-state.md)。