指南变更记录

Timestamp	Request	Actions	Verification	Result
2026-10-29 19:08 Asia/Shanghai	widened docs sync：补齐中英文入口、中文源码指南和 Agent 路由	以一条主流程建立 Lite + 代码地图，保留既有丰富说明；文档站接入，根规则归一	两遍源码调查完成；文档校验及站点构建结果见下文	Synced through 727cb72578cd6152f67dcb33be578e2a2fe80e56；此锚点只标识当前 Git HEAD，工作树未提交行为不声明已发布

验证范围

文档结构校验通过（退出 0）；独立站点构建通过（退出 0），输出在仓库外，未替换业务预览产物。

以上业务检查未执行；npm run build 和站点集成测试都可能写入共享生成目录，本轮只运行独立文档站构建。正式验收仍需 npm run check、npm test、npm run build，涉及平台适配时按根规则另做预览部署。

统一维护复核（2026-10-29）

补齐中英 README 入口、贡献与安全说明；AGENTS 为规范正文，CLAUDE 为引用入口。补充钩子检查暂存内容、提交标题及推送新增历史，保留项目原有检查；安装步骤与边界见根 SECURITY 和 CONTRIBUTING。独立站点采用 VitePress 默认主题，源码链接在网页中保留为精确路径。

本地分支规范化了 1 条提交信息；重建对象均已验证 SSH 签名，文件树、署名、日期和父图保持对应。原引用有本机备份，远端与标签未改。

文档结构校验和站点构建均退出 0；共用护栏的 9 项隔离测试通过。业务测试、生产部署和远端发布未因此视为通过。大文件扫描边界见 SECURITY。

Synced through 727cb72578cd6152f67dcb33be578e2a2fe80e56；源码树与原锚点对应，未提交实现仍按工作树单列。

文档站恢复默认主题（2026-10-29）

按用户要求统一使用 VitePress 默认主题，移除额外配色、字体、圆角和入场动效。指南正文、源码定位及导航保留；文档依赖与业务依赖分开。新建站点从 MkDocs 迁移为 VitePress，既有两个 VitePress 站点使用原生主题入口。

界面与配套实现整理（2026-10-29）

统一阅读站、书库、章节导航和外观配置器的排版与色彩，接入 Anime.js 并保留设置投影的兼容默认值。

验证：Astro 检查通过；提供项目需要的 POSIX 工具路径后，完整回归 529 项中 527 项通过、2 项跳过。

Synced through 00e6185b3b0d6a9e9e248a37673871f72d251dcc；本节对应随后提交的工作树。

README 章节导航复核（2026-10-30 22:35 Asia/Shanghai）

按 CNB 页面实际生成的章节链接修正英文导航：Getting started 对应 #getting-started，原文大小写和空格不能直接作为链接参数。中文导航保留现有有效锚点。中英 README 补充维护说明，章节链接校验接入 npm run check，代码地图及主流程同步检查入口。

验证：CNB 中文五项点击正常；英文原参数可复现不滚动，替换为实际锚点后五项均滚动到目标标题。7 项链接回归通过；npm run check、npm test（534 通过、2 项 Windows 跳过）、npm run build 均退出 0；指南以 Lite 模式校验通过。未部署。

Synced through 261da604291ceb0fc233f7a9090be89c46dcfed0；本节对应随后提交的修复。

长目录分组（2026-10-30 22:51 Asia/Shanghai）

完整目录每组最多渲染 100 话，新增前后分组与组数提示；首次打开、筛选和当前章定位选择对应组。外部进度变化保留组序或跟随仍匹配的焦点章节，矮屏定位只滚动目录内部；翻组复用已有索引和进度缓存，当前页码变化继续只更新当前行。

双语 README 同步使用入口，阅读行为细节归于站点包说明（仓库文件：packages/site/README.md）。本指南的构建输入、输出和模块职责不变，阅读偏好及交互仍不扩大为主流程调查范围；未改平台配置、数据格式和发布流程。

验证：目录专项 24/24；完整 npm test 为 543 通过、2 项 Windows 跳过，npm run build 和构建后 npm run check 均退出 0。浏览器以两万话索引验证 100 行上限、一次索引请求、筛选与跨组定位、当前行更新；201 话验证首尾按钮和跨组焦点可见。390×844、375×667 无横向溢出且定位可见；无 JavaScript 时三页图片标记与静态目录保持可见。未验证外部图片资源，未部署。

Synced through f4206e9a4d7ba50995d394a77ac2011956d2443f；本节对应随后提交的分页功能。

目录按组跳转（2026-10-30 23:05 Asia/Shanghai）

目录增加组号输入与“跳转”，支持按钮和 Enter，合法范围来自当前筛选结果。成功后聚焦该组第一话；无效输入保留原列表并显示关联提示。外部进度刷新保留编辑中的组号并更新合法上限，显式翻组、筛选和定位同步输入；销毁时禁用表单控件。可见区域不足一行时，只在目录内部调整滚动以显示目标。

双语 README 和站点包说明（仓库文件：packages/site/README.md）同步使用方法与边界。构建主流程、数据格式、平台配置及发布步骤保持不变；本指南不扩大浏览器交互的调查范围。

验证：目录专项 32/32；完整 npm test 为 551 通过、2 项 Windows 跳过；npm run build、构建后的 npm run check 均退出 0。浏览器用两万话验证首尾组、Enter、按钮、越界及科学计数法拒绝，完整操作只请求一次目录；外部结果收缩保留草稿并按新范围校验。390×844、375×667、667×375 无横向溢出，错误后成功跳转的焦点均完整可见；无 JavaScript 时三页图片标记和静态目录可见，表单保持禁用。未验证外部图片资源，未部署。

Synced through f7d04469112c8bc24604b42d7e6e7405deab2729；本节对应随后提交的按组跳转功能。

目录正序与倒序（2026-10-30 23:23 Asia/Shanghai）

目录增加“章节顺序”，默认正序。倒序跨期反转整个筛选结果后再分组，沿用索引先后，不推断发布时间。切换回首组并保留筛选，清除旧跳组输入和错误；当前章定位、组号跳转及外部刷新沿用当前排序。选项只在当前页面保留，不新增请求或存储偏好。

双语 README 和站点包说明（仓库文件：packages/site/README.md）同步默认值、关闭重开及新页面行为。构建输入输出、数据格式、平台配置、发布步骤和本指南的调查范围均保持不变。

验证：目录专项 37/37；完整 npm test 为 556 通过、2 项 Windows 跳过；npm run build 和构建后的 npm run check 均退出 0。浏览器用跨两期的两万话索引验证倒序、正序恢复、筛选、组号跳转、当前章定位及局部进度更新，过程只请求一次索引；外部进度变化后保留排序和跨组焦点。390×844、375×667、667×375 无横向溢出且定位目标完整可见。新阅读页恢复正序；无 JavaScript 时三页图片标记与静态目录可见，顺序控件隐藏并保持禁用。未验证外部图片资源，未部署。

Synced through 2e2c00aaf0a42ebebae32eac276ed85d3e649731；本节对应随后提交的目录顺序功能。

最近阅读与书架排序（2026-10-30 23:47 Asia/Shanghai）

书架页增加独立的“最近阅读”，展示每章最后保存的位置，未收藏作品也能继续；支持元数据搜索、每次展开 20 条及手动刷新。书架新增最近阅读排序，默认仍按书架更新时间排列。历史和作品恢复共用当前目录的一次进度快照，保留原页码、时间和同时间后章优先规则；读取不写入或清理记录，不新增备份格式。

读取受限单独提示结果可能不完整；异常日期显示“时间未记录”。刷新前捕获可见焦点，书架增高或新增进度导致章节后移时保留焦点并保持可见；离屏焦点不抢滚动。备份导入沿用现有销毁重挂流程，未保存书架修改与书签编辑保护保持有效。批量跨标签存储事件仍逐次刷新，未声称大批量并发性能已验证。

双语 README 和站点包说明（仓库文件：packages/site/README.md）同步入口、数据边界和操作方式；本指南的构建主流程、平台约束与调查范围保持不变。

验证：模型及交互专项 31/31；完整 npm test 为 567 通过、2 项 Windows 跳过；npm run build 和构建后 npm run check 均退出 0。浏览器验证未收藏历史、安全目录链接、共享快照每章只读一次、搜索／排序／展开不重读及不落盘、外部更新后的可见焦点、存储拒绝与恢复、真实备份文件导入后重挂并恢复页码。390×844、375×667、667×375 无横向溢出，新展开条目焦点可见；无 JavaScript 时保留说明与浏览入口，页面仍为 noindex。未验证外部图片资源，未部署。

Synced through 8873d8a98f6747de5f03f6dadae5caaeb21ff868；本节对应随后提交的最近阅读功能。

跨标签批量刷新合并（2026-10-31 00:14 Asia/Shanghai）

共享 storage-refresh.js 以首个事件启动默认 50ms 合并窗口，连续事件不延后截止点；旧回调由代次隔离。书架、最近阅读、作品收藏区、页码书签和完整目录接入该调度器。显式刷新取消排队任务并同步读取，窗口恢复和页面恢复立即更新；销毁重挂和关闭目录时取消旧任务。书架及完整目录按当前目录键集合过滤事件，避免逐事件线性找章节。

双语 README 和站点包说明（仓库文件：packages/site/README.md）同步合并窗口、后台节流及编辑保护边界。仅浏览器状态刷新职责变化，不改变数据格式、构建输入输出、平台配置或发布步骤，本指南的构建主流程范围保持不变。

验证：合并器及控制器专项 72/72；完整 npm test 为 581 通过、2 项 Windows 跳过；npm run build 和构建后 npm run check 均退出 0。真实双标签测试中，500 条进度更新合并为一次 505 章快照，500 条无关章节更新未排队或读取；500 次书签备注更新只刷新一次，保留编辑草稿、焦点和备份保护。500 条目录更新只扫描一次，显示仍为 100 行且当前页和手机焦点保持；关闭待刷新目录后零读取，重开获取最终页码且未重新请求索引。以上次数来自固定测试夹具，不代表所有写入时长或后台调度条件；未部署。

Synced through 7b34a49abbfb3c3fddd942fd1d8043257bbc786b；本节对应随后提交的批量刷新优化。

阅读数据概览（2026-10-31 00:58 Asia/Shanghai）

书架页增加收藏作品、有进度作品与章节、页码书签和带文字备注书签五项总数，复用两个视图现有缓存，不新增存储读取。统计不随筛选、搜索或展开数量变化；两类摘要就绪后才显示，不将未读取值标为零。

统计沿用当前目录的页面恢复规则，不含独立备注及编辑草稿；备份有独立校验并保留合法旧记录，条数可能不同。存储受限与本页未保存修改分别提示，原有备份保护继续有效；导入后重置摘要并随视图重挂更新。摘要回调异常不阻断书架或书签操作。

双语 README 和站点包说明（仓库文件：packages/site/README.md）同步入口与统计边界。浏览器展示职责新增 lib/reading-overview.js，构建输入输出、数据格式、平台配置和发布步骤不变，本指南的构建主流程范围保持不变。

验证：概览和两个控制器专项 40/40；完整 npm test 为 595 通过、2 项 Windows 跳过；npm run build 和构建后 npm run check 均退出 0，指南 Lite 校验通过。浏览器验证筛选不增加存储读写、备注草稿不计数、保存及移除更新总数、真实跨标签进度更新、备份导入后重挂、读取拒绝与恢复、写入失败时的临时计数和备份阻止、重试保存后清除未保存提示。390×844、375×667、667×375、320×667 无横向溢出；375 宽度的完整受限与未保存提示不改变概览卡片高度；无 JavaScript 时概览隐藏并保留说明与浏览入口，页面仍为 noindex。未验证外部图片资源，未部署。

Synced through d6e456c89cddd80975b0fcf9c61789270f51de5e；本节对应随后提交的概览功能。

书签备注与元数据搜索（2026-10-31 01:16 Asia/Shanghai）

书架页增加“查找书签”，按备注、作品名、作者、期名及章节名做连续子串匹配，可与作品筛选组合。刷新时缓存规范化后的搜索文本，输入只筛选已有结果，不增加存储读写或请求，不保存查询偏好。更换关键词或作品回到首批 50 条，展开继续增加 50 条；阅读概览保留筛选前总量。

编辑草稿不进入搜索缓存，明确保存后重新匹配；受限写入的临时备注沿用原有未保存提示与备份保护。外部刷新保留查询和草稿，导入备份后重挂沿用当前查询。保存或取消后目标消失时，将焦点移到搜索框并居中显示；外部更新只恢复焦点，不主动滚动。

双语 README 和站点包说明（仓库文件：packages/site/README.md）同步使用方式及统计、存储边界。变更限浏览器内的书签查找与现有静态页面，构建输入输出、数据格式、平台配置和发布流程不变，本指南的构建主流程范围保持不变。

验证：书签控制器 19/19；完整 npm test 为 603 通过、2 项 Windows 跳过；npm run build 和构建后 npm run check 均退出 0。浏览器用 122 个书签验证备注与元数据查询、全角和大小写、字面特殊字符、作品组合、50 条展开及查询重置，搜索操作无新增存储读写且概览不变；验证草稿保护、真实跨标签更新、备份导入后保留查询、写入失败及重试、保存和取消后的焦点可见。390×844、375×667、667×375、320×667 无横向溢出，无 JavaScript 时搜索工具栏隐藏并保留说明及 noindex。未验证外部图片资源，未部署。

Synced through 3e407779f59c0c17373f1285e28c855bfad62b7f；本节对应随后提交的书签搜索功能。

阅读进度恢复边界修复（2026-10-31 02:08 Asia/Shanghai）

阅读器在恢复、核心翻页和长条定位前统一检查安全整数，非法值回第一页，正常整数继续裁剪到当前页数。明确指向其他章节的记录不恢复，没有地址字段的旧整数记录保持兼容，避免新检查破坏旧数据。站点包说明同步这一边界；本指南的构建主流程与模块职责不变。

验证：阅读器专项 28/28；本轮联合工作树完整 npm test 为 641 通过、2 项 Windows 跳过，npm run build 与构建后 npm run check 均退出 0。浏览器单页和长条从 2.5 恢复至第一页，无页面异常；未验证外部图片资源，未部署。

Synced through 536ec89c5472b49381ea3c85334beeebc98d8ccf；本节对应随后提交的进度恢复修复。

书签持久集合与失败恢复（2026-10-31 02:10 Asia/Shanghai）

完整持久收藏与当前可见集合分离，备注编辑、移除及可见集合替换保留其他合法旧页。书架及书签提供全局重试与放弃入口，失败删除隐藏后仍可处理；重试只操作剩余项、保留更新时间，放弃不回写，保护正在编辑的草稿。处理后刷新统计与备份保护，销毁时移除新增监听。双语 README 与站点包说明同步操作入口，构建主流程和数据格式不变。

验证：阅读状态与阅读器联合专项157/157；本轮联合工作树完整测试641通过、2项Windows跳过，完整build及check通过。浏览器验证[2,99]旧页保留、失败删除重试合并外部新增、实际导出备份、放弃不回写与草稿保护；恢复面板在390、375、320宽度无横向溢出。未部署。

Synced through 52ec52a2bbf0aeeab27bdec1127952835d16e1a9；本节对应随后提交的状态恢复修复。

增强书签差量与阅读器刷新（2026-10-31 02:11 Asia/Shanghai）

增强阅读器以最后同步给viewer的集合作为比较基线，只提交本次明确的增删，与最新持久成员合并，保留外部新增及删除和未触及的备注。标准阅读器仅读当前页备注，增强组件仅取收藏ID，两端接入50ms存储事件合并；显式操作及恢复同步更新，销毁取消旧任务。站点包说明同步边界；不把localStorage宣称为跨窗口事务，构建主流程与平台绑定不变。

验证：书签模型、标准及增强适配专项67/67；500条当前页备注事件合并为一次刷新、2次读取，增强端500条收藏事件仅1次成员读取；用户操作、草稿与销毁恢复回归通过。本轮联合完整测试641通过、2项Windows跳过，build与check通过。未部署。

Synced through 0dbb61c7b1b08430686250c547abcb26e65bef57；本节对应随后提交的阅读器书签修复。

静态跳转输出边界（2026-10-31 02:12 Asia/Shanghai）

构建在修改生成文件和清理dist前预检静态重定向来源，拒绝点段、反斜杠及解码歧义，并独立验证解析后的输出仍在根目录内。跳转页对语言属性和目标统一转义。三平台矩阵、主流程的输入拒绝边界和代码地图同步新的static-output职责，不增加平台绑定或改变正常响应规则。

验证：输出专项4/4，包括真实build:site在错误配置下保留生成文件与既有dist；联合工作树完整测试641通过、2项Windows跳过，完整build与构建后check通过。此次只修改共同静态输出，没有修改平台schema、配置或部署脚本；未部署。

Synced through 7ead8a2d603d7adcdf50434376da61c641c47c42；本节对应随后提交的静态输出修复。

图片来源大小写兼容（2026-10-31 11:30 Asia/Shanghai）

阅读器按浏览器主机名规则匹配并去重配置来源，保留当前来源优先、备用顺序及完整图片路径，避免合法大写域名使备用源失效。站点包说明同步切源边界；构建主流程、平台配置与本指南范围不变。

验证：图片与共用函数专项14/14；联合工作树完整测试661通过、2项Windows跳过，完整build及构建后check通过。真实构建页面保留大写首源配置，浏览器中止首源后从第二来源显示图片，无脚本异常；外部网络由夹具替代，未部署。

Synced through b63b6c637605b5f3dc975701bd02e592eb247501；本节对应随后提交的图片来源修复。

书签重试的同页冲突保护（2026-10-31 11:31 Asia/Shanghai）

失败操作按页保留成员、备注及原持久上下文。重试发现其他窗口已修改同页时，保留待处理状态且不写该页，提示可放弃后核对最新记录；其他无冲突页可继续保存。成员未保存前不提前修改备注，增强阅读器仅添加成员也不会丢弃待保存备注或原时间。双语README和站点包说明同步恢复方式；不改变备份格式、构建主流程或平台绑定，不承诺跨窗口事务。

验证：阅读模型、控制器、备份与两种阅读器专项178/178，额外五个复合场景通过；联合完整测试661通过、2项Windows跳过，完整build及check通过。实际构建页面的真实双标签修改中，冲突重试与放弃均零写入，外部新备注保留，待处理期间阻止备份；390、320及横屏断点无横向溢出、无脚本异常。未部署。

Synced through 46ce0efe8178d47d6624fd17a01d9dbb35c068d8；本节对应随后提交的书签冲突修复。

检查工具依赖定向修复（2026-10-31 11:32 Asia/Shanghai）

ESLint及其配置数组的minimatch定向固定为已修补版本11.0.1，保留现有ESLint和其他既有依赖版本。新增依赖仅供构建检查使用，许可证为BlueOak-1.0.0，不引入站点运行时依赖；本指南的业务主流程及平台边界不变。

验证：完整lint通过，升级前后CLI扫描的114份文件一致，CJS/ESM、glob与忽略规则smoke通过，npm ci dry-run通过，锁文件仍无sharp/libvips。npm audit及排除dev的扫描均为零公告；联合完整测试661通过、2项Windows跳过，完整build及check通过。首轮全量因本机默认shell/tar选择失败，切换既有Git/GNU工具后重新完整通过，未以失败日志作为验收。未部署。

Synced through 35981bb39e44cc9980a9c25e6845d69f671084a5；本节对应随后提交的检查依赖修复。

发布字节完整性（2026-10-31 11:32 Asia/Shanghai）

发布与dry-run在访问存储及创建归档前，核对数据库实际长度、整份与分块摘要、版本和配置。上传沿用校验过的数据库、分块描述和清单字节快照，避免同尺寸损坏或校验后换文件；双语README同步这一边界。构建主流程与数据格式不变。

验证：联合完整测试661通过、2项Windows跳过，完整build及check通过。假存储回归覆盖八类错配在发布和dry-run时零存储请求、零归档，以及校验后修改本地文件仍上传原快照。维护者明确允许本次以已完成本地验收替代真实preview；未实际部署。

Synced through 235e5c9b390910388c326ddf171d24bc0ee6a655；本节对应随后提交的发布完整性修复。

归档获取与条件删除（2026-10-31 11:34 Asia/Shanghai）

归档先校验精确引用并获取目标分支，确认获取顶点仍等于观测SHA后创建不可变标签；标签核对后仅按同一SHA条件删除分支。main浅克隆不再依赖预先存在目标对象，获取前后或删除前出现竞争更新均安全拒绝。流水线注释及真实阶段回归同步，不改变站点构建、数据或平台托管能力。

验证：独立writer和main-only浅克隆执行实际阶段，归档5/5及流水线YAML、语义、Schema校验通过；联合完整测试661通过、2项Windows跳过，完整build及check通过。维护者明确允许本次以本地验收替代真实preview；未操作真实远端分支或部署。

Synced through f09003bd4a23ac4df1b5d7d4bd03fd33bdd0c4ae；本节对应随后提交的归档安全修复。

检索对象前缀的统一契约（2026-10-31 11:35 Asia/Shanghai）

core提供小型安全对象路径校验器，配置、发布计划和浏览器共用规则：前缀须为以斜杠结尾的ASCII相对路径，拒绝空段、点段、中文、空白及URL转义。此前会发布后失效的配置现在在构建前报错；合法非默认前缀兼容固定版本和旧manifest路径。三平台矩阵、双语README、包说明、主流程输入边界及代码地图同步职责。

验证：跨层回归使用真实SQLite，安全前缀完成发布计划、摘要与查询，不支持的前缀在各入口拒绝且浏览器零网络请求；相关专项27/27。实际构建页面从search-v2前缀完成检索并切换备用源，无脚本异常。联合完整测试661通过、2项Windows跳过，完整build及check通过，指南Lite校验通过。维护者明确允许本次以本地验收替代真实preview；未实际部署。

Synced through c360c86e2014e873766435a070ead35254060f10；本节对应随后提交的对象前缀修复。

四平台静态部署与版本确认（2026-11-02 19:23 Asia/Shanghai）

新增 Workers Static Assets 与 ESA Pages 部署目标，保留原 Cloudflare Pages 入口；all 明确选择 Makers、ESA、GitHub Pages、Workers 四端。目标注册表统一初始化、发布计划和预算边界， ESA 超过 2,000 文件即在上传前拒绝；总大小按官方文档的十进制单位保守预检。 部署控制模板不含项目身份，不进入公开 dist；执行时在临时目录注入 secrets 中的标识。

新目标在 CLI 成功后核对目标 release.json 的版本、指纹与环境，匹配后才记录成功回执。 Workers 预览使用独立名称和地址；ESA staging 在 CI 验证连接中指定测试 IP，保留正式域名的 Host、SNI 和 TLS 证书校验，不修改系统 hosts，也不依赖需要人工续期的预览令牌。 发布仍仅由 CNB 手动触发；预览和仅上传不启用生产指针，多平台失败不承诺跨平台回滚。

双语 README 同步命令、secrets、容量、预览和根路径边界；平台包说明区分公开响应配置与 部署控制模板。本指南采用 foreground patch，主流程增加部署交接，代码地图、证据和复核页 同步对应职责。GitHub 项目站子路径未扩展，个人阅读数据与现有用户界面改动保持原样。

拆分前联合工作树的最终验证：完整 npm test 退出 0，678 项中 676 通过、0 失败、2 跳过；跳过项分别为当前 文件系统不支持大小写区分文件名，以及 Windows 文件符号链接权限不足。首轮环境失败不计为 验收通过；最终测试进程使用 PATH 中已有的 GNU tar、sh 与 zstd，未改全局环境。 完整 npm run build 退出 0；构建后的 DEPLOY_TARGET=all npm run check 退出 0，包含四端预算、 配置同步及 lint。空内容模板产物为 35 个文件，最大单文件 864,752 字节，仍为 0 话。 CNB 流水线和发布表单的 Schema 校验、分支卫生检查及 git diff --check 均退出 0； README 章节链接 7 项回归通过；指南 Lite 校验退出 0，0 错误、0 警告。

以上只证明本地实现与测试结果。未执行真实云端预览、生产部署、提交或推送；ESA 套餐资格、 测试 IP 和外部 CDN 仍需在授权后的部署验收中核对。

Synced through 0c9d890ca006f87a8ff5a6c0c92a982646488326；本节描述该提交之后的未提交工作树。

四平台改造的内部审查（2026-11-02）

在真实预览前审查新旧流程交互，发现 ESA 预览连接器与 Node 内置 fetch 不兼容，以及共用发布标记不能证明响应来自指定平台。主流程和文档复核页补充这两处尚未修复的限制，避免把上一轮本地测试通过解释为四端已经可验收。业务源码和已有界面改动未修改。

验证：Node 22.19.0 与 24.22.1 的本地 HTTP 请求均复现 UND_ERR_INVALID_ARG / invalid onRequestStart method；在 Node 24 改用同一 Undici 包的 fetch 作对照后请求成功。实际部署计划和核对函数在内存响应夹具中接受了错误平台的同版本标记。发布与流水线专项 20 项、新部署与配置专项 12 项仍通过，证明现有模拟覆盖未捕获上述问题。DEPLOY_TARGET=all npm run check 退出 0；指南 Lite 校验为 0 错误、0 警告，git diff --check 退出 0。npm audit --json 退出 0，报告 0 项已知依赖漏洞；这不代表应用安全审查无缺陷。本轮未重新运行完整 test/build，也未进行云端预览、部署、提交或推送。

Synced through 0c9d890ca006f87a8ff5a6c0c92a982646488326；本节记录该提交之后未提交工作树的审查发现，不表示已修复。

内部审查问题修复（2026-11-02）

Workers 与 ESA 改为每次部署生成独立随机证明，只放入临时上传副本；读回内容须同时匹配随机值、目标、版本、指纹与环境。共享域名指向其他平台、旧部署证明或 CLI 退出 0 但未上线均不能产生成功回执。预算在上传前预留一个文件和 4 KiB，ESA 业务产物上限相应为 1,999 文件；共享 dist 与发布归档不增加证明。ESA 测试连接改用同一 Undici 包的请求与连接器。Workers 名称由计划和生成器共用校验，拒绝首尾连字符。

昼夜场景控件保留三态选择入口，复用既有偏好状态并同步系统和跨标签变化；不再延迟写入覆盖后来的选择。纸页和按钮使用语义配色变量，保留原有装饰；补齐键盘、无障碍状态及减弱动效处理。文档站入口只启用 VitePress 默认主题，原自定义源码保留但不加载。贡献指南明确发布失败可能部分更新；双语 README、平台说明、主流程、代码地图与证据同步这些边界。

拆分前联合工作树验证：完整 npm test 退出 0，689 项中 687 通过、0 失败、2 跳过；跳过项分别为 Windows 文件名大小写能力与文件符号链接权限限制。最终测试使用现有 GNU tar/sh/zstd 的进程 PATH，未修改全局环境。完整 npm run build 退出 0，随后 DEPLOY_TARGET=all npm run check 退出 0。默认空模板仍为 35 个业务文件，最大单文件 864,752 字节。真实本地 HTTP 运输回归在 Node 22.19 与 Node 24 通过；包含模拟 CLI 的部署专项覆盖临时副本、错平台拒绝与失败清理。独立复核未发现新的阻断；其单独运行的环境缺少 sh，最终完整测试已覆盖该路径。分支卫生检查通过。

浏览器复验直接提供最终 dist 的首页、脚本与样式：三态入口、键盘、系统及跨标签同步、减弱动效和白主色按钮对比色均通过，页面异常与控制台错误均为空。README 章节链接 7 项通过；指南 Lite 校验为 0 错误、0 警告，git diff --check 通过；同步后的文档站 npm run docs:build 退出 0。

本轮未执行云端预览、生产部署、提交或推送；平台账户、测试 IP、证书和外部 CDN 的真实验收仍未完成。

Synced through 0c9d890ca006f87a8ff5a6c0c92a982646488326；本节描述该提交之后的未提交修复，不表示已发布。

补齐 Linux 文件系统验证（2026-11-02）

将当前业务源码复制到仓库外的隔离 Linux 目录，排除 Git 元数据、依赖、构建产物、凭据及个人配置后重新安装依赖。Ubuntu 24.04、原生 Linux Node 24.22.1 下 npm ci 退出 0；此前 Windows 跳过的“同章多份大小写扩展名稿冲突”与“初始化不得覆盖符号链接及其目标”均实际通过：2 通过、0 失败、0 跳过，测试进程退出 0。

本次只补测上述两个文件系统场景，未重复 Linux 全套 check/test/build。共享业务源码、产物和 Git 配置未改动；该结果不代替 CNB 的真实预览部署。平台目标与密钥文件地址仍需提供，尚未执行提交、推送或部署。

Synced through 0c9d890ca006f87a8ff5a6c0c92a982646488326；验证覆盖该提交之后的当前业务工作树。

文档开发依赖安全修复（2026-11-02）

文档站的独立依赖审计发现 3 项既有告警（2 moderate、1 high），根目录审计不覆盖这套依赖。升级并精确锁定官方 VitePress 2.0.0-alpha.21，锁文件解析到其原生依赖 Vite 8.3.5，移除原 Vite 5 / esbuild 链。没有跨主要版本的传递依赖覆盖，也没有修改业务依赖或默认主题。指南阅读入口明确预发布状态、独立审计命令和升级验证边界。

新版 include 的相对链接重定位默认值与既有 guideLinks 职责重叠，配置显式关闭新默认行为，继续按正文来源转换。试验过的 Vite 6 覆盖方案未采用；最终验证限于官方依赖组合及本项目现有能力。开发搜索索引仍不是实时刷新：编辑页面后旧版与新版的已打开搜索框均未即时更新，新版刷新页面后可读到更新索引；指南说明刷新或重启开发服务的边界。未启用的本地自定义主题文件保持原样。

Windows 验证：最终官方预发布组合的隔离干净安装、审计与文档构建均退出 0，审计为 0 项已知告警；根目录审计同样为 0。业务完整 npm test 退出 0，689 项中 687 通过、0 失败、2 项因 Windows 文件系统能力跳过；随后 npm run build 和 DEPLOY_TARGET=all npm run check 均退出 0。业务回归期间文档依赖仍是试验覆盖方案，最终文档组合另行验证；业务源码与根锁文件均未变更。依赖审计清零不代表不存在未知漏洞，也不代替云端部署验收。

最终工作区安装、文档审计、文档构建及四端 check 再次退出 0；实际 VitePress 2.0.0-alpha.21 / Vite 8.3.5 / plugin-vue 6.0.10，无 override，文档依赖树不再含 esbuild。Ubuntu 24.04 的独立快照在原生 Node 24.22.1 下重新执行 ci、audit、build 和依赖树检查，均退出 0，审计为 0；该结果没有沿用试验组合。最终静态产物的六个页面直接访问均为 200，浏览器导航、本地搜索与仓库文件路径显示通过，无页面脚本异常。指南 Lite 与 diff 检查通过。

Synced through 14c4fc120a358b3b2f390f2a80102932d68ab3d7；本节记录该提交之后的本地依赖修复，未提交、推送或部署。

GitHub Actions 双平台构建与发布入口（2026-11-07）

新增与 CNB 对应的检查、手动发布及分支归档工作流。检查只在 main 推送成功后移动 last-green；发布保留导入、OCR 附件、构建预算、分目标部署、生产启用、STATUS 与搜索推送顺序，归档先核对不可变标签再以精确 SHA 删除分支。GitHub 使用仓库 Actions secrets 中的 YAML/JSON 对象，辅助脚本只在对应子进程注入标量字段，忽略密钥文件控制字段，不打印或落盘秘密。同步双语入口、贡献指南、归档规则、主流程和代码地图，移除旧的单平台目录排斥守卫。

验证：全部工作流 actionlint 通过；密钥助手 4/4 及密钥、流水线联合专项 66/66 通过；完整静态构建与独立文档构建成功，文档依赖审计为 0 项已知告警。当前联合工作树的 check 仅剩既有未提交搜索脚本的 9 个 lint 错误；此前联合全量测试为 733 通过、16 失败、2 跳过，失败涉及该既有 lint、文档运行器及部署测试环境，不记为全绿。指南校验保留既存 glossary.md 与 modules/ 缺项。未执行真实发布、部署、归档或云端 CI。

Synced through 7c87ff4745b82496c6c05a5ac7a246a19cc77410；本节记录该提交之后的双平台构建改动。