PPT 演示生成器openHacking/pptkit-presentation

PPTKit Presentation

将主题、文档、电子表格、图像和现有演示文稿转化为精美、可编辑的 PowerPoint 幻灯片。PPTKit Presentation 在 pptkit-presentation Agent Skill 中结合了结构化幻灯片创作、本地优先的浏览器审阅工作流以及显式的 PPTX 导出功能。

你的源材料、幻灯片数据和资源都保留在本地。在浏览器中审阅生成的幻灯片，然后仅在你选择时才导出可编辑的 .pptx 文件。

主题

该技能在创作前会呈现三种视觉语言。每个预览都是一种设计方向——而非固定的幻灯片模板。

| Clean Business | Swiss Grid | Editorial Story |
| --- | --- | --- |
| Clean Business 主题预览 | Swiss Grid 主题预览 | Editorial Story 主题预览 |
| 高管审阅、战略和业务绩效 | 技术叙述、数据分析和产品发布 | 研究、思想领导力和故事驱动的演示 |

快速开始

安装

在支持技能的 agent（如 Codex）中，发送：

Install the pptkit-presentation skill from the GitHub repository openHacking/pptkit-presentation.

或从命令行安装：

npx skills add openHacking/pptkit-presentation --skill pptkit-presentation -g

更新

让你的 agent 更新已安装的技能：

Update the pptkit-presentation skill from the GitHub repository openHacking/pptkit-presentation.

或从命令行更新已安装的技能：

npx skills update

使用示例

根据主题创建幻灯片：

Use PPTKit to create an 8-slide presentation explaining our AI product strategy to company leadership. Recommend a theme and show me the outline before generating it.

将源材料转化为面向特定受众的演示文稿：

Use PPTKit to turn the attached quarterly-report.pdf and metrics.xlsx into an editable 10-slide presentation for our executive review. Focus on performance drivers, risks, and next-quarter priorities.

重新设计现有演示文稿的样式：

Use PPTKit to restyle the attached sales-kickoff.pptx in the Swiss Grid theme. Preserve the content structure, map each output slide to its source slide, and show me the proposed outline before generating it.

仅在审阅浏览器预览后导出：

The preview looks good. Generate and download the editable PPTX.

DeepSeek Harness

DeepSeek Harness（DSH）通过 packages/dsh-plugin-pptkit-presentation 中的 dsh-plugin-pptkit-presentation 包提供支持。将其安装到 DSH 配置文件中：
前提条件：dsh CLI。 dsh 是 npm 包 @deepseek-ai/dsh 的命令行工具，并非由本仓库安装。如果 command -v dsh 没有输出任何内容，请先安装一次：

npm install -g @deepseek-ai/dsh

或者跳过全局安装，在下面每条命令前加上 npx -y @deepseek-ai/dsh（例如 npx -y @deepseek-ai/dsh plugin --profile web add ...）。dsh plugin 会在 $DSH_HOME/profiles/ 内运行 pnpm（$DSH_HOME 默认为 ~/.dsh），因此 pnpm 也必须在 PATH 中。添加插件后请重启 DSH —— 正在运行的进程不会热重载 profile 包。

from npm (published bundle)
dsh plugin --profile web add dsh-plugin-pptkit-presentation
local checkout (run pnpm --filter dsh-plugin-pptkit-presentation build first)
dsh plugin --profile web add "file:$PWD/packages/dsh-plugin-pptkit-presentation"
from GitHub (prepare build must be allowed — add the key pnpm prints to the
profile's pnpm-workspace.yaml allowBuilds, then re-run)
dsh plugin --profile web add "openHacking/pptkit-presentation#path:/packages/dsh-plugin-pptkit-presentation"

该包会将 pptkit-presentation 技能注册到 DSH 的技能目录中。DSH 没有浏览器工具，因此该技能会以 host-no-browser 证据路由到 Node 工作流，并将 output/deck.pptx 以及构建报告作为聊天附件交付。有关安装选项、工具映射和交付方式，请参阅 DeepSeek Harness 指南。不需要该包？将技能复制到 DSH 的原生技能根目录：

node scripts/install-dsh.mjs

工作原理

1. 提供一个主题或附加源文件，然后描述目标受众和期望的结果。
2. 选择一个视觉方向，并确认所提议的逐页大纲。
3. 在本地优先的浏览器应用中查看生成的 SVG 幻灯片，并在聊天中请求修改。
4. 当演示文稿准备就绪时，明确请求 Generate & download PPTX。

浏览器应用是一个审阅和质量保证界面，而不是像素级一致的 PowerPoint 渲染器。演示文稿数据和资源保留在你的浏览器中，预览应用不会上传它们。

包和应用

| 路径 | 职责 |
| --- | --- |
| packages/presentation-workflow | 可移植的演示文稿会话、确定性创作配方、源提取和质量检查。 |
| apps/preview | 本地优先的浏览器审阅和显式 PPTX 导出应用。 |
| skills/pptkit-presentation | 跨代理工作流、参考资料、主题预览和隔离的 Node 回退启动器。 |
| packages/dsh-plugin-pptkit-presentation | DeepSeek Harness 插件包，将该技能注册到 DSH 的技能目录中。 |

底层演示文稿引擎位于 openHacking/pptkit。本仓库仅使用其发布的公共 API。

开发
PPTKit Presentation 需要 Node.js 20 或更高版本以及 pnpm 10.13.1。

pnpm install
pnpm --filter presentation-preview dev
pnpm build
pnpm typecheck
pnpm lint
pnpm test
pnpm run pack:check

预览开发命令会将仓库技能路径和活动预览 URL 写入 .pptkit-local-preview.json。根目录的 AGENTS.md 会让新的 Codex 任务使用这些本地开发输入，而不是全局安装或已发布的副本。启动该命令，然后在此仓库中打开一个新任务，以针对 http://127.0.0.1:5173/ 测试未提交的技能。已打开的任务不会重新加载仓库指令或技能定义。

文档

- Presentation 技能指南
- presentation-workflow API
- 仓库架构

许可证

MIT