chromebook-linux-fixer

chromebook-fixer 是一个面向单个用户的实用工具，用于收集在主流Linux发行版上运行的Chromebook的硬件启用修复，这些设备上的摄像头、传感器、音频和电源行为通常依赖于ChromeOS固件二进制文件或供应商内核树。它还会安装并配置Nightfall Boot Manager，一个触摸驱动的GRUB前端。 该工具的标志性特性是每项修复都基于检测进行门控：`detect.sh` 在更改任何内容前确定问题是否实际存在于机器上，而 `verify.sh` 检查修复自身的标记是否就位——这刻意区别于“症状已消失”，以便上游修复或软件包升级静默覆盖修复时可见。 它提供21项修复，按子系统分组：IPU3摄像头栈（IOMMU直通、ImgU grableak、VCM自动对焦、方向）、屏幕/亮度/旋转（加速度计、背光权限、自动旋转、通过AUX和DPCD的面板亮度、平板模式切换、触摸恢复重新绑定）、音频AVS DSP、EC按钮轮询、桥接到GNOME锁屏的ChromeOS指纹读取器、Nightfall启动管理器安装和默认设置、Waydroid钩子/netfilter/USB，以及zram交换。 用法明确：`status` 显示机器需要什么，`list -v` 描述每项修复，`apply <id>` 安装一项，`verify` 检查它，`revert` 撤销它。高风险修复需要输入修复ID以确认。`--kernel` 标志针对特定已安装内核用于模块构建修复。除非按名称请求并经检测确认，否则不应用任何内容。 Nightfall管理涵盖启动菜单超时（Nightfall和GRUB）、旋转和启动画面设置、从BobZKernel tarball安装内核、默认内核选择、内核移除，以及备份查看/删除（仅限Pixel Slate）。`update` 命令快进工具的git检出并可原地重建Nightfall，保留 `.previous` 回滚对。 README对风险异常坦诚：修复进行低级更改（替换库、编辑udev规则、修补其他包的文件、更改内核行为），有些可能导致机器硬锁，无内核恐慌且日志中无任何记录。它仅在一台机器上开发和测试——Google Nocturne（Pixel Slate）——每项修复的 `danger` 字段基于观察行为而非通用警告编写。Nightfall本身是例外，可在任何带GRUB的x86-64-v2 PC上提供，已在Pixel Slate和联想LOQ上端到端测试。 修复是数据驱动的：每个修复是一个目录，包含 `fix.yaml` 元数据（类别、风险、针对DMI的 `applies_to` 正则、`reverts_cleanly`、`danger`）和最多四个脚本。为新模型添加支持是检测脚本加数据，而非重写。项目采用GPL-3.0-or-later许可，欢迎为Pixel Slate以外的模型贡献。