Final2x：一个刻意做薄的超分外壳
内容提要
Final2x是一款跨平台图片超分工具，界面用Vue构建，推理由独立的Python内核Final2x-core完成，两者通过base64配置、stdout日志和退出码通信。它支持多种模型和自定义权重，但Linux需自装内核，macOS无签名。设计上刻意简化外壳，使内核可独立使用，便于维护和发版。
延伸解读
进程边界的取舍
Final2x 将 GUI 与推理内核分离，通过 base64 配置、stdout 日志和退出码通信，刻意避免使用 socket 或 HTTP 服务。这种设计让内核可独立作为命令行工具使用，便于集成到脚本或流水线中，同时允许 GUI 和内核独立发版。但代价是协议脆弱，内核日志格式变更会导致进度条失效，且无法在编译期发现。
跨平台安装的注意事项
Windows 和 macOS 用户可直接使用安装包，但 macOS 因未签名需手动放行，建议使用 xattr -cr 而非完全关闭 Gatekeeper。Linux 用户需自行安装 Python 3.9+、PyTorch 2.0+ 及 Final2x-core，因为安装包不包含内核。此外，Intel Mac 无官方构建，Windows arm64 依赖转译运行，可能影响性能。
自定义权重与模型选择
Final2x 内置八个系列七十余项模型，涵盖通用照片和动漫向微调版本。v4 起支持自定义权重，可直接在模型下拉框中输入名称。模型列表由内核自动生成，避免手动同步。用户还可设置目标倍率、设备选择、分块推理等参数，以适应不同显存和需求。
Q&A
Final2x是什么？它主要解决什么问题？
Final2x是一款跨平台的图片超分辨率工具，支持Windows、macOS和Linux。它通过图形界面包装现成的超分模型，让用户无需配置Python、PyTorch、CUDA等环境，只需拖入图片、选择模型和倍率即可完成放大。
Final2x的GUI和推理内核是如何通信的？
GUI（Vue/TypeScript）与推理内核（Python的Final2x-core）通过三种方式通信：base64编码的JSON配置作为命令行参数传递，stdout文本流用于日志和进度，退出码表示进程结束。没有socket或HTTP服务，子进程启动后只能被杀死。
Final2x支持哪些超分模型？
内置模型覆盖Real-ESRGAN、Real-CUGAN、DAT、HAT、SwinIR、SCUNet、EDSR、SRCNN八个系列，共七十多项，还包括APISR、AnimeJaNai、Ani4K等动漫向微调版本。
在Linux上安装Final2x需要注意什么？
Linux安装包不包含推理内核，需要用户自行安装Python 3.9+、PyTorch 2.0+，并通过pip install Final2x-core安装内核，同时安装libomp5和xdg-utils等依赖。
Final2x如何实现进度条显示？
界面通过正则表达式解析内核输出的stdout文本流，匹配百分比更新进度条，匹配跳过标记显示提示，匹配完成标记设置成功标志。如果子进程退出时未收到完成标记，则显示失败。
Final2x的模型下拉框是如何生成的？
模型下拉框由Final2x-core自动生成，文件头部注明不要手动修改，通过代码生成保持跨语言枚举同步。
Final2x有哪些已知的限制？
限制包括：Linux需自装内核；Intel Mac无官方构建；macOS未签名需手动放行；窗口尺寸固定（宽670-870，高470-670）；硬件加速被禁用；进度条依赖文本协议，内核日志格式变化会导致失效。
Final2x的设计哲学是什么？
设计哲学是刻意做薄外壳，将GUI与推理内核分离，使内核可独立使用（pip安装、命令行调用），便于维护和独立发版。判断标准是：删除GUI后内核仍能独立运行。
