安装步骤：

1. 双击com.test.gemini.ultimate.v5_PS.ccx

   
   

2. 点击安装

   
   

3. 点击确认

   
   

4. 打开Photoshop，出现插件框

1. 输入Google AI Studio API密钥，点击保存，即可生图

   
   

   

2. 出图成功
   

   
   

常见问题（用户支持）

本插件支持MAC系统和WIN系统

安装与启动

问：双击 .ccx 没有反应？

答：请确认已安装 Creative Cloud 与兼容版本的 Photoshop（见 manifest.json 中的 host.minVersion）。若仍无法安装，尝试先打开 Creative Cloud 桌面应用再双击安装包。

问：面板里一片空白？

答：尝试在 UXP Developer Tool 中 Reload；正式安装版可尝试在插件菜单中关闭再打开面板，或重启 Photoshop。

API Key 与 Google

问：提示 API Key 无效？

答：请使用 Google AI Studio 创建的 API 密钥（通常以 AIza 开头），完整粘贴、勿含空格；并在 Google Cloud / AI Studio 中已启用 Generative Language API。不要将「OAuth 客户端 JSON」当作 API Key 粘贴。

问：费用谁承担？

答：Gemini API 用量由您的 Google 账号与项目计费，与本插件作者无关（BYOK 模式）。请参阅 Google 官方定价说明。

生成失败与网络

问：提示 high demand / 503 / 429？

答：多为 Google 侧繁忙或限流；可稍后重试、换模型、降低输出尺寸，或关闭「附带当前画布」以减轻负载。

问：约 1 分钟就中断 / AbortError？

答：可能与 Photoshop/UXP 对长时间请求的限制或网络有关；可尝试较小尺寸、关闭图生图，或见插件内状态栏说明。

许可证（商业版）

问：许可证在哪里输入？

答：在面板内的「许可证」区域粘贴密钥并激活（若当前构建启用了许可证功能）。