메뉴
演示文稿创建、编辑和分析。当用户需要处理 PowerPoint 演示文稿（.pptx 文件）时使用，包括创建新演示文稿、修改内容、处理布局、添加批注或演讲者备注等。也适用于将 guizang-ppt HTML 转换为 PPTX。也适用于基于 Word/文本文档生成学术汇报 PPT（docx→PPT），包含中文学术 PPT 配色方案、卡片布局、条形图、表格等常用模式。触发词：做PPT、做个PPT、演示文稿、slides、presentation、汇报PPT。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | pptx |
| description | 演示文稿创建、编辑和分析。当用户需要处理 PowerPoint 演示文稿（.pptx 文件）时使用，包括创建新演示文稿、修改内容、处理布局、添加批注或演讲者备注等。也适用于将 guizang-ppt HTML 转换为 PPTX。也适用于基于 Word/文本文档生成学术汇报 PPT（docx→PPT），包含中文学术 PPT 配色方案、卡片布局、条形图、表格等常用模式。触发词：做PPT、做个PPT、演示文稿、slides、presentation、汇报PPT。 |
| metadata | {"short-description":"PowerPoint 演示文稿创建、编辑与分析"} |
本技能提供创建、编辑和分析 .pptx 文件的能力。核心依赖 $NAVI_HOME/skills/pptx/scripts/ 下的 Python 和 JavaScript 脚本。以下用 %NAVI_HOME% 表示路径。
| 脚本 | 路径 |
|---|---|
| html2pptx.js | %NAVI_HOME%/skills/pptx/scripts/html2pptx.js |
| thumbnail.py | %NAVI_HOME%/skills/pptx/scripts/thumbnail.py |
| inventory.py | %NAVI_HOME%/skills/pptx/scripts/inventory.py |
| replace.py | %NAVI_HOME%/skills/pptx/scripts/replace.py |
| rearrange.py | %NAVI_HOME%/skills/pptx/scripts/rearrange.py |
| unpack.py | %NAVI_HOME%/skills/pptx/ooxml/scripts/unpack.py |
| pack.py | %NAVI_HOME%/skills/pptx/ooxml/scripts/pack.py |
| validate.py | %NAVI_HOME%/skills/pptx/ooxml/scripts/validate.py |
参考文档：
%NAVI_HOME%/skills/pptx/html2pptx.md%NAVI_HOME%/skills/pptx/ooxml.md执行脚本时使用 bash 工具，例如：
python "%NAVI_HOME%/skills/pptx/scripts/thumbnail.py" presentation.pptx
python -m markitdown 文件路径.pptx
python "%NAVI_HOME%/skills/pptx/ooxml/scripts/unpack.py" <pptx文件> <输出目录>
关键 XML 文件：
ppt/presentation.xml — 主元数据和幻灯片引用ppt/slides/slide{N}.xml — 各幻灯片内容ppt/notesSlides/notesSlide{N}.xml — 演讲者备注ppt/comments/modernComment_*.xml — 批注ppt/theme/theme1.xml — 主题配色和字体ppt/media/ — 图片等媒体分析现有设计时：读取 ppt/theme/theme1.xml 中的 <a:clrScheme>（颜色方案）和 <a:fontScheme>（字体方案），以及 slides XML 中的实际使用情况。
必须先完整阅读 html2pptx.md，了解所有语法规则。
如果是将已有的网页展示（如 guizang-ppt-skill 输出的 HTML）转换为 PowerPoint，建议同时阅读 html2pptx-workflow.md——它包含了实战中的字体映射策略、溢出调试流程、Module Resolution 陷阱等经验。
html2pptx.md — 使用 read_file 完整读取<p>, <h1>-<h6>, <ul>, <ol> 中class="placeholder"html2pptx() 函数python "%NAVI_HOME%/skills/pptx/scripts/thumbnail.py" output.pptx workspace/thumbnails --cols 4
html2pptx.js 依赖 playwright 和 sharp。如果用户拒绝安装，使用方式 B。
当 html2pptx.js 的依赖（playwright、sharp）不可用时，直接用 pptxgenjs 手动创建。
const pptxgen = require('pptxgenjs');
const pptx = new pptxgen();
pptx.layout = 'LAYOUT_16x9';
const slide = pptx.addSlide();
slide.background = { color: '#fafaf8' };
// 添加文本
slide.addText('标题', {
x: '10%', y: '20%', w: '80%', h: '15%',
fontSize: 36, fontFace: 'Arial', color: '#0a0a0a',
fontWeight: '200', align: 'center'
});
// 添加形状
slide.addShape('rect', {
x: '10%', y: '40%', w: '30%', h: '20%',
fill: { color: '#f0f0ee' }
});
await pptx.writeFile({ fileName: 'output.pptx' });
⚠️ pptxgenjs 关键注意事项：
#002FA7）或 pptxgen.SchemeColor。不支持 rgba()、rgb()、带透明度的颜色格式。使用 rgba 会被静默替换为 #000000。'rect'、'roundRect'、'ellipse' 等，不要用 pptxgen.shapes.RECTANGLE（会报 undefined 错误）。'Noto Sans SC' 等自定义字体。'10%'）和英寸数值。使用 OOXML 编辑工作流。必须先完整阅读 ooxml.md。
ooxml.md — 使用 read_file 完整读取python "%NAVI_HOME%/skills/pptx/ooxml/scripts/unpack.py" <文件> <输出目录>ppt/slides/slide{N}.xml 等python "%NAVI_HOME%/skills/pptx/ooxml/scripts/validate.py" <目录> --original <文件>python "%NAVI_HOME%/skills/pptx/ooxml/scripts/pack.py" <输入目录> <输出文件>提取模板信息：
python -m markitdown template.pptx > template-content.md
python "%NAVI_HOME%/skills/pptx/scripts/thumbnail.py" template.pptx
阅读模板内容 md 和缩略图，分析布局。
创建模板清单：记录每张幻灯片的用途和布局类型
重排幻灯片：
python "%NAVI_HOME%/skills/pptx/scripts/rearrange.py" template.pptx working.pptx 0,1,2,3
（索引从 0 开始，可重复以复制幻灯片）
提取文本结构：
python "%NAVI_HOME%/skills/pptx/scripts/inventory.py" working.pptx text-inventory.json
阅读 text-inventory.json，了解所有 shape 及其属性。
生成替换文本：基于 inventory 创建 replacement-text.json，包含段落属性和格式化信息
应用替换：
python "%NAVI_HOME%/skills/pptx/scripts/replace.py" working.pptx replacement-text.json output.pptx
python "%NAVI_HOME%/skills/pptx/scripts/thumbnail.py" presentation.pptx [输出前缀]
# 默认 5 列，最多 30 张/图
# 可用 --cols 3-6 调整列数
如果需要安装依赖：
pip install "markitdown[pptx]" defusedxml
npm install -g pptxgenjs playwright sharp
本机已安装 LibreOffice（版本 26.2.3.2），路径 C:\Program Files\LibreOffice\program\soffice.exe，soffice 已在 PATH 中。
PPTX → PDF 转换命令：
soffice --headless --convert-to pdf --outdir ./output_dir input.pptx
PDF → PPTX 转换命令：
soffice --headless --convert-to pptx --outdir ./output_dir input.pdf
检测 LibreOffice 安装路径：
where soffice
当用户要求"基于某个 Word 文档做一个 PPT"时，使用以下工作流：
优先用 markitdown，不可用时用 python-docx 降级（python-docx 几乎总是已安装）：
# 方法1：markitdown（优先，需 pip install markitdown）
python -m markitdown 文档.docx
# 方法2：python-docx 降级（可靠，通常已安装）
python -c "
import docx
doc = docx.Document('文档.docx')
for p in doc.paragraphs:
if p.text.strip():
print(p.text)
"
注意：
read_file读取 .docx 会得到乱码（二进制），必须用上述命令行方式提取文本。
从提取的文本中识别文档结构，规划幻灯片：
用方式 B（pptxgenjs）编写 JS 脚本生成。参考下方学术中文 PPT 模式。
创建中文学术/课程报告 PPT 时的通用模式和样式参考。
const C = {
primary: '1B4F72', // 深蓝 - 标题、强调
accent: '2E86C1', // 亮蓝 - 装饰、链接
light: 'EBF5FB', // 浅蓝 - 背景高亮区
dark: '0B2F4A', // 深蓝黑 - 正文
white: 'FFFFFF',
gray: '7F8C8D', // 次要文字
red: 'E74C3C', // 警告/重要
green: '27AE60', // 成功/低风险
orange: 'F39C12', // 中等/中风险
bg: 'F8FBFE', // 幻灯片背景
};
黑底 + 暖米白文字 + 赤陶红强调色，视觉冲击力强，适合发布会/答辩/营销。
const C = {
bg: '000000', // 纯黑背景
bgAlt: '181818', // 近黑辅底（卡片/区块）
text: 'F8E8D8', // 暖米白主文字
accent: 'C05137', // 赤陶红强调色
gray: '8A8A8A', // 次要文字
dimText: 'A0A0A0', // 淡化文字
accentLt: 'E07040', // 浅赤陶（中等强调）
};
从参考图片提取配色：当用户提供参考图片要求匹配风格时，用 PIL 提取主色：
from PIL import Image
import numpy as np
from collections import Counter
def extract_colors(path, n=5):
img = Image.open(path).convert('RGB').resize((200, 200))
pixels = (np.array(img).reshape(-1, 3) // 8) * 8 # 量化去噪
for color, count in Counter(map(tuple, pixels.tolist())).most_common(n):
print(f' #{color[0]:02x}{color[1]:02x}{color[2]:02x} ({count/len(pixels)*100:.1f}%)')
# 橙红系强调色单独提取（小面积但关键）
def find_accent(path):
img = Image.open(path).convert('RGB')
pixels = np.array(img).reshape(-1, 3)
mask = (pixels[:,0]>150) & (pixels[:,1]<150) & (pixels[:,2]<120) & (pixels[:,0]>pixels[:,1])
accent = pixels[mask]
if len(accent) > 0:
avg = accent.mean(axis=0).astype(int)
print(f' #{avg[0]:02x}{avg[1]:02x}{avg[2]:02x}')
提取后根据图片风格选择浅色或深色方案模板，将提取的 hex 值填入对应角色。
// 三个并排卡片，展示关键数据
const stats = [
{ val: '5.37亿', label: '全球患者', color: C.red },
{ val: '1.4亿', label: '中国患者', color: C.orange },
{ val: '12.8%', label: '患病率', color: C.accent },
];
stats.forEach((st, i) => {
const x = 5 + i * 31;
s.addShape('roundRect', { x: `${x}%`, y: '18%', w: '27%', h: '14%',
fill: { color: C.white }, shadow: { type: 'outer', blur: 6, offset: 2, color: 'D5D8DC' }, rectRadius: 0.08 });
s.addText(st.val, { x: `${x}%`, y: '18%', w: '27%', h: '8%',
fontSize: 24, fontFace: 'Arial', color: st.color, bold: true, align: 'center', valign: 'middle' });
s.addText(st.label, { x: `${x}%`, y: '26%', w: '27%', h: '5%',
fontSize: 11, fontFace: 'Arial', color: C.gray, align: 'center', valign: 'middle' });
});
const features = [
{ name: 'HbA1c', val: 0.2173, color: 'E74C3C' },
{ name: '空腹血糖', val: 0.1487, color: 'F39C12' },
{ name: '多尿', val: 0.0824, color: '2E86C1' },
];
const maxVal = 0.25;
features.forEach((f, i) => {
const y = 18 + i * 7.5;
const barW = (f.val / maxVal) * 45; // 最大占 45% 宽度
s.addText(f.name, { x: '3%', y: `${y}%`, w: '30%', h: '5%',
fontSize: 10, align: 'right', valign: 'middle' });
s.addShape('roundRect', { x: '35%', y: `${y+0.5}%`, w: '48%', h: '4%',
fill: { color: 'EBF5FB' }, rectRadius: 0.03 });
s.addShape('roundRect', { x: '35%', y: `${y+0.5}%`, w: `${barW}%`, h: '4%',
fill: { color: f.color }, rectRadius: 0.03 });
s.addText(f.val.toFixed(4), { x: `${35+barW}%`, y: `${y}%`, w: '10%', h: '5%',
fontSize: 10, bold: true, align: 'left', valign: 'middle' });
});
const risks = [
{ level: '低风险', pct: '60.5%', actual: '6.16%', color: '27AE60' },
{ level: '中风险', pct: '1.8%', actual: '60.00%', color: 'F39C12' },
{ level: '高风险', pct: '37.7%', actual: '93.43%', color: 'E74C3C' },
];
risks.forEach((r, i) => {
const x = 5 + i * 31;
s.addShape('roundRect', { x: `${x}%`, y: '18%', w: '27%', h: '38%',
fill: { color: C.white }, line: { color: r.color, width: 2.5 }, rectRadius: 0.1 });
// ... 标题、占比、实际患病率依次排列
});
function addFooter(slide, pageNum) {
slide.addText('机构名称', { x: 0, y: '95%', w: '100%', h: '5%',
fontSize: 8, color: C.gray, align: 'left', margin: [0,0,0,40] });
slide.addText(`${pageNum}`, { x: 0, y: '95%', w: '100%', h: '5%',
fontSize: 8, color: C.gray, align: 'right', margin: [0,40,0,0] });
}
当用户要求深浅搭配（避免全部黑底或全部白底单调）时，定义两套色板并交替使用：
const D = { bg: '000000', bgAlt: '181818', text: 'F8E8D8', dim: 'A0A0A0', accent: 'C05137', accentLt: 'E07040', gray: '8A8A8A', line: '2A2A2A' };
const L = { bg: 'F0E0D0', bgAlt: 'F8E8D8', text: '1A1A1A', dim: '5A5A5A', accent: 'C05137', accentLt: 'E07040', gray: '8A8A8A', line: 'D8C8B8' };
// 推荐交替模式（内容页浅色更易读）：
// 1-封面: DARK 2-目录: LIGHT 3-背景: DARK 4-数据: LIGHT
// 5-分析: DARK 6-模型: LIGHT 7-特征: DARK 8-分层: LIGHT
// 9-结论: DARK 10-致谢: DARK
function footer(slide, n, theme) {
const c = theme === 'dark' ? D : L;
// footer 颜色跟随主题
}
两套色板共用同一 accent 色保持统一感。bgAlt 用于卡片/区块背景，line 用于分割线和边框。
'Arial'（pptxgenjs 不支持自定义中文字体名）s.addTable() 实现，表头行用 fill 背景色，行交替用 bg/bgAlt 增加层次roundRect + 浅色填充 + 左侧彩色竖条1. 2. 3. 代替 1️⃣，用色块标签代替图标，用 *** 代替 ★。pptxgenjs 的 emoji 渲染在不同系统上不一致。注意：
html2pptx.md和ooxml.md是此技能的关键参考文档。在处理创建或编辑任务时，务必先完整阅读对应文档。
Navi Agent 设计参考库。当用户询问 navi agent 的架构设计、功能方案、技术选型、或某个具体实现应该如何做时，自动参考 Claude Code (cc_src/)、KIMI-CLI (kimi-cli/)、Hermes (hermes-agent/) 三个成熟项目的源码来提供建议。触发场景包括：讨论 agent loop 设计、工具系统、审批机制、会话管理、UI/CLI 交互、技能系统、插件机制、subagent、MCP 集成等任何 navi 的功能设计问题。也适用于：添加新工具、修改工具行为、集成外部 API。也适用于：多智能体系统设计、Worker 模式、sub_agent 委派模式、Interactive SubAgent 模式、Human-in-the-Loop 模式。也适用于：LangGraph 功能评估、工具调用兼容性分析、模型适配方案选型。
CLI agent 工具输出架构设计与调试。当排查工具输出重复、输出丢失、输出乱序、实时流与结果渲染冲突、输出截断策略等问题时使用。也适用于为新的 CLI agent 工具设计输出通道。触发词：工具输出重复、output twice、双份输出、流式输出、tool result rendering、输出截断、truncat。
Navi Agent 工具开发指南。当需要为 Navi 添加新工具（tool）、修改已有工具、或理解工具注册机制时使用。触发场景：用户说"写一个 XX 工具"、"添加工具"、"tool 怎么写"、"注册工具"、涉及 tool.py 或 runtime.py 中工具注册部分的修改。也适用于：集成外部工具协议（MCP 等）、添加工具子系统、批量注册动态发现的工具。也适用于：添加或修改斜杠命令（/xxx）、斜杠命令子命令。
Discover agent-native CLIs for professional software. Access the live catalog to find tools for creative workflows, productivity, AI, and more.
深入分析复杂项目的架构设计、核心机制和实现原理。当用户询问"为什么 X 能做到 Y"、"系统是怎么工作的"、"分析一下这个项目的架构"时使用。也适用于主动分析开源项目的技术栈、模块划分、数据流、配置体系。覆盖 LangChain/LangGraph Agent、前后端分离 Web 应用、CLI 工具等常见项目类型。也适用于：代码缺陷审查（安全漏洞、架构问题、设计反模式）、两个或多个项目的全面对比分析。触发词："缺陷"、"有什么问题"、"对比"、"区别"、"哪个更好"、"review"、"审计"。
全面处理文档创建、编辑和分析，支持修订、批注、格式保留和文本提取。当需要处理专业 Word 文档（.docx 或 .doc 文件）时使用，包括：创建新文档、修改或编辑内容、处理修订、添加批注、提取文本内容或其他文档任务。也适用于中文学术报告、课程设计说明书等格式化文档的生成，以及将matplotlib图表插入到Word文档中。也适用于填写表单模板（中期验收表、申请书、评审表等），从多个参考文档（xlsx、docx、用户记忆）提取数据后填写到 .doc/.docx 表单中。