| name | xiangyu-slides |
| description | AI 演示文稿生成工具。通过调用 xiangyu-slides API 生成 HTML 演示文稿，支持多种风格选择，适合创建融资演讲、教学培训、会议演讲等场景。 |
| version | 1.0.0 |
| metadata | {"openclaw":{"homepage":"https://github.com/kyirexy/xiangyu-skill#xiangyu-slides","requires":{"anyBins":["curl"]}}} |
Xiangyu Slides
AI 演示文稿生成工具。
Language
Match user's language: Respond in the same language the user uses. If user writes in Chinese, respond in Chinese. If user writes in English, respond in English.
功能
- 生成 HTML 演示文稿
- 12 种预设风格
- 支持内联编辑
- 响应式设计，适配所有设备
配置
首次使用需要配置 API 地址和 API Key。
获取 API Key
- 访问 https://xiangyu-slides.com 注册账号
- 在控制台获取 API Key
配置方式
方式一：环境变量
export XIANGYU_API_URL="https://api.xiangyu-slides.com"
export XIANGYU_API_KEY="your-api-key"
方式二：配置文件
在项目根目录创建 .xiangyu-slides/config.json:
{
"api_url": "https://api.xiangyu-slides.com",
"api_key": "xy_xxxxxxxxxxxxxx"
}
方式三：本地开发模式
如果运行本地服务，可以不配置 API Key：
cd frontend-slides-app
npm install
npm start
http://localhost:3007
使用场景
当用户请求：
- "帮我做个 XX 主题的 PPT"
- "生成一个关于 XX 的演示文稿"
- "做一个 XX 相关的幻灯片"
工作流程
Step 1: 收集信息
使用 AskUserQuestion 一次性收集：
Question 1 — 主题 (header: "主题"):
演示文稿的主题是什么？例如：后羿射日、AI发展趋势
Question 2 — 用途 (header: "用途"):
这个演示文稿的用途？
Question 3 — 长度 (header: "长度"):
需要多长？
- 简短 (5-8 张)
- 中等 (10-15 张)
- 完整 (20+ 张)
Question 4 — 风格 (header: "风格"):
喜欢哪种视觉风格？
深色主题：
- Bold Signal (大胆现代)
- Electric Studio (电气工作室)
- Creative Voltage (创意能量)
- Dark Botanical (暗黑优雅)
浅色主题：
- Notebook Tabs (笔记风格)
- Pastel Geometry (粉彩几何)
- Split Pastel (粉彩分割)
- Vintage Editorial (复古编辑)
特色主题：
- Neon Cyber (赛博霓虹)
- Terminal Green (终端绿)
- Swiss Modern (瑞士现代)
- Paper & Ink (纸墨)
Step 2: 调用 API
curl -X POST "${API_URL}/api/generate" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${API_KEY}" \
-d '{
"topic": "主题",
"purpose": "teaching",
"length": "medium",
"style": "bold-signal"
}'
Step 3: 返回结果
返回给用户：
- HTML 文件内容
- 演示文稿预览
- 使用统计（已用/限额）
API 参考
认证
所有受保护的 API 需要在 Header 中传入 API Key：
Authorization: Bearer your-api-key
端点
| 端点 | 方法 | 认证 | 说明 |
|---|
/api/auth/register | POST | 否 | 注册账号 |
/api/auth/login | POST | 否 | 登录 |
/api/auth/me | GET | 是 | 获取用户信息 |
/api/auth/upgrade | POST | 是 | 升级到付费版 |
/api/styles | GET | 否 | 获取风格列表 |
/api/generate | POST | 是 | 一键生成 |
/api/generate-outline | POST | 是 | 生成大纲 |
/api/generate-html | POST | 是 | 生成 HTML |
注册
curl -X POST https://api.xiangyu-slides.com/api/auth/register \
-H "Content-Type: application/json" \
-d '{"email":"your@email.com","password":"password"}'
响应：
{
"success": true,
"user": {"id": "user_xxx", "email": "your@email.com"},
"apiKey": "xy_xxxxxxxxxxxxxx"
}
生成请求
{
"topic": "演示主题",
"purpose": "teaching|conference|pitch|internal",
"length": "short|medium|long",
"style": "bold-signal|electric-studio|...",
"content": "内容概要（可选）",
"editing": false
}
生成响应
{
"success": true,
"outline": {
"title": "标题",
"subtitle": "副标题",
"slides": [...]
},
"html": "<html>...</html>",
"style": {
"id": "bold-signal",
"name": "Bold Signal",
"vibe": "Confident, bold, modern"
},
"usage": {
"used": 1,
"limit": 10
}
}
错误处理
| 错误码 | 说明 | 解决方案 |
|---|
| 401 | API Key 无效 | 检查 API Key 是否正确 |
| 403 | 限额超限 | 升级到付费版或等待下月 |
| 500 | 服务器错误 | 稍后重试 |
限额超限响应
{
"error": "Usage limit exceeded",
"limit": 10,
"used": 10,
"upgrade": "https://xiangyu-slides.com/pricing"
}
价格
| 方案 | 价格 | 限额 |
|---|
| 免费版 | ¥0 | 10 次/月 |
| 付费版 | ¥9.9/月 | 无限次 |
详情访问：https://xiangyu-slides.com/pricing
