Cameo：利用Codex生成图像的无限画布客户端

Cameo 是一款专为本地 Codex 智能体设计的原生桌面端图像画布工具，相当于为 AI 赋予了用于图像编辑的“眼睛”和“双手”。传统的聊天框界面往往难以精准表达图片修改意图，而 Cameo 通过引入无限空间画布，彻底改变了人机协同图像处理的体验。用户可以直接将本地文件夹作为工作区，图片在画布上直观铺开。你可以像平时思考图像一样，用框选、标记等方式直接指出需要修改的部位，输入简单的指令，修改后的图像便会立刻出现在原图旁边，清晰呈现操作脉络。它不托管模型或售卖 Token，而是完全调用你本地配置好的 Codex CLI 运行，提供安全、非破坏性且连贯的对话编辑体验。Cameo 基于 Tauri 2 构建，支持 Windows 和 macOS 系统，是专业设计师和 AI 爱好者理想的桌面端修图利器。

功能列表

• 文件夹级无限画布：以本地文件夹为核心映射单位（Board），工作区在 WebGL2/PixiJS 渲染的无限画布上展开，支持自由平移、缩放、框选、拖拽及快捷导航。
• 直观的区域标记：提供矩形、椭圆、箭头、画笔和点位等多种标记工具，选中后直接作为视觉蒙版发送给 Codex 智能体，告别繁琐的纯文本方位描述。
• 非破坏性编辑与版本谱系：原图绝不会被覆盖，每一次 AI 生成或编辑的结果都会作为全新图像并排生成于源图右侧，自然形成清晰的版本血缘历史。
• 连贯的会话记忆：每个画板均对应一条持续的 Codex 对话进程，智能体具备状态记忆，允许用户进行诸如“色调调暖一点”、“把刚换的背景变暗”等连续多轮指令操作。
• 内置预设与图像对比：内置一键抠图、图像放大等快捷预设，并提供生动的图像差异滑块（Before/After）及双屏并排对比模式。
• 多会话与工作区管理：支持撤销与重做操作，具备完善的历史时间线保存功能，可通过工作区侧边栏轻松管理最近打开的画板及恢复上一次会话。
• 精细的生成控制台：直接在应用输入框区域调整底层生成模型、AI 推理深度及响应速度，并且支持流式输出和工具调用过程的可视化。
• 全局设置与多语言：内置完整的网络代理配置、统一日志系统，支持简体中文与英文界面无缝切换。
• 跨平台桌面支持：基于高效的 Tauri 2 框架开发，提供体积轻巧、性能强劲的本地应用，全面兼容 Windows 以及 macOS（含 Apple Silicon 与 Intel 芯片）。

使用帮助

一、 安装准备与运行环境配置

Cameo 本身是一个图像界面的宿主与交互框架，其背后的“大脑”是基于你本地的 Codex CLI 运行的，因此在安装 Cameo 客户端之前，必须先配置好相关的依赖环境。目前全面支持 Windows 与 macOS（含 Apple Silicon 与 Intel）。

1. 前置条件检查

• Codex CLI 配置：确保你已在系统中正确安装 Codex CLI，并完成了账户的登录与验证。你可以使用系统终端命令 codex login 或 codex login --with-api-key 进行登录授权，或配置其它受 Codex 支持的模型供应商。随后输入 codex --version 以验证是否安装成功。请注意，Cameo 并不会收集存储你的 API 密钥，而是安全地调用本机的 Codex 进程。
• 开发工具链（仅限通过源码编译安装时需要）：
  • 系统需安装 Node.js（版本 20 及以上），并安装好 pnpm 包管理器。
  • 需要安装 Rust 语言工具链（使用 rustup）。
  • macOS 用户：需要在终端执行 xcode-select --install 安装 Xcode 命令行编译工具。
  • Windows 用户：需安装 Visual Studio Build Tools，并在安装程序中勾选“使用 C++ 的桌面开发”工作负载。系统还需具备 WebView2 运行时（Windows 11 用户通常已自动内置）。

2. 获取与安装应用

• 直接下载预编译版本（推荐）：对于绝大多数普通用户，推荐直接访问 Cameo 的官方主页（cameo.ink）下载已经打包编译好的 macOS（.dmg） 或 Windows 安装包，下载后双击按系统提示完成安装即可。
• 源码编译安装：
  1. 将 GitHub 仓库代码克隆到本地目录。
  2. 运行一键环境初始化脚本：macOS 用户在终端执行 ./setup.sh，Windows 用户在 PowerShell 中执行 .\setup.ps1。
  3. 安装依赖包并启动本地开发环境：执行 pnpm install 之后执行 pnpm tauri dev 即可唤起带有热重载功能的桌面应用。
  4. 如果想要打包成独立的发布程序，可分别使用脚本 build_release.sh 或 build_release.ps1。

二、 核心功能操作与工作流详解

Cameo 放弃了传统聊天框单调的从下往上滚动模式，改用广阔的空间无限画布（Infinite Canvas），下面将带您一步步了解整个工作流程，帮助您快速上手体验。

1. 创建与管理画板（Board）

• 初始化工作区：打开 Cameo 桌面应用，点击主界面的“打开文件夹”按钮。你所选择的本地文件夹即作为一个全新的 Board，并且该目录同样会被设为 Codex 智能体当前的工作目录。
• 导入源图片：当前文件夹内的所有图片都会自动被读取并整齐排列在应用画布上。你也可以直接将系统里的图片拖拽进界面，或者使用粘贴快捷键，系统都会实时将图片载入当前画板并保存在该文件夹中。

2. 灵活驾驭无限画布

• 视角移动与缩放：采用类似专业设计软件的操作逻辑。双指在触控板上滑动即可自由平移画布（鼠标用户可按住中键/空格键拖拽）；按住 Ctrl 或 Cmd 键并滚动鼠标滚轮可以顺滑缩放画面。
• 选取与框选：鼠标左键点击单张图片进行选中；按住 Shift 键并拖动鼠标可以拉出一个选框触发多选，方便后续批量针对多图下达处理指令；鼠标直接拖拽图片本体可随意改变其在画布上的摆放位置。
• 视口辅助控制：界面提供实用的小地图预览功能，也可一键点击“适应全部（Fit-All）”或“缩放至选中（Zoom-to-selection）”。无论你生成了多少张衍生图，都能掌控全局视野，不迷路。

3. 图片标记与 AI 指令交互（核心特色）
这是 Cameo 区别于其他传统 AI 绘图工具的独门秘籍，实现了真正的“指哪改哪”。

• 开启标记模式：选中目标图像后，按下快捷键 R（或点击左侧工具栏的矩形虚线图标），你的光标将变为选框绘制工具。
• 非语言视觉指引：在图像上直接画一个框、画一条线或是点一个点（工具栏支持切换为矩形、椭圆、箭头、笔刷等模式）。此时，这一部分将会以高亮蒙版的形式被系统记录。按 V 键可退出标记模式返回标准指针状态。
• 输入编辑要求：在界面底部的聊天输入对话框输入自然语言指令（例如：“把刚才画框的区域换成夜晚的繁星”），然后敲击回车或点击发送。标记好的区域将作为蒙版图层一并发送给 AI。
• 一键快捷预设：对于常见的修图需求如“移除背景”、“高清放大（Upscale）”等，您可以跳过打字步骤，直接点击对话框旁边的预设操作按钮，体验即刻执行的快感。

4. 检视生成结果与连贯会话迭代

• 非破坏性生成机制：指令发送后，右侧面板将显示 Codex 的流式思考和生成进度。完毕后，最新生成的修改图会自动并排放置在原始素材的“右侧”。原始图片保持原样，绝不会被覆盖修改。通过这种从左至右的空间排列，您能用肉眼直接看清全部的迭代演变历史。
• 持续对话与微调：如果发现效果差强人意，无需重新上传图片！直接选中新生成的图片，继续在输入框输入：“画面色调再暖一点”，系统会继承上下文并顺着这层会话继续微调，实现像日常聊天一样的平滑迭代。
• 对比与导出分享：选中修改前与修改后的两张图，可调出应用内置的对比组件。你可以使用拖拽滑块（Before/After Slider）来回滑动，精准比对前后的细微差异。满意之后，通过右键菜单可一键裁剪、复制到剪贴板，或者在资源管理器中定位源文件并快速导出发布。

三、 进阶设置与环境优化

对于高阶探索用户，Cameo 提供了丰富的客制化控制参数：

• 控制台面板快捷调节：在输入框侧边，用户可以直观地调节 Codex 生成引擎的核心参数。你可以自由选择想要调用的基础大语言模型底座，并调整其智力水平（Reasoning effort）和响应生成速度（Speed），完美适配不同复杂程度的任务。
• 网络代理与多语言支持：点击进入系统的“设置”页面，可以配置应用层的全局网络代理。这涵盖了 Codex 接口通讯、Prompt 提示词画廊的访问以及后台版本更新等请求。此外，Cameo 支持简体中文和英文的一键切换，国内用户也能无障碍畅享所有功能。

通过以上细致的操作指引，无论你是探索 AI 辅助设计的尝鲜者，还是每天都要和大量图片打交道的专业创意工作者，都能够在 Cameo 这块无限画布上尽情施展，用前所未有的直觉交互方式指挥你的私人 AI 修图助理。

应用场景

1. UI/UX设计师的快速草图迭代与设计探索
   设计师可以将产品设计线框图或素材导入无限画布。利用框选和箭头工具精准标记需要优化的界面模块，输入指令如“生成一个拟物化风格的按钮”或“将这块导航栏背景色调整为科技蓝”。Cameo 的非破坏性生成和空间阵列可以让多个版本的设计方案并排摆放，极大提升探索设计灵感、进行内部方案对比评估的效率。
2. 电商营销图像批量处理与场景替换
   电商运营人员每天需要处理大量繁杂的商品主图。在 Cameo 中，通过加载包含多个商品图片的文件夹建立画板，只需框选商品主体并使用预设的“移除背景”功能，或输入指令“将背景替换为极简风的家居场景”，即可在保留原商品无损图像的情况下，在右侧迅速衍生出多张全新且可直接使用的营销海报图。
3. 插画师与数字艺术创作者的连续风格微调
   数字插画师在进行原画创作时，可以将未上色的线稿或初期草图放入画布。利用 Cameo 的连续会话与上下文记忆功能，逐步指挥 AI 完成“给画面右侧人物头发加上自然高光”、“把左下角背景建筑改为赛博朋克风格”等精细局部修改。空间画布不仅保留了每个阶段的节点，创作者还能随时对比修改差异，如果对某一步不满意，可随时返回前置版本重新下达指令进行延展。

QA

1. Cameo 软件内部是否内置了 AI 大模型？我需要向其付费购买 Token 吗？
   不需要。Cameo 自身定位为桌面端的“眼睛”和“交互双手”，负责空间界面、画布渲染以及图像管理。所有的 AI 语义理解与图像生成都完全依赖并调用你本地系统配置好的 Codex CLI。因此 Cameo 不托管任何模型，也不收取 Token 费用。只要你的本地 Codex 能够正常计费和运作，Cameo 即可免费作为图形前端使用。
2. 如果我不小心对一张重要的原图下达了错误的修改指令，原图会被覆盖或损坏吗？
   绝对不会。Cameo 的核心设计基石就是“永远的非破坏性”。任何通过智能体指令生成的图像修改，都会作为一张完全独立的全新图片文件保存在你当前的工作文件夹中，并直观地展示在原图的右侧。你可以随时查看、对比两者，甚至通过多会话时间线撤销历史操作，原文件及其参数绝对安全。
3. 如果在特殊的国内网络环境下，应用的所有功能是否还能顺畅加载？
   Cameo 客户端虽在本地原生运行，但 AI 交互的流畅度取决于你配置的 Codex 接口网络状态。如果你的 Codex 依赖外部公网 API，可以在 Cameo 的设置中心配置全局网络代理（Proxy）。该代理设置将全面覆盖 Codex 通讯、官方画廊加载和应用的版本更新，确保复杂网络环境也能顺畅访问。此外，软件已完全内置简体中文，无语言障碍。