Thorium 已知缺陷清单解读状态标签体系、11 条 Bug 记录及其修复证据链【免费下载链接】thoriumChromium fork named after radioactive element No. 90. Source code and Linux releases. Windows/MacOS/ARM builds served in different repos, links are towards the top of the README.md.项目地址: https://gitcode.com/GitHub_Trending/th/thorium本文以 Thorium基于 Chromium 的浏览器分支仓库中的 infra/BUGS.md 为主体完整呈现该缺陷跟踪文档中 2021—2022 年的全部 11 条已知 Bug 记录并逐条结合仓库内的补丁文件、GN 构建配置与源码文件还原每条记录背后的修复证据与验证路径。读完本文你将掌握 Chromium 系 fork 项目中发现—记录—缓解—根因修复—上游回流的缺陷闭环流程并学会用仓库内证据快速定位某类跨平台问题Windows 图标/兼容性、AVX 构建符号、Linux HEVC 解码的处理手法。1. 文档定位与条目格式规范infra/BUGS.md 在文档开头对自身定位有明确说明它记录的是影响 Thorium 或 Chromium 可用性的已知缺陷known bugs ... that will affect usability。其记录规范包含两条硬性要求已修复的 Bug 必须在条目末尾带有FIXED标签并附上修复日期发现者/修复者Discoverers/Fixers的署名必须附在条目末尾。文档整体按年份分节2021、2022每条记录采用统一的结构化格式状态标签 | 日期, 缺陷描述 - 报告者署名 | 修复信息若已修复从 infra/BUGS.md 的实际条目中可以归纳出 4 类状态标签各自代表缺陷生命周期的不同终态标签语义典型含义BUG已知且未解决缺陷仍有效等待进一步排查或补丁FIXED已修复附带修复日期与修复者可验证WONTFIX明确不修复说明放弃修复的理由如上游策略限制UNFIXABLE当前架构下无法修复存在客观技术障碍如功能仅限特定平台这种状态 日期 署名的三元组格式使每一条记录都可作为独立证据被检索引用——后文的分析正是基于这一点展开的。2. 2021 年的 6 条记录从平台限制到上游回归2.1 加载 PDF 崩溃浏览器WONTFIXInk 问题infra/BUGS.md#L8 记录11 月 21 日加载 PDF 文件会直接导致浏览器崩溃该问题已持续数个版本。作者曾尝试通过禁用 Ink 来验证是否为根因并在 Chromium 上游缺陷跟踪系统中提交了该问题编辑注记于 2022 年 5 月 28 日补充。最终状态为WONTFIX理由明确Ink 在可预见的将来仅会在 ChromiumOS 上工作。这是一条典型的由上游平台策略决定去留的缺陷对于桌面平台的 Chromium fork涉及 CrOS 专有子系统Ink的功能无法通过 fork 侧修改解决只能标记为不修复将用户的期望管理落在文档层面。2.2 Pulseaudio 在 chroot/代理环境下失效BUG未解决infra/BUGS.md#L10 记录11 月 21 日Pulseaudio 在 chroot 环境例如 ChromiumOS 上的 crouton且背后有代理时无法工作移除 Pulseaudio 相关补丁后问题依旧。报告者为 Reddit 用户 Pierro78。该条目保留BUG状态说明排查已排除本地补丁引入这一假设移除补丁未解决问题更可能出在 chroot 代理这一特定组合环境本身。这条记录展示了缺陷清单的价值之一即使是未解决的条目也沉淀了已排除的排查路径避免后续贡献者重复验证。2.3 设置 enable_cros_media_app 无法启用媒体应用UNFIXABLEinfra/BUGS.md#L12 记录11 月 30 日将args.gn中的enable_cros_media_app设为true并不能像 ChromiumOS 那样启用chrome://media-app。仓库中的 GN 配置为该结论提供了完整佐证docs/ABOUT_GN_ARGS.md 对该开关的说明是启用 CrOS Media AppChromiumOS 上用于播放媒体的原生应用用于替代原生 Files App 的 views 组件。会破坏非 ChromiumOS 构建。应在 ThoriumOS 中启用并注明作者已就相关缺陷向上游提交过 issueinfra/REMOVED_ARGS.txt 记录该开关仅限 ChromiumOS已从大部分 args.gn 中移除但仍为 ThoriumOS 及 cros_args.gn 保留当前仓库中该开关在 arm/android/chromium_args.gn 与 other/CrOS/cros_args.gn 中均被显式设为false。从源码结构看chrome://media-app依赖 ChromiumOS 专有的应用运行时环境普通 Linux 桌面构建即使打开 GN 开关也拿不到完整的运行时支撑因此被判定为UNFIXABLE而非WONTFIX——前者是修不了后者是不修两者的区分本身是缺陷管理规范的体现。2.4 书签栏文件夹文字颜色错误M98 起上游修复infra/BUGS.md#L14 记录从 M98.0.4738.0 起出现书签栏中的书签文件夹文字着色错误12 月 2 日上游修复。该条目是缺陷随版本引入、随上游修复自然消解的代表仓库中未保留本地补丁与上游修复的记载一致修复责任在 Chromium 主干侧fork 侧只需在 rebase 时携带上游提交即可获得修复。条目中标注起始版本号M98.0.4738.0为后续二分定位提供了精确锚点。2.5 Google API Keys InfoBar 补丁失效上游回归已修复infra/BUGS.md#L16 记录12 月 2 日Google API Keys InfoBar 补丁在上游更新startup_browser_creator_impl.cc后失效需评估修复方案12 月 5 日由作者修复。这条记录揭示 Chromium fork 维护的一个固有成本每次上游 rebase 都可能使本地补丁产生冲突或失效尤其是上游触碰了补丁所依赖的启动流程文件时。仓库中保留了该功能的本地化源文件 src/chrome/browser/ui/startup/google_api_keys_infobar_delegate.cc本仓库src/目录仅存放 Thorium 相对上游修改/新增的文件该文件出现在其中印证了它属于本地补丁范围修复即在 rebase 后对该启动链路补丁做适配。2.6 默认浏览器提示条持续存在命令行标志缓解2022 年 5 月根治infra/BUGS.md#L18 记录12 月 6 日即使已将 Thorium 设为默认浏览器默认浏览器提示条Default Browser InfoBar仍然持续显示。报告者为 GitHub 用户 midzer。文档同时给出了缓解措施在上游修复前通过在.desktop文件中加入--no-default-browser-check命令行标志来规避。仓库中的实际打包配置印证了该缓解措施的落地方式——infra/APPIMAGE/Thorium.yml 生成的桌面条目与 AppRun 启动脚本全部携带此标志# infra/APPIMAGE/Thorium.ymlL41 附近desktop 文件模板 Execthorium --no-default-browser-check %U ... # L74 附近AppRun 启动脚本 ${HERE}/usr/bin/thorium --no-default-browser-check $该标志的语义在 docs/CMDLINE_FLAGS_LIST.md 中有官方说明禁用默认浏览器检查。适用于希望避免显示默认浏览器 info-bar 的 UI/浏览器测试场景。该条目 2022 年 5 月由作者根治FIXED说明命令行缓解只是过渡手段最终仍需修复检查逻辑本身。3. 2022 年的 6 条记录Windows 构建问题群与 Linux HEVC3.1 Windows AVX 构建中 abseil 符号问题反复出现已修复infra/BUGS.md#L22 记录1 月 2 日前后Windows 上的 AVX 构建使用 abseil 库时出现一个问题持续数周、消失、又重新出现最终修复方案由 RobRich999 提供。仓库内的补丁 other/fix_absl_undefined_symbol.patch 保留了修复证据它修改的是third_party/abseil-cpp/symbols_x64_dbg.def的导出表从EXPORTS列表中删除了一行 abseil 的 C 修饰符号涉及absl::UnrecognizedFlag相关的InlinedVector特化。从补丁内容与文件名可以推断该问题表现为 Windows 调试构建下 abseil DLL 的符号导出表引用了不存在的符号属于典型的构建配置AVX/调试× 第三方库导出列表组合回归。消失后又复现的记录方式也提示此类跨 rebase 的间歇性问题需要保留完整的时间线否则容易误判为已自愈。Thorium 的 AVX2 构建配置本身存放在 other/AVX2/ 目录含 other/AVX2/AVX2_args.gn可查阅具体的 SIMD 构建参数组合。3.2 mini_installer 中的 memcpy 问题已修复infra/BUGS.md#L24 记录1 月某日原文日期为 Jan. ?困扰作者一段时间plaguing的 mini_installer 中memcpy问题得到修复修复者为 RobRich999。other/mini_installer.patch 中保留了与此直接相关的差异片段——移除了一段仅在_DEBUG与 ARM64 组合下编译的手写memcpy实现#if defined(_DEBUG) defined(ARCH_CPU_ARM64) // The compiler generates calls to memcpy for ARM64 debug builds so we need to // supply a memcpy implementation in that configuration. // See comments above for why we do this incantation. __attribute__((used)) void* memcpy(void* destination, const void* source, size_t_count) { ... }以上为该补丁差异上下文中的原始实现补丁以删除该定制实现的方式修正行为。从补丁上下文看定制memcpy原本是为 ARM64 调试构建补全编译器生成的调用这类平台 × 构建类型条件编译路径中的内联内存操作正是调试构建与发布构建行为分叉的高发点。3.3 M100 起 Windows 任务栏图标变为黄色感叹号已修复infra/BUGS.md#L26 记录自 M100 起Windows 上的 Thorium 运行时任务栏图标显示为黄色感叹号而非正确的 Thorium 图标2022 年 2 月 28 日由作者修复。黄色感叹号图标是 Windows 资源加载失败时的占位图形通常指向图标资源.ico 文件、版本资源段或chrome.exe资源模板在 rebase 过程中与本地品牌化资源不匹配。仓库中品牌图标资源存放于 src/chrome/app/ 目录包含 Thorium 定制的.ico/.icns/.grdp等资源文件条目未给出具体修复者署名细节仅标注由我修复。3.4 M98 起 Windows 10/11 需兼容模式才能运行已修复infra/BUGS.md#L28 记录自 M98 起Windows 10/11 上必须将兼容模式设为 Win 7/8Thorium 才能正常运行2022 年 5 月由作者修复报告者为多位用户Multiple Users。必须开兼容模式才能跑这一现象意味着可执行文件的某些行为触发了 Windows 的旧版本兼容层。此类问题通常与进程初始化路径、系统 API 探测或子进程启动方式相关。条目未给出技术细节但其版本锚点M98 引入与 2022 年 5 月的修复时间与 2.6 节的根治时间点一致两者可能同源于 M98 后某次上游启动/更新流程变更这一点从文档本身可以合理推断。3.5 chrome://settings 搜索导致崩溃已修复infra/BUGS.md#L30 记录所有 Windows 构建上在 chrome://settings 页面进行搜索会触发崩溃条目同时记录了一条重要的排查线索点击新标签页NTP上的 Customize Thorium 会触发同样的崩溃——两者共享崩溃路径这大幅缩小了排查范围。文档还给出了标准排查方法论应该用二分法bisection和/或带堆栈跟踪的调试构建或挂载调试器来调查。报告者为多位用户状态标记为FIXED。这条记录展示了缺陷清单中排查指令的价值它把可复现入口settings 搜索框、NTP 自定义按钮和推荐手段bisection、debug build stack trace一并沉淀下来使后续任何贡献者都能从断点处继续调查。3.6 Linux 上 H.265/HEVC 内容无法播放BUG未解决infra/BUGS.md#L32 记录文档最后一条Linux 上播放 H.265/HEVC 内容不工作报告者为 GitHub 用户 lovelytwo。该条目在清单中保持BUG状态。仓库内存在一组与之方向吻合的进行中材料印证 HEVC 支持是 Thorium 持续投入而非放弃的方向other/add-hevc-ffmpeg-decoder-parser.patch向 FFmpeg 解码器解析器添加 HEVC 支持的补丁另有patch1与.bak迭代版本other/ffmpeg_hevc_ac3.patchHEVC/AC3 相关的 FFmpeg 补丁infra/build_ffmpeg.sh 与 other/build_ffmpeg.pyFFmpeg 构建脚本根目录脚本 patch_ac3.sh 同样围绕 FFmpeg 补丁应用。从源码结构看HEVC 播放链路涉及 FFmpeg 库的解码器注册与 Chromium media 层的 codec 声明两处任一环节缺位都会表现为文件存在但无法播放这也解释了为何该问题需要独立的补丁与构建脚本配套推进。4. 从 BUGS.md 提炼的三条实战经验经验一以里程碑版本号作为缺陷的时间锚点。清单中多次出现M98、M98.0.4738.0、M100这样的版本标记书签颜色、Windows 兼容模式、任务栏图标、settings 崩溃均如此。对 Chromium fork 而言里程碑号是比日历日期更可靠的二分起点——它直接对应src树的 checkout 位置可结合 rebase 历史定位引入变更的提交窗口。经验二区分缓解mitigate与根因修复fix。2021 年 12 月的默认浏览器提示条是最佳范例--no-default-browser-check命令行标志只是让症状不可见真正的修复发生在 2022 年 5 月。阅读此类缺陷清单时凡带Until this is fixed upstream在上游修复前字样的条目其缓解方案如打包配置中注入命令行标志应视为临时措施并持续跟踪终态。经验三署名制度让缺陷清单成为社区协作契约。从 infra/BUGS.md 可以看到每条记录都标注报告者midzer、Pierro78、lovelytwo、RobRich999、Multiple Users 或作者本人修复条目额外标注修复者与日期。这种格式约定意味着提交一份合格的 bug 报告需要包含明确的复现条件平台 构建类型 版本、影响面哪些构建受影响以及已排除的排查路径清单本身就是撰写规范的模板。5. 小结infra/BUGS.md 虽以简明的列表体呈现实际承载了 Thorium 在 M98—M100 区间内 11 条跨平台缺陷的完整生命周期2 条WONTFIX/UNFIXABLE明确了平台边界Ink 仅限 CrOS、CrOS Media App 不可移植1 条BUG指向 Linux HEVC 的进行中工作仓库内已有配套 FFmpeg 补丁与构建脚本其余 8 条FIXED记录了从上游回归适配API Keys InfoBar、Windows 资源/兼容性问题任务栏图标、兼容模式、settings 崩溃到 AVX 构建符号问题的修复过程并保留了 other/fix_absl_undefined_symbol.patch、other/mini_installer.patch 等可核查的修复证据。对任何维护 Chromium 系 fork 的团队而言这份文档及其背后的补丁、GN 配置、命令行标志见 infra/CMDLINE_FLAGS_LIST.md 与 docs/ABOUT_GN_ARGS.md共同构成了一个可复用的小型缺陷治理样本。【免费下载链接】thoriumChromium fork named after radioactive element No. 90. Source code and Linux releases. Windows/MacOS/ARM builds served in different repos, links are towards the top of the README.md.项目地址: https://gitcode.com/GitHub_Trending/th/thorium创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考