AI 做 PPT 最常见的失败，是交付一堆静态文字页。这个 skill 把资料变成可编辑、可演示、可离线分发的单文件 bento deck。

Turn source material into an editable, presentable, offline-ready bento deck — one self-contained HTML file.

npx skills add joeseesun/qiaomu-bento-ppt

下载示例 deck · 查看 deck plan · 查看生成脚本

真实输出不是一段 JSON，而是一套可交付文件：

市场洞察-deck-plan.md
市场洞察-deck.json
市场洞察.bento.html          ← 双击即可编辑、演示、保存
reports/deck-validation.json ← identity + structure + shell gate

仓库里的介绍 deck就是由本 skill 生成并在真实浏览器中验收的成品；对应的 deck plan、 JSON、 生成脚本和 验证报告全部可复现。

中文 | English

普通 PPT agent 容易停在“标题 + 三个 bullet”。qiaomu-bento-ppt 会先判断 受众、结论和叙事弧，再把不同内容交给真正合适的演示能力：

• 趋势和量级 → chart
• 规格和价格 → table
• 同一对象的前后变化 → morph
• 次级解释 → state slide
• 主视觉 → image + scrim + ken-burns
• 流程和时间线 → path / connector + motion
• 关键数字 → countUp

最终的 .bento.html 同时带着文档、viewer 和 editor。收件人不需要安装 PowerPoint，也不需要登录云服务。

这个仓库已经内置：

• upstream.lock.json 固定的官方 bento/slides release shell
• 官方 bento agent guide
• 官方格式规范
• JSON 提取、构建、身份保护和 shell 校验脚本

因此安装后不需要 clone 原始 bento 项目，也不需要联网下载运行时。 BENTO_REPO 只用于上游兼容性复核，不是前置条件。

普通使用始终读取安装包里的固定快照。维护时可以检查 nyblnet/bento 的最新 正式 release：

python3 scripts/sync_upstream.py \
  --report reports/upstream-sync-check.json

确认需要刷新后：

python3 scripts/sync_upstream.py \
  --update \
  --report reports/upstream-sync.json

同步器要求 shell、官方 skill、docs/agents.md 和格式规范来自同一个 release， 全部暂存并验证成功后才替换。仓库还会每日检查一次上游；发现新 release 时 只创建带完整门禁结果的 PR，不会绕过 review 直接修改 main。

1. 安装 skill：

   npx skills add joeseesun/qiaomu-bento-ppt

2. 验证：

   test -f ~/.agents/skills/qiaomu-bento-ppt/SKILL.md
   python3 ~/.agents/skills/qiaomu-bento-ppt/scripts/bento_deck.py locate

   locate 应返回 "standalone": true。

• “用 qiaomu-bento-ppt 把这份报告做成 12 页离线演示文稿。”
• “修改这个 .bento.html，保留 docId，增加 morph 和演讲者备注。”
• “跳过确认，按默认决策型结构生成一个单文件 HTML 发布会 deck。”
• “把这些数据做成可交互图表，并在浏览器里验收。”

1. 生成 deck-plan.md：受众、目标、叙事弧、逐页计划、视觉方向和证据。
2. 读取包内固定版本的官方 bento 规范。
3. 新建 deck.json，或从既有 .bento.html 提取 JSON。
4. 把内容映射到 chart、table、morph、state、media 和 motion。
5. 使用包内 shell 构建新的 .bento.html，默认不覆盖源文件。
6. 检查文档结构、docId、文档块和 shell。
7. 在真实浏览器中检查编辑态、演示态、字体、图片、图表和动效。

• 安装时需要 Node.js / npx：node --version && npx --version
• 运行时需要 Python 3.10+：python3 --version
• 需要现代浏览器打开 .bento.html
• 如使用外链图片或视频，需自行保证网络可用性和版权

正常生成不需要 API key、账号、bento checkout 或云服务。

检查独立资产：

python3 scripts/bento_deck.py locate

新建 deck：

python3 scripts/bento_deck.py build deck.json \
  --output result.bento.html \
  --new-document \
  --report reports/deck-validation.json

编辑已有 deck，同时锚定原始身份和 shell：

python3 scripts/bento_deck.py extract original.bento.html --output deck.json

python3 scripts/bento_deck.py build deck.json \
  --identity-source original.bento.html \
  --output original.updated.bento.html \
  --report reports/deck-validation.json

脚本会拒绝 deck.json 与原文件 docId 不一致的构建。

python3 scripts/validate_skill.py .
python3 scripts/trigger_eval.py . \
  --cases evals/trigger_cases.json \
  --output reports/trigger-eval.json
python3 evals/output/run_fixture.py \
  --output reports/output-eval.json

fixture 会在临时目录完成新建和编辑两条路径，证明：

• 内置 shell 可以独立构建 deck
• 新文档只 mint 一次 UUID
• 编辑时 docId 保持不变
• source deck 和 fixture 都不会被改写
• 生成文件通过结构和 shell gate

• 默认会写入计划、JSON、报告和新的 .bento.html。
• 默认拒绝覆盖已有输出；只有明确需要时才使用 --overwrite。
• 外链媒体会破坏完全离线承诺。
• 固定 shell 不会自动升级；上游更新需要重新做兼容性和 clean-install 验证。
• 脚本通过不等于视觉正确。没有实际打开浏览器时，必须标记 missing evidence: browser visual review。
• 本 skill 不执行 bento release、签名或部署，也不会读取签名密钥。

• nyblnet/bento：bento/slides shell、官方 skill、文档模型和格式规范。固定版本与 SHA-256 见 NOTICE.md。
• qiaomu-meta-skill：Skill IR、触发评测与证据边界；其方法受 yaojingang/yao-meta-skill 启发。

qiaomu-bento-ppt turns briefs, notes, reports, datasets, or an existing .bento.html file into a complete bento/slides presentation.

It is standalone: the repository includes a release-locked bento shell, official authoring references, and deterministic build/validation tools. No bento checkout or network download is required after installation.

Upstream maintenance is explicit and coherent: scripts/sync_upstream.py checks the latest official nyblnet/bento release and can refresh the shell and all three references from the same tag. A daily GitHub workflow opens a review PR when a new release appears; normal deck generation never updates itself.

The preview above is a real seven-slide product deck generated by this skill and reviewed in a browser. Download the single-file deck, inspect its deck plan, or reproduce it with the generator.

npx skills add joeseesun/qiaomu-bento-ppt

Verify:

python3 ~/.agents/skills/qiaomu-bento-ppt/scripts/bento_deck.py locate

Expected: "standalone": true.

• “Turn this report into a 12-slide offline bento presentation.”
• “Edit this .bento.html deck, preserve its docId, and add morph transitions.”
• “Create a single-file HTML product-launch deck with charts and speaker notes.”

• the plaintext #bento-doc splice contract
• stable document identity when editing
• one-time UUID minting for new documents
• source-file rollback
• structural and shell integrity
• explicit evidence boundaries for browser and human visual review

• Node.js / npx for installation
• Python 3.10+ for build and validation
• A modern browser to edit and present the generated file

No API key or bento source checkout is required.

The bundled shell is pinned rather than auto-updated. External media breaks the fully offline guarantee. Mechanical validation does not replace a real browser review.

向阳乔木（乔向阳 / Joe）是一位实践型 AI 产品与内容创作者，长期把前沿 AI 变化转译成可复用的工作流、产品判断、AI 编程实践、AI 搜索实践和 GEO/AI 营销方法。

• 个人网站: https://qiaomu.ai
• 博客: https://blog.qiaomu.ai
• X: https://x.com/vista8
• GitHub: https://github.com/joeseesun/
• 微信公众号: 向阳乔木推荐看

打赏支持	微信公众号
感谢支持乔木持续分享 AI 实践	扫码关注「向阳乔木推荐看」

The skill code is MIT licensed, Copyright (c) 向阳乔木.

Bundled bento assets remain MIT licensed, Copyright (c) 2026 The Bento authors. See NOTICE.md and THIRD_PARTY_LICENSES/bento-MIT.txt.