新增 / 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 源极慢易超时；且”容器失败回退宿主构建”的兜底等于把全量编译跑两遍——曾把 Linux 腿挂死 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 hung for 5h50m. 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 — please do not waste time trying.

产物 / 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。

新增 · 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。

与 5.0.0-beta 的关系 · Relationship：本版包含 v5.0.0-beta 的全部内容，并补上内核交叉校验。 直接升级到 5.1.0 即可，无需先装 beta。 This release includes everything in v5.0.0-beta plus the kernel cross-check. Upgrading straight to 5.1.0 is enough.

新增 · Added

• 内核一致性硬化：清单 ↔ 运行期模块交叉校验 · Manifest coverage cross-check 一次性对抗性探针（跑在独立 CI 分支上）发现：引导清单里声明了某模块、装配时却没有提供它这种情况，此前既不拒绝也不留痕——应用”看起来正常”，实际少了一整层能力。现在内核在封存总线后逐一比对，缺失项记为 OGL-BOOT-108（warn 级诊断 + 引导信任告警）：仍可启动，但一定留痕，不误伤可用性。附回归用例。
  A throwaway adversarial probe on its own CI branch found that a module declared in the boot manifest but never assembled was previously accepted silently. The kernel now cross-checks the manifest against the modules actually provided and records OGL-BOOT-108 (warn-level diagnostic + boot trust warning): boot still succeeds, but nothing is silent. Covered by a regression test.

• 多连接分片下载 · Multi-connection chunked download 用 Range 请求把文件切成至多 N 片并发拉取，再顺序合并；每片写独立临时文件（规避”共用文件句柄错位写坏”），任一分片失败即清理全部分片——绝不交付半成品；服务端不支持 Range 时自动回退单连接（同 taskId，页面无感）。新增设置「下载并发连接数」（1/2/4/8，默认 4）。
  Files are split into up to N ranges fetched in parallel and merged sequentially. Each part uses its own temp file, and any failing part deletes every part — never a half-written file. Servers without Range support fall back to a single connection transparently. New setting: download connections (1/2/4/8, default 4).

• 权限自检（每次启动）· Permission self-check on every launch 每次启动实测存储（真实写入探针）与通知权限，缺失时以 warn + 事件码（OGL-PERM-001 / 002 / 000）进通知中心；「关于 → 启动诊断」新增权限自检折叠组。
  Storage (real write probe) and notification permissions are re-tested on every launch; problems are reported as warnings with event codes, and About → boot diagnostics gains a permission section.

变更 · Changed

• 页面过渡重做为单层淡入 + 轻位移 · Page transitions rebuilt 去掉整页缩放——ZoomPageTransitionsBuilder 要求整页在过渡期间反复重新光栅化，正是”只有页面过渡卡、其它动画不卡”的根因；同时强制 RepaintBoundary，过渡期间只重合成、不重绘页面内容。
  Whole-page scaling is gone (it forced full re-rasterisation each frame — the exact reason transitions stuttered while other animations did not), replaced by a single fade + slight offset inside a RepaintBoundary.
• Actions 长日志分块虚拟化 · Virtualised long logs 按行分块（120 行/块）交给 ListView.builder 按需渲染，并显示「共 N 行」。
  Logs are chunked by line (120/chunk) and rendered on demand, with a total line count.
• 通知中心去掉 emoji 风格符号 · Emoji-style glyphs removed ✔ / ▶ / ✗ / ★ 不再出现在用户可见文案里（改由图标与日志级别承载），详情展开带动画。
  Symbols like ✔ / ▶ / ✗ / ★ are gone from user-visible copy (icons and log levels take over), and detail expansion is animated.
• 安卓返回键统一 · Unified Android back key 二级页 / 弹窗 → 抽屉 → 回首页 tab → 首页第一次提示「再按一次退出」、窗口内第二次才退出；一次误按不会退出应用。
  Nested routes/dialogs → drawer → home tab → confirm-then-exit on home; a single stray press never quits the app.

修复 · Fixed

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

已知限制 · Known limitations

• 分片下载的暂停 = 重新开始（不假装续传）；单连接库任务的断点续传不受影响。
  Pausing a chunked download restarts it rather than resuming; library tasks keep true resume.
• 桌面端仍使用库下载（分片引擎按 Range 能力判定，不支持则回退）。
  Desktop keeps the library downloader; the chunk engine falls back when Range is unsupported.
• 翻译由 AI 产出并通过格式 / 占位符校验，但未逐条人工校对。
  Translations are AI-produced and validated for structure and placeholders, not line-by-line reviewed.

产物 · 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.1.0。

变更 · Changed

• 动效改成「按档位给质量」· Animation tiers now mean quality 每一档都保留完整动效，只是开销逐级降低；档位 0 静默但内容依旧完整呈现：

  档位	快/中/慢	入场效果	错峰项数	过渡位移	缩放	模糊
  0 静默	0 / 0 / 0	无	0	0	无	无
  1 保守（默认）	110 / 150 / 190 ms	只淡入	前 4 项	0.012	无	无
  2 标准	170 / 220 / 280 ms	淡入 + 轻位移	前 9 项	0.035	无	无
  3 拉满	220 / 300 / 380 ms	淡入 + 位移 + 轻微缩放	前 17 项	0.06	0.99 / 0.985	≤6

  Every tier keeps the full vocabulary; only cost drops. Tier 0 is silent but shows all content. 设置项文案随之改为 静默 / 保守 / 标准 / 拉满（15 种语言同步，写清每档做了什么）。

• 入场动画按档位限项 · Bounded entrance animation OgLAnim.staggerOf() 对超出档位上限的序号返回 null，OgLReveal 见到 null 直接静态渲染。此前长列表的每一项都挂动画、且越靠后的项越晚——这是”列表滑动发涩”的常见来源。
• 长列表懒加载 · Lazy long lists 5 处数据驱动长列表改用懒加载（其余保持急加载的已在审计里登记理由）： 仓库文件列表 / PR 文件 / 提交文件 → CustomScrollView + SliverList.builder； 议题评论 → OgLAsyncSliver；Actions 作业 → SliverList.builder。 Five data-driven lists now build rows on demand instead of eagerly; bounded lists are explicitly registered in the audit with reasons.
• 窄 MediaQuery 选择器 · Narrow selectors OgLAnim.enabled 改用 MediaQuery.disableAnimationsOf：列表项不再因为键盘 / 旋转 / insets 变化整列重建。
• 隐藏页停表 · Offscreen pages stop ticking 切 tab 时给隐藏页套 TickerMode(enabled: false)。
• 主题缓存 · Theme cache 主题按（亮度 + 种子色 + 密度 + 动效档位）缓存，避免每次重建 ThemeData。
• 日志通知合并 · Coalesced log notifications 批量写日志时把通知合并为同一事件循环一次（微任务，不引入计时器；数据仍逐条入表）。

新增 · Added

• 内核一致性硬化：清单 ↔ 运行期模块交叉校验 · Manifest coverage cross-check 引导清单声明了某模块、装配时却没提供它，此前既不拒绝也不留痕；现在记为 OGL-BOOT-108（warn 级诊断 + 引导信任告警）——仍可启动，但一定留痕。附回归用例。 Found by a throwaway adversarial probe: a declared-but-never-assembled module is now recorded as OGL-BOOT-108 instead of passing silently.
• CI 门禁扩到四个维度 · Four CI gates layer_audit（依赖只能向下）、i18n_scan（界面文案 0 遗漏 / 分片键集合一致）、 motion_audit（动画必须走档位质量表，禁止硬编码时长 / 缩放 / 模糊）、 perf_audit（禁止 shrinkWrap 与过宽 MediaQuery.of）。

修复 · Fixed

• 修掉 issue_page 在列表懒加载改造中丢失「发表评论」输入区的问题 （由 CI 的 unused_element 警告当场拦下，已按原文恢复）。
• 修掉主题切换 / 切换 tab / 下载进度 / 引导翻页绕开档位硬编码时长的问题。

已知限制 · Known limitations

• 分片下载的暂停 = 重新开始（不假装续传）；单连接库任务的断点续传不受影响。
• 数量有界的列表（关于 / 账号 / Gist 文件 / Release 附件 / 工作流 inputs / 分支弹层） 刻意保持急加载：数据量小，懒加载反而多一层每帧判断。
• 桌面端仍使用库下载；分片引擎按 Range 能力自动判定。
• 翻译由 AI 产出并通过格式 / 占位符校验，未逐条人工校对。

产物 · 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.2.0。

变更 · Changed（动效 · Motion）

• 大体积动画：更快 / 更灵动 · Large-surface motion, faster and livelier
  • 全页过渡改为「视觉窗口」压缩：不改路由时长（保留系统返回手势语义），把”实际运动”压进路线时间线的前 42% / 55% / 70%（按档位）。
  • 三档时长整体下调（标准档 150 / 220 / 300 → 120 / 170 / 230 ms）；新增的大体积动画时长同样逐档增加但都 ≤ 200ms：外壳切换 110/150/190ms、整页状态切换 110/140/180ms、引导翻页 160/200/260ms、底部弹层 130/160/200ms（均快于 Flutter 底部弹层默认 250ms）。
  • 新增 OgLSurfaceSwitch（大体积内容切换）与 ogLShowSheet<T>()（弹层统一定速入口），5 处底部弹层已改用它。
• 曲线一律「自然减速」· Natural deceleration everywhere 去掉所有匀速（Curves.linear）：三档走 ease-out 阶梯（easeOut → easeOutCubic → easeOutQuart，大体积再各进一档到 easeOutQuint）——起手快、落位柔。切 tab 的整页位移也从”控制器直驱匀速”改为走档位曲线。
• 物理动效（基础版）· Physics-based motion (basic)
  • 物理弹簧 + 可中断：新增 OgLSpring（SpringSimulation 驱动），切 tab 改为弹簧——由刚度 / 阻尼而非固定时长决定运动，天然可打断 / 可续跑（”跟手”）；阻尼比逐档递减（档位 1 临界阻尼不振荡，档位 2 / 3 轻微回弹）。
  • 轻微回弹（”Q弹”）：新增 settleCurve，只作用在位移 / 缩放上（拉满档用 easeOutBack）；透明度插值保持单调，绝不回弹。
  • 共享元素（容器变换）：新增 OgLSharedTitle，把仓库列表的名称与仓库详情的标题连成一次 Hero 飞行；标准档及以上启用。

• 全覆盖动效 + 覆盖面分档 · Full coverage & coverage tiers 分档从”效果强弱”扩展为「覆盖 × 丰富度」（新增 revealAll）：

  档位	覆盖面	效果
  0 静默	无	无
  1 保守（默认）	主要区域 + 前 3 项	纯淡入
  2（倒数第二档）	每个控件都动	最简：纯淡入（不位移、不缩放）
  3 拉满	每个控件都动	淡入 + 位移 + 缩放 + 回弹 + 模糊

  • OgLAnim.staggerOf：超出错峰范围的项在全覆盖档位仍参与动画（只是不再错峰），不再是”直接静态渲染”。
  • AsyncView 数据态加入场：加载 → 数据不再”硬切”，整片内容淡入（单子层的 OgLReveal，放进 Expanded 也不会无界）。
  • 静态页 / 表单页补齐入场：设置 / 关于 / 登录 / 四个新建页 / 代码编辑器 / 议题 / PR / 提交 / Release 详情页的内容统一包一层入场动画；Gist 列表逐项入场。
  • 新增 OgLRevealList.of(context, children)：把一串子控件逐个包上入场动画（自动错峰）。

修复 · Fixed（统计曲线 · Stat charts）

• 纵轴不再按极值拉伸：旧实现取各自 min..max 满高绘制（3→4 也能画成”垂直暴涨”，且星标图和提交图量纲不同却看起来同量级）；现在从 0 起、上限取整齐刻度（1 / 2 / 2.5 / 5 × 10ⁿ）、5 条刻度线并标注数值。
• 补上坐标系与单位：图内有标题行（STARS (COUNT) / COMMITS (COUNT)）、纵轴单位、最新值标记与来源说明。
• 横轴改为真实时间：按 UTC 时间戳线性映射（旧实现按索引等距，采样不均时时间被拉伸 / 压缩），标注 MM-DD HH:MM；计数类小范围改用整数刻度（不再出现”1.2 个星标”）；图内文字放大到 2×。
• 新增图表自检 --selftest（含落墨像素断言，不依赖 OCR），已接入 stats.yml 与 ci.yml；历史点容错、降采样、README 图注重写（中英对照）。

已知限制 · Known limitations

• 「每个控件」的粒度：当前落在内容块 / 列表项（页面 body、列表 item、异步数据态），不是逐个叶子控件（每个图标按钮 / 文本）；Material 控件本身已有水波纹等反馈动画。
• 弹簧 / 共享元素按档位生效：切 tab 的弹簧在档位 1 为临界阻尼（不振荡）；共享元素仅标准档及以上启用，低档位退回普通页面过渡。
• 分片下载的暂停 = 重新开始（不假装续传）；单连接库任务的断点续传不受影响。
• 数量有界的列表（关于 / 账号 / Gist 文件 / Release 附件 / 工作流 inputs / 分支弹层）刻意保持急加载：数据量小，懒加载反而多一层每帧判断。
• 桌面端仍使用库下载；分片引擎按 Range 能力自动判定。
• 翻译由 AI 产出并通过格式 / 占位符校验，未逐条人工校对。

产物 · 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.3.0。

新增 · Added（存储 · Storage）

• 三档落盘 · Three storage tiers

  档	条件	落点	用户可见	自检
  ① 公共目录	有「所有文件访问」	/storage/emulated/0/ogl	✅	过
  ② SAF 文件夹	用户授权了文件夹	私有目录 → 导出粘贴到该文件夹	✅	过
  ③ 应用内部	两者都没有	应用私有目录	❌	不过（不阻断）

• SAF 的落地方式：下载照旧写应用私有目录（分片 / 断点续传 / 后台通知全部零改动），完成之后用 SafStream.pasteLocalFile 把成品粘贴进你自己选的文件夹。这样”用户看得见”与下载实现解耦，不需要重写下载引擎。 Downloads keep writing to the app-private directory (sharding / resume / background notifications untouched); the finished file is then pasted into the folder you picked.

• 设置 → 存储位置：如实显示当前档位与实际路径，并提供「选择文件夹（SAF）」「取消文件夹授权」「打开『所有文件访问』设置」。
• 新增事件码 OGL-DL-301（已导出到所选文件夹）。

变更 · Changed（引导 / 设置 · Onboarding & settings）

• 引导页新增第 1 步「语言与外观」：语言与明暗模式在引导里首次设定、改完即时生效；引导不含登录——按商业规范，登录不属于引导流程。
• 登录页左上角新增入口，可随时重新触发引导（回顾模式：不改动”已引导”标志，也不影响登录状态）。
• 网络设置独立成页（DNS / 下载并发 / 加速通道），不再是一个可折叠分组。
• 开源许可合并为一条，打开时弹窗（本项目 + 第三方依赖）。
• 加速通道内置优先链：内置通道 = gh.344977.xyz（优先）+ gh.felicity.ac.cn（降级），用户不可调整；下载时逐个探测、静默降级，最后永远保留直连兜底。

变更 · Changed（图标 / 命名 / 平台 / 产物）

• 应用图标改为矢量、背景透明：几何形状的唯一事实来源是 assets/icon/ogl_icon.svg； Android 用矢量 XML（VectorDrawable 前景 + 自适应图标，背景 @android:color/transparent），不再依赖多倍率 PNG。
• 应用名：Android = OGL；其余平台 = OhGithubLost。
• 平台调整：自 5.6.0 起弃用 macOS 与 iOS（不再构建、不再发布）； 最后支持版本 = v5.3.0。 其余平台补齐 ARM：Windows（x64 / arm64）、Linux（x64 / arm64）， 且 arm64 由”尽力而为”改为正式腿（失败即阻塞发布）。

  桌面端没有 32 位目标（上游 Flutter 只提供 x64 / arm64）， 32 位产物仅 Android 有（armeabi-v7a）。

• Release 只提供压缩包：每个平台产物同时给出 .zip 与 .7z， 且都用极限压缩（zip -9 / 7z -mx=9）；不再直传裸 APK / AAB / 平台目录。

修复 · Fixed

• 存储权限”假装已授权”：探针以前探的是回退之后的目录，退回应用私有目录也会被判成”已取得权限”。现在改为探测用户可见性（Android/data 与内部存储一律不算可见）。
• “给了所有文件权限仍用内部存储”：根目录结果被进程级缓存，授权后不会重新解析；现在探针前会 invalidate() 并重新解析。
• 按 Android 版本如实说明：未就绪时说明会追加”为什么”（Android 11+ 需要「所有文件访问」；部分 ROM 只支持逐个授权文件夹）与”现在落在哪”（实际路径）。
• 修正内置通道名称的文案分片（应取 common 分片），此前可能显示成键名。

已知限制 · Known limitations

• SAF 只作用于下载成品（导出到所选文件夹）；日志与缓存仍在应用私有目录。
• ② 档下导出是下载完成后的一次性复制，大文件会多占用一份临时空间。
• 「所有文件访问」开关由系统 / ROM 决定，部分设备确实不提供——此时请用 SAF 文件夹。
• 数量有界的列表刻意保持急加载；分片下载的暂停 = 重新开始。
• 翻译由 AI 产出并通过格式 / 占位符校验，未逐条人工校对。

产物 · 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

本版本共 20 个构件产物。

Android

Windows

Linux

完整列表与校验信息见 Releases v5.6.0。

新增 · Added

• 设置页重构 · Settings rebuild 改为可折叠分组、默认收起，并补充更多设置项与子项。
  Rebuilt around collapsible groups that start collapsed, with more settings and sub-items.
• 动效档位设置 · Motion level setting 提供「最小 / 当前 / 标准 / 增强」四档，接入页面过渡与减少动效。
  Four levels (minimal / current / standard / enhanced) wired into page transitions and reduced motion.
• 关于页 · About page 整理为设置页内的独立页面：项目名称、主要开发者、版本、仓库地址、未来扩展与启动诊断。
  Now a standalone page inside Settings: project name, lead developer, version, repository URL, roadmap and boot diagnostics.
• 「捐赠一颗心」· Donate a star 二次确认后，用当前登录账号为本仓库加星；已 star 时不重复操作。
  After a confirmation, stars this repository with the signed-in account; a second attempt is a no-op.
• 开源许可与日志栏目 · Licence and log sections 「开源许可」列出本项目许可（AGPL-3.0）与第三方依赖；「日志」给日志文件位置与复制入口。
  The licence section lists the project licence (AGPL-3.0) and third-party dependencies; the log section shows file locations and a copy action.

变更 · Changed

• 首页移除无响应的刷新按钮，保留下拉刷新。
  Removed the non-functional refresh button on the home page, keeping pull-to-refresh.
• 写入与删除带基线校验：冲突时先提示，再由用户决定是否覆盖。
  Writes and deletes validate against the baseline SHA and, on conflict, ask the user before overwriting.
• 开源许可切换为 AGPL-3.0；新增星标与提交历史图表（见仓库首页）。
  Switched to AGPL-3.0 and added star/commit history charts to the repository home page.
• 清理部分过时文案。
  Cleaned up outdated copy.

已知限制 · Known limitations

• 多语言仍是骨架：15 种语言的分片结构自 2.2.0 起存在，但覆盖面很小（只有少量已抽取文案）；界面文案的完整本地化在 4.9.0 才真正落地。
  Localisation remains a skeleton: the 15-locale shard structure has existed since 2.2.0 but covers very little, and complete UI localisation only landed in 4.9.0.
• 动效为逐页接入，尚未覆盖全部页面。
  Motion was wired page by page and does not cover every screen yet.

产物 · Artifacts

Android（arm64-v8a / armeabi-v7a / x86_64 / universal APK / AAB）、Windows、Linux、macOS、iOS —— 共 19 个文件。
Android (arm64-v8a / armeabi-v7a / x86_64 / universal APK / AAB), Windows, Linux, macOS, iOS — 19 files in total.

下载 / Download

本版本共 19 个构件产物。

Android

Windows

Linux

macOS

iOS

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

新增 · Added

• 内建多线程下载器 · Built-in multi-threaded downloader 32 线程分块下载，支持暂停 / 继续 / 取消 / 重试 / 移除；小于 16 MB 的文件一次铺满并发；服务器不支持 Range 时自动退回单流（不硬撑）。下载管理页展示进度与速率，首页右上角加入口。
  Chunked downloads across 32 threads with pause/resume/cancel/retry/remove; files under 16 MB saturate concurrency in one go, and servers without Range support automatically fall back to a single stream. The download manager shows progress and speed, reachable from the home app bar.
• 统一应用根目录 · Unified app root 根目录固定为 ogl：日志落 ogl/logging，下载按分类存放。平台路径适配：Android 优先外部可见目录、不可写时退到应用外部目录，桌面用文档目录。
  Everything lives under ogl: logs in ogl/logging, downloads sorted by category. Paths adapt per platform — Android prefers a visible external directory and falls back to the app-specific one, desktops use documents.
• 编辑器草稿 · Editor drafts 自动保存草稿，再次进入同一文件自动恢复并提醒，提交成功后清除；「我的」页新增草稿箱入口。
  Drafts save automatically, restore with a notice when the same file is reopened, and clear after a successful commit; the profile page gained a drafts entry.
• 通知中心 · Notification centre 首页右上角新增通知中心，可按告警 / 错误筛选、单条复制。
  A notification centre in the home app bar with alert/error filtering and per-entry copy.
• 分步引导 · Step-by-step onboarding 引导改为欢迎 / 权限 / 隐私 / 完成四步。
  Onboarding is now four steps: welcome, permissions, privacy, done.

修复 · Fixed

• 启动接入失败写入重放，不再丢启动期的写入。
  Failed writes during startup are now replayed instead of being lost.
• CNAME 更新改为加锁写入，避免并发写覆盖。
  CNAME updates take a lock so concurrent writes cannot clobber each other.
• 权限网关：Android 存储以真实写入探针主动获取，失败弹窗并跳转系统设置。
  The permission gateway actively probes storage with a real write on Android and, on failure, shows a dialog and opens system settings.

已知限制 · Known limitations

• 本版下载器为自研实现：后续 4.0.0 已替换为成熟库（background_downloader），桌面端下载能力随之变化。
  This downloader is home-grown; 4.0.0 replaced it with background_downloader, which also changed desktop download support.
• Release 附件加速依赖内置代理通道；该通道在 4.3/4.4 起改为设置项并在 4.8.0 以 HTTPS 重做。
  Accelerated Release downloads relied on the built-in proxy channel, later turned into an opt-in setting (4.3/4.4) and reworked over HTTPS (4.8.0).
• 多语言（R6）尚未开始：界面为中文。
  Localisation (R6) has not started yet — the UI is Chinese-only.

产物 · Artifacts

Android（arm64-v8a / armeabi-v7a / x86_64 / universal APK / AAB）、Windows、Linux、macOS、iOS —— 共 19 个文件。
Android (arm64-v8a / armeabi-v7a / x86_64 / universal APK / AAB), Windows, Linux, macOS, iOS — 19 files in total.

下载 / Download

本版本共 19 个构件产物。

Android

Windows

Linux

macOS

iOS

完整列表与校验信息见 Releases v3.1.0。

新增 · Added

• 动效档位体系 · Motion-level system 新增档位作用域与动效工具箱：动画时长与叠加效果按档位 0–3 联动——0 关闭全部动画 / 1 仅淡入 / 2 淡入 + 位移 / 3 再叠缩放（开销随档位递增）。
  Added a scoped motion toolbox where duration and effects follow levels 0–3: off, fade only, fade + offset, and fade + offset + scale (cost grows with the level).
• 入场动画覆盖 · Entrance animation coverage 首页仓库、下载管理、通知中心、草稿箱，以及仓库页的 Issues / Pull Requests / Releases / 分支 / 提交 / Actions 列表统一入场。
  Entrance animations now cover the home repository list, download manager, notification centre, drafts box and the repository page’s issues, PRs, releases, branches, commits and Actions lists.
• 加载 / 空 / 错误三态之间加入淡入淡出，切换不再突兀。
  Loading, empty and error states cross-fade instead of snapping.

变更 · Changed

• 新增 docs/ANIMATION_PLAN.md：把 3.2 的动效任务与性能代价对应起来。
  Added docs/ANIMATION_PLAN.md, mapping the motion work to its performance cost.
• 分段选择位移、对话框曲线、共享元素等交互细项移交 3.3，本次不硬塞。
  Segmented-control sliding, dialog curves and shared elements were explicitly deferred to 3.3 rather than rushed in.

测试 · Tests

• 新增分档与回退测试：时长随档位递增、降到 0 完全回退为零、叠加效果按档位生效。
  Added tests asserting duration grows with the level, drops to zero at level 0, and that stacked effects apply per level.

产物 · Artifacts

Android（arm64-v8a / armeabi-v7a / x86_64 / universal APK / AAB）、Windows、Linux、macOS、iOS —— 共 19 个文件。
Android (arm64-v8a / armeabi-v7a / x86_64 / universal APK / AAB), Windows, Linux, macOS, iOS — 19 files in total.

下载 / Download

本版本共 19 个构件产物。

Android

Windows

Linux

macOS

iOS

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