剑侠AI · 全能创作整合包（老照片修复 / 图片高清修复）

一、整合包介绍

    本整合包由剑侠君制作，基于 ComfyUI 工作流与自研「剑侠 UI」界面封装而成，

    面向 Windows 用户开箱即用。整合包内已内置 Python 运行环境、PyTorch（CUDA）、

    ComfyUI 及常用插件，无需自行安装 Python、Anaconda 或 CUDA 开发工具包。

    解压后双击根目录「双击-剑侠启动器.exe」，即可启动 ComfyUI 节点服务（8188 端口）

    与剑侠 Gradio 界面（7860 端口），在浏览器或内嵌窗口中完成老照片修复与图片高清修复。

二、整合包特色

    1. 绿色便携：解压即用，内置 python 目录，不污染系统环境。

    2. 剑侠 UI：中文可视化界面，2×2 卡片布局，参数与工作流已预配置，无需手动画节点。

    3. 双功能合一：顶部标签可在「老照片修复」与「图片高清修复」之间切换。

    4. 低显存优化：支持 GGUF 量化模型、SeedVR2 BlockSwap、VAE 分块等省显存策略。

    5. 一键启动：启动器支持内嵌窗口、系统浏览器、仅 ComfyUI 三种模式。

    6. 输出本地化：生成结果默认保存在整合包内 ComfyUI\output 目录。

三、整合包功能

    【启动器菜单】

      [1] 老照片修复 · 内嵌窗口（推荐）

      [2] 老照片修复 · 系统浏览器

      [3] 仅 ComfyUI 工作流（不启动剑侠 UI）

      [0] 退出

    命令行启动器时，输入 1、2 或 3 后回车即可。

    ────────────────────────────────────────

    【剑侠 UI · 老照片修复】

      · 上传老照片，自动上色与修复

      · K 采样器、Unet（GGUF）、可选 LoRA

      · 可选 SeedVR2 高清放大（目标分辨率 / 最大分辨率等）

      · 默认主模型：flux-2-klein-9b-Q4_K_M.gguf

      · 高清放大模型：seedvr2_ema_7b-Q8_K_M.gguf（启用 SVR 时）

    【剑侠 UI · 图片高清修复】

      · 上传待放大图片

      · 缩放算法、scale_by 预处理

      · DIT / VAE 模型选择与刷新

      · 目标分辨率、批次、保存文件名前缀

      · SeedVR2 视频/图像放大管线

    ────────────────────────────────────────

    【主要模型路径】

      大模型（Unet / DiT）：ComfyUI\models\diffusion_models\

      SeedVR2 模型：        ComfyUI\models\SEEDVR2\

      LoRA：                ComfyUI\models\loras\

      VAE：                 ComfyUI\models\vae\

      文本编码器：          ComfyUI\models\text_encoders\

      输出目录：            ComfyUI\output\

四、配置要求

    【操作系统】

      · Windows 10 / 11（64 位）

    【硬件 · 推荐】

      · 显卡：NVIDIA 独立显卡，显存 12GB 及以上（如 RTX 3060 12G、4070、5070 系列）

      · 内存：16GB 及以上（推荐 32GB）

      · 硬盘：预留足够空间存放整合包与生成图（建议 60GB 以上可用空间）

      · 显卡驱动：保持较新版本（整合包内置 PyTorch CUDA 13.0 运行库，仍需系统安装 NVIDIA 驱动）

    【硬件 · 最低可尝试】

      · 显存 8GB：可尝试运行，需降低分辨率与批次，SeedVR2 建议使用 3B 或 7B Q4 量化模型

      · 不推荐：GTX 10 系 6GB 及以下、无独显（速度极慢或无法运行）

    【显存与模型参考（本整合包默认组合）】

      模型名称     |    模型大小  |  建议显存

      ─────────────────────────────────────────────────────

      flux-2-klein-9b-Q4_K_M.gguf      ~5.5GB    8～12GB（含文本编码器后建议 10GB+）

      seedvr2_ema_7b-Q8_K_M.gguf       ~8.2GB    12GB+（配合 BlockSwap / 降 batch）

      seedvr2_ema_7b-Q4_K_M.gguf       ~4.5GB    8GB+（低显存备选）

      seedvr2_ema_3b 系列              ~3.2GB    8～12GB（更省显存）

    说明：老照片流程为「先生成、后放大」，两阶段不会长期同时占满显存，但单阶段峰值

    仍可能达到 10～14GB+，请根据实际 OOM 情况调低分辨率、批次或更换更低 Q 版本模型。

    【无需用户自行安装】

      · 系统 Python、pip、Anaconda

      · CUDA Toolkit（nvcc 开发套件）

      · 单独部署 ComfyUI

五、注意事项

    1. 解压密码：jianxiaym.com（见《关于模型存放路径说明（必看）.txt》）

    2. 请勿修改 ComfyUI\.jx_ui\ 目录内核心文件，否则可能导致剑侠 UI 无法启动或页面异常。

    3. 请勿删除整合包内 python\、ComfyUI\ 等运行必需目录。

    4. 路径建议：解压到磁盘空间充足的目录，路径不宜过深，尽量避免含特殊字符。

    5. 首次启动 ComfyUI 加载模型较慢，请耐心等待；界面显示「运行中」属正常现象。

    6. 若切换剑侠 UI 标签后页面空白，请重启启动器；请使用整合包附带的最新版本。

    7. 生成图片保存在 ComfyUI\output\，文件名前缀可在界面中自定义（如「高清修复」）。

    8. 使用 VPN 或代理时，若本地 ComfyUI 连接异常，请确保 127.0.0.1 不走代理。

    9. 整合包仅供学习与技术交流，商用、传播生成内容须自行承担合规责任（见《AI合规使用声明.txt》）。

六、使用须知

    【快速开始】

      ① 解压整合包至目标目录（输入解压密码）

      ② 双击「双击-剑侠启动器.exe」

      ③ 选择 [1] 内嵌窗口（推荐）或 [2] 系统浏览器

      ④ 等待 ComfyUI（8188）与剑侠 UI（7860）启动完成

      ⑤ 在顶部标签选择「老照片修复」或「图片高清修复」

      ⑥ 上传图片，按需调整参数，点击开始生成

      ⑦ 在「本次输出」区域查看结果，或到 ComfyUI\output\ 打开文件

    【老照片修复建议参数】

      · 首次使用保持默认即可

      · 显存不足：关闭或降低 SeedVR2 目标分辨率，批次保持 1～3

      · 需要更清晰：启用 SeedVR2，分辨率 2048，显存 12GB 及以上较稳

    【图片高清修复建议参数】

      · scale_by 默认 0.5 为预处理缩放，可按原图大小微调

      · 目标分辨率 2048、最大分辨率 4096 为常用设置

      · 显存紧张时降低批次大小与目标分辨率

    【常见问题】

      · 提示 ComfyUI 未连接：确认启动器已选 [1] 或 [2]，等待 8188 端口就绪后点「刷新模型」

      · 显存不足（OOM）：降低分辨率 / 批次，或换用 Q4 量化模型、启用工作流内 CPU 卸载

      · 模型列表为空：确认模型文件已放在对应 models 子目录，再点「刷新模型列表」

    【版权与免责】

      本整合包及相关 UI、工作流配置归剑侠君所有。使用者须遵守国家法律法规及

      《AI合规使用声明.txt》中的规定，因违规使用产生的一切后果由使用者自行承担。

================================================================================

              剑侠源码网 · https://jianxiaym.com/ · 整合包作者：剑侠君

================================================================================