RAYCAST_AI_SUPPORT.md•3.23 kB
# Raycast AI 支持说明
## 客户端环境
用户使用的是 **Raycast AI** (而非 Claude Desktop),它支持 **Markdown 渲染**。
## 输出格式
当前实现已经完美支持 Raycast AI,返回格式为:
```markdown
✅ 图片生成成功!
提示词: 中文"可口可乐",潮流派对风格艺术字体
尺寸: 2K
---
**📸 图片预览:**

---
**📋 详细信息:**
**☁️ 七牛云链接:**
- 图片 1: https://newimg.t5t6.com/seedream/20251118_115120_xxx.jpeg
**💾 本地保存:**
- 图片 1: `/Users/joe/Dropbox/code/Seedream_MCP/seedream_images/2025-11-18/text_to_image/xxx.jpeg`
```
## 关键特性
1. ✅ **Markdown 图片渲染** - Raycast AI 会自动渲染 `` 格式的图片
2. ✅ **七牛云公网链接** - 可以复制分享给他人
3. ✅ **本地保存路径** - 方便本地查看和管理
## 技术实现
- **返回类型**: 只返回 `TextContent` (不需要 `ImageContent`)
- **图片格式**: Markdown 格式 ``
- **自动上传**: 图片自动上传到七牛云,生成公网可访问的 URL
## 与 Claude Desktop 的区别
| 特性 | Raycast AI | Claude Desktop |
|------|-----------|----------------|
| Markdown 渲染 | ✅ 支持 | ❌ 不支持 TextContent 中的 Markdown 图片 |
| 需要 ImageContent | ❌ 不需要 | ✅ 需要 (base64 编码) |
| 返回格式 | TextContent | TextContent + ImageContent |
## 测试结果
```bash
$ python test_raycast_output.py
================================================================================
完整的 Markdown 输出:
================================================================================
✅ 图片生成成功!
提示词: 中文"可口可乐",潮流派对风格艺术字体
尺寸: 2K
---
**📸 图片预览:**

---
**📋 详细信息:**
**☁️ 七牛云链接:**
- 图片 1: https://newimg.t5t6.com/seedream/...
**💾 本地保存:**
- 图片 1: `/Users/joe/Dropbox/code/Seedream_MCP/seedream_images/...`
================================================================================
验证结果:
✅ 包含 Markdown 图片: True
✅ 包含七牛云链接: True
✅ 包含本地路径: True
🎉 测试通过! Raycast AI 应该能够渲染 Markdown 图片
================================================================================
```
## 使用方法
在 Raycast AI 中使用 MCP 工具生成图片:
```
"潮流派对,关键词:可口可乐"
```
Raycast AI 会:
1. ✅ 显示文本说明(提示词、尺寸等)
2. ✅ **渲染 Markdown 图片** (直接显示图片预览)
3. ✅ 显示七牛云链接(可复制分享)
4. ✅ 显示本地保存路径
## 代码位置
- `seedream_mcp/tools/image_helpers.py` - `create_image_content_response()` 函数
- 第78-84行: Markdown 图片预览
- 第92-97行: 七牛云链接
- 第99-103行: 本地保存路径
## 总结
✅ **当前实现已经完美支持 Raycast AI!**
- 返回 `TextContent` 包含 Markdown 格式的图片链接
- Raycast AI 会自动渲染 Markdown 图片
- 同时提供七牛云链接和本地路径
- 无需修改代码,直接使用即可