变更 / Changed（原 v6.4.3，未单独发布，并入本版）

• 删除内置加速通道与内置网络镜像：通道列表不再包含任何内置项，代码里也不再 预置第三方代理地址（原 proxy.344977.xyz、ghproxy.net 规则）。要加速需自行 添加通道地址；不添加则始终直连。
• 删除降级回退：加速判定现在至多返回一项 —— 加速就是 前缀 + 原址，不加速 就是原址，不再追加直连候选。所依据的判断是：静默降级会让「是否经过通道」无法 从结果判断。
• 加速适用范围可逐项开关（设置 → 网络 → 加速），共 4 类：Release 附件、 Action 构建产物、仓库文件（下载与预览）、README 仓库内图片。默认全开，可逐项 关闭。Action 运行日志不在此列 —— 它不经由加速判定。
• 加速协议升版 v3 → v4，需重新同意：正文删去「本应用提供 / 维护通道」的表述， 写明「不预置任何通道、不提供代理服务」，并说明失败时不会静默回落到直连。

修复 / Fixed（用户可感知）

• README 仓库内图片在私有仓库返回 404：Image.network 没有 headers 参数， 无法携带令牌，而私有 raw 匿名访问返回 404。此前「私有 + 已知情接受」会走到 该分支；现在私有仓库一律回退到 API 取字节（该路径带令牌）。
• 仓库内图片跨仓库串图：字节缓存只以仓库内相对路径为键，assets/logo.png 这类同名文件在两个仓库间会命中同一份缓存。键改为 仓库@分支:路径。
• 分页列表在缓存窗口内只显示第一页：缓存命中时只回填响应体、headers 为空， 而翻页依赖 Link 头。现在缓存条目连同 link 一起存储并在命中时回填。
• 同一文件第二次下载不再导出到 SAF：导出去重表只在失败路径移除 id， 成功导出后 id 常驻；taskId 由 url + 文件名派生，重复下载会命中同一条目。
• 自定义 DNS / DoH 开关对真实请求不生效：connectionFactory 只在传输层 构造时安装一次，而 DNS 模式的写入发生在模块注册之后。现在每次发送前按当前 策略校正（模式变化才重装，切回系统 DNS 时把 factory 摘掉）。
• 登录页切换账号不清缓存：只清仓库缓存会留下 DNS 缓存与页面分页快照， 多账号下是「用 B 账号看到 A 账号内容」的来源。现与「我的」页一致，清全部缓存。
• 版本常量 kOgLAppVersion 停在 6.0.0，与 pubspec.yaml 相差三个小版本； 该常量会写入日志与内核报告。已对齐。

修复 / Fixed（下载器与网络）

• 分片任务在探测期间被移除后会重新出现在列表：_runRanged 在 await probe 之后无条件写回快照。现在探测返回后先确认任务仍在，否则直接退出。
• 任务表清理不完整：remove() 与 clearFinished() 漏清 _urlCandidates、 _rangeConnections、_lastSample、_expectedSha256、_exportedToSaf。
• dispose() 不取消进行中的分片下载：分片任务不等待返回，管理器回收后引擎 仍在下载并调用已释放的通知器。现取消全部令牌并加 _disposed 守卫。
• ix_presign 在 200 直链分支先读取响应体再注释说明「不能读」：每个直链下载 都会多传输一遍完整内容。已移除。
• isForbiddenHost 存在绕过形式：原先只识别点分十进制与 fe80: 前缀。 现在先做归一化（整数形式的 IPv4、IPv4-mapped IPv6、方括号与尾点），IPv6 段 按位判断（fc00::/7、fe80::/10），并支持 127.1 这类缩写。
• 分片合并失败会留下不完整的文件：finally 只删分片，不删目标文件。
• abs() 未拒绝绝对路径与空串（注释称会拒绝）：/etc/passwd 会被静默剥掉 前导斜杠并塞进根目录。现显式拒绝。

修复 / Fixed（界面文案）

• 19 个界面文案取自错误的语言分片，显示为裸键名：设置页 13 处、仓库页 2 处、 关于页 4 处。取法已改到键实际所在的分片。
• previewSvg / previewUnknown 两个键在 6 种语言里都不存在（「打开方式」 弹窗的 SVG 与未知类型条目显示裸键）。已补齐。
• 三处硬编码中文改为 i18n：Gist 详情页的「公开 / N 个文件」、议题列表的 「N 条评论」、评论作者缺失时的「未知用户」（复用已有的 common.unknown）。

变更 / Changed

• i18n_scan.py 的分类规则收紧：LOG_CONTEXT 原含 log\w*(，该模式会命中 AlertDialog(、showDialog(、catalog( 与 login(，使对话框附近的用户可见 文案被计为开发者日志。现改为只列精确的日志入口。
• docs/NETWORK.md 更正与代码不符的表述，补入「加速适用范围」与 web 端 CORS 实测表；docs/README.md 补入索引，路径改为可点击链接。
• 多处注释更正为与实现一致（平台分派范围、私有仓库口径、模块描述、 IxChannel.auto 语义、日志文件名格式、诊断中的并发数文案）。
• 删除无引用的 IoBootFileSystem；对仅测试使用的 ScriptedTransport 与 无调用方的 DiskPaths 加注说明。

已知限制 / Known limitations

• docs/ARCHITECTURE.md、BOOT.md、CONSISTENCY.md、DURABILITY.md、 NAMING.md 被代码注释引用，但仓库中并不存在；这些引用尚未清理。
• Action 运行日志不走加速（直接请求 api.github.com），加速适用范围没有它。
• web 端：私有仓库的 raw 与「私有 + 加速」均不可用 —— 浏览器预检会拦截 Authorization，而 Release 附件的签名地址不带 CORS 头。
• Linux 裸放安装包 3 / 6：rpm（arm64）缺少平台定义；AppImage 的 ARCH 环境变量未被接受。三种包在 zip / 7z 里都齐全。
• macOS / iOS 自 v5.6.0 起弃用。

产物 / Artifacts

Android arm64-v8a / armeabi-v7a / x86_64 / universal-APK / AAB、 Windows x64 / arm64、Linux x64 / arm64，每份均含 zip 与 7z。

下载 / Download

本版本共 23 个构件产物。

Android

Windows

Linux

完整列表与校验信息见 Releases v6.5.0。

垂直切片 / Vertical slices

切片一 · 译文与语言清单一致 Language accuracy

上一版的情况是：15 种语言里有 12 种的法律类正文实际是英文占位 —— 键在、目录在、值与英文一字不差。用户切到自己的语言，看到的仍是看不懂的 法律说明。而这方面的文本需要准确：本项目对数据收集、令牌存储、 加速责任的承诺都写在这些文本里。

以下 6 种语言的键全部有实际译文，予以保留：

• zh 简体中文（原始表述）
• zh_TW 繁體中文
• en English
• de Deutsch
• fr Français
• ru Русский

移除 ja ko es pt ar hi th vi id。 加回某个语种的前提是其全部键都有实际译文，而非复用英文。 OgLI18n.locales 的注释里写明了这条规矩。

切片二 · 三处语言清单必须一致 Consistency guard

根因在这里。语言清单散在三处，任两处不同步都会出事， 而且两种故障方向相反、都很难在排查时想到根源：

• OgLI18n.locales（Dart 运行时清单）
• assets/i18n/ 下的目录
• pubspec.yaml 的 assets 声明

pubspec 多声明 → 构建期「资源不存在」直接失败； pubspec 少声明 → 构建通过，运行时该语言全是裸键名。

后者的表现是：打出来的包能安装运行，但该语言下显示的是键名（如 settings.theme）。 v6.4.0 删了 9 个语言目录，若不同步 pubspec，踩的就是第一种。

tool/i18n_scan.py --check 新增该项检查。负向验证：故意在 pubspec 加一个 不存在的语言目录 → 报「pubspec.yaml 声明但目录不存在（构建必失败）」， 退出码 1。

新增 / Added

• 语言清单三处一致成为 CI 门禁：OgLI18n.locales × assets/i18n/ 目录 × pubspec.yaml 的 assets 声明，逐项比对，不一致即失败（退出码 1，已负向验证）。

变更 / Changed

• 界面语言由 15 种收敛为 6 种：zh / zh_TW / en / de / fr / ru。 同步更新 OgLI18n.locales、pubspec.yaml、README.md、docs/USAGE.md、 docs/I18N.md。
• 仓库页选项卡按语种分别处理（此前各语言混杂、口径不一）：
  • zh / zh_TW：Code / Issues / Pull requests / Actions 保留英文， 其余（分支 / 提交 / 设置）照常用中文。
  • de / fr / ru：译为各自语言的对应词。此前这些语言里混着英文残留 —— 例如 fr 的 pulls 原是 Pull Requests、releases 原是 Releases， 现已分别改为 Demandes de tirage / Versions。
  • 测试相应更新：语种数 15 → 6，并保留「中文语境下 GitHub 术语必须保持英文」 这条断言。
• 繁体中文修正少量沿用大陆用法的词：Gist 片段 → Gist 程式碼片段、 我的加速 → 我的加速節點。

修复 / Fixed

• OgLProjectInfo.licenseUrl 仍指向 AGPL-3.0：v6.3.0 换了许可， 标识（licenseId）与名称（licenseName）都改了，地址漏改，还指向 www.gnu.org/licenses/agpl-3.0.html。该常量目前无引用（死常量），但一旦有人 用它生成「查看许可」链接，就会把用户送到一份与实际许可无关的全文。 已改为 https://www.apache.org/licenses/LICENSE-2.0。
• 私有仓库大图预览「用了 raw 却不带令牌」：超过 1 MB 改用 raw 链接时， 代码写成 headers: proxied || !repoPrivate ? null : const <String, String>{} —— 注释说「未走代理且私有仓库才带认证头」，实际给的是空 map，一个头都没带。 私有仓库必然 404，而界面显示成「文件过大，无法在内置预览中加载」， 把认证失败误报成文件过大。现在真的去取一步令牌。
• 私有仓库被「加速已开启 → 不弹窗」规则误伤：raw 族的加速门槛本就是 「内置通道 + 公开仓库」，私有仓库的 raw 永远不加速。旧代码只要检测到加速 开着就不弹窗、直接走 raw，私有仓库用户于是什么都看不到就掉进上面那个必然失败 的分支。现已显式排除私有仓库。
• 私有仓库的音频「播放」按钮点了必然失败：该按钮把 raw 地址交给系统播放器， 而系统播放器没有本应用的令牌。私有仓库现在只给「下载」。
• 法律全文弹窗写死 height: 460：小屏 / 大字体 / 横屏下会溢出。 改为按视口比例给上限。
• 新增键 common.previewLoadFailed（6 语言），把「加载失败」与「文件过大」 区分开 —— 超过 1 MB 已有专门面板处理，走到 errorBuilder 说明是认证 / 限流 / 网络问题，说成「文件过大」会让人往错的方向排查。

  已知限制 / Known limitations

• 音频不做内置播放：Contents API 对超过 1 MB 的文件不返回内容，音频必然超限。 预览页对公开仓库给「播放」（交系统播放器），私有仓库给「下载」。
• Linux 裸放安装包仍缺失：rpm（arm64）因 Ubuntu 的 rpm 缺少 aarch64 平台 定义、无法在 x86_64 宿主上交叉构建；两个 AppImage 因 appimagetool 未接受到 ARCH 环境变量而退出码 1。三种包在 zip / 7z 里都齐全，功能不缺， 只是未裸放直传。
• 私有仓库的 raw 内容无法走加速（README 仓库内图片、仓库文件）：raw 端点 没有签名机制，交给代理等于送令牌。这是硬约束，不是取舍。
• macOS / iOS 自 v5.6.0 起弃用。
• Linux 需要 glibc ≥ 2.35（Ubuntu 22.04 一代及以上）。

产物 / Artifacts

Android arm64-v8a / armeabi-v7a / x86_64 / universal-APK / AAB、 Windows x64 / arm64、Linux x64 / arm64，每份均含 zip 与 7z。

Linux 裸放安装包

与 v6.2.0 / v6.3.0 相同，仍为 3 / 6：

三种包在 zip / 7z 里都齐全，功能不缺，只是未裸放直传。

下载 / Download

本版本共 23 个构件产物。

Android

Windows

Linux

完整列表与校验信息见 Releases v6.4.0。

变更 / Changed

• 私有仓库加速的知情开关（accelPrivateRepoAccepted，默认关闭）：
  • 位于设置 → 网络 → 加速通道；
  • 开启必须先过警告弹窗，且强制展示 3 秒后才可操作，按钮显示剩余秒数 （防止误触连点 —— 这是「令牌离开设备」的唯一一道闸门）；
  • 关闭不弹窗，语义是「不再询问且不再加速」，退回 API 直取。 本项目不提供「不再询问但仍发送令牌」的选项，以避免把一次性知情同意 变为永久授权。
• 公开仓库不受影响：加速行为与之前一致。

为什么要有这道闸门（都是实测结论）

• 私有仓库的 raw 匿名 404，?token= 形式早已废弃，只有带 Authorization 头才 200；
• 内置通道会原样转发该头给 GitHub（带令牌 200 / 不带 404） —— 所以「令牌离开设备」是实测事实，不是理论风险；
• 令牌进入第三方服务器后，其留存与用途不在本项目控制范围内。

新增 / Added

• docs/NETWORK.md：全仓库网络连接清单 —— 出口主机 × 资源类型 × 取法 × 公私差异 × 复现命令。

修复 / Fixed

• 补回 ogLAccelCandidates 在上一笔提交中被误删的 repoPrivate 参数 （改签名时替换掉了，函数体却仍在引用它），该项曾导致 9 条构建腿与质量门全红。
• 私有 + 已接受加速时必须带令牌：旧判据 proxied || !repoPrivate 在此情形给出空头，代理拿到一个取不到内容的地址，必然 404。

已知限制 / Known limitations

• 音频不做内置播放：Contents API 对超过 1 MB 的文件不返回内容。
• 私有仓库的 raw 无法像 Release 附件那样「先签名再加速」 —— GitHub 没有 给 raw 提供签名机制，这是硬约束。
• Linux 裸放安装包 3 / 6：rpm（arm64）缺平台定义；AppImage 的 ARCH 环境变量未被接受。三种包在 zip / 7z 里都齐全。
• macOS / iOS 自 v5.6.0 起弃用。

产物 / Artifacts

Android arm64-v8a / armeabi-v7a / x86_64 / universal-APK / AAB、 Windows x64 / arm64、Linux x64 / arm64，每份均含 zip 与 7z。

下载 / Download

本版本共 23 个构件产物。

Android

Windows

Linux

完整列表与校验信息见 Releases v6.4.1。

修复 / Fixed

1. Windows 与 Linux 的图标自 v5.6.0 起一直是空白的

desktop_icon.render_rgba 解析出的图层里存的是 url(#bodyGrad) 这样的引用串， 而渐变表的键是 bodyGrad；查表写成 grads.get(layer["fill"].strip())， 结果始终为空，于是每个图层都被跳过，输出是一张全透明的图。

症状不是报错，而是一个看不见的图标；构建全程”成功”。 现在：正确解析引用，并且渲染结果若全透明就直接报错 —— 不允许再交出空白图。

2. Android 图标从来没有跟过源图

注入器里是一段硬编码的矢量前景（盾牌 + 蓝色三角），与 assets/icon/ogl_icon.svg（深色多边形 + 金色双眼）不一致。此前所称的「唯一事实来源」与实际不符。现在改为真实转换。

3. 自适应图标纵向偏移 3%

居中只按 X 算了横向平移，Y 套用了同一个值；源图重心是 (256, 272)，于是图形在 安全区里整体下移。已改为 X/Y 分别计算。

变更 / Changed

• 图标全平台统一从同一份 SVG 派生：
  • Android：矢量（VectorDrawable，自适应前景收在安全区内）
  • Windows：256 ICO；Linux：2048 PNG 母版
• 传统启动图标放 mipmap-anydpi/：优先级高于具体密度，会盖过模板生成的 PNG， 因此 API < 26 也不会残留 Flutter 默认图标。

新增 / Added

• tool/svg_vector.py：SVG → VectorDrawable（纯标准库，渐变按 objectBoundingBox 语义换算成绝对坐标）。
• 注入器自检新增「图标管线」一节共 13 项断言：渲染非空白、全透明必须报错、 矢量含真实几何与渐变、安全区生效、五个 Android 图标文件均写出。

已知限制 / Known limitations

• 图标转换器只认 polygon + linearGradient（当前源图恰好只用这两者）； 源图若引入 path/circle/径向渐变，转换会明确报错而不是静默画错。
• 私有仓库的 raw 无法像 Release 附件那样「先签名再加速」：GitHub 没给 raw 提供签名机制，这是硬约束（详见 v6.4.1）。
• Linux 裸放安装包 3 / 6：rpm（arm64）缺平台定义；AppImage 的 ARCH 环境变量未被接受。三种包在 zip / 7z 里都齐全。
• macOS / iOS 自 v5.6.0 起弃用。

产物 / Artifacts

Android arm64-v8a / armeabi-v7a / x86_64 / universal-APK / AAB、 Windows x64 / arm64、Linux x64 / arm64，每份均含 zip 与 7z。

下载 / Download

本版本共 23 个构件产物。

Android

Windows

Linux

完整列表与校验信息见 Releases v6.4.2。

新增 / Added

• 文件预览：图片（可缩放）、SVG（矢量渲染）、XML 与文本（语法高亮）。 在仓库页长按文件 →「打开方式」可在「内置预览 / 编辑器 / 浏览器」之间选择。 File previews for images (zoomable), SVG (vector), XML and text; long-press a file in the repository page and pick “Open with”.
• Action 构建产物下载控件：运行详情页列出产物（名称 / 大小 / 有效期）， 已过期的条目直接禁用。 Build-artifact download control in the run detail page; expired artifacts are disabled.
• 编辑器长按菜单：复制 / 剪切 / 粘贴 / 全选（只读态自动裁掉剪切与粘贴）。 Long-press selection menu in the code editor.
• 引导页最后一页《开源协议与隐私承诺》（15 语言全文）： 保证不收集数据（无遥测 / 分析 / 广告 / 追踪 SDK，令牌只在本机）， 并明确排除可选的 Web 浏览器版本 —— 该功能默认关闭，开启前会再次单独提示。 A licence-and-privacy page as the final onboarding step, guaranteeing no data collection while explicitly excluding the optional Web build.

变更 / Changed

• 内置加速通道改为 https://proxy.344977.xyz/（单前缀转发完整原始链接）， 同意协议版本 1 → 2（地址变更属实质修改，需重新征求同意）。 Built-in acceleration channel switched to proxy.344977.xyz; consent version 1 → 2.
• 加速路由改为纯函数判定（ogLAccelCandidates）：签名族（Release 附件 / Action 日志 / 产物）按 500KB 阈值；raw 族仅「内置通道 + 公开仓库」才加速。 Routing is now a pure function: signed assets follow a 500 KB threshold; raw assets accelerate only on the built-in channel for public repositories.
• 仓库文件取法按是否加速分流：不加速走 API （/repos/{o}/{r}/contents/{path} + Accept: application/vnd.github.raw， 实测支持 Range，多连接分片不退化）；加速才把 raw 链接交给代理。 Repository files now use the Contents API with the raw media type when not accelerating, and only hand raw links to the proxy when accelerating.
• README 仓库内图片：内置 + 公开时改走 raw + 代理 —— raw 不限流，而 Contents API 认证后也只有 5000 次/小时，一次 README 几十张图很容易吃配额。 README images use raw through the proxy on the built-in channel: raw is not rate-limited, unlike the 5 000/hour authenticated Contents API.
• 登录页精简：删掉「怎么拿令牌」引导、「向导进度」四步清单与重复标题， 保留安全说明、输入、显示/隐藏、登录与游客入口（文件缩小 27%）。 Login page simplified; the how-to guide and step checklist are gone.
• 下载管理页的状态与分类标签改为走 i18n（此前是域层硬编码中文）。 Download status/category labels are now localised.

修复 / Fixed

• 私有仓库下载未带认证头（Release 附件 / Action 产物 / 仓库文件三处都会 401/404）。私有仓库此前实际上无法下载。 Private-repository downloads carried no auth header and failed outright.
• 下载后不校验完整性：现在比对 GitHub 提供的 SHA-256；不匹配判为失败且 不导出到 SAF；没有摘要可比对时如实标注「未校验」，不声称已验证。 Downloads are now verified against GitHub’s SHA-256 digest; mismatches fail and are never exported. Resources without a digest are honestly labelled “not verified”.
• 文件名未做净化：新增净化（只取末段、剔控制字符、拒 ..、绕开 Windows 保留设备名、限长 120 并保住扩展名）。 Download file names are now sanitised.
• 非 http(s) 地址被放行：新增协议白名单，入队与全部降级地址一律校验。 A scheme allow-list now rejects anything that is not http/https.
• 跨域重定向的令牌外泄风险：此前依赖 Dart SDK 未文档化的”自动剥离 Authorization”行为；现在显式不跟随重定向，并校验跳转目标（拒绝回环 / 私网 / 链路本地，含云元数据 169.254.169.254）。 Redirects are no longer followed implicitly, and redirect targets are validated.
• 构建：Windows 两条腿 spec 从未被应用 —— Windows runner 无 PyYAML，注入器 走了手写的兜底解析器，而它几乎解析不出内容，导致编译宏全部未注入。 已重写为缩进驱动解析器，与 PyYAML 结果逐字段一致。 Windows builds never applied the platform spec because the dependency-free YAML fallback parser was broken; it has been rewritten.
• 构建：Android 五条腿未跟进 Kotlin DSL 迁移 —— 模板已生成 build.gradle.kts，spec 仍指向 build.gradle，注入被静默跳过， compileSdk 停在 36 且 desugaring 未开。注入器现在缺目标文件即报错退出， 失败点从编译期前移到注入期。 Android legs had not followed the Kotlin DSL migration; the injector now fails loudly instead of silently skipping.
• 发布：Linux 的 deb / rpm / AppImage 从未真正发布过 —— 发布作业没有 actions/checkout，工作目录是空的，tool/linux_packages.py 根本找不到； 而该步骤带 || true，把错误整个吞掉。v5.6.0、v6.0.0、v6.2.0 的 Release 里 裸放安装包数量均为 0。已补上签出步骤，并把「脚本不存在」改为非零退出码失败 （单个格式打包失败仍只告警，不拖垮发布）。 Linux .deb / .rpm / AppImage were never actually published: the release job had no actions/checkout, so the packaging script was absent, and || true swallowed it.

移除 / Removed

• main 上的 Web 残留：.github/workflows/web.yml（挂在 push:[main]，每次推 main 都会执行且带 contents: write）、tool/web_build.py、docs/WEB.md。
• 5 个已被 platform_spec.yaml + 统一注入器取代的旧脚本 （inject_android_gradle / inject_android_icon / inject_android_manifest / inject_desktop_shell / inject_windows_cmake）。
• 2 个无引用的遗留文档（docs/ANIMATION_PLAN.md、docs/RELEASE_NOTES.md）。

已知限制 / Known limitations

• 私有仓库的 raw 内容无法走加速（README 仓库内图片、仓库文件）。raw 端点 没有签名机制，私有内容必须直接带令牌 —— 交给代理等于泄露令牌。这是硬约束。 Raw content of private repositories cannot be accelerated: the raw endpoint has no signing mechanism, so delegating it to a proxy would leak the token.
• 音频不做内置播放：Contents API 对超过 1 MB 的文件不返回内容，音频必然超限。 可在下载后用系统播放器打开。 No in-app audio playback: the Contents API returns no content above 1 MB.
• Web 功能不在隐私承诺范围内（见引导页最后一页）；该功能默认关闭。 The Web build is excluded from the privacy commitment; it is off by default.
• macOS / iOS 自 v5.6.0 起弃用。
• Linux 需要 glibc ≥ 2.35（Ubuntu 22.04 一代及以上）。
• Linux 裸放安装包本版仅 3 / 6：deb（两架构）与 rpm（x86_64）已产出， rpm（arm64）与两个 AppImage 尚未产出。三种包在 zip / 7z 里都齐全， 详见「产物」一节。

产物 / Artifacts

Android arm64-v8a / armeabi-v7a / x86_64 / universal-APK / AAB、 Windows x64 / arm64、Linux x64 / arm64，每份均含 zip 与 7z。

Linux 裸放安装包：本版只产出了 3 / 6（如实说明）

这三种包此前从未真正发布过 —— 本版第一次让它们开始产出，但仍未齐备：

三种包在 zip / 7z 里都齐全 —— deb / rpm / AppImage 一并打进了 OGL-v6.2.0-Linux.*.zip 与 .7z，所以功能上不缺，只是没有裸放直传。 裸放安装包是本版新增的，缺失项会在后续版本补齐。

下载 / Download

本版本共 23 个构件产物。

Android

Windows

Linux

完整列表与校验信息见 Releases v6.2.0。

新增 / Added

• 无障碍语义标注（4 处）：此前全项目 Semantics 为 0 —— 50 个图标按钮虽都有 tooltip（Flutter 会自动取作语义标签），但自定义可点击区域没有任何语义标注， 屏幕阅读器只能念出”按钮”，用户不知道点了会怎样。
  • 标题栏窗口控件（最小化 / 最大化 / 关闭）→ Semantics(button: true, label: …)
  • 代码配色色板 → Semantics(button: true, selected: …, label: 颜色 #rrggbb)
  • 通知开关行 → Semantics(toggled: …, button: true, label: 消息内容)
  • 仓库页分支选择条 → Semantics(button: true, label: 选择分支)
  • 文案 4 键 × 15 语言。
• 恢复 UI 截屏矩阵：从 2 张样本扩回 26 张（5 页面 × 亮/暗 × 横/竖 = 20， 再加 3 平台 × 亮/暗的首页 = 6）。此前退化成冒烟测试后，UI 改动无法自动发现视觉回归。

变更 / Changed

• 「落盘可见性」统一成一套判定。此前有两处定义：
  • OgLStoragePlan.userVisible：mode != internal（按档位）
  • OgLAppDirs.isUserVisible：tier ∈ {public, desktop}（按路径分级）

  两者在「桌面文档目录不可写、最终落到应用支持目录」时会给出相反结论。 界面接的是前者、测试锁的是后者，两者的一致性未被验证。 现统一为路径分级（唯一来源），SAF 档作为例外单列（用户授权过就可见）。 新增测试把「无论什么档位，可见性都等于按路径分级的结论」钉成回归。

• OgLAppDirs.categoryFolder 补上 artifact 映射。此前漏了 Action 构建产物， 一旦被用到会静默落到 other/ —— 用户看不到任何异常，只是分类目录不对。 补上映射，并新增测试把底座与中枢两份映射逐枚举比对（新增分类漏改一侧立刻红灯）。 死代码转为防漂移护栏。

修复 / Fixed

• window_windows.dart 缩进损坏：第 27/29/30 行等顶格，Linux 同位置正常。 应是 v6.0.1 删除注入脚本那次重构的残留。
• app_dirs.dart 注释与代码矛盾：_resolveRoot() ② 档注释原说应用外部目录 「文件管理器可见」，而 isUserVisible() 明确判为不可见（Android 11+ 隐藏 Android/data/）。注释会误导后续维护，已改为准确描述并说明为何仍选它作退路。
• appTitle 三份字面量重复（windows / linux / macos）：值上收到 window_capability.dart 的 kOgLAppTitle，各平台保留同名常量指向它 （不删符号），消除标题不一致的可能。

已知限制 / Known limitations

• 音频不做内置播放：Contents API 对超过 1 MB 的文件不返回内容，音频必然超限。 预览页给出「下载」动作，之后可在下载管理页交给系统播放器。
• Linux 裸放安装包仅 3 / 6：deb（amd64 / arm64）与 rpm（x86_64）已产出； rpm（arm64）因 Ubuntu 的 rpm 缺少 aarch64 平台定义、无法在 x86_64 宿主上交叉构建； 两个 AppImage 因 appimagetool 未接受到 ARCH 环境变量而退出码 1。 三种包在 zip / 7z 里都齐全，功能不缺，只是未裸放直传。详见「产物」一节。
• 14 种语言的加速协议文本仍为旧版（zh 已改，键集合未变故门禁通过）。 法律 / 隐私文本在 15 种语言下不一致是合规风险，需按既定流程补齐。
• 私有仓库的 raw 内容无法走加速（README 仓库内图片、仓库文件）：raw 端点 没有签名机制，交给代理等于送令牌。这是硬约束。
• macOS / iOS 自 v5.6.0 起弃用。
• Linux 需要 glibc ≥ 2.35（Ubuntu 22.04 一代及以上）。

产物 / Artifacts

Android arm64-v8a / armeabi-v7a / x86_64 / universal-APK / AAB、 Windows x64 / arm64、Linux x64 / arm64，每份均含 zip 与 7z。

Linux 裸放安装包：本版只产出了 3 / 6（如实说明）

| | amd64 / x86_64 | arm64 | |—|—|—| | .deb | ✅ | ✅ | | .rpm | ✅ | ❌ Ubuntu 的 rpm 缺少 aarch64 平台定义，无法交叉构建 | | .AppImage | ❌ | ❌ appimagetool 声称未收到 ARCH，退出码 1 |

三种包在 zip / 7z 里都齐全，功能不缺，只是未裸放直传。 裸放安装包是 v6.2.0 才开始产出的（此前从未真正发布过），缺失项后续补齐。

下载 / Download

本版本共 23 个构件产物。

Android

Windows

Linux

完整列表与校验信息见 Releases v6.3.0。

新增 / Added

• 桌面自绘窗口：自研标题栏（拖拽 / 双击最大化 / 最小化·最大化·关闭），可在设置菜单回退系统窗口管理器。 Custom desktop window: our own title bar (drag / double-click maximize / min / max / close), with a fallback to the system window manager in Settings.
• 桌面图标与原生标题：Windows 生成 256 单帧 ICO，Linux 生成 2048 PNG 母版，原生窗口标题统一为 OhGithubLost。 Desktop icon & native title: a single-frame 256 ICO for Windows, a 2048 PNG master for Linux; the native title is OhGithubLost everywhere.
• Linux 安装包：.deb / .rpm / .AppImage，在 Release 中裸放直传。 Linux packages: .deb, .rpm and .AppImage, uploaded raw in the Release.
• Windows 长路径三层处理：\\?\ 前缀绕过 → 超限收纳为 TooLongRoad_<8位>.zip → 根目录 .ogl_toolong.json 索引，读 / 写 / 删 / 列全部可还原。 Windows long paths in three layers: \\?\ prefix bypass → overflow packed into TooLongRoad_<8-hex>.zip → .ogl_toolong.json index; read / write / delete / list all round-trip.

修复 / Fixed

• Linux 产物长期构建不出来：原先在 ubuntu:20.04 容器内构建，而该版本已 EOL、archive 源缓慢易超时；且”容器失败回退宿主构建”的兜底等于把全量编译跑两遍——曾使该腿运行 5 小时 50 分后失败。现在 x64 腿固定 ubuntu-22.04、arm64 腿 ubuntu-24.04-arm，宿主直编；并给 build job 加 45 分钟超时兜底。 Linux artifacts could not finish building: they were built inside an ubuntu:20.04 container that is now EOL (slow, timeout-prone archive mirrors), and the “fall back to a host build” path effectively compiled everything twice — one leg ran for 5h50m before failing. The x64 leg is now pinned to ubuntu-22.04 and the arm64 leg to ubuntu-24.04-arm, building directly on the host; the build job also gained a 45-minute timeout.
• README / Markdown 里的链接点了没反应：相对地址（LICENSE、docs/x.md、#锚点、裸域名）先按仓库基址解析成绝对地址再交给系统浏览器；解析不了会明确提示。 Links in README / Markdown did nothing: relative targets are now resolved against the repository base before opening, and unresolvable ones are reported instead of failing silently.
• README 图片不显示：改为经 GitHub Contents API 取字节后用 Image.memory 渲染，不经过 raw.githubusercontent.com，避开 DNS 污染；<img src=…> 也会渲染；单次上限 40 张，失败退化为 alt 文本。 README images never showed: they are now fetched through the GitHub Contents API and rendered with Image.memory, avoiding raw.githubusercontent.com DNS pollution; <img src=…> is rendered too, capped at 40 images per view with an alt-text fallback.
• Windows 缓存崩溃：缓存 blob 文件名原样拼接编码键，其中 | 是 Windows 非法文件名字符；改为 sha256(编码键)。 Windows cache crash: blob names embedded the raw encoded key and | is illegal on Windows; now sha256(key).
• 设置页退出登录入口重复（危险区已在用户页）。 Duplicate sign-out entry in Settings.

变更 / Changed

• 设置页重新分层：根级一律取消折叠、严格排序；分类下拉移入二级且默认收起。 Settings re-layered: no collapsing at the root and a strict order; category dropdowns moved down a level and collapsed by default.
• 赞助入口并入「关于」页。 The sponsor entry moved into About.

已知限制 / Known limitations

• glibc ≥ 2.35（对应 Ubuntu 22.04 一代及以上；Linux 产物在 ubuntu-22.04 / ubuntu-24.04-arm 宿主上直接构建以锁定该下限）。

  glibc >= 2.35 (Ubuntu 22.04 era and newer; Linux artifacts are built directly on ubuntu-22.04 / ubuntu-24.04-arm hosts to pin that floor).

• Windows 建议开启长路径支持（非必须，超限有收纳回退）；桌面 32 位、musl、Windows 7 / 8.1 均不支持。 Windows: enabling long-path support is recommended (not required). Desktop 32-bit, musl and Windows 7 / 8.1 are unsupported.

产物 / Artifacts

• Android：arm64-v8a、armeabi-v7a、x86_64、universal APK、AAB
• Windows：x64、arm64
• Linux：x64、arm64（deb / rpm / AppImage 裸放）

压缩包统一命名为 OGL-v6.0.0-<平台>.<架构>.zip / .7z，zip 与 7z 双份、极限压缩。 完整逐版本日志：https://yingo-server.github.io/OhGithubLost/

下载 / Download

本版本共 20 个构件产物。

Android

Windows

Linux

完整列表与校验信息见 Releases v6.0.0。

架构决策 / Architecture

• Web 端独立：独立分支 web + 独立 lib/ + 独立 workflows。
  • 不共用代码：web 端不复用 main 的 lib/；
  • 不共用 actions：web 端不跑 build.yml / ci.yml；
  • 允许反复失败：web 失败不影响 main 的五平台构建与发布。

    Web lives on its own branch with its own lib/ and its own workflows — no shared code, no shared actions, and it may fail as often as it needs without ever affecting the five-platform release.

• 平台能力下沉为原生实现（下一阶段）：原先由 action 里的 inject_*.py 改平台工程的做法，改为原生 Dart 实现，action 退化为可选编译开关。 Platform capabilities move from action-time injection to native Dart implementations; actions degrade to opt-in compile switches.

变更 / Changed

• 内置加速通道改走 gh.felicity.ac.cn 转发完整 GitHub 链接：优先前缀由 https://gh.344977.xyz/ 改为 https://gh.felicity.ac.cn/https://github.com/； https://gh.felicity.ac.cn/ 保留为降级备选，仍按序探测并静默降级， 最后永远保留直连兜底。 The built-in channel now forwards the full GitHub link through gh.felicity.ac.cn; the bare host stays as a silent-fallback option.
• 更新日志站（changed/）全部 Release 下载链接改为同一形式。 All changelog-site download links now use the same form.

移除 / Removed

• 实验性 Web（wasm）构建管线从 main 移除：Web 改由独立分支承接。 The experimental Web (wasm) pipeline is removed from main; Web moves to its own branch.

新增 · Added

• 交互层类型门面 · Surface type facade 新增 lib/surface/types.dart：UI 只能看到 DTO / 枚举 / 异常，服务类（GhClient / GhAuthService / IxDownloadManager / IxSession / IxNotificationCenter）被 hide，一律经 SurfaceBridge 取用；15 个页面 / 组件改为只 import 门面。
  Added lib/surface/types.dart: the UI sees only DTOs, enums and exceptions, while service classes are hidden behind a facade and reached exclusively through SurfaceBridge. Fifteen pages/components now import only the facade.

• 下载能力上桥 · Download capabilities on the bridge SurfaceBridge 提供 downloadTasks / downloadsListenable / pause|resume|retry|cancel|removeDownload / clearFinishedDownloads，下载页不再接触管理器实现。
  SurfaceBridge now exposes task listing, a listenable, pause/resume/retry/cancel/remove and “clear finished”, so the download page never touches the manager implementation.

• 15 种界面语言 · 15 UI languages zh / zh_TW / en / ja / ko / fr / de / es / pt / ru / ar / hi / th / vi / id：27 个页面 / 848 条中文文案由人工按语境撰写（GitHub / Release / Actions / PR / Token / Pages 等术语不译），其余 14 种语言 AI 按语种合并生成，校验 15 × 27 / 13065 键，0 问题。首次启动跟随系统语言（繁体系统 → zh_TW），设置页即时切换、选择落盘。
  Chinese copy for 27 pages (848 strings) was authored by hand with terminology deliberately left untranslated; the other 14 locales were generated per-language in a single merged request each and validated with zero issues (15 × 27 pages / 13,065 keys). First launch follows the system language (traditional Chinese systems get zh_TW); switching in Settings applies instantly and persists.

• 可执行门禁 · Executable quality gates tool/layer_audit.py --fatal（依赖只能 surface → domain → base → kernel）与 tool/i18n_scan.py --check（界面文案 0 遗漏 / 分片键集合与 zh 一致）已接入 CI；新增维护手册 docs/I18N.md。
  Added to CI: a layer audit (dependencies may only point downwards) and an i18n audit (no unlocalised UI copy; shard key sets identical to the source locale). A maintenance handbook ships as docs/I18N.md.

变更 · Changed

• 共享抽象上提到 kernel/contract/（disk_store / disk_types / net_types，原路径保留转发导出），逻辑层改依赖契约；待收敛项由 11 处降至 2 处（仅剩两个实现类）。
  Shared abstractions moved into kernel/contract/ with forwarding exports kept at the old paths, and the domain layer now depends on the contracts; outstanding convergence items dropped from 11 to 2 (two implementation classes remain).
• 交互层界面文案 0 处未本地化；剩余约 405 处中文均为开发者日志 / 诊断（按设计保留）。
  There is now zero unlocalised UI copy; the ~405 remaining Chinese strings are developer logs and diagnostics, kept in Chinese by design.

已知限制 · Known limitations

• 本版本为预发布（pre-release），仅结构与多语言改动，请以稳定版为准。
  This is a pre-release containing architecture and localisation changes only; prefer a stable build for daily use.
• 翻译由 AI 产出并经过格式与占位符校验，但未逐条人工校对；如发现措辞问题请反馈。
  Translations are AI-produced and validated for structure and placeholders, but not line-by-line human-reviewed; please report wording issues.
• 个别上下文相关文案（如通知正文）可能与实际场景存在细微语感差异。
  A few context-sensitive strings (e.g. notification bodies) may read slightly off in specific scenarios.
• 5.0 待办：下载多线程与进度/速度动画、页面过渡卡顿、Actions 长日志加载、通知中心图标与展开动画、安卓返回键统一处理。
  Planned for 5.0: multi-threaded downloads with progress/speed animation, page-transition jank, long Actions logs, notification-centre icons & expand animation, unified Android back-key handling.

产物 · Artifacts

Android（arm64-v8a / armeabi-v7a / x86_64 / universal APK / AAB）、Windows、Linux、macOS、iOS，以及引导清单 boot-manifest.zip —— 共 19 个文件；APK 文件名与版本名一致（OGL-v4.9.0-app-*）。
Android (arm64-v8a / armeabi-v7a / x86_64 / universal APK / AAB), Windows, Linux, macOS, iOS plus the signed boot manifest — 19 files in total; APK names match the version (OGL-v4.9.0-app-*).

下载 / Download

本版本共 19 个构件产物。

Android

Windows

Linux

macOS

iOS

完整列表与校验信息见 Releases v4.9.0-beta。

已被取代 · Superseded：本 beta 的产物构建于内核一致性硬化之前； 请直接使用 v5.1.0（正式版） ——它包含本版全部内容 + OGL-BOOT-108 交叉校验。 These artifacts predate the kernel hardening; use v5.1.0 instead.

主题 · Theme — 交互与体验打磨（不加新功能面）：多连接下载、过渡卡顿修复、长日志虚拟化、通知中心去符号、返回键统一。 Interaction and feel: multi-connection downloads, transition jank fix, virtualised long logs, emoji-free notification centre, unified back key.

新增 · Added

• 多连接分片下载 · Multi-connection chunked download 用 Range 请求把文件切成至多 N 片并发拉取，最后顺序合并；每片写独立临时文件（规避”共用文件句柄错位写坏”），任一分片失败即删除全部分片——不交付不完整的文件。服务端不支持 Range 时自动回退单连接（同 taskId，页面无感知）。
  Chunked downloads fetch up to N ranges in parallel and merge sequentially. Each part has its own temp file (avoiding the old shared-handle corruption), and any failing part deletes every part — never a half-written file. Servers without Range support fall back to a single connection transparently.
• 「下载并发连接数」设置 · Download connections setting 设置 → 网络：1 / 2 / 4 / 8（默认 4）；非法值回落默认。
  Settings → Network: 1 / 2 / 4 / 8, default 4; invalid values fall back to the default.
• 权限自检（每次启动）· Permission self-check on every launch 每次启动实测存储（真实写入探针）与通知权限；缺失时以 warn + 事件码（OGL-PERM-001 / 002 / 000）进通知中心；「关于 → 启动诊断」新增权限自检折叠组。
  Every launch re-tests storage (real write probe) and notification permissions. Missing ones are reported as warnings with event codes through the notification centre; About → boot diagnostics gains a permission self-check section.
• 内核「清单 ↔ 运行期模块」交叉校验 · Manifest coverage cross-check 清单声明了某模块、装配时却没提供它 → 记为 OGL-BOOT-108（此前会静默放过）。
  If the manifest declares a module that is never assembled, it is now recorded as OGL-BOOT-108 (previously silent).

变更 · Changed

• 页面过渡改为单层淡入 + 轻位移 · Page transitions rebuilt 去掉整页缩放（ZoomPageTransitionsBuilder 要求整页反复重新光栅化，正是”只有页面过渡卡”的根因），并强制 RepaintBoundary：过渡期间只重合成、不重绘页面内容。
  Dropped whole-page scaling (the root cause of transition-only jank) in favour of a single fade + slight offset, wrapped in RepaintBoundary so transitions only re-composite instead of repainting.
• Actions 长日志分块虚拟化 · Virtualised long logs 按行分块（120 行/块）交给 ListView.builder 按需渲染，并显示「共 N 行」。
  Logs are chunked by line (120 per chunk) and rendered on demand, with a total-line count shown.
• 通知中心去掉 emoji 风格符号 · Emoji-style glyphs removed ✔ / ▶ / ✗ / ★ 等不再出现在用户可见文案里（改由图标与 level 承载），详情展开带动画。
  Symbols like ✔ / ▶ / ✗ / ★ no longer appear in user-visible copy (icons and log levels take over), and detail expansion is animated.
• 安卓返回键统一 · Unified back key 二级页 / 弹窗 → 抽屉 → 回首页 tab → 首页第一次提示「再按一次退出」、窗口内第二次才退出；一次误按不会退出应用。
  Nested routes/dialogs → drawer → home tab → on home, first press asks for confirmation and only a second press within the window exits.

修复 · Fixed

• 修掉「页面过渡卡顿」根因（见上）。
• 修掉IxDownloadManager 在分片任务下的暂停 / 取消 / 重试语义（走取消令牌；不产生错位文件）。
• 修掉通知/日志正文里的符号字形（Android 上会被当 emoji 渲染，即用户报告的”emoji 撕裂”）。

已知限制 · Known limitations

• 本版本为 beta 预发布：请以正式版为准。
  This is a beta pre-release; prefer a stable build for daily use.
• 分片下载的暂停 = 重新开始（不声称续传）；单连接库任务的断点续传不受影响。
  Pausing a chunked download restarts it rather than resuming; single-connection library tasks keep true resume.
• 桌面端仍使用库下载（分片引擎按 Range 能力自动判定，不支持则回退）。
  Desktop keeps using the library downloader; the chunk engine falls back whenever the server lacks Range.

产物 · Artifacts

Android（arm64-v8a / armeabi-v7a / x86_64 / universal APK / AAB）、Windows、Linux、macOS、iOS，以及引导清单 boot-manifest.zip —— 共 19 个文件。 Android (arm64-v8a / armeabi-v7a / x86_64 / universal APK / AAB), Windows, Linux, macOS, iOS plus the signed boot manifest — 19 files in total.

下载 / Download

本版本共 19 个构件产物。

Android

Windows

Linux

macOS

iOS

完整列表与校验信息见 Releases v5.0.0-beta。