跳转到内容

文档站实施记录

开始日期:2026-10-07;审阅日期:2026-10-08。全部文档与源码注释配对已完成审阅; 本地检查通过;截图发布、自动 CI 和自定义域名 HTTPS 已核验,包括导航、布局和主题修改。 新主题设计已通过本地检查、自动发布与公开域名检查。 Plan.md维护活动状态,文档要求维护行为。

环境与范围

工作目录:D:/workspace/projs/github/owent/llm-usage。Windows、PowerShell 7.6.6、 Node 24.21.0、Git 2.56。根目录锁定 Astro 7.3.6 与 Starlight 0.42.5。 文档站使用英文根路径及 /zh-cn/ 中文路径,支持浏览器语言选择及显式偏好、 系统/亮色/暗色主题与本地 Pagefind 搜索。本地构建检查未观察到第三方请求。 公开域名的 Cloudflare 代理额外注入分析脚本;编译产物中没有该脚本。

用户已授权文档发布,包括 gh-pages 与自定义域名。此次补充截图前,用户已将初步双语 文档提交并推送为 af64b8951936c5b009640537cdad51e1f4da4164,其中包含此前应用提交。 本次截图、导航及布局更新修改文档和站点工具。临时日志、数据库、生成内容和预览均位于 build/documentation-site/。

已实施内容与剩余覆盖

已有 21 组双语用户/开发指南,覆盖安装、首次采集、看板、来源、客户端、调度、遥测、 价格、数据管理、隐私、故障排查、无障碍、开发、架构、适配器、测试、发行、文档维护 和源码注释对照。

199 组使用、架构和开发文档全部已翻译并人工审阅,包括本实施记录、设计说明、 测试预期、资源说明和历史原型使用说明。AI 规则、Skills 和执行计划仅维护原件, 已移除 docs/zh-CN 下 14 份多余译文副本,相关链接改为指向仓库原件。 完整原始中文版本与已完成的英文版本一同保留。 460 个源码文件的 7939 组注释全部完成中英文配对与审阅。 已迁移的原型、配置和 Rust 文件只改注释及 docstring,其他可执行内容未变。 运行时词条、原生记录和第三方许可证声明保留原始内容。

内容检查拒绝缺失或变更后未审阅的中英文配对。审阅摘要记录同步状态; 翻译质量通过直接阅读完整配对检查。

审阅还发现 19 条有实际内容的注释,中文对照错误使用空行标记。现已补齐相应路径、 公式及说明,并增加回归:含字母或数字的注释不能用空行对照,真正的空行和分隔线 仍可使用该标记。草稿检查也在写入源码前拒绝了仅有 ASCII 的中文续行,相关对照已补全。

安装器审阅发现 16 段含 # 的 Handlebars 模板表达式被误计为 NSIS 注释。 扫描器现跳过完整模板表达式,包括带引号的结束符;仍保留 NSIS 语法说明允许的行内 hash 注释。 新增两项回归检查模板及非注释内容保留,并确认实际安装器的全部 32 条条件和循环指令。 安装器审阅后统计 539 个源文件,其中 460 个文件含有 7939 条实际注释。 当前共 541 个源文件;新增两个侧栏模块没有注释。 真实安装器回归首次因仓库相对路径错误而报 ENOENT;修正路径后,22 项文档测试全部通过。 安装器注释翻译保留可执行内容、模板指令及许可证声明;这不代表重新完成软件包安装生命周期验收。

后续注释审阅修正了 Crush 分页及事件键、Copilot 行读取错误处理、Kilo 合成时间戳日期, 以及 Kimi Work 和日期测试实际检查范围的说明。Hermes 枚举深度为 3;OpenCode 接受直接 包含数据库的手工根,通过格式探测确认产品身份,不能只凭文件名前缀判断。 两种语言现均按实际实现描述;运行时字符串、合成数值及断言保持原样。

最后的数据规则、适配器矩阵及 M8 历史报告译文保留未知值、版本限制、首次失败、 样本数值和文件摘要。适配器矩阵现反映已实现的 Qwen 0.25.0 SDK 读取器,Visual Studio 使用唯一的 A49 参考编号。源码注释按实现修正了过时的 Cline/Zoo 探测说明及 ZCode 可空字段说明,可执行代码未变。 文档及注释配对现已完整;发布前仍须通过全部必需检查。

完整文档直接由当前大语言模型翻译。措辞审查覆盖双语指南、工程提示词、导航、首页卡片、 标题和图注,将含糊的研发名称改为具体设计说明、字段规则、测试数据、处理位置及验证结果, 保留标识符、原始输出和历史链接。前一阶段曾翻译中文版写作指导; 用户明确 AI 规则与 Skills 不需要双语后,该多余副本已移除。

源码与样本核对还发现两项计算说明有误:Codex 0.139.0 首条调用之后有 8 次正增量和 1 次不变重复,共 9 次调用;Pi 费用样本输入为 100+5=105,与 pi_gaps_synthetic.rs 一致。 中英文均已纠正。架构说明现按 scanner.rs、framework.rs 和调度规则描述已实现的两个 工作槽及 JSON/JSONL/SQLite 作用域取消。

本轮进一步修正了过时的源码说明:Goose 1.53.0 已有真实容器验证,分页最多读取 50,001 行;价格缓存默认 3 天,界面查询防抖为 200ms。未访问、合并或中断的来源不推进采集到期时间。Codex 注册表的解析器或支持版本变化会重置检查点,旧注释所写的“不自动重扫”已不符合实现。应用数据库版本不匹配需要显式处理,当前不自动迁移。所有修正均同步核对英文和中文,保留原生数值、版本、运行字符串和测试断言。

产品检查首次因 ingest 参数行注释变长后的对齐失败;rustfmt 调整空白后,核对非空白代码和注释内容均未变化,并更新位置和哈希。 下一次 clippy 检查发现 Kiro 文档列表续行缺少缩进,修正后完整 verify 通过。再次应用该草稿时多加了缩进,导致后续 clippy 失败; 辅助脚本已改为设置所需缩进,不再叠加。原始失败日志保存在 build/documentation-site/product-verify-comment-alignment-first-failure.log、 product-verify-doc-list-first-failure.log 和 clippy-doc-list-repeat-first-failure.log;后续通过不替代这些失败记录。 另一批五个解析器的文档列表续行缩进过多,Clippy 报出 57 项错误;修正为所需 缩进后通过。首次失败保留在 clippy-batch54-indent-first-failure.log。 完整检查还首次拒绝本记录的两条过长英文行,换行后通过;保留 verify-complete-md-first-failure.log。这些产品检查不表示新的原生 GUI、安装或发布验证。

原生截图依据

截图工具运行真实 Windows release 程序,版本 0.2.1,SHA-256 为 d09328d76d3f437b890f9d85024b2c7dd48f58fbba7e363082511841911ff1bb。 GUI 使用真实 Tauri IPC/WebView2、独立应用库及隔离合成 Codex 来源。 后端独立核对 240 次调用,来源类别仅有 Codex。 此结果验证截图场景,不能据此确认真实供应商用量或其他客户端版本。

五页界面分别采集中英文及亮暗主题,共 20 张原始 PNG。视口 1440×1000、设备缩放 2, 每张图片为 2880×2000。截屏前仅在界面中把本任务拥有的测试路径替换为 Demo 路径, 数字和控件不变。来源文件记录版本、程序摘要、截图时间、语言、主题、尺寸及每张图片摘要。 截图无水印、账号数据或对话正文。指南使用对应语言的图片,并链接原尺寸 PNG。

两个首页现均在功能说明旁展示总览、趋势、详情、数据源和设置,图片跟随站点主题, 包括系统为暗色时手动选择亮色的情况。中英文 README 展示对应语言的总览,看板指南 补充详情截图及字段说明。图注说明合成数据、未知值,并链接原 PNG。复用原有 20 张 原生截图,不修改像素或采集来源记录。图片整行显示、保持原比例,后续图片按需加载; 小屏可打开原图阅读细节。

首次展示构建失败,因为相对组件导入从生成目录解析。核对已安装 Astro 的别名实现后, 使用相对于 docs/site/src 的固定 @docs/ 别名修复。保留 build/documentation-site/screenshots-docs-build-first-failure.log。 新增浏览器检查随后发现 /zh-cn/ 虽然标记中文 html 语言,实际首页内容及图片却为英文。 Starlight 0.42.5 路由仅规范根 index ID;自定义加载器保留 zh-cn/index,导致 zh-cn 回退路由覆盖渲染内容。去除嵌套 ID 末尾 /index 后修复,公共 URL 及版本标点保持不变。 保留 screenshots-docs-browser-first-failure.log。单元检查现覆盖 index ID 及 README 站内 截图链接;输出检查拒绝截图语言与页面不符,浏览器检查实际加载图片,不仅检查 html 语言。目视检查还调整了手机首页标题的自动换行,避免最后一行只剩一个汉字。

首次尝试暴露了来源隔离问题:没有 HOME 时可发现宿主来源;模拟 USERPROFILE 导致 WebView2 CDP 无法启动;仅隔离 HOME 仍会访问固定绝对路径候选。一次尝试观察到 279 次而非 240 次调用。改为不采集地初始化存储,并在 GUI 启动前保存仅手工根设置, 修正发现范围。最终截图仅包含预期 240 次合成调用。

目视复核发现来源/设置页仍显示工程测试目录,按已说明的 Demo 替换后重新采集。 尺寸检查随后发现 Playwright 截图只有 1440×1000,与两倍缩放记录不符。 改用显式设备参数的原生 CDP 截图并断言像素尺寸后,最终全部图片符合 2880×2000 及记录摘要。

导航与布局修复

在公开 HTTPS 看板指南复现了两种语言的空侧栏分组。点击标题可改变展开状态,但分组 内没有页面链接。已安装 Starlight 0.42.5 导航在目录匹配前,从 entry.filePath 去除假定 的 src/content/docs/ 前缀;本工程加载的是根 build/documentation-site/content/, 因此没有记录匹配。sidebar.mjs 现按已审阅原件清单生成显式 Starlight slug 链接, 保留顺序、嵌套版本目录、译文标题和当前页标识。七个分组均包含链接;产物检查拒绝缺失必需页面。

2560 像素视口下,原指南正文实测只有 832 像素。新桌面布局为左菜单留 19rem、右目录 留 16rem;两种语言正文在 1920 像素视口为 1312 像素,在 2560 像素视口为 1760 像素, 首页示例可扩展到 1600 像素。浏览器检查覆盖 320、390、768、800、1024、1152、1440、 1920、2560 像素,无整页横向溢出或目录重叠。鼠标/键盘分组展开及桌面/手机实际跳转 通过。旧检查只确认手机菜单可见,没有检查其内容;新增检查实际使用菜单链接。

站点、页头和首页标题统一为“AI usage dashboard” / “AI 用量看板”。相关介绍、导航名称 及指南减少重复强调本机的措辞,保留本地来源与隐私限制。既有章节别名及应用截图像素 保持原样。首页第一个按钮打开对应语言的下载章节。GitHub 只读查询没有 Release 条目, 因此说明如何下载应用 CI 制品及登录要求,不链接尚不存在的安装包。译文审阅首次拒绝 英文正文中引述的中文标题;用代码格式保留准确名称,不将其判为未翻译正文。 首次临时在线检查脚本的 Playwright 相对导入路径有误;修正后完成实际站点检查。

主题设计与对比度

实际 1920 像素首页与指南截图显示,原亮色页头、侧栏和阅读背景几乎相同;暗色主题 各区主要使用同一组绿色。这是视觉分区不明显,并未据此认定原文字对比度不合格。 2026-10-08 查阅 W3C 文字、非文字及 CSS 装饰说明,以及 Material 官方颜色用途文档; 链接与要求见文档站设计说明。

初始主题源码 6025b075 区分灰蓝页面及菜单、不透明的近白阅读区、深蓝导航及首页主区域,以及 青绿操作按钮。暗色页面采用深蓝背景、较亮卡片及薄荷绿按钮。外侧留白点阵间隔为 48px,首页插图区为 40px;圆弧保持静态,不会拦截鼠标。正文、表格、卡片和图注保持 纯色背景。打印和强制颜色模式移除装饰,打印卡片标题保持黑色。已目视审阅中英文 首页、指南的亮暗主题截图,以及功能卡片和 390 像素手机页面;图片位于 build/documentation-site/theme/reviewed-source/。原有 20 张应用 PNG 保持原样。

视觉复查发现统计与隐私图标为空。已安装 Starlight 0.42.5 的 Icons.js 没有原先的 chart/shield-check 名称,analytics/padlock 则包含实际 SVG 路径。两种语言首页现使用 这些有效名称,浏览器检查拒绝空功能图标。

浏览器测试测量首页、看板指南和文档维护开发页的实际文字,包括导航、链接、表格、 图注和代码。按计算后的文字颜色及祖先背景合成颜色计算,使用未经舍入的结果与 适用的 4.5:1 或 3:1 文字要求比较;另查悬停按钮和 3px 键盘轮廓。故意将说明文字 设为不可读,确认检查会拒绝失败项。两种语言的最低实测文字对比度均为亮色 5.34665:1、暗色 5.54803:1;键盘轮廓最低为 5.16081:1。这些检查针对抽样文档页, 不代表完整 WCAG 审查,也不包括截图中的应用界面。

首次对比度运行失败,是测量代码把 alpha 分量加入三通道亮度求和,导致焦点比值无效。 限定使用 RGB 后检查通过;界面原有轮廓对比度已足够。保留 theme-browser-first.log。 后续一次浏览器命令开始前,自动批准审核超时;重试一次后正常运行。临时截图工具 还曾等待 Markdown 指南中不存在的 MDX 图形;仅在首页等待该图后恢复。

冷色与较低亮度背景

用户要求背景不偏黄,也不要出现大面积亮白。已安装 Starlight Card.astro 的装饰图标 默认使用橙黄和绿色背景;初始配色还包含纯白卡片及近白阅读区。本次调整采用冷灰蓝的 页面(#dde6f1)、阅读区(#edf2f8)、卡片(#e8eef6)和侧栏(#d3deec)背景。 卡片装饰边线及图标背景改用青绿、蓝、靛蓝和青色。基础背景的 RGB 数值均满足 蓝 >= 绿 >= 红。计算相对亮度为页面 0.783、阅读区 0.883、卡片 0.850,纯白为 1.000;这些数值说明颜色,不代表眼睛舒适度测量。亮色主题代码块也使用卡片背景。 暗色背景保持深蓝配色。

已在 1920 及 390 像素视口审阅中英文亮暗截图,位于 build/documentation-site/theme/cool-background/。原有 30 项浏览器检查通过, 实测最低文字对比度为亮色 4.93674:1、暗色 5.54803:1;键盘轮廓最低为 4.57120:1。 JavaScript 错误及本地第三方请求仍为零,生产构建仍为 1363 页、2853 文件。 日志位于 build/documentation-site/ 下的 cool-background-build-final.log、 cool-background-browser-final.log 和 cool-background-screenshots.log。这些是本次调整的 本地检查;下方既有远端运行编号对应此前源码版本。推送后的自动发布结果可在 文档流水线查看。

验证结果

命令从仓库根执行,使用已安装工具链。下表于 2026-10-08 更新,覆盖全部 460 个含注释源码文件与 220 组文档。最新文档检查覆盖截图、中文首页路由、导航、下载、 宽屏布局及主题设计、对比度。 下表产品结果及原生截图采集早于这些仅涉及文档的改动。

检查 实际结果
npm run verify 完整语料上通过:1032 项 Rust 测试通过、8 项按原设置跳过;22 项界面测试、5 项脚本测试通过;Markdown、Svelte、fmt、clippy 和前端构建通过
npm run test:docs 31 项通过,覆盖侧栏原件清单/顺序/嵌套版本、精确管理员分支配置及读回、语言首页 index ID、截图链接、NSIS 模板保留、注释对照、文档范围、语言选择、链接/章节标识、源码解析及发布完整性
npm run check:docs 199 组仓库文档、21 组指南及全部源码注释同步;Astro 检查 32 个文件,零错误、警告及提示
npm run build:docs 主题源码 6025b075 在本地及 CI 均构建 1363 页、2853 文件并通过;检查必需侧栏链接、链接/片段、语言入口、本地搜索、域名标记及截图摘要/尺寸
npm run test:docs:browser 已安装 Edge 的 30 项通过;实际文字/焦点对比度、悬停按钮、主题保存、图标、强制颜色/打印、侧栏导航、标题/下载、320–2560 像素布局、双语亮暗截图、原图链接、搜索、语言选择、存储拒绝、无 JavaScript 回退及键盘访问;本地构建零 JS 错误/出站请求
npm run docs:screenshots 20 张真实原生截图,语言/主题正确,240 次隔离调用,像素尺寸符合声明
npm run lint:md 451 个文件,零问题,包括本记录
cargo fmt –manifest-path desktop/src-tauri/Cargo.toml –all –check 通过
cargo metadata –manifest-path desktop/src-tauri/Cargo.toml –no-deps –locked –format-version 1 Cargo 注释修改后通过
npm install –package-lock-only –ignore-scripts –offline 通过,核对根依赖/锁文件一致性,不运行依赖脚本
node docs/site/scripts/check-content.mjs 退出 0;全部文档与源码注释配对完整,没有翻译或审阅失败项
git diff –check 最终记录与计划修改后通过

首次构建准备使用了旧版 Starlight 侧栏配置,按 0.42.5 修正后通过。 预渲染构建遇到嵌套 js-yaml 解析不兼容,改为打包各导入方自己的依赖后通过。 章节链接标识插入 YAML 元数据曾破坏 frontmatter,使用识别元数据的标题偏移修复。 源码标题别名放在 H1 后,符合 Markdown 校验;生成参考保留两种语言的章节链接标识。 源码注释回归还覆盖 TypeScript 空块注释,以及 Windows 换行下 PowerShell/Python 原生偏移保留。

标题改名回归首次失败,因为 Markdown 将空的章节链接标签的开始和结束标签分别解析。 修复后,历史链接在两种语言中都定位到对应章节,并删除了失败尝试产生的重复章节链接标识。 连续 TypeScript 注释还暴露了回调返回 Map 导致枚举提前结束的问题,改为不返回值后 正确读取全部注释;回归覆盖相邻注释和 Windows 换行。写入译文前比较注释以外的可执行内容, 确保注释翻译不改变程序行为。

81 文件注释批次先后拒绝了两条中文说明:一条只有 libuv URL,另一条只有数值和 货币符号。现已补齐中文解释。应用工具仅允许与原文或已翻译内容完全相同的注释继续执行, 并核对注释以外内容不变;翻译草稿在应用前检查全部语言条目。这属于翻译检查失败, 不是可执行程序或产品测试失败。Markdown 检查还发现路径占位符和下划线未用代码格式, 五处均已修正,样本数值不变。安全认证头及认证 UI 保留准确名称,版本检查使用核验表述。

后续直接由模型审阅十五份历史记录和两份原生样本记录,并补齐 94 个源码文件。 版本检查和冲突处理改为实际核验条件及比较顺序,保留安全认证名称。 按源码纠正了模型筛选总量、Qoder 目录深度及 Codex 缺版本条件的误导注释,执行代码未变。 一个临时草稿有未转义撇号,两次精确匹配失败涉及原注释空格,一条纯数值中文说明未通过语言检查。 修正后,工具在写入前校验全部计划文件;继续执行仅接受原文或已翻译内容的精确匹配。 这些准备工具失败与产品测试分开记录。

以上区分本地、静态、浏览器检查与原生截图采集。远端 Actions、Pages 部署及公开域名 HTTPS 结果在后文单独记录。

进一步逐篇审阅了本机 Copilot/WSL 安装、版本迁移、平台凭据/Hermes、价格与看板修复、 调度及 Buddy/遥测历史记录,以及另外 26 个源码文件。明确了 Copilot 保存请求对象与 底层调用数的区别,修正 Cline 完整 JSON 数组、OpenClaw 安装失败、Hermes 已有真实样本 及字节格式取整说明。JSONL 读取时间取剩余时限一半的规则已核对实际读取器。 临时翻译草稿曾因模板分隔符未转义而失败,未写入源码。另一个只有文件名的中文条目 在任何文件写入前未通过语言检查,补充中文标签后通过。Markdown 中的 synthetic 字面量 需转义才能正确显示。历史遥测说明补充了当前接收器认证链接;保留原始程序输出、标识符 及安全认证的准确名称。

首次批量删除译文被自动审批拒绝,原因是筛选范围可能包含仍需保留的开发文档,当时未执行删除。随后只读核对了 14 份 AI 规则、Skill 和执行计划译文,保留全部 199 份使用、设计和开发参考文档。缩小范围后执行通过,原件保留。源码注释通过开发指南索引查阅,侧栏不再逐个列出源文件。

plan-finalization.md 的翻译曾被自动审批拒绝,原因是按文件名将它判为执行计划。 只读核对发现它记录已完成测试的日期与测量值,current-acceptance.md 也将它列为开发验收记录。 文档范围明确包含这些记录;核对后审批通过,两份已排除的执行计划仍仅保留原件。 一份 M8 翻译工具因 Windows 换行处理失败,在写入前退出;随后一处表格残留中文阻止了审阅登记。 两项均已修正,固定源码提交与当时字段假设保留,并链接后续真实样本规则。

发布实现与前提

流水线检查并构建 PR/默认分支变化,仅主分支成功构建可以发布。 静态制品在内容、单元、构建和浏览器检查后记录源码 revision 及全部文件摘要。 发布脚本拒绝变化/未记录验收的制品、过期 revision 和意外 origin。 使用 build 下自有工作树,不强推并保留 gh-pages 历史,保存真实资源而非 LFS 指针, 显式请求并观察发布 revision 对应的 Pages 构建。Git/GitHub 命令最长 60 秒且不等待 交互;Pages 轮询包含请求时间,总期限十分钟。提交身份仅对该命令生效, 不修改共享仓库配置。

首次 Pages 设置由已授权管理员的 GitHub CLI 会话使用 –configure-pages 参数完成。 普通 CI 仅有 contents/pages 权限,没有 Administration 权限。来源为 gh-pages 根目录 /, 域名为 llm-usage.atframe.work。最初核查没有分支,Pages API 返回 404;运行 37712495970 成功构建 af64b8951936c5b009640537cdad51e1f4da4164,但发布在读取未初始化设置时失败。 保留 build/documentation-site/initial-remote-docs-ci-failure.log。一次回查连接重置属于 网络失败,不证明配置变化。用户已经推送该双语提交,其中包含应用提交 4296121185af04456d1e5fef29294781f4a100c7,此前推送范围问题已解决。已登录管理员随后 发布截图源码 db44b0300750ef4f3e00c89ad21edbfa83e60813 并初始化 Pages;分支版本 ac2547f2bc1b084a1b4d6ce2b1aa8c8489fa50f4 达到 built。

推送触发的运行 37716140836 首次构建通过,但 github-pages 自定义部署分支规则不含 main,GitHub 拒绝发布。check-run 提示明确指出 main 不允许部署。自动审批首次拒绝 修改这一持久环境规则,原因是没有针对该规则的具体授权。用户随后明确允许仅添加 {“name”:“main”,“type”:“branch”}。读回保留 gh-pages 规则 62317275,新增 main 规则 62317907,并比较确认其他保护设置未变。发布工具现提供单独管理员参数 –configure-environment,只执行这项写入并核对读回,已有回归检查;单独使用 –configure-pages 不修改分支规则。

运行 37716140836 的第 2 次尝试在 db44b03 上构建与发布均成功,产出的 gh-pages 版本 d9e2ea32d1c36d6b81e0faed6f2d5458a9e96c44 达到 built。远端 20 张 PNG 的 Git blob 均 与原文件一致,归属标记记录准确源码。Pages 历史还保留此前两个分支版本的通用 Page build failed 结果;其原因尚未核验,后续 built 不删除此前失败。

公开 HTTPS 检查中,两种语言首页均返回 200,核对实际语言内容及主题图片,下载全部 20 张 PNG 并比较 SHA-256 与原图一致。线上源码标记为 db44b03,浏览器没有 JavaScript 错误。DNS 返回 Cloudflare 代理 A 地址 104.21.30.73 与 172.67.172.61;启用代理时,仅查 CNAME 不能证明缺少路由。公开 HTTPS 通过不证明 GitHub 源站强制证书状态。代理注入 static.cloudflareinsights.com 分析脚本,受查编译产物中没有该脚本或第三方请求。 未修改 DNS 或 Cloudflare 设置。报告为 build/documentation-site/ 下的 remote-screenshot-publication.json、pages-environment-readback.json 和 live-before.json。

导航与布局源码 16c77e3fd386071ce266d862e70914a33cf2b4ed 的自动运行 37719512134 通过 31 项单元测试、24 项浏览器检查、内容/类型/Markdown、生产构建和发布。 gh-pages 版本 4e31c8c1eba6911469da27fe16d215798dab812d 达到 built;历史还保留一次 原因未核验的通用失败。公开 HTTPS 检查确认准确源码标记、双方首页标题、对应语言下载 跳转、全部七个菜单分组、鼠标/键盘展开、桌面页面跳转及手机键盘导航。双方指南正文 在 2560 像素视口均为 1760 像素。再次下载的 20 张 PNG 全部与原图一致,没有 JavaScript 错误。首次公网 HTTP 检查超过 15 秒期限;后续有时限的检查完成,没有请求失败。 保留 live-layout-after.log、live-layout-first-failure.json,以及通过后的 live-layout-after-retry.log、live-after.json、layout-remote-publication.json 和 layout-remote-ci.log。这些结果验证文档发布与交互,不代表重新验收应用或原生功能。 后续发布记录修改不改变已核验的站点实现。

主题源码 6025b0750f852686f9e874ea6f9a1b97f70887dd 的自动运行 37722735785 通过 31 项单元测试、30 项浏览器检查、内容/类型/Markdown、生产构建和发布。 gh-pages 版本 d8a473b9f63fe9624e9200408844d6d5f6fc75b1 达到 built;此前通用 Page build failed 结果仍保留,原因尚未核验。远端 20 张 PNG 的 Git blob 均与原图一致。 公开 HTTPS 检查确认准确源码标记、两种语言的实际亮暗配色、稀疏装饰、卡片图标及 对应语言图片。七个菜单分组均可用鼠标及键盘操作;下载和手机数据源跳转通过。 2560 像素视口的指南正文仍为 1760 像素,没有手机溢出或 JavaScript 错误。 已审阅线上首页与指南截图。报告及日志位于 build/documentation-site/ 下的 theme/live-6025b075/report.json、remote-37722735785-publication.json、theme-remote-ci.log 和 theme-live-implementation.log。后续仅修改记录,不改变已测试的主题样式、首页图标 或浏览器实现。

曾提议在已忽略 build/ 下建立可选离线翻译环境,使用固定版本 CTranslate2/ SentencePiece/PyYAML 和官方 OPUS-MT 权重,本机推理,不把仓库文本发送到翻译服务。 自动审批拒绝了安装,理由是维护说明要求可选工具安装已有采用或当前授权。 没有安装翻译工具或模型。用户随后要求直接由当前大语言模型翻译,现已将此方式写入 维护流程,可选离线工具安装不再属于本任务。文档翻译和站点实施继续进行。