返回目录

ppt-design-skill

维护状态: 活跃

sunchaokun/ppt-design-skill

面向 OpenCode / Claude Code / Codex 的 PPT 设计技能,内置 4 万+ 样式库,支持像素级 build 模式控制与 AI 配图生成,一键产出高质量演示文稿。

安装
$ git clone https://github.com/sunchaokun/PPT-Design-Skill.git && cd PPT-Design-Skill && python install.py

533

星标

99

Fork

Python

语言

MIT

许可证

2026-07-09

创建于

2026-08-20

最近推送

一个面向 AI 编码工具的 Python PPT 生成技能,含 Build/FreeStyle/VI 三模式、4 万+ 风格与 AI 配图——并非 DeepSeek Harness 插件。

DSH 适配

生态相关

作者声明

安全审计

未审计

最后核验

2026-08-22

许可证

MIT

01它能帮你完成什么?

  • 在 AI 编码工具里用自然语言提示生成完全可编辑的 .pptx

    通过三大引擎产出真实 .pptx——Build Script(用 `build_helpers` 工具箱逐页像素级控制)、FreeStyle(一句话提示或带每页 goal 的 `content.json`)、VI Build(基于企业模板生成 VI 合规稿件),成品仍可在 PowerPoint 中继续编辑

    在 AI 编码工具(OpenCode、Claude Code、Codex、Cursor 等)中做幻灯片、希望得到可确定且可编辑结果、而非扁平图片的设计师与开发者

  • 无需手工设计每一页,也能使用庞大且可控的样式系统

    40,000+ 风格组合(30 配色 × 25 字体 × 15 装饰 × 12 布局)外加 41 个 mood 关键词与内置设计数据库(192 配色 · 84 风格 · 74 字体搭配 · 161 反模式,支持 BM25 检索);用预设名(如 `dark-tech`)或 mood 即可得到确定性输出

    需要品牌一致或风格丰富、且希望跨次运行结果可复现的用户

  • 为幻灯片添加 AI 配图与矢量图形

    AI 图片引擎(Seedream、GPT Image、DALL-E、Gemini、Wanx + Kimi 增强,缓存优先)外加 SVG→PPTX 编译器(把 SVG 矢量编译为原生可编辑形状)、10 种图形引擎,以及 12 切换 + 8 入场 + 8 退场 + 8 强调的动画系统

    希望在不脱离 PPTX 格式的前提下获得插画、图表与动效的用户

02如何接入 DeepSeek Harness?

前置条件

  • Python 3.10+(README 徽章标注 'Python 3.10+')
  • git,以及 13 个已列平台中的某个 AI 编码工具(OpenCode、Claude Code、Codex、Cursor、Windsurf、Roo Code、Gemini、Trae、Continue、Droid、KiloCode、Augment、Copilot);DeepSeek Harness 不在文档化平台之列
  • `python-pptx` 1.0.2(作为依赖引入,README 带有依赖徽章)

安装步骤

  1. 01

    克隆并运行安装器:`git clone https://github.com/sunchaokun/PPT-Design-Skill.git && cd PPT-Design-Skill && python install.py`(自动检测平台;可用 `python install.py --platform opencode` 指定,或 `--force` 强制覆盖)

    $ git clone https://github.com/sunchaokun/PPT-Design-Skill.git && cd PPT-Design-Skill && python install.py

  2. 02

    或作为 Python 包安装:`pip install --upgrade git+https://github.com/sunchaokun/PPT-Design-Skill.git`——安装后任何项目均可 `import ppt_pro_max`

  3. 03

    在 AI 编码工具中用类似 `用Build模式生成一份AI融资路演PPT` 的提示触发,skill 即生成 .pptx

验证接入成功

作者未说明

03DSH 适配与能力边界

DSH 适配生态相关

PPT Design Skill 是面向 AI 编码工具的 SKILL / Python 包,并非 DeepSeek Harness(`dsh`)插件。其 README 列出 13 个目标平台——OpenCode、Claude Code、Codex、Cursor、Windsurf、Roo Code、Gemini、Trae、Continue、Droid、KiloCode、Augment、Copilot——其中不包含 DeepSeek Harness,因此没有文档化的原生 dsh 集成。只有当你的 dsh 暴露通用 skill/agent 机制时才能配合使用,而 README 并未描述这一点。

  • Build Script 模式(推荐)

    手写的使用 `build_helpers` 工具箱的 `build.py`逐像素、完全可编辑的 .pptx——`rect`/`text`/`gradient_text`/`kpi_card`/`native_chart`/`donut_chart`/`code_block`/`section_divider`/… 支持暗色主题,`clean_save` 还会修复 PPTX 合法性

  • FreeStyle 模式

    一句话提示(`ppt-design "AI产品融资路演"`)或带每页 goal 的 `content.json`经 11 种 goal 版式(hook/problem/features/data/code/exercise/diagram/section/testimonials/cta/content)产出稿件,含主题化图表、卡片与图形;预设名可确定性输出

  • VI Build 模式(企业)

    企业 `template.pptx`生成 VI 合规稿件:`template_analyzer` 产出分析,由 LLM 转为 `build.py`,保留框架页与 build helpers

  • 40,000+ 样式系统与 AI 配图

    自然语言 `--style`(如 `dark cyberpunk`),可选 `--fetch-images --llm-provider seedream`30×25×15×12 风格组合、41 个 mood 关键词与 BM25 设计数据库;Seedream/GPT Image/DALL-E/Gemini/Wanx 生成 AI 图片且缓存优先

  • 原生 python-pptx 直出

    来自三种模式的任何设计意图完全可编辑的 .pptx(非 HTML→截图),含 10 种图形引擎(流程/漏斗/时间线/SWOT/矩阵/循环/表格/层级/金字塔/韦恩)、CJK 字体回退与动画系统

04适合谁?何时不该用?

适合

  • 在 AI 编码工具(OpenCode、Claude Code、Codex、Cursor 等)中做幻灯片、希望得到可确定且可编辑结果、而非扁平图片的设计师与开发者
  • 需要品牌一致或风格丰富、且希望跨次运行结果可复现的用户
  • 希望在不脱离 PPTX 格式的前提下获得插画、图表与动效的用户

不适合

  • 未接入 DeepSeek Harness:README 列出 13 个目标平台(OpenCode、Claude Code、Codex、Cursor、Windsurf、Roo Code、Gemini、Trae、Continue、Droid、KiloCode、Augment、Copilot),其中不包含 DeepSeek Harness。没有文档化的 `dsh plugin` 安装路径,因此与 dsh 配合使用取决于 dsh 是否暴露 README 未描述的通用 skill 机制。

05兼容性、维护与安全提示

  • 未接入 DeepSeek Harness:README 列出 13 个目标平台(OpenCode、Claude Code、Codex、Cursor、Windsurf、Roo Code、Gemini、Trae、Continue、Droid、KiloCode、Augment、Copilot),其中不包含 DeepSeek Harness。没有文档化的 `dsh plugin` 安装路径,因此与 dsh 配合使用取决于 dsh 是否暴露 README 未描述的通用 skill 机制。
  • 需要 Python 3.10+ 与 `python-pptx` 1.0.2(作为依赖引入)。安装通过 git clone + `python install.py`,或 `pip install --upgrade git+https://github.com/sunchaokun/PPT-Design-Skill.git`;README 文档了更新(`git pull && python install.py --force`)但未给出卸载/回滚命令。
  • AI 配图需要外部供应商与密钥(例如 Seedream 用 `--llm-provider seedream --llm-api-key $ARK_API_KEY`,或 gpt-image/dalle/gemini/wanx)。无密钥时使用默认占位符/搜索模式;这是按功能的可选项,不影响核心稿件生成。
2026-07-092026-08-20作者未说明

MIT · 面向 AI 编码工具的 Python 包 / SKILL——README 未文档化任何 DeepSeek Harness 插件

06常见问题

PPT Design Skill 是什么,怎么安装?

它是 SKILL / Python 包(MIT)。安装方式:克隆后运行 `python install.py`(自动检测你的 AI 编码工具),或 `pip install --upgrade git+https://github.com/sunchaokun/PPT-Design-Skill.git`。安装后 `ppt_pro_max` 成为全局 Python 包,可用类似 `用Build模式生成一份AI融资路演PPT` 的提示触发。

它能和 DeepSeek Harness 一起用吗?

文档并未支持:README 列出 13 个平台(OpenCode、Claude Code、Codex、Cursor、Windsurf、Roo Code、Gemini、Trae、Continue、Droid、KiloCode、Augment、Copilot),不含 DeepSeek Harness。没有描述 `dsh plugin` 安装路径,所以任何 dsh 用法都要依赖 dsh 暴露 README 未覆盖的通用 skill 机制。

三种模式分别是什么?

Build Script(推荐)用 `build_helpers` 做逐页像素级控制;FreeStyle 接受一句话提示或带 11 种 goal 版式的 `content.json`;VI Build 基于 `template.pptx` 生成企业 VI 合规稿件。推荐流程:FreeStyle 快速打样,再用 Build 出交付级稿件。

样式系统有多大,输出确定吗?

30 配色 × 25 字体 × 15 装饰 × 12 布局 = 4 万+ 组合,外加 41 个 mood 关键词与内置设计数据库。自然语言风格在未指定 seed 时会随机选取,使用预设名(如 `dark-tech`)或 `--style-seed` 可得到可复现结果。

AI 配图怎么用,是必需的吗?

AI 图片用 Seedream / GPT Image / DALL-E / Gemini / Wanx(含 Kimi 增强),通过 `--fetch-images --llm-provider seedream --llm-api-key $ARK_API_KEY` 等参数调用,结果缓存优先。这是可选项——无密钥时使用默认占位符/搜索模式,核心稿件生成仍正常。

08数据与来源

  • 作者声明github.come687898fbf06…

    支持 13 个平台:OpenCode · Claude Code · Codex · Cursor · Windsurf · Roo Code · Gemini · Trae · Continue · Droid · KiloCode ·…

  • 作者声明github.come687898fbf06…

    在 AI 编码工具中输入:`用Build模式生成一份AI融资路演PPT` → 自动调用 skill → 输出可编辑 .pptx

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-08-22。发现错误?提交更正。

DSH Plugins 是独立的 DeepSeek Harness 插件市场,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。