前言¶
DeepSeek Harness (DSH) 的核心设计理念是“一切皆插件”。在智能体开发中，让大模型生成 PPT 是常见需求。现有的做法往往依赖浏览器截图或不可靠的云端服务。dsh-kimi-ppt 插件通过内置的 kimi-ppt 技能，解决了这个问题。
是什么¶
dsh-kimi-ppt 是一个客户端插件，由 OMSociety 维护。它集成了 kimi-ppt 技能，允许用户在 DSH 环境中创建、编辑、复刻和导出 PPT 文件。其核心价值在于纯本地导出，不依赖浏览器或外部网络，保证稳定性和可控性。
核心特性¶
- PPTD DSL：基于 Moonshot
.pptd（YAML）抽象 OOXML，单页自包含、可视即所得。 - 双素材导出：默认产出「可编辑 PPTD 项目 + 本地生成的 .pptx」。
- 设计系统：内置学术 / 咨询 / 金融 / 促销 / 工作等场景预设主题。
- DSH 本地导出：使用 python-pptx 本地生成
.pptx，Pillow 本地渲染预览图；离线稳定。 - 插件即技能：通过
dsh plugin add安装，宿主自动注册skills/kimi-ppt技能根。
安装与启用¶
- 停止正在运行的 DSH（运行中的服务会锁住依赖，装完再起）。
- 执行安装命令：
dsh plugin --profile <profile> add "dsh-kimi-ppt"
- 重启 DSH，技能目录自动发现。
注意：桌面版（desktop profile）由应用独占管理，CLI 无法代管安装；请在桌面应用内操作。
典型用法¶
技能脚本随插件包安装，位于 profile 的 node_modules/dsh-kimi-ppt/skills/kimi-ppt/scripts/ 目录。
- 本地生成 PPTX（不依赖浏览器）：
python scripts/pptd_to_pptx.py <deck.pptd> -o <deck.pptx>
- 本地渲染预览图：
python scripts/pptd_to_png.py <deck.pptd> -o <.preview>
- 检查本机字体：
python scripts/check_fonts.py <deck.pptd>
若需桌面增强导出（包含字体嵌入与淡入淡出转场），请使用：
python scripts/export_pptx.py <deck.pptd> -o <deck.pptx>
python scripts/export_images.py <deck.pptd> --output <.qa-images>
设计系统与字体¶
插件内置了多套设计系统，位于 reference/design_system/：
* academic：学术
* consulting：咨询
* finance：金融
* promotion：促销
* work：工作
字体方面，reference/local-fonts.md 规范了场景与推荐字体的映射。生成前建议运行 check_fonts.py 验证，缺失字体系统会自动提示并给出本地替代方案（如 MiSans、Century Gothic 等）。
依赖与注意事项¶
- 本地导出依赖：
python-pptx、Pillow、PyYAML。 - 桌面增强依赖：Node.js 18+、
agent-browser、Chrome 或 Edge。桌面增强导出需要可访问www.kimi.com与statics.moonshot.cn。 - 功能限制：字体嵌入与淡入淡出转场仅在桌面增强导出中提供，本地导出不支持。
- 项目性质：kimi-ppt 为非官方项目，仅供学习与研究。
结尾¶
dsh-kimi-ppt 解决了智能体在 DSH 环境下本地化、可控化生成 PPT 的需求。通过 PPTD DSL 和本地脚本，它为开发者提供了一套从设计到导出的完整工作流。
- 目录页：https://www.skillhub.cn/plugins/OMSociety/kimi-ppt-skill
- 源码：https://github.com/OMSociety/dsh-kimi-ppt
