下载 UI界面还原工作台
选择 Unity 或 Cocos Creator 版本，安装后使用官网账号登录。
请根据使用的引擎选择对应安装包；下方 Unity 安装教程中的英文为编辑器原文。
Cocos · 0.1.0.zip
UI界面还原工作台 安装包
Windows 与 macOS 均可使用。 选择对应引擎版本，按下方说明安装，再使用官网账号登录并在线验证订阅。
下载 Unity 引擎版 下载 Cocos 引擎版Cocos Creator 3.8.x · ZIP · v0.1.0 · 需要 .NET 7 运行时
插件中的可用功能需要有有效订阅，登录后由服务端在线判定；尚未购买可先查看价格与购买方式。
系统要求
确认环境满足后再下载，避免导入或权益校验失败。
操作系统
Windows 10 64 位及以上，或 macOS 11（Big Sur）及以上。
联网校验
权益由服务端在线校验：使用时需保持网络可访问授权服务器，网络中断会锁回登录页，暂不支持离线使用。
Cocos Creator 安装流程
下载 Cocos 引擎版 ZIP，五步完成安装并登录。
安装与使用提示
安装后的目录应为 项目根目录/extensions/ui-reconstruction/package.json；如果没有 extensions 文件夹，可在项目根目录新建。
macOS 默认尝试 /usr/local/share/dotnet/dotnet；其他环境需确保 Creator 进程能通过 PATH 找到 dotnet。启用后若菜单未出现，可重启 Creator。
使用官网账号登录并在线验证订阅。Reader 支持 8 位 RGB PSD/PSB；字体、复杂排版、遮罩和图层效果可能与原稿不同，请检查导入报告。Cocos 版目前需手动下载更新。
Unity 安装流程
用 Package Manager（包管理器）导入 .tgz，五步完成。英文为 Unity 界面原文，括号内为中文含义。
⚠ 别选 from disk：只认文件夹，.tgz 会全部变灰
教学视频即将上线，敬请期待。
＋ 菜单里两项别选错
| 菜单项 | 接受什么 | 本包 |
|---|---|---|
| Add package from disk （从磁盘添加包） | 文件夹（含 package.json 包清单） | ❌ 不适用 |
| Add package from tarball （从压缩包添加包） | .tgz 文件（Unity 压缩包） | ✅ 用这个 |
装上后 Console（控制台）没有 error CS（编译错误）、Tools › 微热星球乐岛工作室 UI界面还原工作台（Tools = 顶部「工具」菜单）能打开工作台、且先出登录页，就算导入成功。
常见问题
先查看对应引擎的排查方法；账号和订阅问题也可参考下方通用说明。
Cocos Creator 常见问题
Cocos 中找不到插件入口？
确认使用 Creator 3.8.x，且文件位于 项目根目录/extensions/ui-reconstruction/package.json。在扩展管理器中刷新并启用插件，再从顶部“扩展”菜单打开工作台；仍未出现时重启 Creator。
读取 PSD 时提示找不到 dotnet？
确认已安装 .NET 7 运行时。macOS 默认尝试 /usr/local/share/dotnet/dotnet；其他环境需确保 Creator 进程的 PATH 能找到 dotnet。安装后重启 Creator 再试。
Prefab 与原稿有差异或九宫没有拉伸？
目前支持 8 位 RGB PSD/PSB；字体、遮罩和复杂图层效果可能有差异，请查看导入报告并对照原稿。九宫边界写入后，还需将目标 Sprite 的类型设为 SLICED。
Unity 及通用问题
导入后找不到菜单？
请确认导入过程无编译报错，然后在 Unity 顶部菜单栏查看 Tools › 微热星球乐岛工作室 UI界面还原工作台（Tools = 顶部「工具」菜单）。
注意：Window › 微热星球乐岛工作室 › PSD Document Reader Diagnostics（窗口 › 微热星球乐岛工作室 › PSD 文档读取器诊断）是诊断工具，不是工作台。
若两处都看不到，重启编辑器后重试。
登录或权益校验失败怎么办？
检查账号邮箱与密码是否正确、订阅是否在有效期内、网络能否访问授权服务器，并确认当前设备未超出绑定上限（每账号 2 台）。
仍失败可在用户中心解绑本机后重新登录，或联系技术支持。
支持团结引擎吗？
支持，导入与联网校验流程和 Unity 一致。
可以装几台设备？
单个订阅最多绑定 2 台设备，可在用户中心解绑后换设备使用。
生成 Prefab 时提示「缺少 TMP Essentials」怎么办？
这条提示说明当前工程还没导入 TMP Essentials（TMP 基础资源），插件无法创建文字层。按下面两步导入即可，只需做一次。
-
打开 TMP Importer（TMP 导入向导），两种方式选一种：
- 菜单：
Window › TextMeshPro › Import TMP Essential Resources（窗口 › TextMeshPro › 导入 TMP 基础资源）； - 或在场景里新建一个 TMP 文本：
GameObject › UI › Text - TextMeshPro（游戏对象 › UI › 文本 - TextMeshPro），首次创建时编辑器会自动弹出该向导。
- 菜单：
-
在窗口里点
Import TMP Essentials（导入 TMP 基础资源），也就是左侧那个实心按钮。右侧的Examples & Extras（示例与附加资源）是可选的，不装也能正常生成 Prefab。
怎么算导入成功：工程里出现 Assets/TextMesh Pro/Resources/TMP Settings.asset（资源目录 › TextMesh Pro › Resources › TMP 设置资产）。
两个容易卡住的点：① 资源已导入时再点菜单不会有这个窗口——「找不到导入向导」通常等于「其实已经导过了」；② 导入是按工程算的，换一个工程要重新导一次。只有含文字层的 PSD 才需要它。
生成 Prefab 失败，提示「请检查图层是否都栅格化」？
这属于 PSD 源文件的问题，常见原因有三类：
- 图层没有栅格化：形状图层、文字图层、智能对象、图层样式等取不到像素数据。请在 Photoshop 里对相关图层执行「栅格化图层」后另存再试。
- 位深不是 8-bit：目前仅支持 8-bit PSD。
- 文件损坏或被截断：重新导出或重新传输一次源文件。
提示末尾的括号里会写出具体原因，例如「（原因：不支持的位深（仅支持 8-bit））」；完整技术细节可在 Unity 的 Console（控制台）查看。
右键菜单里没有「生成 Prefab」，或者点了直接跳到登录页？
- 点了直接打开工作台并停在登录页：说明当前没有通过在线授权校验。插件在未授权时会直接打开工作台、不再弹窗提示；登录并在订阅有效期内即可恢复。
- 菜单项是灰的、点不动：右键菜单只对 PSD / PSB 文件生效，路径为
Assets › 微热星球乐岛工作室 UI界面还原 › 生成 Prefab（Assets = 资源目录）。选中图片、Prefab 或文件夹时不可用。 - 整个「微热星球乐岛工作室 UI界面还原」子菜单都不见了：多为工程编译未通过，先解决 Console（控制台）里的 error CS 报错。
工作台窗口内也有同样的入口：打开 Tools › 微热星球乐岛工作室 UI界面还原工作台（Tools = 顶部「工具」菜单），直接选择 PSD 执行即可。
还没购买？先看看价格
一次订阅，不限项目与界面数量；订阅期内享受免费升级和开发者技术支持。