初始化奇妙小屏幕控制器项目

2026-09-08 22:56:52 +08:00
commit 8d368de3b5
491 changed files with 67678 additions and 0 deletions
@@ -0,0 +1,39 @@
+# 构建镜像配置编辑器 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`。