# fix-tool

**Repository Path**: newwangsong/fix-tool

## Basic Information

- **Project Name**: fix-tool
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2024-04-22
- **Last Updated**: 2025-03-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

介绍：此工具目的是检查系统软件包环境是否异常，以及提供修复办法



功能特性：

1. 支持修复各种异常状态的系统，例如黑屏、桌面环境异常等等，修复规则：将当前异常系统的软件包拉齐到标准版本通过补齐依赖或者升级降级相关软件包依赖进行修复，若都无法解决时进行卸载
2. 支持卸载软件包时检查是否是系统必须的软件包
3. 支持被卸载的软件包进行打包备份，特殊情况下进行还原 
4. 支持检查卸载第三方应用，被卸载的放到kare进行运行
5. 支持模拟修复流程，来校验修复的结果
6. 支持离在线修复



注意事项：

1. 修复脚本使用的`/var/lib/kylin-system-updater/sources.list`软件源，不存在时使用`/etc/apt/sources.list`的软件源作为修复基准软件源
2. 必须确保修复基准`软件源`由版本组提供的2107、2203、2303、2403发布的`正式软件源`，否则禁止使用脚本修复
3. 如需要单独指定源 执行修复时加入参数 `-s sources.list` 例如`python3 fix-system.py --sources sources.list`



修复操作步骤：

1. 下载脚本：`wget https://gitee.com/newwangsong/fix-tool/raw/master/fix-system.py`
2. 模拟执行修复，`sudo python3 ./fix-system.py` ，如需指定源执行`python3 fix-system.py --sources sources.list`
3. 审计模拟修复结果，查看`/tmp/aptroot-cache/will-fix-pkgs.json` 中修复时需要卸载和降级的软件包，尤其需要查看需要`被卸载的软件包`，确定可以卸载时再执行后续操作
4. 执行修复流程，`sudo DEBIAN_FRONTEND=noninteractive  apt -c /tmp/apt-fix.conf install $(cat /tmp/pkgs.txt)`或执行`sudo python3 fix-system.py --run`
5. 等待修复完成后重启设备



脚本其他参数：

```shll
usage: fix-system.py [-h] [-c CONF] [-j JSON] [-r] [-s SOURCES] [--status STATUS] [-d]

系统环境修复脚本

optional arguments:
  -h, --help            显示帮助信息
  -c CONF, --conf CONF  提供额外的APT配置文件
  -j JSON, --json JSON  提供临时的JSON配置，否则从源里进行下载
  -r, --run             执行修复系统环境。
  -s SOURCES, --sources SOURCES
                        提供修复环境使用的在线源或者离线源，默认使用系统更新源，不存在时使用系统源
  --status STATUS       提供需要修复系统的status文件
  -d, --debug           debug模式调试输出
```