OMSociety/kimi-ppt-skill

kimi-ppt-skill

DeepSeek Harness 插件 —— 内含 kimi-ppt 技能：创建 / 编辑 / 复刻 / 导出 PPT，DSH 内纯本地导出

DeepSeek Harness
License
Stars
Issues

⚠️ 免责声明：本插件内含的 kimi-ppt 技能为非官方 Kimi Slides 逆向/衍生项目（源自 MIT 的 open-kimi-ppt-skill），未获 Moonshot AI 认可或支持。仅供学习与研究使用。

📌 目录：• 核心特性 • 功能概览 • 快速开始 • 命令 • 设计系统与字体 • 常见问题 • 更新日志

✨ 核心特性

| 特性 | 说明 |
|---|---|
| 🔧 PPTD DSL | 基于 Moonshot .pptd（YAML）抽象 OOXML，单页自包含、可视即所得 |
| 📄 双素材导出 | 默认产出「可编辑 PPTD 项目 + 本地生成的 .pptx」 |
| 🎨 设计系统 | 内置学术 / 咨询 / 金融 / 促销 / 工作等场景预设主题 |
| 🖥️ DSH 本地导出 | python-pptx 本地生成 .pptx，Pillow 本地渲染预览图；离线稳定 |
| 🔤 本机字体 | 按实装字体解析，缺失自动提示 + 给本地替代（MiSans / Century Gothic…） |
| 📦 插件即技能 | 通过 dsh plugin add 安装，宿主自动注册 skills/kimi-ppt 技能根 |

🗂️ 功能概览

- 🔧 创建与编辑：从零生成，或导入 .pptx 转 .pptd 再逐页精修、复刻图片/PDF 为 PPTD。
- 📄 双素材导出：一个 deck 同时给出 ① 可继续编辑的 PPTD 项目目录；② 嵌入字体、带淡入淡出翻页的本地 PPTX（浏览器导出路径）。
- 🎨 设计系统：选题后套用预设主题（如学术答辩/咨询/金融），保证版式、配色、层级一致。
- 🖥️ DSH 本地导出与预览（本仓库增强）：pptd_to_pptx.py 纯本地生成 PPTX；pptd_to_png.py 纯本地渲染每页预览图做视觉 QA，不依赖浏览器/外网。

🚀 快速开始

1. 安装插件（DSH 用户级）：
- 方式一：插件安装（宿主自动把这技能挂到技能目录）：
dsh plugin --profile web add github:OMSociety/kimi-ppt-skill

- 方式二：手动放技能（不装插件也能用）：克隆后把 skills/kimi-ppt 整个目录复制到 ~/.dsh/skills/kimi-ppt/。
2. 重启/刷新 DSH：技能目录自动发现；对话里直接说"帮我做一份 PPT"即触发。

💡 依赖：技能本地导出仅需 python-pptx + Pillow + PyYAML。浏览器导出（字体嵌入/淡入淡出）另需 Node 18+、agent-browser、Chromium 及可连 www.kimi.com。

⌨️ 命令

技能脚本位于 skills/kimi-ppt/scripts/（安装到 ~/.dsh/skills/kimi-ppt/scripts/）：

| 命令 | 说明 |
|---|---|
| python scripts/pptd_to_pptx.py  -o  | 本地生成 PPTX（python-pptx，离线） |
| python scripts/pptd_to_png.py  -o  | 本地渲染每页预览图 + overview.jpg |
| python scripts/check_fonts.py  | 检查本机字体，输出 已装/缺失/替代 |
| python scripts/export_pptx.py  -o  | 浏览器导出 PPTX（字体嵌入/淡入淡出，需桌面环境） |
| python scripts/export_images.py  --output  | 浏览器导出整页图（视觉 QA） |

📚 设计系统与字体

预设主题（reference/design_system/）：academic 学术 · consulting 咨询 · finance 金融 · promotion 促销 · work 工作。

字体（reference/local-fonts.md，规范名→实装名映射 + 免费商用标记）：
| 场景 | 推荐（中文 / 西文） | 说明 |
|---|---|---|
| 默认正文 | MiSans / Arial | 干净现代 |
| 几何标题 | MiSans / Century Gothic | 更 Bauhaus，适合设计 |
| 学术衬线 | 思源宋体 CN / Georgia | 论文/文学 |
| 手写/特色 | 站酷文艺体 / 得意黑 / 飞波正点体 | 品牌/文化 |

💡 生成前跑 check_fonts.py 验证；缺失会提示并给本地替代（如 MiSans→更纱黑体 SC、QuattrocentoSans→Century Gothic）。

❓ 常见问题

- 字体变成底格（tofu）：deck 用了未安装字体 → 改成本机字体或按映射替换；见 reference/local-fonts.md。
- 浏览器导出失败：agent-browser 建 socket 权限或连 kimi.com 超时 → 改用本地 pptd_to_pptx.py / pptd_to_png.py。
- 本地导出没有字体嵌入/淡入淡出：这两项仅在浏览器导出路径提供。

🔄 更新日志

参见 CHANGELOG.md。

🧩 致谢

- 核心源自 binaryify/open-kimi-ppt-skill（MIT，逆向 Kimi Slides）。
- 基于 DeepSeek Harness 插件/技能体系。

📄 许可证

MIT（衍生自 MIT 的 open-kimi-ppt-skill，保留原版权声明）。

👤 作者

OMSociety