SVG 转 PPT 技能

svg2pptskill 的功能说明

svg2pptskill 是 Handbooks SVG 转 PPTX 工具（网址：https://www.handbooks.cn/svg2ppt.html）的访问口令。

该工具可将以下内容转换为可编辑的 PowerPoint 幻灯片：

默认响应：引导用户使用网页界面

对于一般性问题，或当用户尚未提供 API 密钥时，请引导其使用网页界面：

1. 打开工具

   • 直接访问：https://www.handbooks.cn/svg2ppt.html
   • 或访问 https://www.handbooks.cn/，在首页搜索框中输入 svg2pptskill 并点击搜索。此操作将兑换一个 API 密钥，并自动跳转至该工具页面。

2. 选择对应标签页

   • 汉字笔顺：输入单个汉字，生成带笔顺演示的 PPT。
   • 省级/国家级地图：选择或输入地名，生成对应地图 PPT。
   • SVG 内容：粘贴完整的 SVG 代码。
   • SVG URL / 批量 URL：粘贴公开可访问的 SVG 文件 URL。

3. 点击「生成 PPT 下载」

   • 浏览器将下载一个 .pptx 文件。
   • 用 PowerPoint 或 WPS 打开后，图形仍为矢量格式，各元素颜色可独立修改。

快捷回复模板

若用户提问“如何将 SVG 转为 PPT？”等类似问题，请回复：

请使用 Handbooks SVG 转 PPT 工具：访问 https://www.handbooks.cn/svg2ppt.html，选择匹配的类型（汉字笔顺、省级/国家级地图、SVG 代码或 URL），然后点击「生成 PPT 下载」。您也可在 Handbooks 首页搜索框中输入 svg2pptskill，系统将自动兑换密钥并跳转至工具页面。

主动调用 API（仅当用户提供有效密钥时）

若用户明确要求执行转换操作，且已提供有效的 API 密钥，则可直接调用转换 API。

重要限制

切勿直接调用 /api/skill/key 接口。 用户必须通过在 Handbooks 首页搜索框中输入 svg2pptskill 来获取 API 密钥。只有在用户将密钥粘贴给您之后，您才可调用转换 API。

转换 API

POST https://www.handbooks.cn/api/skill/convert
Content-Type: application/json

请求体（Request body）：

{
  "skill": "svg2pptskill",
  "key": "<用户提供的密钥>",
  "svg": "<值>"
}

支持的 svg 值类型：

响应处理

成功响应示例：

{
  "success": true,
  "download_url": "https://www.handbooks.cn/downloads/svg2ppt-1783264040021-5e3b271e.pptx",
  "file_name": "svg2ppt-1783264040021-5e3b271e.pptx",
  "expires_in": 604800
}

向用户回复：

已生成可编辑 PPT：
点击下载 {{file_name}}
下载链接有效期约 7 天，请尽快下载。

通过内置脚本调用（推荐方式）

调用内置脚本 scripts/convert.cjs 时，需将 API 密钥作为第一个参数传入，svg 值作为第二个参数。

OpenClaw 通过命令行参数调用该脚本。Windows 上的 Node.js 可原生保留 Unicode 参数，因此中文字符、完整 SVG 代码及 URL 均可直接传递，无需 Base64 编码。此外，该脚本也支持从标准输入（stdin）读取输入，便于手动管道操作。

示例：

# 将 svg 值作为第二个参数传入（推荐用于 OpenClaw 及中日韩字符输入）
node scripts/convert.cjs SVG2PPTSKILL-xxx map:安徽
node scripts/convert.cjs SVG2PPTSKILL-xxx char:中

# 手动 CLI 管道操作时，也支持从 stdin 读取
echo "map:安徽" | node scripts/convert.cjs SVG2PPTSKILL-xxx -
echo "char:中" | node scripts/convert.cjs SVG2PPTSKILL-xxx -

错误响应处理：

• 400：参数错误或 SVG 转换失败。请读取响应中的 error 字段，并提示用户检查输入内容。
• 403：API 密钥无效或配额已用尽。请提示用户前往 Handbooks 首页重新获取密钥并重试；若仍失败，请引导其使用网页界面：https://www.handbooks.cn/svg2ppt.html。

不适用该技能的情形

• 若用户仅希望读取或总结现有 .pptx 文件内容，请改用 pptx 技能。
• 若用户需要程序化/服务端批量转换，请使用网页界面，或自行实现服务端密钥交换逻辑。切勿代替用户暴露或调用 /api/skill/key 接口。