Inspiration C4D Bridge - 安装与使用
====================================

这是一版根据你上传的 Blender 插件「Inspiration Blender V5.10」重做的 Cinema 4D 桥接插件。

一、安装
--------
1. 解压本压缩包。
2. 把整个文件夹「Inspiration_C4D_Bridge」放到：
   Cinema 4D 安装目录/plugins/
   或者用户插件目录/plugins/
3. 重启 Cinema 4D。
4. 在 C4D 菜单/插件列表里打开「Inspiration C4D Bridge」。
5. 面板高度不够时，右侧会出现垂直滚动条，可以向下滚动查看底部功能。

二、核心功能
------------
1. 本地 ComfyUI：
   - 填写 ComfyUI 原始地址，例如：http://127.0.0.1:8188
   - 可分别设置本地生成宽度和高度。
   - 新增常用尺寸快捷选项：1:1、3:4、4:3、16:9、9:16。
   - 点击「测试 ComfyUI 连接」。
   - 选择或使用内置 workflow_api.json。
   - 默认 LoadImage 节点 ID = 36，Prompt 节点 ID = 16，对应原 Blender 插件工作流。
   - 点击「本地生成」。

2. 在线 / 中转 API：
   - 填写 API Key；支持输入隐藏与本地加密保存。
   - 点击「保存 API/设置」后，settings.json 只保存加密值，不再明文保存 API Key；下次打开面板会显示为掩码。
   - 如果需要更换 API Key，直接在掩码框里粘贴新的 Key 后重新保存。
   - 默认接口地址：https://geekai.co/api/v1/images/generations
   - 可选模型：
     * nano-banana-2
     * nano-banana-pro
     * gpt-image-2
     * 自定义 / 中转 API 模型
   - 如果选择自定义模型，需要填写「自定义模型名」。
   - 点击「保存 API/设置」会提示 API 保存成功。
   - 点击「在线生成」。

3. 色块区域提示：
   - 选择颜色与透明度。
   - 点击「创建正方形色块」或「创建椭圆形色块」，插件会在 C4D 中创建 AI_Color_Zone 色块对象。
   - 在红/橙/黄/绿/蓝/紫区域输入描述后，最终提示词会自动合并。
   - 生成时会自动追加“去掉所有色块和颜色标记”的提示。

4. 参考图独立参考度：
   - 在线 / 中转 API 区域提供 2 个参考图：
     * 参考图 1
     * 参考图 2
   - 每个参考图都有独立参考度滑杆。
   - 滑杆范围是 0-1，步进 0.01。
   - 数值越高，生成结果越贴近对应参考图。
   - 当前 C4D 渲染截图仍作为主输入图，不占用参考图 1 / 2 的命名。
   - 插件会把这些值作为 image_strengths / reference_strengths / reference_image_strengths，以及带序号的字段一并传给在线接口，以兼容不同中转 API。

三、注意事项
------------
1. 本插件使用 C4D 当前渲染设置进行截图，因此如果你当前使用 Redshift，它会调用当前 Redshift 渲染设置。
2. 生成结果会自动尝试在 C4D 图片查看器中打开；如果 C4D 版本不支持，会弹出生成图片的临时路径。
3. 这个版本尽量复刻 Blender 版逻辑，但 C4D 与 Blender API 不同，视口截图/色块可见性无法做到完全一模一样。当前版本采用“当前渲染器渲染截图”的方式，更适合产品渲染工作流。
4. workflow_api.json 是从你上传的 Blender 插件中保留的原始工作流，默认节点 ID 与原插件一致。
5. API Key 使用本地机器/用户环境派生密钥进行可逆加密，适合防止 settings.json 明文泄露；如果把 settings.json 拷贝到另一台电脑，可能无法自动解密，需要重新输入 API Key。
6. 如果某些旧版 C4D 不支持密码输入控件，输入时可能临时可见，但保存后仍会加密写入并在再次打开时显示掩码。

四、常见问题
------------
Q：ComfyUI 测试失败怎么办？
A：先确认 ComfyUI 已启动，并且浏览器能打开 http://127.0.0.1:8188/system_stats。如果你用的是局域网 IP，请把 127.0.0.1 换成对应 IP。

Q：在线 API 保存后没有测试是否成功？
A：为了避免测试接口产生图片生成费用，保存 API 只做本地保存提示；真正请求时如果 Key 或接口不对，会在状态栏显示完整 HTTP 错误。

Q：我想使用其他中转 API？
A：把「图片生成接口地址」改成中转 API 的完整 /images/generations 地址，模型预设选择「自定义 / 中转 API 模型」，然后填写模型名。
