咩想AI 本地助手｜千问原版环境闭环测试包
================

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

安装方式
--------
1. 请使用“解压全部”完整解压 ZIP。助手可以放在桌面；模型、环境、缓存和日志会自动转到可写的 D 盘或 E 盘。
2. 解压完成后会自动得到一个完整文件夹：咩想本地助手。
3. 不要把 runtime 文件夹、DLL 或其他文件单独拖到磁盘根目录，也不要移动文件夹里面的文件。
4. 打开“咩想本地助手”文件夹，双击“启动千问原版测试.cmd”。不要只双击 MiexiangBridge.exe。
5. 启动器会确认千问工作服务真实运行后再打开测试网页；Edge 询问本地网络访问时请选择“允许”。

如果双击后没有看到窗口
----------------------
- 先检查 Windows 右下角的系统托盘，助手可能已经在后台运行。
- 如果电脑上已有另一个咩想助手，请先从系统托盘退出旧助手，再双击“启动千问原版测试.cmd”。
- 当前启动器遇到缺少文件、核心启动失败或安全软件拦截时，会显示具体错误，不会静默修改 Windows 安全设置。
- 不要直接启动 runtime 文件夹里的 MiexiangBridgeCore.exe。
- 启动失败时，具体原因会显示在命令窗口；桌面启动时，详细日志位于 D/E 盘的 SoftwareData\咩想图片工作台测试\千问原版\启动日志。

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

环境准备
--------
- 图像创作助手会先在本机启动轻量的咩想图像服务，然后自动查找本机已有的 ComfyUI。
- 默认不要求你先填写路径；助手会优先复用已经存在并通过校验的 ComfyUI 和模型。
- 已存在且通过文件大小与 SHA-256 校验的模型会直接复用，不会重复下载。
- 缺失模型可以在网页中直接选择“软件下载并安装”，也可以选择“选择已下载文件”导入；助手会按清单放入正确的 ComfyUI 子目录，然后自动重新扫描。
- 选择文件夹时可以选择嵌套或改过名字的 ComfyUI。若发现多个候选目录，网页会列出路径让你明确选择，不会静默猜一个。
- 网页会分别显示环境、模型、显卡/驱动、工作服务四种状态。显卡或驱动不足时，仍允许先完成环境和模型准备。
- 如果自动方式确实找不到或无法启动，环境设置中才会显示手动搭建入口；手动入口仍然可以继续模型扫描和导入。

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

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

本版环境准备说明
----------------
- 自动搭建适用于 64 位 Windows 10/11；Windows 8/8.1 及 32 位系统不在本版支持范围。
- 无需预先安装 Python。本包附带经校验的独立 Python，环境依赖、模型和下载缓存会放在非系统盘的新工作区。
- 首次从零搭建会下载模型和显卡依赖，建议工作区所在磁盘至少保留 30 GB 可用空间，并保持网络连接。
- 本里程碑只验证“自动准备或手动接管环境、识别模型、下载/导入/放置模型、重新扫描”的闭环，不把真实出图作为本轮通过条件。出图仍需要外部电脑的真实显卡、驱动和显存条件。
- 显卡/驱动不足时，软件会明确显示“生成硬件未就绪”，但不会把环境和模型准备一并判失败；已有作品与模型不会被自动删除。
- 手动选择文件夹时，请选实际 ComfyUI 安装目录。窗口可能需要几秒载入；完成选择后，网页会显示所选路径供你确认。

本次千问原版独立测试 ENV-R3
--------------------
- 本包是从 R32 独立复制后重写环境/模型闭环的候选版本，旧 R32 不会被覆盖；ENV-R3 还会自动隔离并保留同名损坏模型，再放入通过校验的新文件。
- 本轮必测：本地助手能启动；自动扫描或手动选择 ComfyUI；已有模型复用；缺失模型的软件内下载或文件导入；正确子目录放置；放置后自动重扫。
- 本轮不要求必须完成图片生成；如果外部电脑的显卡和驱动允许出图，可作为额外结果记录。
- 本助手包不包含 Qwen 模型文件。模型由助手在测试电脑上按清单现场下载到选择的工作区。
- 下载器支持断点续传，并在写入完成后按锁定文件名、大小和 SHA-256 校验；校验失败的文件不会被当作可用模型。
- 启动器会识别 8291 上是否误连基础专项版；发现旧版本时明确提示退出旧助手，不把其他服务当作千问环境成功。
- 请只使用本包中的“启动千问原版测试.cmd”，不要直接启动 runtime 文件夹里的程序；不要与基础模型专项测试包混用。

ENV-R3 退出说明：从系统托盘退出助手后，配套千问工作服务会自动停止；也可双击“退出当前助手.cmd”。

