Files

shumengya 50edff80f5 feat: 导出 SproutClaw .sproutclaw 配置

包含 extensions、skills、prompts、settings、auth、models、mcp 等配置。
排除 node_modules、npm 缓存、sessions 等运行时数据。

2026-06-26 15:48:56 +08:00

6.9 KiB

Raw Blame History

快速入门

最快做出第一份 deck 的路径、围绕它的各项能力——模板、实时预览、动画、旁白、声音复刻——以及出问题时去哪里查。章节大致按你真实使用时遇到它们的顺序排列。每节都是精简版,需要细节就点 完整说明 → 链接。

用模板
做出第一份 deck
实时预览与可视化修改
转场与动画
旁白与视频
使用复刻音色
遇到问题怎么办

用模板

可选。 默认走自由设计——不需要模板,可以直接跳到下一节。只有当 deck 必须复用一套固定版式或品牌时,才需要模板。

复用现成 .pptx 有两条路,取决于你想要什么结果:

你想要…	路径	会发生什么
就要这份 deck,换成新内容	套模板(template fill)	挑出合适的页面,把文字 / 表格 / 图表数据直接写回原文件。设计、版式、图片、动画都保留;输出就是同一份 deck,原生可编辑。最快;但受限于现有页面。
基于这份 deck 的风格生成新 deck	create-template	把 `.pptx` 解析成可复用的风格资产包,再走 SVG 管线重新生成——结构自由、页数任意。更灵活;完整重建。

前者:把 .pptx 连同素材(或一个主题)给 AI,说「套模板」——见套模板工作流。本节其余部分讲 create-template。

想基于某份现成 PPT 的风格重新生成 deck,必须显式走 create-template 流程——别直接丢个 .pptx 指望 AI 自动处理。 AI 默认走自由设计,不会主动切进创建模板的流程;不显式启动它,生成过程就容易错乱。先用 create-template 把那份 .pptx 复刻成 PPT Master 模板:

你：用 /create-template 把这个复刻成模板：projects/brand/our_deck.pptx

这会跑 pptx_template_import.py,把文件重建成可复用的资产包——版式 SVG + design_spec.md + 抽取出的主题色、字体、图片。生成时引用的就是这个资产包。

复刻出的模板可以放在两个位置之一:

位置	路径	说明
注册进 skill 库	`skills/ppt-master/templates/layouts/<id>/`	全局,所有项目可复用;跑 `register_template.py` 后,问"有哪些模板"时会被列出来
放进项目里	`projects/<project>/templates/`	项目本地;给路径即用,无需注册

无论放哪,生成时都靠在对话里给出它的目录路径来引用——工作流只认显式路径,绝不认裸模板名:

你：用 sources/report.pdf 做 deck,模板用 skills/ppt-master/templates/layouts/academic_defense/

完整说明 → 模板指南

做出第一份 deck

整个流程就三步。先装好环境——只需要 Python,见快速开始。

把源材料放进 projects/ —— PDF、DOCX、Markdown、一个网址,或直接要粘贴的文字。
在对话里告诉 AI 要把什么做成 deck(如果上面准备了模板,把它的路径一起给;否则就是自由设计):
```
你：用 projects/q3-report/sources/report.pdf 做一份 PPT
你：把这份内容做成 PPT：<粘贴你的文字>
```
拿回可编辑的 .pptx,位于 exports/<名称>_<时间戳>.pptx —— 真正的 DrawingML 形状、文本框、图表,在 PowerPoint / Keynote / WPS / LibreOffice 里点开就能改。

开始前 AI 会先确认一份简短的设计规格(模板、格式、页数……);之后内容分析、排版、配图、SVG 生成、导出都由它完成——这就是其它能力围绕的核心环节。

实时预览与可视化修改

生成过程中会自动打开浏览器预览 http://localhost:5050。

实时看着每页渲染出来。
直接改,无需 AI —— 选中元素后在右栏改文字、颜色、字体、字号;拖拽即可移动,或用方向键微调(Shift = 10px),Ctrl+Z 撤销。改动即时预览,点 Apply changes 写回 svg_output/。
或写注解交给 AI —— 点选元素写一句要改成什么,点 Submit annotations,再回对话说"应用注解"(或 "apply my annotations"),AI 会改写那块区域并重新导出 PPTX。

PPT Master 最初是纯对话设计;可视化编辑是在很多用户提出后融入的(建立在 @WodenJay 的 PR #85 之上)。

完整说明 → 实时预览工作流

转场与动画

导出的 deck 自带页间转场和页内元素入场动画,输出为真正的 OOXML——不是嵌入视频。默认元素进入页面时自动级联入场,无需设置,在 PowerPoint 和 Keynote 中原生播放,无需额外工具。只有当你想要特定顺序、效果或时序时,才需要定制。

完整说明 → 转场与动画

旁白与视频

把演讲者备注按页生成语音旁白,把音频嵌回 PPTX,再用 PowerPoint 导出带旁白和转场的 MP4——无需第三方工具。

你：给这个 PPT 生成音频,并把音频嵌回重新导出
你：给这个 PPT 生成音频

旁白默认用 edge-tts(约 90 种语区);需要更高质量音色可配置云端 provider。AI 会按 deck 语言推荐音色,生成前只问你一次。

完整说明 → 音频旁白与视频导出

使用复刻音色

用 ElevenLabs / MiniMax / Qwen / CosyVoice 复刻你自己的声音(或在授权前提下复刻演讲者的声音),让整份 deck 用 你的声音 念出来。在 provider 控制台复刻一次,把得到的 voice_id 传进来,PPT Master 就会用这个音色逐页朗读备注并嵌回 PPTX。

完整说明 → 使用复刻音色

遇到问题怎么办

常见问题(FAQ) 是持续更新的排查真值——来自真实用户反馈。最常见情况的快速指引:

情况	先试这个
AI 跑偏或漏了步骤	让它重新读 `skills/ppt-master/SKILL.md`。
视觉质量不理想	换成大上下文 Claude 模型 + `gpt-image-2`——harness 决定下限,模型决定上限。
文字溢出或元素重叠	重跑那一页,或用实时预览修;详见 FAQ。
没有生图 API key	零配置的网络图片搜索仍可作为兜底;见 FAQ。
动画或部分效果在别的软件里不对	文件是标准 `.pptx`,PowerPoint / Keynote / WPS / LibreOffice 都能打开;元素动画在 PowerPoint 2016+ 和 Keynote 还原最完整,更老的 Office 会把部分效果降级为 Appear。
担心长 deck 撑爆上下文	生成可走分段模式;详见 FAQ。

模型选择、费用、图表可编辑性、自定义模板等,都在 FAQ 里。

6.9 KiB Raw Blame History Unescape Escape