WorkBuddy 自定义图片模型安装器 3.0.1（Windows x64）

安装入口
https://workbuddy.tongyuye.com
推荐下载 WorkBuddy-ImageModels-Setup-3.0.1.exe 后由用户双击运行。
它内嵌固定版本的补丁源码，不依赖 WorkBuddy 的 AI 执行安装命令。
网页也提供 install.cmd 与 bootstrap.ps1，下载固定 3.0.1 包并核验 SHA256。
校验可以发现损坏或文件被替换，它不等于微软或腾讯认证。

安装器流程
自动从正在运行的进程、注册表安装记录、App Paths 和常用目录寻找 WorkBuddy。
发现多个安装目录时让用户选择，并显示实际目录和版本供确认。
先准备 Node.js、构建本机补丁、检查代码结构、文件完整性和语法。
检查未通过时保留原应用，不关闭它，不强制替换。
需要管理员写权限时通过 Windows UAC 请求授权，必须由用户确认。
构建检查通过后由独立助手关闭对应目录的 WorkBuddy、完整备份、安装并重启。
请先保存正在进行的任务。跨用户提权时尝试通过原桌面 Explorer 启动；不能确认用户身份则提示手动启动。
优先使用已有 Node.js 22+ 或 WorkBuddy 自带 resources/vendor/node.zip。
缺少运行时时下载固定版本的官方 Node.js，并对照官方 SHASUMS 校验。

脚本使用
双击发布站点的 install.cmd。
高级用法：powershell.exe -NoProfile -STA -ExecutionPolicy Bypass -File bootstrap.ps1
指定目录：在以上命令末尾加 -InstallRoot "C:\Program Files\WorkBuddy"。
只检查构建、不安装：加 -PrepareOnly，不会关闭或重启 WorkBuddy。
离线源码包：解压 workbuddy-image-model-patch.zip 后运行其中的 install.ps1。
EXE 参数：--install-root "目录"、--prepare-only、--rollback "备份目录"。

跨版本适配
不再把某一台电脑的 ASAR header SHA 写成唯一允许值。
动态发现带哈希文件名的设置、模型菜单和模型提供者模块。
通过代码语义、局部 AST 和唯一命中检查取得变量名与插入位置。
生成/编辑工具按结构识别，支持压缩变量名变化，原文本模型逻辑保持原样。
校验本机 ASAR 与 EXE 完整性记录一致，生成本机自己的哈希和安装 manifest。
5.8.0、5.8.1 进入同样的结构检查，不因版本号或不同 header SHA 直接拒绝。
尚未获得这两版安装包样本，不能宣称已经实测。代码结构变动时停止并留下原因。
取得并验证的版本及范围见 compatibility.json。离线构建与语法验证不等于启动整个应用实测。
未来版本也需通过结构检查，不保证所有未知版本都兼容。

新增图片设置
在原生菜单“配置自定义模型”下方新增“配置自定义图片模型”。
设置在“设置 → 模型”的原文本区域之后，不改文字表单、字段、保存和调用逻辑。
填写 Base URL 与 API Key，点击获取模型，从 GET <Base URL>/models 的真实列表选择 ID。
清晰度 1K、2K、4K，无宽高输入框，AI 按内嵌文档处理构图、文生图、参考图编辑。
启用后 ImageGen/ImageEdit 与已存在的 Miora 图片工具自动使用该接口。
成功立即返回，失败直接报错，不同时调用原内置生图、不自动回退。
关闭路由恢复原图片行为，文本模型继续负责对话和工具规划。

接口与配置
Base URL 示例：https://education.tongyuye.com/v1
POST <Base URL>/images/generations，JSON；POST <Base URL>/images/edits，multipart 上传图片。
支持 data[].b64_json 或 data[].url 同步响应，不支持供应商私有异步/聊天生图协议。
quality、response_format 默认不发送，路径与额外参数可在高级设置配置。
API Key 由 Windows DPAPI 按当前用户加密，存到 %USERPROFILE%\.workbuddy\image-model.json。
不写浏览器 localStorage，不上传给安装包下载站。公共安装包不包含个人凭据。
测试按钮真实生图，由服务商计费；安装和构建过程不发真实生图请求。

应用文件与签名
这是第三方本地补丁，需要修改 app.asar、外部 CLI/Miora 及 EXE 中对应的 ASAR SHA256 记录。
保留原 ASAR 条目、无关文件内容和全部 Electron fuse 字节，不关闭已启用的 ASAR 校验。
更新 EXE 校验资源会使腾讯原 Authenticode 数字签名失效。
原 EXE 和待修改文件完整备份。本安装器也未取得微软 Authenticode 发布者签名。
WorkBuddy 官方更新或修复可能覆盖补丁，之后重新运行安装器做本机检查。

回滚与日志
备份：<安装目录>\resources\custom-image-model-backups\<时间及随机 ID>\。
备份根记在 <安装目录>\resources\custom-image-model\installation.json。
EXE 回滚：WorkBuddy-ImageModels-Setup-3.0.1.exe --rollback "具体备份目录"
脚本回滚：install.ps1 -RollbackBackup "具体备份目录"
回滚恢复应用文件，保留图片配置和已生成图片。
EXE 解包目录：%LOCALAPPDATA%\Tongyuye\WorkBuddyImageModels\3.0.1\。
安装日志与结构检查报告保存在安装器提示的工作目录，不包含 API Key。

公开源码
ZIP 包含安装脚本、适配器、设置组件、结构匹配模块及 MIT 许可的 Acorn 解析器。
不含腾讯原 EXE/ASAR、个人配置、API Key、SSH 密码或历史截图。
由同于野独立发布，WorkBuddy 是腾讯产品。

卸载（新增）
下载 uninstall.cmd 并双击，或运行安装器 --uninstall。
离线源码包可运行 install.ps1 -Uninstall；只检查恢复文件加 -PrepareOnly。
卸载恢复首次安装前的原始应用文件；连续升级补丁也恢复首次原始文件，而非退回上一版补丁。
卸载前校验当前补丁、安装记录、首个原始备份及准备文件；官方更新/其他改动导致哈希变化则拒绝覆盖。
卸载失败会尝试恢复到卸载前状态并保留恢复快照。图片模型配置、API Key、生成图片和历史备份保留。

后续平台与版本
国内主要来源：https://www.workbuddy.cn/docs/workbuddy/Download-History
国际主要来源：https://www.workbuddy.ai/docs/zh/workbuddy/Changelog
Mac Apple Silicon（arm64）与 Intel（x64）官方 DMG 已取得，下载哈希与官方 feed 一致。
Mac 尚未完成包内结构、签名、权限及实际安装/卸载测试，本次不提供可运行的 Mac 补丁。
platform-roadmap.json 记录样本及适配边界。后续发布将区分平台和架构，保留旧版固定下载地址。
