Skip to content
dsh marketplace

ppt-plugin

Verified

@weimin96/ppt-plugin · v0.106.1 · MIT · Web UI

可编辑演示文稿插件，支持宿主适配、原生 PPTX 与来源驱动生成。

Install

dsh plugin add @weimin96/ppt-plugin

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Readme

ppt-plugin

面向 Codex 和 DeepSeek Harness 的可编辑演示文稿插件。在会话旁创建、修改和预览幻灯片，并导出原生 PPTX；文稿与素材保存在项目工作区，可继续编辑。

功能

  • 可视化编辑：文本、形状、图片、连接线、表格、图表、公式与媒体；支持主题、母版、备注和动画。
  • AI 辅助制作：从资料（Source Intake）出发，使用 Style Pack、模板和原生构图规划、生成并修改多页文稿。
  • 质量检查：支持页面预览、视觉检查与生成任务状态记录；PPTX 内容保持原生可编辑。
  • 导入与导出：导入 PPTX，导出 PPTX、PDF、PNG、离线 HTML 和 MP4；支持撤销重做与持久化版本历史。

宿主支持

宿主 目前验证情况
Codex MCP App 和 Presentation 面板已接入；当前重构版本尚待实际宿主安装复验
DeepSeek Harness Web 已在 0.2.1-rc.2 验证安装、面板编辑、刷新恢复和 PPTX 导出；完整 AI Generation 尚待验收
DeepSeek Harness Desktop 已提供适配入口；Desktop profile 由 Electron 应用管理，尚待应用内实际安装验收

各宿主共用文稿模型与编辑器，宿主适配只处理启动、会话和交互。具体边界参见多宿主架构。

快速安装

从源码安装需要 Node.js 22+、pnpm 11.22.0 以及对应宿主。先在项目根目录安装依赖：

pnpm install --frozen-lockfile

Codex

pnpm plugin:install

该命令会构建并安装本地插件 ppt-plugin@ppt-plugin-local。在 Codex 中启用插件，打开 Presentation 面板即可使用；安装不会自动重启正在运行的 Codex。

如果之前安装过旧名称的插件，先执行 codex plugin remove codex-ppt@codex-ppt-local，避免重复注册。macOS 如需安装后重载 Codex Desktop，可在保存当前工作后执行 pnpm plugin:install:desktop。

DeepSeek Harness Web

需要与当前适配一致的 DeepSeek Harness 0.2.1-rc.2：

pnpm build
dsh plugin --profile web add ./package

重启 Web Host，在会话右侧面板选择「演示文稿」。Desktop 使用应用内管理入口，不可将上述命令直接改为 --profile desktop；参见 DSH 安装与验证。

npm 上的 @weimin96/[email protected] 仅为不含运行时的初始化包，不可用于安装插件。正式 npm 版本的发布与安装说明见构建与发布。

基本使用

  1. 打开 Presentation /「演示文稿」，新建文稿或导入现有 PPTX。
  2. 直接在面板中编辑，或向宿主会话描述要生成、修改的内容。多页生成建议先关联资料，再确认风格与大纲。
  3. 预览并检查页面，按需导出 PPTX 或其他格式。

文稿默认存储于当前项目的 docs/presentations/，其中 .presentation.json 是可编辑文档，assets/ 保存媒体，sources/ 保存来源，.generation/ 与 .history/ 分别保存生成状态和版本历史。显式选择其他输出工作区后，后续操作沿用该目录，不会在目录失效时自动写入其他项目。

导出注意事项

  • MP4 导出依赖 FFmpeg；服务端截图依赖 Chrome/Chromium。
  • 图片素材需要保留来源与授权信息；自动图片署名和引用信息保存在来源记录与演讲者备注中。
  • 导出的 PPTX 保留原生可编辑对象，但复杂第三方动画及未建模的 Office 效果不保证完全还原。跨平台字体与最终 Office 显示效果仍需检查。

开发与验证

pnpm typecheck
pnpm test
pnpm build

按需运行真实 MCP / DSH 冒烟检查：

node --import tsx scripts/smoke-application-mcp.ts
node --import tsx scripts/smoke-dsh-plugin.ts

DSH 冒烟需要本机可执行的 dsh，使用隔离 profile，不改动现有宿主配置。要在浏览器中单独检查共享编辑器，执行 node --import tsx scripts/serve-editor-smoke.ts 并打开输出的本机地址；这不等于实际宿主安装验收。

更多文档

许可

项目采用 MIT 许可。第三方依赖及素材遵循各自的许可证，见第三方声明。