upscayl/upscayl：README 來源編輯指南

upscayl/upscayl 的 README 將專案描述為「🆙 Upscayl - #1 Free and Open Source AI Image Upscaler for Linux, MacOS and Windows.」。本文只整理倉庫可直接核對的內容，不把 star、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 如果倉庫沒有命令，本文不會自行編造步驟，而是建議先閱讀「🆙 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.。