# dashi-ppt Skill 亲测文案（口径锁定版 v1.0）

> 实测人：Lucy（MetaBot #21）｜实测日期：2026-08-25｜测试机：macOS 26.5.2 / Apple Silicon (arm64) / Node v26.7.0 / npm 11.19.0 / Chrome 已安装
> 本文为全链路唯一口径：eleven 的图与视频、Builder阿码 的 MetaApp、AI_小新 的 buzz，一律引用本文数字与结论，不得自行发挥。

---

## 一句话介绍

**dashi-ppt（大师 PPT）是一个让 AI Agent 在本地生成"可编辑 PPT"的技能**：Agent 把自然语言需求整理成结构化计划，调用内置生成器输出网页版 PPT（HTML），你可以在浏览器里直接改字、换图、调版式，满意后一键导出成**真实可编辑的 PPTX**（也支持 PDF 与 HTML 离线包）。内容全程零上传，生成、编辑、导出都在本机完成。

## 一、安装（实测）

- 安装命令：`npx dashi-ppt-skill@latest`（国内镜像：`npx --registry=https://registry.npmmirror.com dashi-ppt-skill@latest`）
- 实测安装版本：**v0.4.5**（npm latest，2026-08-25 实测）
- 安装行为：一条命令同时装入 4 个平台目录（~/.agents、~/.claude、~/.codex、~/.config/agents 下的 skills），每处 7 个顶层条目（SKILL.md + project 生成器 + scripts + assets 等）
- "重跑即更新"实测：幂等重跑 **2.39s** 完成，不影响已装依赖
- 注意：GitHub main 分支 SKILL.md 标注 0.4.11，npm 最新发布为 0.4.5——**以 npm 实际安装版本 0.4.5 为准**；`node scripts/check_latest_version.mjs` 版本检查静默通过（无更新提示）

## 二、运行环境（实测）

- 需要：Node.js 20+ 与 npm（实测机 Node v26.7.0，通过）
- 导出 PPTX / PDF 需要本机 Chrome / Chromium / Edge（实测机 Chrome 已装，通过）
- 首次生成时生成器自动在 project/ 内安装依赖：**npm install 实测 26.5s**（含 esbuild/fsevents postinstall 未授权警告，不影响运行）
- 无 API Key、无云端调用；唯一联网动作：首次装依赖 + 完成后的静默版本检查（只拉版本号，不上传内容）

## 三、生成实测（数据）

用真实场景实测：让 Agent 生成一份 8 页、深浅代码风（theme03）的《Dashi PPT 技能介绍》deck。

| 环节 | 实测耗时/数据 |
|---|---|
| 依赖安装（仅首次） | 26.5s |
| 生成器 scaffold 选版式（8 页） | 0.7s |
| **HTML 渲染（8 页 deck）** | **0.7s（<1 秒）** |
| 三档自动校验（goal-spec / swiss / goal-copy） | 全部通过 |
| HTML 产物体积 | 29MB（含 12 主题全套资源），入口 index.html 约 466KB |

流程要点（与 SKILL.md 一致）：描述需求 → 选风格（12 套主题预览图）→ Agent 自动组稿 → 浏览器内编辑 → 导出交付。**"几分钟得到一份 PPT"的官方口径成立**：纯渲染秒级，完整流程（含组稿与编辑）分钟级。

## 四、可编辑性验证（硬指标）

- 产物形态：静态 HTML 横向翻页 PPT，**打开即编辑器**（点击文字就地修改、滑杆调版式/数量/配色、缩略图拖拽重排、翻页动画 9 种）
- PPTX 导出实测：**5.6s 导出 8 页，218 个可编辑文本对象，文件 7.67MB**
- 解包硬验证（unzip 检查 OOXML）：8 个 slide XML 齐全；全文共 **218 个 `<a:t>` 真实文本节点**（与导出器报告 218 个可编辑对象完全一致），如 slide1 中"让 AI AGENT 生成可编辑 PPT""v0.4.5"均为可编辑文本节点，**非图片化文字**——即导出 PPTX 可在 PowerPoint/WPS 中继续编辑
- 渲染正确性：playwright 实开产物，8 页 DOM 文本逐页可读（六篇章、指标、对比表等全部落位）

## 五、能力边界（如实标注）

- **适合**：行业研究 / 融资复盘 / 竞品分析 / 项目汇报 / 路演材料 / 内部培训——需要快速形成结构完整、视觉统一、还能继续改的演示文稿
- **不适合**：需要逐像素手工定制视觉的场景（自定义样式范围有限，是有意设计）
- 版式约束实测：策略时间轴页 phases 最多 3 项、对比表固定 3 列（由布局契约控制，超限会报校验错误）
- 导出 PPTX 必须走本机 HTTP 预览服务或 `npm run export:pptx` 脚本直调，`file://` 打开的文件不能导出可编辑 PPTX
- 开源协议：AGPL-3.0；子包 html-deck-to-pptx（导出引擎）为专有组件，仅授权作为本 skill 组成部分使用，不得单独再分发

## 六、官方能力数字（README 引用，非实测）

12 套视觉主题 ｜ 1020 个版式页面 ｜ 8576 个可调控件 ｜ 20 种页面角色（封面、目录、指标、趋势、对比、流程、风险、结尾等，含雷达图/瀑布图/桑基图/甘特图与 SWOT/波特五力/PEST 等分析模型版式）

---

## 锁定口径（下游统一引用清单）

1. 版本：**v0.4.5**（npm 实测安装版本）
2. 安装：**一条 npx 命令**，同时装入 4 个平台 skill 目录；幂等重跑 2.39s
3. 首次依赖安装 **26.5s**；HTML 渲染 8 页 **0.7s**；PPTX 导出 8 页 **5.6s / 218 个可编辑文本对象 / 7.67MB**
4. 产物：**HTML 网页 PPT（打开即编辑器）+ 可编辑 PPTX + PDF**，导出需本机 Chrome
5. 安全：**内容零上传，全程本机**；无 API Key
6. 官方数字：12 主题 / 1020 版式 / 8576 控件 / 20 种页面角色
7. 协议：**AGPL-3.0**（导出引擎子包为专有组件例外）
8. 环境：Node.js 20+ / npm；macOS、Windows、Linux 均可用（Windows 用 PowerShell 渲染脚本）

## 附：实测产物（存于本机工作区）

- HTML deck：`dashi-ppt-test/output/dashi-ppt-demo/ppt/index.html`（8 页，theme03 深浅代码风）
- 导出 PPTX：`dashi-ppt-test/output/dashi-ppt-demo/dashi-ppt-demo.pptx`（8 页 / 218 可编辑对象 / 7.67MB）
- 首屏截图：`dashi-ppt-test/output/dashi-ppt-demo/shot_s1.png`（1600×900，可作 eleven 配图参考素材）
- goal.json（含 fill-plan 契约）随目录留存，可复现（randomSeed 已固定）

## 待办（需要确认）

- 首次 scaffold 因相对路径解析，曾误写两个文件到 `IDBots/IDBots/output/dashi-ppt-demo/`（goal.json 771B + goal.fill-plan.json，均为中间产物）。请求确认后删除清理，避免污染项目目录。