Skip to main content Home Creators zinohome zinoclaw deskclaw-pptx
deskclaw-pptx Generate, edit, and read PowerPoint presentations. Create from scratch with PptxGenJS (cover, TOC, content, section divider, summary slides), edit existing PPTX via XML unpack/pack workflows, or extract text with markitdown. Includes 18 color palettes, 4 style recipes, 5 slide types, and full design system. Triggers: PPT, PPTX, PowerPoint, presentation, slide, deck, slides, 演示文稿, 幻灯片.
Jump to install Skills Marketplace Discover and explore AI skills built by the community.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Show prompt details A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/zinohome/zinoClaw --skill deskclaw-pptxThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Download Zip Downloading... More from this repository Related occupations SOC
Based on SOC occupation classification
.skillshub-meta.json 513 B name deskclaw-pptx slug deskclaw-pptx version 4.0.0 displayName PPT 演示文稿生成器（DeskClaw PPTX） summary DeskClaw 自研 PPT 全能工具。支持从零创建（PptxGenJS 高精度渲染）、模板编辑（OOXML unpack/pack）、内容分析三大工作流。内置 18 种配色方案、5 种幻灯片类型、完整设计系统，跨平台兼容。 description Generate, edit, and read PowerPoint presentations. Create from scratch with PptxGenJS (cover, TOC, content, section divider, summary slides), edit existing PPTX via XML unpack/pack workflows, or extract text with markitdown. Includes 18 color palettes, 4 style recipes, 5 slide types, and full design system. Triggers: PPT, PPTX, PowerPoint, presentation, slide, deck, slides, 演示文稿, 幻灯片. author DeskClaw tags office, pptx, presentation, slides, design-system, charts, templates, powerpoint
PPT 演示文稿生成器
工作流选择
用户需求 走哪条路 关键命令 创建新 PPT PptxGenJS 工作流 写 JS → python scripts/compile.py slides/ output.pptx 编辑现有 PPT OOXML 工作流 unpack.py → 编辑 XML → pack.py查看 PPT 内容 markitdown python -m markitdown file.pptx
执行须知 (减少不必要的工具调用):
python bootstrap.py 只需执行一次，它会自动检测已安装的依赖并跳过，输出所有可用路径compile.py 会自动创建输出目录，不需要提前 mkdirwrite_file 直接写文件即可，不需要先 ls 检查或 mkdir 创建目录简单任务不需要读 reference 文件，SKILL.md 本身包含足够的示例
命令速查表
任务 命令 安装依赖 python bootstrap.py提取文本 python -m markitdown presentation.pptx生成缩略图 python scripts/thumbnail.py presentation.pptx解包 PPTX python scripts/office/unpack.py input.pptx unpacked/打包 PPTX python scripts/office/pack.py unpacked/ output.pptx --original input.pptx复制幻灯片 python scripts/add_slide.py unpacked/ slide2.xml清理孤立文件 python scripts/clean.py unpacked/验证 XML python scripts/office/validate.py unpacked/ --original input.pptx编译 JS→PPTX python scripts/compile.py slides/ output.pptx
10" x 5.625" (LAYOUT_16x9)
颜色格式 6 位 hex，无 # 前缀 (如 "FF0000")
中文字体 Microsoft YaHei (微软雅黑)
英文字体 Arial (默认)，或 Georgia/Calibri/Cambria
theme 键 primary, secondary, accent, light, bg
参考文档 (按需读取)
两个核心工作流
工作流 A: 从零创建 (PptxGenJS) 用于没有现成模板的场景。用 JavaScript 生成原生 PPTX 文件。
工作流 B: 模板编辑 (OOXML) 用于基于现有演示文稿的场景。解包 PPTX 为 XML，直接编辑后重新打包。
工作流 A: 从零创建
第 1 步: 理解需求
第 2 步: 选择色彩方案与字体 色彩方案应该为这个特定主题而选择。如果把你的颜色换到一个完全不同的演示中还能"成立"，说明选择不够具体。
第 3 步: 选择设计风格
Sharp & Compact : 数据密集、财务报告Soft & Balanced : 企业商务、通用场景Rounded & Spacious : 产品介绍、营销Pill & Airy : 品牌发布、高端展示
第 4 步: 规划幻灯片大纲 类型 用途 数量 封面 (Cover) 开场，定调 1 张 目录 (TOC) 导航，设预期 0-1 张 分隔页 (Section Divider) 章节过渡 按章节数 内容页 (Content) 主体内容 (6 种子类型) 占大部分 总结页 (Summary) 收尾，行动号召 1 张
内容页 6 种子类型: 文字型、图文混排、数据可视化、对比型、时间线/流程、图片展示。
确保视觉多样性 — 不要在多张幻灯片上重复同一布局。
第 5 步: 生成幻灯片 JS 文件 每张幻灯片一个 JS 文件 (slides/slide-01.js, slides/slide-02.js, ...)。
每个文件必须导出同步 createSlide(pres, theme) 函数。不需要 require pptxgenjs — pres 对象由 compile.js 传入:
function createSlide (pres, theme ) {
const slide = pres.addSlide ();
slide.background = { color : theme.bg };
slide.addText ("标题" , {
x : 0.5 , y : 2 , w : 9 , h : 1.2 ,
fontSize : 48 , fontFace : "Microsoft YaHei" ,
color : theme.primary , bold : true , align : "center"
});
return slide;
}
module .exports = { createSlide };
第 6 步: 编写 compile.js 并编译 在 slides/ 目录下创建 compile.js，汇编所有幻灯片:
const pptxgen = require ('pptxgenjs' );
const pres = new pptxgen ();
pres.layout = 'LAYOUT_16x9' ;
const theme = {
primary : "2b2d42" ,
secondary : "8d99ae" ,
accent : "ef233c" ,
light : "edf2f4" ,
bg : "ffffff"
};
for (let i = 1 ; i <= 3 ; i++) {
const num = String (i).padStart (2 , '0' );
require (`./slide-${num} .js` ).createSlide (pres, theme);
}
const output = process.env .PPTX_OUTPUT || './output.pptx' ;
pres.writeFile ({ fileName : output });
编译命令 (compile.py 自动处理 node 路径和模块查找):
python scripts/compile.py slides/ ~/Desktop/testout/deskclaw-pptx/output.pptx
第 7 步: QA 质量检查 slides/
├── slide-01.js ... slide-NN.js
├── imgs/
└── compile.js
→ python scripts/compile.py slides/ <目标路径>.pptx
Theme 对象协议 (必须遵守) 所有幻灯片通过 compile.js 接收同一个 theme 对象，包含且仅包含以下 5 个键:
键 用途 示例 theme.primary最深色，用于标题和背景 "22223b"theme.secondary次深色，正文和装饰 "4a4e69"theme.accent中间色调，强调 "9a8c98"theme.light浅色调，轻装饰 "c9ada7"theme.bg背景色 "f2e9e4"
不要使用其他键名 (如 background, text, muted)，因为编译脚本只传递这 5 个键。
页码徽章 (非封面页必须添加) 位置: x: 9.3", y: 5.1"。只显示当前页号 (如 3 或 03)，不显示 "3/12"。
slide.addShape (pres.shapes .OVAL , {
x : 9.3 , y : 5.1 , w : 0.4 , h : 0.4 ,
fill : { color : theme.accent }
});
slide.addText ("3" , {
x : 9.3 , y : 5.1 , w : 0.4 , h : 0.4 ,
fontSize : 12 , fontFace : "Arial" ,
color : "FFFFFF" , bold : true ,
align : "center" , valign : "middle"
});
工作流 B: 模板编辑
分析 : python scripts/thumbnail.py template.pptx + python -m markitdown template.pptx解包 : python scripts/office/unpack.py template.pptx unpacked/操作 : 在 ppt/presentation.xml 的 <p:sldIdLst> 中删除/复制/重排幻灯片编辑 : 修改各 slide{N}.xml 中的文本和元素清理 : python scripts/clean.py unpacked/打包 : python scripts/office/pack.py unpacked/ output.pptx --original template.pptx验证 : python scripts/office/validate.py unpacked/ --original template.pptx
设计原则
不要做无聊的幻灯片 白色背景加项目符号是最低标准。每张幻灯片都应该有视觉元素 — 图片、图表、图标或形状。
排版规范 元素 字号 幻灯片标题 36-44pt 加粗 章节标题 20-24pt 加粗 正文 14-16pt (中文 16-18pt) 注释/来源 10-12pt 数据突出显示 60-72pt
正文左对齐 (不要居中)。标题可以居中。中文正文不加粗 — 粗体仅用于标题。
布局建议
双栏布局 (文字左，图片右)
图标 + 文字行 (图标在彩色圆圈中)
2x2 或 2x3 网格
半出血图片 + 内容叠加
大数字标注 (60-72pt 数字 + 小标签)
常见错误 (必须避免)
不要在多张幻灯片上重复同样的布局
不要居中正文 — 正文左对齐
不要使用 # 前缀的 hex 颜色 (会导致文件损坏)
不要把透明度写进 8 位 hex 颜色字符串 — 用 opacity 属性
不要在 createSlide() 中使用 async/await — 必须同步
不要复用选项对象 — PptxGenJS 会原地修改，用工厂函数代替
不要在标题下加装饰线 — 这是 AI 生成幻灯片的明显标志
不要使用低对比度的文字或图标
QA 检查 (必须执行)
内容检查 python -m markitdown output.pptx
python -m markitdown output.pptx | grep -iE "\bx{3,}\b|lorem|ipsum|\bTODO|\[insert"
验证循环
生成 → markitdown 检查内容
列出发现的问题
修复
重新验证
重复直到无新问题
图标 (react-icons) 使用 react-icons 将 SVG 图标栅格化为 PNG，提升视觉效果。
const React = require ("react" );
const ReactDOMServer = require ("react-dom/server" );
const sharp = require ("sharp" );
const { FaCheckCircle } = require ("react-icons/fa" );
function renderIconSvg (IconComponent, color = "#000000" , size = 256 ) {
return ReactDOMServer .renderToStaticMarkup (
React .createElement (IconComponent , { color, size : String (size) })
);
}
async function iconToBase64Png (IconComponent, color, size = 256 ) {
const svg = renderIconSvg (IconComponent , color, size);
const pngBuffer = await sharp (Buffer .from (svg)).png ().toBuffer ();
return "image/png;base64," + pngBuffer.toString ("base64" );
}
图标库: react-icons/fa (Font Awesome), react-icons/md (Material), react-icons/hi (Heroicons)。
注意: 图标渲染是异步的，应该在 createSlide() 之前预处理好，将 base64 数据传入同步函数。
中文本地化
字体: 微软雅黑 (Microsoft YaHei)
正文字号: 16-18pt (比英文大 2pt)
行高: 1.5-1.8x
每行中文字符: 15-20 个
中英文/数字之间加半角空格: 会议有 12 位参与者
依赖安装 运行 python bootstrap.py 自动安装所有依赖。
pip install "markitdown[pptx]" Pillow defusedxml lxml -i https://pypi.tuna.tsinghua.edu.cn/simple
npm install pptxgenjs react-icons react react-dom sharp --registry=https://registry.npmmirror.com
