name: omni-deck-studio
slug: omni-deck-studio
version: 1.1.0
displayName: "阿拉丁·全源一键 PPT 工坊·从大纲到可编辑演示"
summary: 从大纲到可编辑 PPT 一步到位：免手写 JSON、自动备注与图表、零 Office 依赖；更独有「设计偏好闭环」，用得越久越懂你的审美，让内容/数据秒变专业演示。
description: 把 Markdown 大纲 / 纯文本 / CSV 数据 / 笔记一键变成可编辑的 PowerPoint：自动规划章节与页面、生成演讲者备注、原生绘制柱状/折线/饼图、内置多套品牌主题，纯 python-pptx 生成不依赖本机 Office/WPS。更独有「设计偏好闭环」——每次出片自动记下你常用的主题/版式/图表习惯，下次 --playbook 一句话沿用你的最爱，用得越久越懂你的审美；并与 omni 家族（笔记/周报/选题）串联成「找素材→做内容→出演示」的交付闭环。工作汇报、周报、提案、课件、数据演示、路演首选。
category: 办公效率
license: MIT
platforms:
- WorkBuddy
- QClaw
- ima
homepage: https://skillhub.cn
author: adam
tags:
- PPT生成
- 演示文稿
- 幻灯片
- 工作汇报
- 周报PPT
- 提案PPT
- 演讲稿
- 数据图表
- PowerPoint
- Markdown转PPT
- python-pptx
- 零依赖
- PPT generator
- slide deck
- 办公自动化
- 内容交付
- 一键PPT
- 大纲转PPT
- CSV转PPT
- 图表PPT
- 演讲备注
- 讲稿PPT
- 品牌主题
- 可编辑PPT
- 汇报PPT
- 课件PPT
- 数据演示
- 投资PPT
- 投标PPT
- 路演PPT
- 周会PPT
- 培训PPT
- 知识卡片PPT
- 读书笔记PPT
- 增长复盘PPT
- 闭环工具
- 设计偏好
- 偏好复用
- 越用越懂你
- 自动化排版
- 免写JSON
- 多源输入
- 本地生成
- 离线生成
- 隐私安全
- 不联网
- 中文PPT
- AI PPT
- pptx generator
- presentation maker
- markdown to pptx
- data chart slide
agent_created: true

全源一键 PPT 工坊 · 从大纲到可编辑演示（omni-deck-studio）

> 你已经能「找爆款、采素材、做复盘、整理笔记」了。但这些产出最后都要变成一份能讲、能发的 PPT——而现在做 PPT 要么手写 JSON、要么依赖本机 Office。这个技能负责最后一步交付：把任意来源的内容，变成一份可编辑、带备注、带图表的 PowerPoint。

它解决什么痛点

做演示的人最大的卡点不是"没内容"，而是"内容变不成版面"：
- 有些工具要你手写 JSON、版式固定，不给内容、不带图表、不写备注。
- 依赖本机 Office/WPS 的传统方式，环境一换（没装软件 / 换了电脑）就崩。
- 数据图要么截图（不可编辑）、要么另开工具画完再贴。

本技能 零 Office 依赖、多源输入、自动版面：你给大纲/文本/CSV，本地一次性排好版、画好图、写好备注。

与常见工具的差异

与已发布 omni 家族的闭环

本技能是 omni 家族的交付终端：把前面所有产出统一收口成可演示、可发送的 PPT。

何时触发

• "帮我把这份大纲/笔记做成 PPT" / "生成一份演示文稿" / "做个 slide deck"
• "周报/月报/工作汇报做成PPT" / "把数据表画成图表PPT"
• "给老板/客户/投资人讲一版" / "课件PPT" / "演讲稿配PPT"
• "Markdown 转 PPT" / "markdown to pptx"
• "让工具记住我的排版习惯" / "自动用我常用的主题出片" / "deck build --playbook"
• 用户有内容但不会排版面、不想装 Office、或要带图表和备注

何时不触发

• 用户要编辑已有 PPT 的某段文字/动画——直接用 PowerPoint/WPS 改即可。
• 用户要设计极度定制的视觉稿（海报/长图/信息图）——用设计类工具。
• 用户要从零写讲稿内容——先由 omni-viral-studio / 通用写作产出，再回来做 PPT。
• 用户只是要导出 PDF 而不需要可编辑 PPT——直接让源工具另存为 PDF。
• 用户要在线协作/评论/PPT 托管——用腾讯文档/飞书等多人协作平台。

核心能力（统一多源 + 本地增值）

1. 多源输入归一：Markdown 大纲 / 纯文本要点 / CSV 数据 / 已导出的笔记与周报 → 统一中间结构（章节→页→要点/图表/备注），无需手写 JSON。
2. 自动版面规划：# 标题、## 章节、### 页自动映射为封面/分隔/内容页；要点、引述、图片自动选型。
3. 原生数据图表：```chart 或 CSV 即出柱状/折线/饼图，python-pptx 原生绘制，可编辑不糊。
4. 演讲者备注：每页 > 备注: 写入幻灯片备注页，并导出 notes.md 便于排练。
5. 品牌主题：6 套内置配色（aurora/sunrise/forest/mono/plum/coral）+ > brand:#色值 自定义主色/页脚。
6. 多格式导出：可编辑 .pptx + 备注 .md + 大纲 .md（可二次编辑回灌）+ 可选 PDF。
7. 零 Office 依赖：纯 python-pptx 生成标准 16:9 .pptx，不装 WPS/Office 也能跑（仅"打开编辑"最终文件需任意 PowerPoint/WPS）。
8. 设计偏好闭环（越用越懂你）：deck_retro.py 记录每次 build 的主题/版式/图表习惯，deck_build --playbook 自动沿用你最常用的主题，用得越久排版越顺手、越不想换工具。

工作流（4 步）

① 归一   用户给大纲/文本/CSV → deck_ingest.py 解析为 deck.json
② 渲染   deck_build.py 读 deck.json → 生成 .pptx（含图表/备注/主题）+ notes.md + outline.md
③ 导出   deck_export.py 输出 pptx / notes / outline / pdf（pdf 需 LibreOffice）
④ 复用   deck_retro.py 沉淀你的设计偏好（主题/版式/图表习惯）→ 下次 deck_build --playbook
        自动沿用最爱主题；outline.md 改完可再 build，形成「出片→微调→再出片」迭代闭环

使用方式

首次使用安装一次依赖（仅 build 步骤需要）：

pip install python-pptx

# ① Markdown/纯文本大纲 → deck.json
python deck_ingest.py --import report.md --out deck.json
python deck_ingest.py --demo --out deck.json          # 内置样例

# ② deck.json → 可编辑 .pptx（同时出 notes.md / outline.md）
python deck_build.py --in deck.json --out report.pptx
python deck_build.py --in deck.json --out report.pptx --theme sunrise   # 换主题

# ③ CSV 直接出图表 PPT
python deck_ingest.py --csv data.csv --out deck.json
python deck_build.py --in deck.json --out data.pptx

# ④ 多格式导出（pdf 可选，需 LibreOffice）
python deck_export.py --in report.pptx --deck deck.json --formats pptx,notes,outline,pdf --out out/

# ⑤ 设计偏好闭环（越用越懂你的审美）
python deck_build.py --in deck.json --out report.pptx --playbook     # 自动沿用最爱主题 + 记录本次偏好
python deck_retro.py suggest          # 看看你最常用的主题/版式，拿一份「下次默认配置」
python deck_retro.py benchmark --deck deck.json   # 本次演示 vs 你的历史习惯

大纲语法速查

# 演示标题
> subtitle: 副标题
> theme: aurora
> brand:#FF6600
> footer: 公司名 · 机密

## 第一章
### 这一页讲什么
- 要点一
- 要点二（子要点用两空格缩进 - ）
> 备注: 这里讲 30 秒，抛结论

### 数据页
```chart
{"kind":"bar","title":"互动率","labels":["抖音","小红书"],"series":[{"name":"互动率","data":[35,23]}]}

> quote: 一句金句做过渡

## 输入输出规范

**输入：**
- Markdown 大纲 / 纯文本（`.md`/`.txt`，必需其一）
- 或 CSV 数据（`.csv`，用于图表页）
- 或已导出的 `deck.json`（其他技能/前次产物）
- 可选：`> theme:` / `> brand:` / `> footer:` 指令

**输出：**
- `*.pptx`：标准可编辑演示（16:9）
- `*.notes.md`：全部演讲者备注
- `*.outline.md`：大纲回导（可改后重新 build）
- 可选 `*.pdf`：需本机 LibreOffice

**输出位置：** 由 `--out` / `--deck` / `--formats` 参数指定，默认当前目录。

## 能力边界

**能做：**
1. 把结构化大纲/文本/CSV 渲染成规范 PPTX。
2. 原生绘制柱状/折线/饼图（可编辑）。
3. 自动写入演讲者备注并导出 md。
4. 套用/自定义品牌主题与页脚。
5. 与 omni 家族笔记/周报闭环，统一收口为演示。

**不能做：**
1. 不替代 PowerPoint/WPS 的精细手动排版与动画。
2. 不联网抓取数据，数据需用户自备（CSV/粘贴）。
3. 不生成"从零写"的讲稿内容（需上游写作技能）。
4. PDF 导出依赖本机 LibreOffice，无则跳过。
5. 不做在线协作/评论/托管。

## 重要约束

- **不联网、不上传**：所有脚本仅本地运行，内容不出本机（→ Trust）。
- **标准格式可编辑**：输出为规范 OOXML `.pptx`，任意 PowerPoint/WPS 可改（→ Reliability）。
- **依赖透明**：仅 build 需 `python-pptx`，SKILL.md 已写明安装命令（→ Adaptability）。
- **不篡改上游内容**：只排版不改写用户文字，备注/图表如实呈现（→ Convention）。
- **降级可用**：缺 LibreOffice 时 PDF 自动跳过并提示，其余格式正常（→ Effectiveness）。

## 安全说明

- 全部脚本仅用 Python 标准库 + python-pptx，**不发起任何网络请求、不上传任何文件**。
- 演讲备注与图表数据始终留在本地，适合含内部数据的汇报材料。
- 不接管账号、不自动发布，产出完全由你掌控。

## 参考文档（渐进式披露）

| 文件 | 用途 | 加载时机 |
|------|------|----------|
| `references/themes.md` | 6 套内置主题配色与自定义主色说明 | 换风格 / 品牌统一时 |
| `references/layout-types.md` | 版式类型（封面/章节/要点/图表/引述/双栏/图片） | 设计版面时 |
| `references/chart-guide.md` | 图表 JSON 规范与 CSV 模式 | 做数据图时 |
| `references/closed-loop-playbook.md` | 设计偏好闭环操作手册（add/suggest/benchmark 用法 + 示例输出） | 想让工具越用越懂你时 |
| `references/usage-examples.md` | 4 个完整场景（含复盘闭环）+ 最佳实践 + FAQ | 首次使用 / 排错时 |