企业官网建设流程全解析

🖼️AI Toolbox Image工作台是开源项目 AI Toolbox 内置的图片生成与改图模块，帮你在一套本地化的界面里统一管理AI图片生成渠道：接入 Gemini 原生、OpenAI Compatible、OpenAI Responses 三类协议，支持文生图与图生图，并自动保存历史任务与生成资产。本文面向新手，带你完整评测这个「AI 图片生成渠道管理」新方案的核心能力、配置流程与本地化优势。

为什么需要本地化AI图片生成渠道管理

用过多个生图渠道的朋友大概都有同样的烦恼：

• 🔄切换渠道全靠手动：Base URL、API Key、请求路径（images/generations还是images/edits）要在不同工具间反复粘贴；
• 📦生成结果容易丢：网页端生成的图，过两天就找不到记录了；
• 🔁迭代成本高：想让上一张图继续改，得手动下载、再上传、再填提示词；
• 📉渠道故障无感知：网关 504、超时，只能干等或反复重试。

AI Toolbox 是一个跨平台（Windows / macOS / Linux）的桌面应用，主打 AI 编码助手配置管理，而 Image 工作台则是其中一个完全本地化运行的图片模块：渠道配置、任务记录、图片文件都保存在你自己的电脑上，无需注册任何第三方平台。

Image工作台：三步走完一张图的生成流程

打开顶栏的Image入口后，页面分为工作台 / 历史 / 更多三个并列视图。工作台的选图顺序被刻意简化为「模式 → 模型 → 自动渠道」，新手也能零思考上手：

1. 选模式：文生图 或 图生图；
2. 选模型：下拉列表是跨所有「已启用渠道」聚合出来的可用模型，不用关心它属于哪个渠道；
3. 渠道自动就位：系统按渠道排序自动选中第一个可用渠道，你也可以手动切换，比如同一模型在主渠道拥堵时切到备用渠道。

参数区是高密度的横向布局，常用项一目了然：

• 提示词（建议写清主体、光线、风格、镜头语言）；
• 参考图：图生图模式下支持上传最多16 张参考图，可点击、拖拽或粘贴；
• 尺寸：支持「自动 / 按比例 / 自定义宽高」三档，自定义时会自动规整到 16 的倍数；
• 质量、输出格式（PNG / JPEG / WebP）、压缩率、审核等级等参数，会按渠道协议自动隐藏不适用的项——比如选择 Gemini 原生渠道时，质量、输出格式、压缩率等 OpenAI 风格参数会自动消失，避免把错误协议的参数发出去导致网关报错。

生成过程中，结果区会实时展示「第几次请求 / 已重试次数 / 单次超时秒数」等进度信息。后端默认执行「首次请求 + 最多 3 次自动重试」的短间隔策略，能明显减少「同一提示词有时成功、有时失败」的随机体验。这套重试与协议适配逻辑的说明见 tauri/src/coding/image/AGENTS.md。

渠道管理：三种图片协议可视化配置

「更多」视图下的渠道管理是这个模块的核心，也是「本地化渠道管理新方案」的落地之处。每个渠道是一张独立的配置卡片：

三种协议在底层由统一的适配层处理，例如 Gemini 原生走models/{model}:generateContent并使用x-goog-api-key鉴权，Responses 协议固定走/v1/responses，相关实现集中在 tauri/src/coding/image/commands.rs；前端则通过集中的 provider profile 声明各类型的默认地址与参数可见性，见 web/features/coding/image/utils/providerProfile.ts。

💡新手建议：新增渠道时先只启用一个最熟悉的渠道跑通流程，再逐步添加备用渠道并调整排序，形成「主渠道 + 备渠道」的高可用组合。

历史与资产：生成结果不丢失，一键继续迭代

「历史」视图保存了所有图片任务，每条记录都附带参数摘要与缩略图：

• 下载：结果图直接导出到本地任意目录；
• 继续迭代：一键把该任务的输出图作为参考图，自动切到图生图模式并返回工作台——这是迭代出满意画面的最高效路径；
• 请求详情：仅用于排障，展示脱敏后的请求头与请求体摘要，不会把真实 API Key 暴露在界面上；
• 删除：可选择「同时删除本地图片文件」，清理彻底。

数据层面采用「元数据入数据库 + 图片文件落盘」的设计：任务记录存在 SQLite 中，真实图片文件保存在应用数据目录的image-studio/assets/下。这样历史可以无限积累而不撑爆数据库，且天然接入备份链路。相关设计与约束见 web/features/coding/image/AGENTS.md。

本地化数据与备份恢复：图片资产也能打包带走

本地化最大的价值是数据可控。在「设置 → 网络与备份」中，AI Toolbox 支持本地备份、WebDAV 云端备份、定时自动备份，且图片资产默认包含在备份包里（如上图右侧的数据备份卡片）。如果你只想备份配置、不想要图片文件，可以关闭图片资产备份开关来减小体积。这意味着换电脑或数据损坏时，渠道配置、历史任务、生成的图片可以整套恢复，不会出现「历史记录还在、图片文件丢了」的分叉。备份模块的实现说明见 tauri/src/settings/backup/AGENTS.md。

评测小结：谁适合用 AI Toolbox Image工作台？

✅推荐人群：

• 同时拥有多个 AI 图片生成渠道（官方 API、自建网关、中转服务），想统一管理、互为备用；
• 习惯本地工作流，不希望创作记录分散在各个网页标签页；
• 需要频繁「图生图」迭代，看重一键复用参考图的能力。

✅核心价值：三种图片协议的可视化渠道管理 + 自动渠道选择 + 本地历史资产与备份，把「AI 图片生成渠道管理」从一堆 JSON 配置变成了桌面级的工作流。

📌相关模块路径，方便进阶阅读：

• 前端工作台页面：web/features/coding/image/pages/ImagePage.tsx
• 渠道配置弹窗：web/features/coding/image/components/ImageChannelModal.tsx
• 界面文案（工作台的交互语义）：web/i18n/locales/zh-CN.json
• 后端任务与协议实现：tauri/src/coding/image/