Dashiai Ppt Hermes

DashiAI PPT（Hermes 封装）

封装自 chuspeeism/dashiAI-ppt-skill v0.3.0 吸收日期：2026-07-12 | AGPL-3.0

DashiAI PPT 基于 12 套预置视觉主题 + 1020 个版式页面生成 HTML 演示文稿。产物可在浏览器中打开编辑（翻页、改文字、换图、调布局），支持导出 PPTX / PDF。

前置条件

# 环境要求
Node.js 20+, npm, Chrome/Chromium/Edge（导出 PPTX/PDF 需要）

安装

首次使用需安装（一键，已装则原地更新）：

npx dashiai-ppt-skill@latest
# 国内镜像
npx --registry=https://registry.npmmirror.com dashiai-ppt-skill@latest

安装后 Skill 位于：~/.claude/skills/dashiai-ppt/（Windows 为 %USERPROFILE%/.claude/skills/dashiai-ppt/）

12 套主题速查

⚠️ theme10 不自动选用，仅用户明确指定或金融投资强相关时使用。

执行流程

Phase 1: 需求提炼 🔍

从用户输入中提取：

• title: 演示标题
• goal: 一句话目标（面向谁、讲什么、达成什么）
• audience: 受众
• owner: 汇报人/团队
• pageCount: 页数（默认 10 页，最少 8 页）
• format: 交付格式（HTML 默认 / PPTX 明确指定时）

🔴 CHECKPOINT：确认主题风格和图片需求后才进入 Phase 2。

委托模式：仅当用户说"都你来定/不用问直接干"时才自选主题。否则必须展示主题预览后等待确认。

Phase 2: 风格确认 🎨

🔴 必须展示主题预览图：回复中嵌入 {SKILL_ROOT}/assets/skill/theme-style-grid.png（展开为绝对路径）。

列出可选主题和「适合场景/人群」后等待用户选择。

同时确认：是否需要图片/视频素材？用户有本地素材先 media:stage。

Phase 3: 选页 📋

SKILL_ROOT="$HOME/.claude/skills/dashiai-ppt"

# 查询候选页面
node "$SKILL_ROOT/project/scripts/layout-query.mjs" \
  --theme {themePack} --role {role} --limit 8

# 需要媒体槽时
node "$SKILL_ROOT/project/scripts/layout-query.mjs" \
  --theme {themePack} --role {role} --needs-media --limit 8

# 查看页面契约
npm --prefix "$SKILL_ROOT/project" run inspect:layout -- --compact {layout...}

选页原则：

• 封面从当前主题前 5 页（themeXX_page001~`page005`）中选 1 页
• 正文从第 6 页以后选
• 同一 deck 中 layout 必须唯一，不重复使用
• contentLocked: true 的页换一页

Phase 4: 组装 goal.json 📝

{
  "title": "标题",
  "goal": "一句话目标",
  "audience": "受众",
  "owner": "汇报人",
  "randomSeed": "{主题}-{日期}-{3位随机词}",
  "pageCount": 10,
  "themePack": "theme01",
  "slides": [
    {"layout": "theme01_page001", "props": {"kicker": "眉题", "titleTop": "主标上", "titleBottom": "主标下", "lead": "导语"}},
    {"layout": "theme01_page006", "props": {"kicker": "核心数字", "value": "970", "unit": "亿美元"}}
  ]
}

填写规则：

• 只填 copyKeys 和可见数组字段，不改样式/结构
• display / metric 字段只写短词短句或数字
• Html 字段只用 <br> + <b> / <em>，禁止 <span>
• 数组按 fillPlan.arrays[].visibleCount 填满可见项
• decorativeKeys 装饰位不填
• 图表页填数据后，页内 insight/读图文案一并改写

Phase 5: 安全写入与校验 ✅

SKILL_ROOT="$HOME/.claude/skills/dashiai-ppt"
OUT_DIR="output/{deck-name}"

# 安全写入 props
npm --prefix "$SKILL_ROOT/project" run props:safe -- \
  --goal "$OUT_DIR/goal.json" --write

# 校验 goal spec
npm --prefix "$SKILL_ROOT/project" run validate:goal-spec -- \
  "$OUT_DIR/goal.json"

Phase 6: 渲染 🚀

SKILL_ROOT="$HOME/.claude/skills/dashiai-ppt"
OUT_DIR="output/{deck-name}"

# 渲染 HTML
"$SKILL_ROOT/scripts/render_goal_deck.sh" \
  "$OUT_DIR/goal.json" \
  "$OUT_DIR/ppt/index.html"

脚本会自动启动本机预览服务，输出 http://127.0.0.1:{port}/。

⚠️ 只能用该脚本启动的预览服务（有导出和自动保存接口），不能用 python -m http.server 等静态服务器替代。

Phase 7: 输出校验 ✅

SKILL_ROOT="$HOME/.claude/skills/dashiai-ppt"
OUT_DIR="output/{deck-name}"

npm --prefix "$SKILL_ROOT/project" run validate:swiss -- "$OUT_DIR/ppt/index.html"
npm --prefix "$SKILL_ROOT/project" run validate:goal-copy -- \
  "$OUT_DIR/goal.json" "$OUT_DIR/ppt/index.html"

Phase 8: 交付 📦

HTML 交付（默认）：给用户 http://127.0.0.1:{port}/

PPTX 交付（用户明确要求时）：

# 方式 A：通过预览服务 API（需要预览服务运行中）
curl -X POST http://127.0.0.1:{port}/api/export-editable-pptx \
  -H "Content-Type: application/json" \
  -d '{"exportKind":"pptx"}' -o output.pptx

# 方式 B：命令行导出（无浏览器会话时）
npm --prefix "$SKILL_ROOT/project" run export:pptx -- \
  "$OUT_DIR/ppt" "output.pptx"

Phase 9: 版本检查（静默）

node "$SKILL_ROOT/scripts/check_latest_version.mjs"

有输出时在回复末尾提醒用户更新；无输出则静默。

工具命令速查

所有路径均基于 SKILL_ROOT="$HOME/.claude/skills/dashiai-ppt"：

媒体工作流

1. 用户提供本地素材：先 media:stage 到 deck 目录
2. 需要生图：Codex 环境用 image-gen 并行生成（≥2 张时 subagent 并行）
3. 素材路径只引用 deck 内相对路径，不引用临时目录或外部绝对路径

返工与修复

只在以下情况返工：

• 渲染失败
• validate:swiss / validate:goal-copy 失败
• 输出中出现与用户主题无关的模板文案
• 用户明确指出某页有问题

默认最多修复 2 轮。仍失败时说明阻塞原因。

设计定位

本技能是 Hermes 的默认 PPT 生成方案。之前探索过的「解析 PPTX 模板 → 页面库 → 填充组装」路径因模型和模态能力达不到实用要求已废弃，但其方法论精华（内容分析/模板匹配/和谐化策略）已记录在 references/methodology-insights.md 供参考。

反例（禁止）

• ❌ 不确认主题就开工 — 风格必须用户选定
• ❌ 在 goal.json 中引用 file:// 或远程 URL — 只允许 deck 内相对路径
• ❌ 用 python -m http.server 替代预览服务 — 导出和自动保存不可用
• ❌ 交付空媒体槽或伪造路径 — 交付前必须写入真实素材
• ❌ 修改页面样式/CSS/结构来填内容 — 只改 props 内文案
• ❌ 复用旧 goal.json 或旧 HTML — 每次新建独立输出目录
• ❌ 交付包含模板默认文案的页面 — 渲染前必须全部覆盖为用户内容
• ❌ 技术方案产出差却硬撑 — 之前「解析 PPTX 模板→页面库→填充」路径技术架构优雅但产出质量不过关，果断废弃。方法论保留（references/methodology-insights.md），不因沉没成本死守。

失败模式

源仓库：https://github.com/chuspeeism/dashiAI-ppt-skill | AGPL-3.0 | 导出引擎专有组件