upscayl/upscayl：README 来源编辑指南

upscayl/upscayl 的 README 将项目描述为"🆙 Upscayl - #1 Free and Open Source AI Image Upscaler for Linux, MacOS and Windows."。本文只整理仓库能直接核验的内容，不把星标、Fork 或宣传语当成质量证明。README 在"Free and Open Source AI Image Upscaler"下的说明是：Upscayl lets you enlarge and enhance low-resolution images using advanced AI algorithms. Enlarge images without losing quality. It's almost like magic! 🎩🪄。这给出的首先是项目边界，而不是已经完成的生产验证。

从 README 的"🤓 FAQ"和相关条目看，读者可以先判断它是否解决自己的具体问题：I don't see a drastic change in my upscaled image. Why is that?。如果你的目标与这段说明不一致，就不应仅凭项目热度采用它。这里保留原项目名、命令和组件名，方便回到一手来源核对。 README 还列出了另一条可核对的信息：Upscayl uses AI models to enhance your images by guessing what the details could be. It uses Real-ESRGAN and Vulkan architecture to achieve this. Our backend is fully open-source under the AGPLv3 license.。这类原文条目可以帮助读者设计试运行步骤，但不能代替自己的环境测试。

README 把工作方式分散写在"🐧 Linux"等段落中。可确认的线索包括：Upscayl should be available on the software listings of most Linux operating systems. Your distro's Store app might also support the Flatpak or Snap version.。这篇整理没有把未写出的架构、性能或安全边界补成结论；真正的运行链仍应结合仓库目录、配置文件和版本标签检查。

第一次安装应从 README 给出的入口开始。当前可复核的命令是： git clone https://github.com/upscayl/upscayl cd upscayl # INSTALL DEPENDENCIES npm install # RUN THE DEVELOPMENT SERVER LOCALLY ## YOUR LOGS WILL NOW APPEAR IN THE TERMINAL npm run start 如果仓库没有提供命令，本文不会替它编造安装步骤，而是建议先打开 README 的"🆙 Upscayl"部分，确认系统依赖、默认端口和首次初始化动作。

日常使用的细节取决于项目实际文档。README 的"💼 Portable Method"段落提到：1. Go to releases section. 2. Download the upscayl-x.x.x-linux.AppImage file. 3. Right Click AppImage -> Go to Permissions tab -> Check 'allow file to execute' and then double click the file to run Upscayl.。对于配置文件、环境变量、权限和数据目录，当前稿只记录来源明确的部分；未写明的默认值必须在测试环境中验证，并保留可回滚的配置副本。 同一部分还提到：Upscayl can enhance low resolution images and images that are pixelated but it cannot de-blur or do focus adjustment on your image. If your image is out-of-focus or totally blurred, Upscayl is not the right tool for it.。