安装目录
将插件发布包解压到项目的 extensions/icarus-tool，然后重新打开 Cocos Creator。
BEFORE YOU START
网络连接
授权与更新通过 https://api.icarustool.com 完成，使用受保护面板时请保持网络畅通。
准备凭证
准备好你的 Icarus 凭证。用户 ID 可选，建议填写姓名或设备用途，方便团队识别绑定设备。
01
LICENSE GATE
授权当前设备
首次打开 Icarus → 资产管理 或 Icarus → 构建发布 时，未授权设备会进入验证页面。填写用户 ID 和凭证后点击“激活凭证”；没有正式凭证时，也可以申请 3 天试用。
- 用户 ID 为 1–64 个字符，可填写姓名、公司或设备用途；它会显示在两个工作面板顶部。
- 凭证无效、过期、被禁用或设备绑定被删除时，资产管理和构建发布都会停止开放。
- 不要在截图、聊天或公开文档中展示完整凭证。
看到“授权有效”就可以继续
激活成功后，页面会显示有效期、用户 ID 和设备指纹。永久凭证会直接标记为“永久授权”，限时凭证则显示到期时间。
02
RESOURCE MANAGEMENT
扫描和理解项目资产
从 Creator 顶部菜单选择 Icarus → 资产管理，点击右上角“开始扫描”。扫描完成后，按标签查看不同维度的项目结果。
删除前先复核：动态加载、脚本拼接路径和远程资源可能无法仅靠静态引用关系判断。建议先提交版本记录，再处理未引用或重复资产。
- 未引用
- 查找没有静态引用关系的资源。
- 丢失引用
- 定位场景、预制体或材质中的失效引用。
- 重复
- 识别内容相同或高度相似的重复文件。
- 所有资源
- 按名称或 UUID 搜索项目资产。
- Bundle / 内存
- 查看分包构成与资源占用。
- 资产 / 节点引用
- 追踪资源与场景节点之间的使用关系。
03
BUILD & PUBLISH
检查配置并构建 WebGL
从 Creator 顶部菜单选择 Icarus → 构建发布。面板会集中展示项目名称、宏配置、功能裁剪、自动图集检查、未合批材质筛查、网格压缩筛查和 WebGL 构建设置。
- 重新读取从项目文件重新载入当前配置，适合外部修改后同步面板。
- 检查各模块展开条目查看问题数量和建议，确认后再执行批量处理。
- 应用到项目将面板中的改动统一写入项目配置；应用前建议保留版本记录。
- 构建与运行确认发布平台和输出设置后开始构建，成功后可直接运行结果。
04
PLUGIN UPDATE
先卸载旧版，再导入新包。
发现新版本后，建议按下面的顺序更新，避免旧文件残留导致面板或构建行为异常：
- 卸载原插件关闭 Cocos Creator，在项目的
extensions/icarus-tool中删除旧版插件目录。 - 下载并校验在更新面板点击“下载并校验”。客户端会核对文件大小和 SHA-256，校验失败不会保存最终文件。
- 导入新插件下载完成后会自动打开文件夹，将新 ZIP 解压或导入到项目的
extensions/icarus-tool，再重新打开 Creator。 - 重新确认授权打开资产管理或构建发布面板，确认用户 ID、授权状态和新版本号均显示正常。
05
UPDATES & TROUBLESHOOTING
更新与常见问题
提示凭证无效
先确认凭证没有多余空格，再到帮助中心查询有效期、状态、剩余名额和已绑定设备。
查询凭证 →提示设备已撤销
管理员删除设备绑定后，该设备将不能再使用原凭证。请联系凭证管理员更换新的凭证。
无法连接服务器
检查系统时间和网络，确认可以访问 https://api.icarustool.com。离线时受保护功能会自动停用。
发现新版本
插件会检查最新发布包，下载完成后严格核对文件大小和 SHA-256；校验失败不会保存最终文件。
YOU ARE READY
教程完成，开始整理你的项目。
遇到授权问题时，先查询凭证和设备绑定；处理资源或构建配置时，始终保留可回退的项目版本。