dashi-ppt
制作 PPT、演示文稿、幻灯片、汇报材料时使用。Dashi PPT 基于预置视觉主题组合页面,生成可离线打开、可在浏览器编辑的 HTML 演示,支持导出 PPTX / PDF 文件。
By chuspeeism · 608 installs
npx skills add chuspeeism/dashi-ppt-skill --skill dashi-ppt
Source repository · Upstream listing
Dashi PPT
Dashi PPT 生成静态 HTML 横向翻页 PPT。使用本 skill 时,先把用户的自然语言需求整理成 JSON 计划,再调用本地项目生成器输出 index.html 和 assets/ 。
版本
当前版本: 0.4.14
每次完成用户请求、准备最终回复前,运行:
如果脚本有输出,把输出内容附在最终回复末尾提醒用户更新;如果脚本无输出或检查失败,保持静默,不要提版本检查。
Skill 目录
当前 SKILL.md 所在目录就是 Skill 根目录,下文记为 <skill root 。
内置生成器目录:
<skill root /project
渲染脚本:
macOS / Linux: <skill root /scripts/render goal deck.sh
Windows PowerShell: <skill root /scripts/render goal deck.ps1
版本检查脚本:
<skill root /scripts/check latest version.mjs
生成原则
本 Skill 为每个逻辑页生成 3 个模板方案和 1 个 Agent 定制方案,输出可离线打开的 HTML PPT。
前三个模板方案使用“锁模板填文案”:保留所选页面组件的原始视觉、结构、数量、显隐、强调、配色、图表类型和图片槽位,只替换可见文字内容。除非用户明确要求调整页面属性,不要改任何非文案 props。第四个方案由 Agent 在当前主题视觉语言内按本页内容定制,不属于模板候选。
成果验收是默认流程。每次生成后都要判断最终产物是否达到用户目标;默认检查目标、内容、结构、明显可见问题和交付完整性,不做截图审美精修,不因普通断行反复返工。用户明确要求“视觉精修”“100% 检查”“帮我调到满意”时,再扩展为视觉 QA。
使用规则
运行生成器需要 Node.js 20+ 和 npm;首次生成时渲染脚本会在 Skill 内置 project/ 目录安装依赖。Windows 用 render goal deck.ps1 (直接 PowerShell,不经 WSL/bash);macOS / Linux 用 render goal deck.sh 。
风格选择提问:用户可见回复必须嵌入 <skill root /assets/skill/theme style grid.png 的 Markdown 图片,先展开绝对路径;这是回复展示用内置风格图,不可写入 goal.json 或任何 media 字段;列出当前可选风格和极简“适合/人群”,不能只在内部进度提示中提到风格图。
开工前确认两件事:主题风格、是否需要图片/视频。用户未明确表达且非整体委托时,先提问等答复,不得代选;无法提问的环境(脚本/批处理)才自选,并在交付说明中列出所选与理由。
委托模式:仅当用户对整体明确委托(“都你来定”“不用问,直接开干”)时,才自选主题、默认 HTML、默认不使用 image gen,最终说明假设。用户只说内容/文案“随意”“自拟”时,仅自拟内容;风格、页数、媒体等已给的不得擅自改变,未给的按上一条先问。
非交互/一次性执行(无法追问)时:未指定风格按内容主题自选已验收主题;无真实素材且不能生图时优先选无媒体页,不调 image gen;最终说明全部假设。
Deck 语言跟随用户沟通语言:非中文用户在 goal.json 顶层加 "language": "en" ;全部文案字段用目标语言撰写,页面自带的默认中文文案(含结尾页“感谢阅读”类装饰字段)一律覆盖,不得残留中文。编辑器界面语言自动跟随打开者的系统语言,右上角可手动切换,无需在生成时处理。
交付格式:默认 HTML;“生成 PPT”“做 PPT”“做一个 PPT”“制作 ppt”表示 PPT 呈现形态。只有明确 PPTX 、 PowerPoint 、 可编辑 PPTX 、 导出 PPTX 、 PPT 格式 或“格式/文件类型为 PPT/PPTX”时才交付 PPTX 文件。
PPTX 文件:仍先生成 HTML 并启动本机预览服务,再调用本机 HTTP 导出服务;最终只给 PPTX 文件路径或下载结果。
当前可选风格: theme01 轻拟态风、 theme02 炫光紫绿风、 theme03 深浅代码风、 theme04 玻璃糖果风、 theme05 色谱图表风、 theme06 深色图谱风、 theme07 冷白调研风、 theme08 黑金实验风、 theme09 深蓝杂志风、 theme10 金色指数风、 theme11 高能增长风、 theme12 声波霓虹风。
普通自动选择不选 theme10 ;只有用户明确指定,或金融/投资指数内容强相关且 inspect 确认可填时才用。
<! theme choice hints:start
theme01 轻拟态风 适合: 产品介绍 / 企业汇报 人群: 创业团队 / 产品经理
theme02 炫光紫绿风 适合: 科技发布会 / AI/自动驾驶/机器人主题 人群: 科技公司创始人 / 技术负责人
theme03 深浅代码风 适合: 技术方案 / 开发者大会 人群: 工程师 / 技术管理者
theme04 玻璃糖果风 适合: 年轻化品牌 / 消费产品 人群: 品牌团队 / 设计师
theme05 色谱图表风 适合: 数据报告 / 市场分析 人群: 数据分析师 / 咨询顾问
theme06 深色图谱风 适合: 高密度数据展示 / 战略分析 人群: 战略团队 / 投资人
theme07 冷白调研风 适合: 调研报告 / 白皮书 人群: 研究机构 / 咨询团队
theme08 黑金实验风 适合: 高端发布 / 品牌提案 人群: 高端品牌 / 创意总监
theme09 深蓝杂志风 适合: 品牌故事 / 人物访谈 人群: 公关团队 / 媒体编辑
theme10 金色指数风 适合: 金融数据 / 投资报告 人群: 投资机构 / 金融分析师
theme11 高能增长风 适合: 增长复盘 / 商业计划 人群: 创业者 / 增长团队
theme12 声波霓虹风 适合: 音乐娱乐 / 潮流活动 人群: 娱乐品牌 / 活动策划
<! theme choice hints:end
不使用旧 token、旧主题、旧媒体槽、旧风格分支或旧入场动画控制。
选页先用 npm prefix <skill root /project run layout:query theme <themePack role <role limit 8 seed <randomSeed :slide <n ;每个逻辑页的 3 个模板方案必须是结构指纹不同的 layout。相同 seed 和输入必须稳定,也不要固定只用未打散列表的前三条。跨逻辑页允许在候选稀缺时复用,由既有跨页 layout/组合/family 软惩罚降低重复。需要媒体槽时加 needs media 、 planned images <n 、 provided images <n 或 image gen 。
字段不清楚、对象/数组/count、图片/媒体:先运行 npm prefix <skill root /project run inspect:layout compact <layout... 检查该页 3 个模板方案;单 layout 写 props 时运行 props:safe ;schema v2 结构投影 goal 运行 goal spec 校验,不要用 props:safe write 回填 props。
把 layout:query / inspect:layout 的 JSON 管道给程序解析时,改用 node <skill root /project/scripts/layout query.mjs / node <skill root /project/scripts/inspect layout.mjs : npm run 会在 stdout 前打印生命周期 banner,污染 JSON。
标准 3+1 deck:必须先逐页写 output/<deck name /page content pack.json ,每页使用稳定 id 和下列完整 PageContentPack 结构;再运行 npm prefix <skill root /project run goal:scaffold title <title goal <goal theme <themePack pages <n layout variants 3 content plan output/<deck name /page content pack.json seed <randomSeed chunk size 5 out output/<deck name /goal.json 。schema v2 的 3 个模板方案和 v4 定制方案必须由该 content plan 生成;没有 content plan 时不要使用 layout variants 3 。
文案长度和数组数量:优先按 fillPlan.text[].maxChars 、 fillPlan.arrays[].visibleCount 、 fillPlan.arrays[].nestedArrays 写; display / metric 字段只写短词、短句或数字。
Html 字段(如 headlineHtml / quoteHtml )写文案只用 <br 换行加 <b / <em 行内强调,禁止 <span 等自由 HTML;主题默认值里的 <span class 依赖主题 CSS,只是占位,不要照抄。 validate:goal spec 会拦截自由 HTML。
可见数组项必须写实文案;被 count/显隐控制隐藏的尾项可保留“请输入文本”占位。
元素出现动画使用页面组件自带的原生效果。
页面切换动画可以在预览控制面板里调整。
面向用户交付的 deck 默认不显示风格/主题切换选项;风格切换只保留在内部调试 demo 页面。用户明确要求保留主题切换时,在 goal 顶层写 preview: {"themeSwitcher": true} 。
不手写自由 HTML slide。新生成 deck 使用 schemaVersion: 2 ;每个逻辑页只保存一份 content ,前三项只保存 {kind:"template", layout, contentMap, projection} 的结构目标与 source binding,第四项保存 {kind:"bespoke", adjustable:false, composition, contentMap, projection} 的网格/type/style 与 source binding;goal 不持久化模板 props 或 bespoke 文案、指标、列表、图表、media src/alt 业务副本。v4 不写 layout 、 props 或 controls 。
每套主题的前 5 页 themeXX page001 到 themeXX page005 都是封面候选。一个 deck 只能有 1 个逻辑封面页;标准 PageContentPack 3+1 中 pageIntent=cover 优先使用可承载的封面候选,只有前 5 页能形成 3 个结构不同的真实模板时才整页使用封面布局,否则整页回退到第 6 页以后的真实正文布局,同一逻辑页禁止混用封面与正文布局。
同一逻辑页的 3 个模板方案必须结构不同;不要只换页码或镜像同一结构。跨逻辑页不要求 3N 个 layout 绝对唯一,保留 scaffold 既有的 layout、组合和 family 复用软惩罚。
面向用户交付的 deck 不能依赖页面默认文案。除非用户明确要默认 demo,每一页业务内容都必须先写入 PageContentPack,不直接写入 variant props/composition。
slide.content.presentation 是唯一业务事实源;模板在运行时按 contentMap + projection.structure 即时生成 props,bespoke 按 contentMap + itemBindings/chartBindings/mediaBindings 即时注入 composition。修改 canonical content 后 4 个方案必须一起更新。
v4 必须独立分析用户目标、受众、本页叙事作用、重点信息和当前主题特征后设计;继承主题颜色、字体、间距、形状、媒体和图表语言,使用受限 composition 元素,不新增事实、不写自由 HTML/JSX,也不是前三个模板的小改。生成失败时仍输出安全的 kind:"bespoke" 组合。
v4 composition 写 designIntent 、主题背景语义和 12×8 网格元素;元素类型只用 text / metric / list / quote / media / shape / chart 。
3 个模板方案各自的可见文案槽必须由 contentMap 或 projection.structure 绑定 canonical content,未使用槽位由结构投影显式关闭或置空;遗漏会交付模板演示文案。
优先只写 layout:query / inspect:layout 暴露的文案字段。字段是对象或数组时按 fillPlan 和 propShapes 填内部 key。 copyKeys 已展开嵌套路径(如 copy.quote 、 items[].label ),按列出的路径直接填。
inspect:layout 标 contentLocked: true 的页正文由组件固定、props 填不进:换一页能填正文的布局,或仅当用户接受其默认正文时使用。数组按 fillPlan.arrays[].visibleCount 填满可见项; decorativeKeys 是装饰位,不要填。
不要改页面元数据、组件源码、className、CSS、样式字段或默认视觉结构来完成内容填充。schema v2 业务内容只写 PageContentPack,结构目标与 binding 由 scaffold 生成。
允许用顶层 text 覆盖可见文字槽位,但只用于替换文字内容。不要在普通生成中启动浏览器批量抽取全页面文本槽位;只有用户明确要求“彻底清除所有模板默认文案/逐页校对可见文案”时才做运行时槽位抽取。
禁止复用 output/ 里已有的旧 goal.json 或旧 HTML。每次请求都新建本次输出目录和本次 JSON 计划。
输出目录写在当前会话工作目录,不要写入 <skill root /project/output 。
HTML 交付:给用户的预览地址只给 http://127.0.0.1:<port / (不给 https 或 .local 变体);本机 HTTP 可导出 HTML/PDF/PPTX,本地 HTML 或 file:// 不能导出可编辑 PPTX。不要返回 theme preview 。在自带浏览器的 Agent APP(如 Codex)里生成时,提醒用户导出 PDF/PPTX 前把该地址在系统浏览器中打开。
PPTX 交付:调用 /api/export editable pptx ;最终只给 PPTX 文件路径或下载结果。
无浏览器会话、脚本直调、或预览导出接口返回 403/5xx 时:改用 npm run export:pptx <deck /ppt <out.pptx (PDF 用 export:pdf )直接产出文件,不需要先起浏览器会话。
如果输出正文里出现与用户主题无关的默认文案,例如 AI Capital / 投融资 / SoundWave / 声浪 / Key Metrics / Roadmap / End of Report 等,必须重写 JSON 后重新渲染,不能交付。
媒体工作流
媒体字段只写 mediaSlots[].canPresetMedia: true 的槽,按该槽 presetProp / fieldPath 写路径; goal.json 只引用 deck 内相对媒体路径,不可引用临时目录、外部绝对路径、 file:// 或远程 URL。
视觉素材任务先判断意图:无图但需要视觉素材时先问是否预留图片槽;无真实素材且不能生图时优先选无媒体页。用户提供素材库/素材目录路径即视为有图意图:至少选 2 个带媒体槽页面并填入合适素材。素材路径不可访问时改选无媒体页并在交付说明中告知,不在页面内留占位提示文字。用户同意用 planned images <n / needs media ,用户给素材用 provided images <n / provided media ,用户明确要求原创视觉图/生图时,Codex 环境用 image gen 生成图片并加 image gen ;未明确生图时先询问用户。 plannedImages / needsVisual / imageGen 只表示选页意图,除非用户明确选择预留空槽,交付前必须写入真实媒体路径,不能交付空媒体槽或伪造路径。
用户本地图片/视频先运行 npm prefix <skill root /project run media:stage <deck output dir or ppt dir <media file... ,使用返回的 relative 路径;AVIF 会转成浏览器可用格式。image gen 输出也先落到本次 deck 目录。
渲染后核对 goal 引用的每个图片/视频: ppt/<relative 存在且 HTML 包含文件名;缺失时只补最终 ppt/assets 并重跑校验。图片/视频素材每个最多使用一次;同一逻辑页的 4 个方案共用同一份素材,算 1 次逻辑使用,不同逻辑页不要重复填充同一素材。素材用完后,媒体插槽留空或改选无媒体插槽页面。
需要 image gen 生成 2 张以上独立图片时,用多个 subagent 并行生成,不要串行逐张等待;每张图独立生成,不要用一张拼图/素材板再拆分。subagent 只用于生图,不用于选题、文案、选页或校验。
工作流
1. 提炼用户目标: title 、 goal 、 audience 、 owner 、页数、内容重点和最终产物格式;同时形成验收清单,记录用户显式要求、已确认选项和必要假设。用户未指定页数时默认 10 页左右,不少于 8 页。
2. 确认 themePack 。用户未指定时先询问风格;用户选定后生成 randomSeed ,例如 <主题 <日期 <3位随机词 ,保证随机选页可复现。
3. 判断图片意图:无图但需要视觉素材时先问是否预留图片槽;用户给本地素材先 media:stage ;明确生图时用 image gen。
4. 先按上方 {"pages":[...]} JSON 骨架和逐页语义 brief 写完整 output/<deck name /page content pack.json ,再把该 JSON 和 seed <randomSeed 通过 content plan 传给 goal:scaffold ;不要另走手写 3+1 骨架路径。
5. 每页只承载一个主要信息角色。业务值只写一次到 PageContentPack;scaffold 仅保存 3 个模板的结构投影/source binding 和 v4 的结构 composition/source binding,不要手工复制 props、文案、指标、列表、图表或 media 值。
6. scaffold 把 schema v2 JSON 写入本次工作目录的 output/<deck name /goal.json ;每页包含 selectedVariant: "v1" 和恰好 3 template + 1 bespoke。渲染前运行 goal spec 校验;不要对该结构投影 goal 运行 props:safe write ,以免把运行时 props 写回存储模型。
7. 图表页填入自己的数据后,页内 insight/读图/结论类文案字段必须据新数据一并改写,不保留默认结论。
8. 运行渲染脚本输出 output/<deck name /ppt/index.html ;脚本会使用 Skill 内置生成器,不要切回外部项目目录。
9. 渲染后核对素材路径,缺失时补最终 ppt/assets 。
10. 确认脚本完成 validate:swiss 和 validate:goal copy 校验。
11. 渲染脚本会启动本地 HTTP 预览服务并输出 http://127.0.0.1:<port / ;需要指定端口时设置 DASHI PPT PREVIEW PORT 后再运行脚本(端口用 5200 5999 段,4178/4300/4400 为用户保留端口不可用)。只能用该预览服务,不得用 python m http.server 、 npx serve 等静态服务器替代:静态服务器没有导出和自动保存接口。预览服务下编辑自动保存到 index.html 本体; file:// 打开的本地文件不自动保存,交付前需导出。
12. 对最终产物执行成果验收:默认 comparison 应按逻辑页连续输出全部 4N 页,selected only 输出 N 页;逐组核对 4 个方案内容一致、构图不同,并确认 v4 无模板属性控件但可选择、保存和导出。
13. 状态为“待修正”时定位不合格页,修改文案/数据/媒体,必要时更换 layout 或重新生成对应页;重新渲染、运行全部校验并复验。
14. 运行 node <skill root /scripts/check latest version.mjs 做静默版本检查。
15. 验收通过后按交付格式回复:HTML 只给 http://127.0.0.1:<port / ;PPTX 调用 /api/export editable pptx 后只给文件路径或下载结果。
成果验收与返工
机器校验通过只是技术基线,不等于成果达标。最终验收以用户原始需求、已确认选项、明示假设和最终渲染产物为准:
目标一致性:Deck 回答用户的核心问题,重点、结论和语气适合目标受众。
内容覆盖:指定的主题、必含要点、页数、风格、语言、媒体和产物格式都已落实,无跑题、缺项或无关模板文案。
逐页检查:每页都服务于整体目标;标题、正文、数据、图表和 insight 相互一致,没有重复、断层、空白页或明显不匹配的 layout。
叙事完整性:开场、论证/展开和结论/行动顺序清晰,页与页之间有逻辑承接。
交付完整性:最终文件存在且能打开,页数和格式正确,素材可用,首尾页非空白。
有浏览器能力时,最终一轮必须逐页打开预览,检查内容可见、媒体正常,无明显溢出、遮挡或裁切;不创建专用 Chrome profile,不默认做截图审美精修。无浏览器能力的脚本/批处理环境至少复核 goal.json 、校验结果和输出文件,并不得声称已完成视觉验收。
验收状态只有“通过”“待修正”“阻塞”。发现任一不合格项就标记“待修正”:文案、数据、insight 或媒体错误时改对应 props;页面信息角色或容量不匹配时重新 layout:query 并更换 layout;内容缺失时补写或重新生成对应页。修正后从 props:safe 、 validate:goal spec 、渲染、素材核对、 validate:swiss 、 validate:goal copy 到成果验收全部重跑。
默认最多修正 2 轮。验收通过后才能交付;两轮后仍不通过则标记“阻塞”,说明未达标项和阻塞原因,不得将其表述为已完成成果。
示例命令(macOS / Linux):
Windows PowerShell:
JSON 结构
如果 slides 为空, pageCount 只适合临时草稿预览。新生成 deck 面向用户交付前必须落成 schema v2 的 3 template + 1 bespoke;旧单版式和旧 3 候选 goal 仍可读取。
页面角色
role 只用于草稿选页,最终 JSON 的前三个方案必须落成具体 layout ,v4 必须落成无 layout 的 bespoke composition。角色说明见 references/layout roles.md ;真实模板候选以 layout:query 输出为准。
单版式草稿的 cover 只能从当前主题前 5 页选择；标准 PageContentPack 3+1 按上文的真实候选承载规则选择同质模板池。 image / media 候选基于真实 mediaSlots ,不是页面标题关键词。动态背景页可用 ambient 作为氛围页或章节页。
可以直接指定页面:
交付能力
生成后的预览页默认把 N 个逻辑页展开为 4N 个方案页。右侧面板可在同组 4 页之间跳转或标记最终方案;前三个模板方案可调 props,v4 显示为固定的 Agent 定制方案。 variantOutputMode:"comparison" 导出 4N 页, "selected only" 导出 N 页。面向用户交付的页面底部不显示页码标识、翻页引导、圆点导航或索引提示。
页面属性契约
普通生成不要读 layout manifest.json 。先用 layout:query 输出的候选摘要。只有需要更细契约时,再用 npm prefix <skill root /project run inspect:layout compact <layout... 看页面契约:
copyKeys : 可安全改写的文案/数据字段。
copyBudgets : 文案长度预算; display / metric 超长会被 goal spec 拦截。
propShapes : copyKeys / 数组字段的内部形状;写 copy 、 cells 、 items 、 rows 等对象字段时只使用这里列出的 key。
fillPlan.arrays[].itemFields[].enum : 该字段为结构枚举,只能从列出的值中选,不是自由文案。
mediaSlots : 图片/视频写入字段、count key、默认数量和最大数量。
countBindings : 数量参数与数组字段的绑定。
fillPlan 里数值字段看 numericBounds 填数: enforced:false 是提示、真实数据可超出, enforced:true 必须遵守, semantics:'normalized' 填 0 1 比例;定长嵌套数组看 fixedLength / fixedLengths 按下标填,不试错。
controlKeys : 右侧面板可操作字段,不是普通内容填充清单;仅用户明确要求调整页面属性时使用。默认只填 copyK