咩想AI 本地助手
================

这是咩想 AI 本地创作助手测试包。

安装方式
--------
1. 请使用“解压全部”把 ZIP 解压到你选择的非系统盘位置，例如 E:\。
2. 解压完成后会自动得到一个完整文件夹：咩想本地助手。
3. 不要把 runtime 文件夹、DLL 或其他文件单独拖到磁盘根目录，也不要移动文件夹里面的文件。
4. 打开“咩想本地助手”文件夹，双击里面唯一的 MiexiangBridge.exe。
5. 助手启动后，再回到咩想 AI 网页点击连接本地助手。

如果双击后没有看到窗口
----------------------
- 先检查 Windows 右下角的系统托盘，助手可能已经在后台运行。
- 如果电脑上已有另一个咩想助手，请先从系统托盘退出旧助手，再启动当前文件夹里的 MiexiangBridge.exe。
- 当前启动器遇到缺少文件、核心启动失败或安全软件拦截时，会显示具体错误，不会静默修改 Windows 安全设置。
- 不要直接启动 runtime 文件夹里的 MiexiangBridgeCore.exe。

文件和数据
----------
模型、作品、缓存和任务记录保存在你在咩想网页中选择的工作区。更新助手时请保留整个“咩想本地助手”文件夹和创作工作区，不要覆盖已有作品和模型。

环境准备
--------
- 图像创作助手会先在本机启动轻量的咩想图像服务，然后自动查找本机已有的 ComfyUI。
- 默认不要求你先填写路径；助手会优先复用已经存在并通过校验的 ComfyUI、模型、节点和 LoRA。
- 已存在且通过内容校验的文件会直接复用，不会重复下载。
- 缺失项会直接显示可用的下载入口、目标位置和校验信息；下载后会自动重新扫描，全部通过才会显示“已就绪”。
- 如果自动方式确实找不到或无法启动，环境设置中才会显示手动搭建入口。

退出
----
点击窗口关闭按钮会收起到系统托盘；选择托盘中的“退出助手”才会退出本地助手。

安全边界
--------
助手只监听本机回环地址，并检查网页来源和任务归属。它不会把任意电脑路径或任意命令暴露给网页，也不会修改 Windows 下载来源安全标记。

本版环境准备说明
----------------
- 自动搭建适用于 64 位 Windows 10/11 与已安装 NVIDIA 驱动的电脑；Windows 8/8.1 及 32 位系统不在本版支持范围。
- 无需预先安装 Python。本包附带经校验的独立 Python，环境依赖、模型和下载缓存会放在非系统盘的新工作区。
- 首次从零搭建会下载模型和显卡依赖，建议工作区所在磁盘至少保留 30 GB 可用空间，并保持网络连接。
- 软件只有在启动 ComfyUI 且实际生成并取回一张验证图片后，才会显示环境就绪。若失败，请查看环境设置中的具体原因和模型清单；已有作品与模型不会被自动删除。
- 手动选择文件夹时，请选实际 ComfyUI 安装目录。窗口可能需要几秒载入；完成选择后，网页会显示所选路径供你确认。

本次千问原版独立测试
--------------------
- 配套测试网址：https://qwen-image-original-test.miexiang.cn/
- 本轮必测：本地环境自动搭建；Qwen 模型真实下载、大小与 SHA-256 校验、环境状态确认。
- 本轮不要求必须完成图片生成；如果出图成功可作为额外结果记录。
- 本助手包不包含 Qwen 模型文件。模型由助手在测试电脑上按清单现场下载到选择的工作区。
- 请从上述测试网址下载本包，并在该网页连接本地助手；不要与基础模型专项测试包混用。
