{ "name": "html-to-pptx", "version": "1.0.0", "description": "当用户想把 HTML 幻灯片转成 .pptx 时触发——\"HTML 转 PPT\"、\"网页幻灯片转 pptx\"、\"把这个 deck 转成 ppt\"、\"给同事一份 ppt 副本\"、\"汇报不方便放浏览器\"、给了 .html 路径 + 提到 ppt/pptx/演示/幻灯片。保留矢量文字可编辑、字体按需嵌入、复杂装饰自动走截图兜底；不依赖 reveal.js / 自写 deck 等具体框架。", "system_prompt": "name html-to-pptx description 当用户想把 HTML 幻灯片转成 .pptx 时触发——\"HTML 转 PPT\"、\"网页幻灯片转 pptx\"、\"把这个 deck 转成 ppt\"、\"给同事一份 ppt 副本\"、\"汇报不方便放浏览器\"、给了 .html 路径 + 提到 ppt/pptx/演示/幻灯片。保留矢量文字可编辑、字体按需嵌入、复杂装饰自动走截图兜底；不依赖 reveal.js / 自写 deck 等具体框架。 html-to-pptx 何时触发用户说出下列任一意图： \"把这个 HTML / 网页 deck 转成 PPT / pptx\" \"做了 HTML 幻灯片，要给同事一份 ppt\" \"汇报现场不方便放浏览器，想要 ppt 文件\" 已有 HTML 文件路径 + 提到 ppt / pptx / 演示 / 幻灯片调用是这个 skill 安装路径（通常 ~/.claude/skills/html-to-pptx/ ，Windows 上是 %USERPROFILE%\\.claude\\skills\\html-to-pptx\\ ）。下面命令里的替换成实际路径，或者先 cd 再直接 python convert.py … 。 python /convert.py 默认输出到与输入同目录的 .pptx 字体完全按需：HTML 用到的字体在 convert 时从 Google Fonts 拉取并 subset 嵌入，缓存到 %LOCALAPPDATA%\\html-to-pptx\\fonts\\ 或 ~/.cache/html-to-pptx/fonts/ ，下次同名字体秒复用 HTML 含 CJK 字符会自动种子 Noto Sans SC + Noto Serif SC（首次约 40 MB / ~30s 下载并 instance 静态 Regular/Bold，之后命中 cache） GF 没有的家族会回退到 viewer 系统字体并打印 warning 选项含义 --out 自定义输出 .pptx 路径 --keep-screenshots 同时保留每页 HTML 参考截图 + preflight.json --no-embed-fonts 跳过字体嵌入。文件更小但换机会回退到系统字体 --no-preflight 关闭 Stage 1 风险预扫 --no-verify 关闭 Stage 5a 结构化自检 --no-visual-audit 关闭 Stage 5b 视觉 audit 物料产出。日常不要关 --install-user-fonts 把自动解析到的非 CJK 字体装到用户字体目录（让 WPS 能正确渲染）。Win/macOS/Linux 都支持。必须先问用户，见下方\"配置确认\"章节 --only-slides N,N,N 增量重跑。逗号分隔的页号（1-based）。measure 只跑指定页 + 与上轮 cached measurement 合并；assemble/embed 仍全量；Stage 5a 只渲指定页；Stage 5b 只重建指定页的 compare 图——其它页全部复用上轮缓存。audit 迭代轮专用，详见下方\"增量重跑\"章节 --cleanup 不做转换。删 input.pptx 旁的 audit / measurement / preflight 工作物，只保留 .pptx 和 audited.html。最终交付前用，见下方\"工作流\"末步工作副本（原 HTML 不动）第一次 python convert.py .html 跑完，convert.py 自动 cp 一份 .audited.html 到源 HTML 同目录。机制：所有 audit 修复改 audited.html ，不改源 HTML 后续轮 convert（含 --only-slides ）input 用 .audited.html ，输出仍是 .pptx （自动去掉 .audited 后缀） audited.html 已存在 → 复用，不覆盖（保留上轮修复） agent 误传源 HTML 当 input → convert.py 内部检测后切到 audited.html 兜底 cleanup 不删 audited.html（视为可交付副产物，跟 .pptx 一组交付）想从头开始 → 手动删 audited.html 后重跑配置（ .config.local.toml ） skill 根目录下可选的本机偏好文件，gitignored，每用户一份。当前有三类偏好： [fonts] auto_install = \"ask\" # \"yes\" 自动装、\"no\" 永不装、\"ask\" 由 agent 询问 [cleanup] default = \"clean\" # \"clean\" 工作流末步自动 cleanup、\"keep\" 保留 audit 产物 [audit] mode = \"ask\" # \"triage\" / \"page\" / \"manual\" / \"ask\" 由 agent 询问文件 / key 缺失 → 走默认（同上）模板： /.config.local.toml.example fonts.auto_install 由 convert.py 强制读取并应用（=yes 自动加 --install-user-fonts 、=no 自动忽略） cleanup.default 由 agent 在工作流末步读取决定行为 audit.mode 由 agent 在第一次 convert 前确认；Stage 5b 后按该值执行审查： \"triage\" → 主 agent 自己看 audit_contact_*.png 总览分流，再派 sub-agent 看入围页单图，节省 token \"page\" → 每个目标页都派 sub-agent 看单页 slide_NN_compare.png ，覆盖最严 \"manual\" → 只生成审查物料，交给用户人工核查；用户反馈问题后再修 \"ask\" 或缺失 → agent 通过 AskUserQuestion 收集偏好后改写此项（默认）首次使用：agent 通过 AskUserQuestion 收集 fonts.auto_install 和 audit.mode 后自己 Write 这个文件 ——用户不用手动建配置确认（第一次 convert 之前完成）两条偏好要在第一次 convert 之前确认： fonts.auto_install 和 audit.mode 。流程相同，差别只在触发条件和问法。通用流程每条偏好独立按下面顺序判定： Read /.config.local.toml ，看对应字段：合法非 ask 值 → 按该值走，会话内不再问 ask 或文件 / 字段缺失 → 走\"触发判定 + ask\" CLAUDE.md / 全局指令写明了等同值的，按写明值走，并补写 config（保持单一事实源）触发后 AskUserQuestion 问一次，两条都要做：写入 /.config.local.toml 对应字段为用户答复（不写 ask ，否则下次会话还会再问）本次会话同时按答复走写 config 时：文件不存在 → Write 整文件落盘（[fonts] [cleanup] [audit] 三段模板）；文件已存在 → 用 Edit 做单行 replace（只改这一个字段），不要 Write 重写整文件，否则会吞掉用户其它自定义 key。同一会话两条都触发 → 合并到同一条 AskUserQuestion 里一次问完。 fonts.auto_install —— 字体安装 PowerPoint COM slide.Export() 和 WPS Office 都不读 pptx 内嵌的裸 TTF——audit 渲染和 WPS 都回退到系统字体。装到用户字体目录后两者都按系统字体走。目录（均为用户级，可手工删）： Windows: %LOCALAPPDATA%\\Microsoft\\Windows\\Fonts\\ + HKCU 注册 macOS: ~/Library/Fonts/ Linux: ~/.local/share/fonts/ + fc-cache -f 触发判定：看 HTML 的 / @import url(https://fonts.googleapis.com/...) /