# 构建镜像配置编辑器 2.0.0

源码使用 Python 3 和 PySide6，不依赖本项目其他目录。支持 Python 3.10–3.14，构建依赖已在 `requirements-build.txt` 锁定。

以下命令均在本文件所在的 `发布更新相关/镜像编辑器/编辑器源代码/` 目录执行。

## Windows 10/11 x64

```powershell
.\build_windows.ps1
```

脚本创建隔离构建环境、运行单元测试，再使用 PyInstaller 生成单 EXE，并更新 `../编辑器程序/` 的版本和 SHA-256。发布后的电脑不需要安装 Python、.NET 或 Qt。
已有锁定依赖的 venv 时可传入 `-BuildEnvironment "<venv路径>"`，脚本会拒绝错误的 PySide6/PyInstaller 版本。

## macOS

必须在 macOS 上本地构建，PyInstaller 不是跨平台编译器：

```sh
chmod +x ./build_macos.sh
./build_macos.sh
```

本项目未交付或验收 macOS 产物；对外分发 `.app` 时还应由分发者完成 Apple 签名和公证。命令行功能位于同一源码入口；若需在终端直接查看标准输出，将 macOS 构建参数的 `--windowed` 改为 `--console`。

## 源码运行与命令行

```powershell
$env:PYTHONPATH = ".\src"
python .\editor_main.py
python .\editor_main.py --validate "<镜像.img>"
python .\editor_main.py --apply "<原镜像.img>" "<配置.json>" "<新镜像.img>"
python -m unittest discover -s .\tests -v
```

编辑器只修改 IMG 内 FAT16 启动分区的固定双槽配置区，不负责向 TF 卡写入镜像。源码、构建物和日志不得内置发布密码或读取项目凭据文件。

第三方软件声明见 `THIRD_PARTY_NOTICES.md`。