pptwise Skill:让 AI 生成真正可编辑的原生 PPTX 文件
大多数 AI 生成 PPT 的方式是输出图片或 HTML——不可编辑,只能截图分享。pptwise 打破了这个范式:它是一个 Agent 技能 + DeepSeek Harness 插件,能让 AI 直接在本地生成.pptx 格式的原生 PowerPoint 文件,每根柱子、每个标签都是 PowerPoint 可编辑形状,文字直接能改。无需账号、无需 API Key、纯本地渲染,Node 22+ 装上就能用。因其解决了一个长期痛点,近期在 GitHub 和各大 Agent 社区讨论度快速攀升。
功能与原则
pptwise 的核心设计原则是「语义输入 + 原生输出」:用户给出意图(说什么主题、加哪些要点),AI 将其转化为语义化描述文件(IR,Intermediate Representation),再由 pptwise 引擎绑定主题模板,渲染成真正的 PPTX 文件。
两条关键设计哲学:
- 本地优先:渲染不调任何 API,纯本地 Node/Bun 执行,无账号、无 Key、不联网,适合企业内部隐私场景。
- 原生可编辑:导出的每页元素都是 PowerPoint 原生 DrawingML 形状,不是图片、不是 HTML——这意味着用户拿到文件后可以在 PowerPoint 里直接改字、改色、重新排版。
支持 DeepSeek Harness(原生插件模式)和 Claude Code / Codex 等主流 Agent(技能文件夹模式)。
认可度
截至 2026-10-06,GitHub 17 颗星、2 个 Fork,距离上次更新仅数小时,仍处于极高活跃状态。npm 包 @liustack/pptwise 月下载量 3.7K,且以天为单位持续更新(最近一次 commit 就在数小时前)。在 DSH Directory、Honeystax 等开发者工具评测站点上,pptwise 均被标注为「值得本周测试」的热门新工具,在 DeepSeek Harness 生态内热度上升明显。
链接
GitHub:https://github.com/liustack/pptwise
原作者
liustack(GitHub @liustack),独立开发者,专注 AI Agent 工具链生态,同时维护 pptwise 主项目和 @liustack/pptwise npm 包。X/Twitter:@liustack,更新频率高,版本发布第一时间在此公告。
介绍
pptwise 起源于一个简单观察:AI 能生成幻灯片,但生成出来的是截图或 HTML——不是真正的 PPT。用这类文件做正式汇报,收到的人根本无法修改。
项目提供两种接入路径:
作为 Agent 技能(Skill folder):克隆到 ~/.claude/skills/pptwise,Claude Code 启动时自动识别,此后可以直接用自然语言要求 AI 制作 PPT,AI 会在后台调用 pptwise 渲染引擎完成。
作为 DeepSeek Harness 插件:通过 dsh plugin add @liustack/pptwise 一键安装,是目前 DSH 生态内评分最高的 PPT 生成插件。
渲染引擎核心逻辑:输入是语义化 IR 文件(JSON 格式,描述每页的类型和内容),引擎根据 IR 中的页面类型(cover / content / ending 等)从主题目录中匹配模板,生成 PPTX。任何 Agent 只要能读写文件,就能驱动这个流程。
特点
- 纯本地渲染,无 API 依赖:不需要 OpenAI / Claude / 任何大模型 API 做渲染,Node/Bun 安装好即可。
- 输出是原生 PPTX:每根柱子、标签、卡片都是 PowerPoint 可编辑形状,不是截图,可直接交给甲方或同事继续改。
- 24 个出厂主题 + 主题自定义:从预设主题库选择,可复制进工作区修改,也可从现有 PPTX 提取企业品牌配色。
- 实时预览:运行
pptwise preview deck.json -o out/review --html,浏览器打开,每改一次 AI 指令页面自动刷新。 - 支持多 Agent 平台:DeepSeek Harness(插件)、Claude Code、Codex,以及任何读取 skill folder 的 Agent。
- 可版本化的 IR:语义层与渲染层分离,同一份 deck.json 配不同主题会渲染出不同视觉风格,便于模板复用。
- 无账号体系:无注册、无登录、无追踪,下载即用,适合企业内网场景。
使用方法
基本安装
方式一(推荐):把安装指令发给 AI
Install pptwise following https://raw.githubusercontent.com/liustack/pptwise/main/INSTALL.md, then run the health check and tell me the result.
方式二:手动克隆
git clone https://github.com/liustack/pptwise ~/.claude/skills/pptwise
渲染一份 PPT
第一步:创建 IR 文件 deck.json:
{
"version": "5",
"filename": "hello.pptx",
"theme": { "id": "brief" },
"slides": [
{ "type": "cover", "heading": "Hello pptwise", "subheading": "A first native deck" },
{ "type": "content", "kind": "points", "heading": "Why it works",
"components": [{ "type": "bullets", "items": ["Semantic IR in", "Theme-menu lookup", "Native DrawingML out"] }] },
{ "type": "ending", "heading": "Thanks" }
]
}
第二步:渲染并预览
pptwise render deck.json -o out/hello.pptx
pptwise preview deck.json -o out/review --html
切换主题
# 查看所有内置主题
pptwise themes --json
# 对比多个主题
pptwise theme try brief,swiss,memo
# 自定义主题(从企业PPT提取品牌色)
pptwise brand extract corp.pptx -o themes/acme-brand.theme.json --id acme-brand --from brief
使用场景与人群
目标用户:
– 需要用 AI 生成正式 PPT 的职场人士(咨询、运营、产品)
– 在公司内网环境无法调用外部 API 的开发者
– 希望 AI 生成的幻灯片能继续手动修改的设计/产品团队
适用场景:
– 季度业务汇报、产品提案、技术方案评审
– 需要 AI 快速出初稿,再由人工细化的 PPT 工作流
– 企业内部培训材料自动生成
– AI Agent 在无人介入情况下自动生成可交付 PPTX 文件
输入与输出案例
案例一:季度业务汇报
输入(对 AI 说):
用 pptwise 做一份 Q3 业务汇报 PPT,包含:封面页(标题”Q3 业务复盘”、副标题”2026年9月”)、要点页(3个要点:收入增长 23%、新客转化率提升 8%、团队扩张至 50 人)、结束页(”谢谢”)。用 brief 主题。
输出:
q3-review.pptx——封面有标题和副标题,每页要点均以 PowerPoint 原生列表形式呈现,图表和标签全部可编辑,可直接发给管理层。
案例二:产品提案
输入(对 AI 说):
用 pptwise 生成一份产品提案,主题是 AI 辅助代码评审工具。包含:封面、问题陈述(传统 code review 效率低)、解决方案(LLM 辅助审查)、预期收益(效率提升 40%)、结束页。用 swiss 主题,提取我们公司的品牌色。
输出:
product-proposal.pptx——按语义 IR 渲染成 PPTX,每页内容和排版均可后续手动调整,品牌色与公司现有模板一致,无需 AI 重复生成。
评论区
登录后可评论。