Dify可通过GCS直接读取高分辨率图像以提升视觉分析性能。需创建同区域Standard存储桶、配置服务账号权限、导入JSON密钥，并在插件中设置bucket名与URI（gs://格式）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要将高分辨率图像上传至Google Cloud Storage（GCS）并让Dify在视觉分析任务中直接读取，而不是下载后本地处理——这能避免带宽瓶颈、提升多节点并发分析吞吐量，并确保原始像素信息不因中间压缩丢失。
创建GCS存储桶并配置权限
登录Google Cloud Console → 进入“Storage” → 点击“Create bucket”，Bucket name必须全局唯一，Region建议选与Dify部署地同区域（如Dify在us-central1，则选该区域），Location type选“Region”，Storage class用“Standard”。【不要勾选“Uniform bucket-level access”】，否则Dify插件无法按对象粒度设置ACL。
创建完成后，点击进入该bucket → 左侧菜单选“Permissions” → 点击“ADD” → 在New principals栏输入服务账号邮箱（格式为dify-gcs@your-project.iam.gserviceaccount.com）→ 选择角色为“Storage Object Viewer”和“Storage Object Creator” → 保存。
生成并配置服务账号密钥
进入Google Cloud IAM页面 → 找到你刚创建的服务账号 → 点击右侧“KEYS”标签页 → “Add key” → “Create new key” → 格式选JSON → 下载密钥文件（自动命名为类似your-project-123456-abcdef7890.json）。
将该JSON文件内容完整复制，粘贴进Dify后台的插件配置项“GCS Service Account Key”字段。注意：此密钥含私钥，【绝不可提交到Git或共享给非运维人员】。
注册GCS图像处理器插件
方法一：通过Dify UI安装（推荐新手）
进入Dify控制台 → 左侧导航栏点“Plugins” → 点击右上角“+ Add Plugin” → 搜索“gcs-image-loader” → 点击“Install” → 填写Bucket Name（如my-dify-vision-bucket）、Service Account Key（粘贴上一步JSON全文）、默认Image Format（选JPEG或PNG）→ Save。
方法二：手动注册（适合CI/CD集成）
在Dify项目根目录下创建plugins/gcs_loader.py，内容需包含register_processor函数，调用register_image_processor("gcs", GCSImageLoader)；然后修改.env中PLUGIN_STORAGE_PATH=/path/to/plugins，确保Dify启动时加载该插件。
在视觉分析工作流中调用GCS图像
第一步：新建一个Agent应用 → 进入“Orchestration”画布 → 拖入“Start”节点。
第二步：添加“Tool Call”节点 → Tool类型选“gcs-image-loader” → 在Configuration面板中填写GCS URI，格式必须为gs://your-bucket-name/path/to/image.jpg（注意是gs://开头，不是https://）。
第三步：连接至“LLM”节点 → 在Prompt中明确要求模型基于原始图像像素分析，例如：“请逐像素检查该工业零件表面是否存在微米级裂纹，输出坐标范围与置信度”。
测试时上传一张12MP以上的JPEG图像到GCS bucket对应路径，触发工作流。若返回403 Forbidden，说明服务账号缺少Storage Object Viewer角色；若返回404 Not Found，检查URI中bucket名拼写是否与GCS控制台完全一致（区分大小写）。
