﻿简顿科技视觉工作台 expert-3.7.0
GrsAI Gemini兼容接口与生图方案快捷切换（2026-10-28）

一、入口
主界面现有顶栏新增“生图方案”下拉框及“管理方案”按钮。
模板预置生图、对话生图、AI细修、局部重绘及AI加文案使用同一个生图方案选择。
不必进入原API设置日常切换。

二、首次添加GrsAI
1. 点击“管理方案”→“新增GrsAI方案”。
2. 填写：
   基础地址：https://grsai.dakka.com.cn/v1beta
   模型：nano-banana-fast，或文档支持的其他型号
   认证：bearer（若节点明确要求x-goog-api-key，可另行选择）
   图像参数格式：imageConfig
   API Key：GrsAI自己的密钥
3. 保存。默认“保存后启用”，也可稍后从主界面下拉选择。
程序构造兼容请求：
https://grsai.dakka.com.cn/v1beta/models/nano-banana-fast:generateContent
使用原生contents、generationConfig、参考图Base64及内联图片返回，不混用/v1/draw的流式、回调或轮询格式。

三、多方案保存
可新增Google、GrsAI，或选择compatible配置其他Gemini兼容节点。
支持修改已有方案、另存新方案和重启恢复选中项。
旧方案密钥留空即保留；另存会复制该方案密钥。
“当前Google配置”继续使用原API设置，不要求重新录入原密钥。
原API设置里的生图模型字段用于这个默认方案；已保存的独立方案不随该字段改动。

四、规格限制
Fast和nano-banana没有列在所提供文档的imageSize支持名单中，本版保守只允许1K、不发送imageSize。
需要2K/4K请选支持的型号，例如nano-banana-2，或根据实际情况修改任务清晰度。
nano-banana-2.1、nano-banana-2、nano-banana-pro、nano-banana-pro-vt：1K/2K/4K。
nano-banana-2-cl、nano-banana-pro-cl：1K。
nano-banana-2-2k-cl：2K；nano-banana-2-4k-cl、nano-banana-pro-4k-vip：4K。
nano-banana-pro-vip：1K/2K。
规格不匹配会提前提示，不自动换模型或降低清晰度，也不改变产品保护画布。
这些限制基于提供的文档，未进行真实付费节点验证。

五、独立与稳定性
只切换生图与AI修图；产品识别、资产分析、推理、文案分析和记忆蒸馏保持原有配置。
当前流程仍需要有效的识别接口及密钥。
任务运行中禁用切换；每次任务固定所选方案和密钥快照。
错误或超时不自动换服务商、换认证、调用另一绘图接口或重复发送生图请求。
历史记录保存非敏感的方案来源；用量按实际服务地址和模型记录。没有返回Token时显示未知，费率按对应服务地址及模型维护。

六、密钥与数据
方案：D:\简顿科技视觉数据\生图方案\生图方案.json
独立密钥：同目录“密钥”文件夹，使用Windows当前账户加密。
普通配置、历史、日志及升级包不保存明文密钥。
换电脑或Windows账户后，请在使用电脑输入自己的密钥；不自动同步开发电脑账户。

七、升级
关闭工作台，将累计升级包解压到任意独立文件夹。
不要解压到 D:\产品视觉工作台 或其子目录。
运行“安装或更新到D盘.cmd”，完成后用桌面快捷方式启动。
保留本机原设置、模板、统计、记忆及密钥数据。

“检查参数”仅本地检查，不联网，不代表密钥或服务已验证。
本次使用模拟接口验收，没有调用真实付费生图API。

验收结果：261项全量离线回归通过，界面及启动检查通过；升级包校验及源码哈希校验通过。
