英文原文正文为项目原始 README（英文），本站后续会翻译为中文，当前仅剔除图片与无关章节并统一排版。

👨‍💻 安装

[!重要]
你需要一个支持 Vulkan 的 GPU（显卡）来对图像进行放大。许多 iGPU（集成显卡）可能无法工作，但尝试一下也无妨 :)

🐧 Linux

Upscayl 应该可以在大多数 Linux 操作系统的软件列表中找到。你的发行版的应用商店应用也可能支持 Flatpak 或 Snap 版本。

💼 便携式方法

1. 访问 发布页面 或 我们的官方网站。
2. 下载 upscayl-x.x.x-linux.AppImage 文件。
3. 右键点击AppImage ->进入权限标签页 -> 勾选“允许文件执行”，然后双击文件以运行Upscayl。

你也可以选择使用其他格式安装，比如RPM（Fedora）、DEB（基于Debian/Ubuntu）和ZIP（任何x86 Linux操作系统）。

🍎 macOS

（macOS 12及更高版本）

链接

1. 访问 发布页面 或 我们的官方网站。
2. 下载 upscayl-x.x.x-mac.dmg 文件。
3. 双击伤害，把Upscayl图标拖到应用文件夹里。
4. 打开Finder，点击左侧边栏的“应用”标签。找到Upscayl并右键点击。选择“打开”。
5. 在出现的窗口中，再次点击“打开”。

🍺 自制内容

brew install --cask upscayl

🐌 窗户

（Windows 10及更高版本）

1. 访问 发布页面 或 我们的官方网站。
2. 下载 upscayl-x.x.x-win.exe 文件。
3. 双击 exe 文件以启动。
4. 如果收到 SmartScreen 警告 - 点击 '更多信息' 然后 '仍然运行' 或在未验证的发布者对话框中按 '是'。
5. 按照安装步骤操作。
6. 获利！

👨‍🏫 文档 - 教程和指南

查看我们的文档 这里。

• 尝试更多新模型！
• 转换你自己的模型
• 兼容性列表
• 故障排除

⚖️ 结果

查看 Upscayl 前后对比 这里。

🤫 路线图

您可以在此跟踪所有进度：https://github.com/orgs/upscayl/projects/1

• 修复错误
• 让全世界使用自由开源软件（进行中 🚧）

🛠 开发

我推荐使用 Volta: https://volta.sh 来安装 Node.js。下载并安装 Volta，然后执行: volta install node。

🏃 运行

[!注意]
如果你不愿意安装 git，你可以跳过第一行，下载 源代码压缩包，并将其解压到 upscayl 中，然后继续执行其余的说明。

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

🏗️ 建筑

# INSTALL DEPENDENCIES
npm install

# PACKAGE THE APP
npm run dist

# PUBLISH THE APP, MAKE SURE TO ADD GH_TOKEN= IN SHELL
# ONLY DO THIS IF YOU'RE A MAINTAINER
npm run publish-app

🤓 常见问题

• Upscayl 是如何工作的？
  • Upscayl 使用 AI 模型提升您的图片，通过猜测细节可能的样子来实现。它使用 Real-ESRGAN 和 Vulkan 架构来做到这一点。我们的后端 是完全开源的，遵循 AGPLv3 许可证。
• 我没有看到放大后的图片有明显变化。为什么？
  • Upscayl 可以增强低分辨率和像素化的图片，但无法去模糊或调整焦点。如果您的图片是失焦或完全模糊，Upscayl 并不是合适的工具。请使用类似我们提供的示例的图片。
• 是否有命令行工具可用？
  • 命令行工具叫做 upscayl-ncnn。
• 使用这个工具需要 GPU 吗？
  • 是的，不幸的是，需要。NCNN Vulkan 需要 Vulkan 兼容的 GPU。Upscayl 无法在大多数 iGPU 或 CPU 上运行。但嘿，尝试一下也无妨 ;)
  • @Wyrdgirn 为 Windows 和 Linux 提供了一个解决方法，在 #390 中！没人知道如何操作 macOS 和 Haiku 框架……
• 我停止了魔法批量 Upscayl，图片没有处理、压缩或比例错误！
  • 当模型不支持某个操作时，Upscayl 会先完成对所有图片的放大处理，然后再进行后处理。这意味着您只需等待处理完成。
• 我如何贡献？
  • 您可以提交问题报告、修复代码或添加功能（通过提交 PR），或者捐赠！😊
• GPU ID 是做什么的？
  • 它用于选择要使用的 GPU。具体操作可参见 Wiki。
  • 请注意，对于 Windows 系统，如果 Upscayl 没有设置为性能模式，系统可能会覆盖此设置。
• 我在哪里可以找到更多模型？
  • 更多模型可在这里获取：https://github.com/upscayl/custom-models

🎁 捐赠

• 感谢 Real-ESRGAN 出色的研究工作。Real-ESRGAN: 版权所有 (c) 2021, Xintao Wang
• 感谢 @JanDeDinoMan、@xanderfrangos、@Fdawgs、@keturn 的代码贡献
• 感谢 @aaronliu0130 提供社区支持 :)
• 感谢 Helaman 提供的 HFA2k 模型（包括为“高保真”）
• 感谢 Foolhardy 提供的 Remacri 模型
• 感谢 Kim2091 提供的 Ultrasharp 和 Ultramix 平衡模型
• 感谢 @NicKoehler 提供的精彩标志 :) #