本版主要内容
围绕正式发布、许可证权限、任务稳定性、环境安装和新手自查体验进行了整理。
简洁发布
主程序采用单 exe 方式，发布包只需携带 Models 文件夹。
手动环境
环境不再盲目后台下载，先选择下载源，再手动安装或修复 Runtime。
许可证系统
普通许可证支持单图处理，高阶许可证支持批量处理，并加入后端权限校验。
小白使用教程
第一次建议只处理一张图片，确认模型、许可证、环境都正常后再批量。
解压软件
把发布包解压到简单路径，例如 D:\TCore 或 C:\TCore。不建议放在路径很长、带特殊符号、网盘同步目录或系统权限目录里。
检查文件结构
解压后应能看到 TCore.exe 和 Models 文件夹。不要删除 Models 文件夹。
检查模型
建议至少包含 Models\mosaic\mosaic_position.pth 和 Models\mosaic\clean_face_HD.pth。其中 mosaic_position.pth 是定位模型，不一定显示在主模型列表里。
准备环境
进入环境页，选择下载源后点击安装或修复环境。国内网络优先选择清华、阿里、腾讯等源；下载慢时不要频繁关闭，先看日志是否仍在下载或安装。
安装许可证
复制软件显示的本机机器码，到 https://ipdate.keqing.beauty/ 获取许可证。拿到 keqing.lic 后按软件提示导入，或放到 TCore.exe 同目录。
添加并处理图片
点击添加图片或添加文件夹。普通许可证一次只能处理一张，高阶许可证可以批量处理。人脸图片建议优先使用 clean_face_HD.pth。
遇到问题先自查
不要一报错就直接问群主。先看日志、看提示、动脑子判断大概是哪一类问题，再带着信息反馈。
优先把日志发给 AI 分析
可以打开 https://chat.qwen.ai/，把报错截图、运行日志、系统版本、显卡型号一起发给 AI，让它先帮你判断是环境、CUDA、模型、许可证还是系统问题。
先看运行日志
日志里如果出现 torch / numpy / cv2 / PIL missing，通常是环境没装完整；出现 CUDA error，通常是显卡驱动或 CUDA 兼容问题。
常见问题 FAQ
下面是群里最常见的问题，先对照看一遍。
1. 环境安装日志一直刷，是不是卡死？
不一定。看到 Downloading、Using cached、Installing collected packages，说明还在下载或安装。首次环境准备可能比较久，网络慢时更明显。长时间完全不动再考虑关闭软件，删除 Runtime 后换下载源重装。
2. 提示缺少 torch、numpy、cv2、PIL 怎么办？
说明 Runtime 环境没装完整。进入环境页选择下载源，点击安装/修复环境。必要时关闭软件，删除 Runtime 文件夹后重装环境。
3. CUDA error: no kernel image is available 怎么办？
这是显卡 CUDA 兼容问题，常见于驱动过旧或显卡架构太新。先更新 NVIDIA 驱动，再删除 Runtime 重装 CUDA 环境；仍不行就先用 CPU 环境，速度慢但兼容性更好。
4. RTX 50 系显卡反复提示 Found GPU 正常吗？
环境能识别显卡，但当前 torch/CUDA 对新显卡可能支持不完整。先点检测环境，依赖完整就可以试跑；如果处理时报 CUDA kernel 错误，就更新驱动或切 CPU 环境。
5. mosaic_position.pth 为什么不显示在已识别主模型里？
正常。mosaic_position.pth 是定位模型，程序后台自动调用，不是可选择的清理模型。主模型列表通常只显示 clean_face_HD.pth、clean_youknow_resnet_9blocks.pth 这类 clean 模型。
6. 添加图片弹 COMException 怎么办？
这通常是 Windows 文件选择器、路径权限或系统组件问题。先把软件放到 C:\TCore 或 D:\TCore，图片放到 D:\test，再试“添加文件夹”。如果还弹，把 Logs\tcore_crash.log 发出来。
7. 提示没有许可证怎么办？
请确认 keqing.lic 已导入，或者放在 TCore.exe 同目录。许可证获取地址：https://ipdate.keqing.beauty/
8. 提示机器码不匹配怎么办？
说明许可证不是给当前电脑签发的，需要复制当前软件里显示的机器码，重新获取许可证。
9. 普通许可证为什么不能批量？
这是正常限制。普通许可证只支持单图，高阶许可证才支持批量处理。
10. 处理结果显示“完成/未检测到”是什么意思？
说明任务跑完了，但没有检测到有效马赛克区域，或者检测阶段出现兼容问题。请看日志是否有 CUDA error、模型加载失败、图片路径异常等信息。
11. 为什么处理效果不好？
去马赛克不是百分百还原原图。马赛克越大、图片越糊、压缩越重、遮挡越完整，效果越不稳定。人脸图片建议用 clean_face_HD.pth，并先用小块马赛克图测试。
12. 普通用户需要安装 .NET SDK 吗？
不需要。SDK 是开发和打包用的，不是普通用户运行 TCore 必需的东西。
13. 支持哪些 Windows 系统？
推荐 Windows 10 22H2 / Windows 11 64 位。最低建议 Windows 10 2004，系统版本 19041 及以上。不建议在 Windows 7、8、8.1、32 位系统、精简系统、魔改系统上使用。
14. Unknown Hard Error 怎么办？
这常见于系统组件异常、权限问题、杀毒拦截、Runtime 损坏或系统环境不干净。先换简单路径、管理员运行、删除 Runtime 重建，并检查杀毒软件是否拦截。
许可证说明
许可证在 https://ipdate.keqing.beauty/ 获取。许可证和机器码绑定。
单图处理
- 支持单图 demosaic。
- 适合少量图片测试和个人基础使用。
- 不支持批量处理。
批量处理
- 支持批量 demosaic。
- 适合多图处理和更高频使用。
- 解锁批量处理权限。
正确反馈格式
真遇到问题需要反馈时，请一次性把信息发完整。