diff --git a/docs/.vitepress/config.ts b/docs/.vitepress/config.ts
index 75bad21..8f5eabc 100644
--- a/docs/.vitepress/config.ts
+++ b/docs/.vitepress/config.ts
@@ -31,8 +31,7 @@ export default defineConfig({
       {
         text: '参考',
         items: [
-          // { text: 'API 端点', link: '/reference/endpoints' },
-          // { text: '常见问题', link: '/reference/faq' }
+          { text: 'Cherry Studio 配置', link: '/cherry-studio-nanobana' }
         ]
       }
     ],
diff --git a/docs/assets/9a1a0771d520055942e263d4b1011328.png b/docs/assets/9a1a0771d520055942e263d4b1011328.png
new file mode 100644
index 0000000..02c63ee
Binary files /dev/null and b/docs/assets/9a1a0771d520055942e263d4b1011328.png differ
diff --git a/docs/assets/add.png b/docs/assets/add.png
new file mode 100644
index 0000000..f354651
Binary files /dev/null and b/docs/assets/add.png differ
diff --git a/docs/assets/cherry studio 官网.png b/docs/assets/cherry studio 官网.png
new file mode 100644
index 0000000..8e18c7a
Binary files /dev/null and b/docs/assets/cherry studio 官网.png differ
diff --git a/docs/assets/setting.png b/docs/assets/setting.png
new file mode 100644
index 0000000..d3144c1
Binary files /dev/null and b/docs/assets/setting.png differ
diff --git a/docs/assets/填写从ke和base url.png b/docs/assets/填写从ke和base url.png
new file mode 100644
index 0000000..9e0f6ac
Binary files /dev/null and b/docs/assets/填写从ke和base url.png differ
diff --git a/docs/assets/添加助手和配置.png b/docs/assets/添加助手和配置.png
new file mode 100644
index 0000000..bc24a69
Binary files /dev/null and b/docs/assets/添加助手和配置.png differ
diff --git a/docs/assets/添加提供商.png b/docs/assets/添加提供商.png
new file mode 100644
index 0000000..b807319
Binary files /dev/null and b/docs/assets/添加提供商.png differ
diff --git a/docs/cherry-studio-nanobana.md b/docs/cherry-studio-nanobana.md
new file mode 100644
index 0000000..f46f60d
--- /dev/null
+++ b/docs/cherry-studio-nanobana.md
@@ -0,0 +1,102 @@
+# 如何在 Cherry Studio 中愉快使用 大香蕉 Nano Banana Pro ？
+
+## 一、Cherry Studio 简介
+
+Cherry Studio 是一款支持多服务商集成的 AI 对话客户端，目前支持市面上绝大多数服务商的集成，并且支持多服务商的模型统一调度。
+
+**官方网站：** https://www.cherry-ai.com/
+
+![Cherry Studio 官网](assets/cherry%20studio%20官网.png)
+
+---
+
+## 二、添加 XCodeCLI 提供商
+
+### 步骤 1：打开设置，添加提供商
+
+在 Cherry Studio 中，点击左下角的 **设置按钮**（齿轮图标），进入设置页面，选择「模型服务」，然后点击底部的「+ 添加」按钮。
+
+![设置页面 - 添加提供商](assets/add.png)
+
+### 步骤 2：配置提供商信息
+
+- **提供商名称：** `XCodeCLI`
+- **提供商类型：** 选择 `Gemini`
+
+> ⚠️ **重要：** 提供商类型必须选择 Gemini，不要选错！
+
+![添加提供商](assets/添加提供商.png)
+
+---
+
+## 三、填写 API 密钥和地址
+
+配置完提供商后，需要填写 API 密钥和 API 地址：
+
+- **API 密钥：** 填入你的 XCodeCLI API Key（以 `sk-` 开头）
+- **API 地址：** `https://api2.xcodecli.com`
+- **模型：** 选择`gemini-3-pro-image-preview`
+
+填写完成后，可以点击「检测」按钮验证配置是否正确。
+
+![填写 API 密钥和地址](assets/填写从ke和base%20url.png)
+
+---
+
+## 四、开始使用：添加助手并生成图片
+
+完成上述配置后，就可以开始生成图片了！
+
+1. 点击左上角「+ 添加助手」创建新助手
+2. 顶部选择模型：`gemini-3-pro-image-preview | Xcodecli`
+3. 直接输入你的绘图需求，即可生成图片
+
+![添加助手和配置](assets/添加助手和配置.png)
+
+---
+
+## 五、进阶：生成高清图片（2K/4K）
+
+想要生成更高清的图片，需要进入助手配置进行额外设置。
+
+点击助手名称旁的 **三点菜单** 进入助手配置，然后：
+
+1. **关闭流式输出** - 这一步很重要！
+
+2. **添加自定义参数：**
+
+| 参数名        | 类型 | 值                                           |
+| ------------- | ---- | -------------------------------------------- |
+| `imageConfig` | JSON | `{"aspectRatio": "16:9", "imageSize": "4K"}` |
+
+> 💡 **提示：**
+>
+> - `aspectRatio` 可选值：`16:9`、`4:3`、`1:1` 等
+> - `imageSize` 可选值：`4K`、`2K`、`1K` 等（K必须是大写）
+> - 详情请参考：[Google Gemini API 文档](https://ai.google.dev/gemini-api/docs/image-generation?hl=zh-cn#aspect_ratios_and_image_size)
+
+![助手参数配置](assets/9a1a0771d520055942e263d4b1011328.png)
+
+
+
+---
+
+## 六、提醒
+
+> ⚠️ **特别注意以下模型的使用：**
+
+| 模型                 | 建议                                   |
+| -------------------- | -------------------------------------- |
+| **Claude 系列**      | 不要在这里用，去 Claude Code (CC) 使用 |
+| **GPT 5.1/5.2 系列** | 只能在 Codex 内使用                    |
+| **Gemini 系列**      | ✅ 推荐使用                            |
+
+---
+
+## 七、快速上手总结
+
+1. 下载安装 Cherry Studio
+2. 添加提供商：名称填 `XCodeCLI`，类型选 `Gemini`
+3. 填写 API Key 和地址 `https://api2.xcodecli.com`
+4. 生成高清图时：关闭流式输出 + 配置自定义参数
+5. 优先使用 Gemini 系列模型，避开天价的 Claude 和 GPT 系列