安装 Pikapika260214/rw-consulting-ppt 前，需要明确它不是“从材料一步生成全对象可编辑 PPTX”的工具。这个仓库里的 rw-consulting-ppt 默认走图片版咨询页路线：每页先生成一张完整 16:9 PNG，如果打包成 PPTX，每一页也只是一张完整图片，不包含可逐字编辑的 PowerPoint 文本框、图表、表格或形状。

它真正有价值的地方，是把行业报告、会议纪要、访谈笔记和半成品 bullet，整理成 proof-object-first 的咨询表达：对齐目标、梳理 storyline、编写页面 brief、确认样页，最后交付 PNG 或 image-only PPTX。第一个限制也要提前记住：后续要改字、改数字、改标签时，通常要接同仓库的 ppt-to-editable，而不是指望 rw-consulting-ppt 本身直接做原生可编辑 deck。

先把两个 skill 分开装，不要互相覆盖

仓库根目录下的 skills/ 里有两个平级目录：rw-consulting-ppt 和 ppt-to-editable。前者负责把粗糙商业材料变成咨询级图片页；后者负责把单张 slide 图片、截图、PNG/JPG 或 image-only PPTX 转成更可编辑的 PowerPoint。两个目录需要分别安装、分别触发。

mkdir -p ~/.codex/skills/rw-consulting-ppt ~/.codex/skills/ppt-to-editable
cp -R ./skills/rw-consulting-ppt/. ~/.codex/skills/rw-consulting-ppt/
cp -R ./skills/ppt-to-editable/. ~/.codex/skills/ppt-to-editable/

Windows PowerShell 也按同样思路复制到 $env:USERPROFILE.codexskills 下的两个子目录。安装后检查的重点不是仓库名是否在本地出现，而是每个目录里都有自己的 SKILL.md、references/ 和 scripts/；如果只复制了外层仓库，Codex 未必能把它们当作两个独立 skill 读取。

依赖分两层：生成 deck 和恢复可编辑能力不是一回事

rw-consulting-ppt 主要依赖 Codex 与完整幻灯片图片生成能力。它的规则里写得很硬：先生成 1 到 2 页代表性完整 PNG 样页，得到确认后再批量生成每页 PNG，只有被接受的 PNG 存在后，才用 skills/rw-consulting-ppt/scripts/package_image_deck.py 或等价机械打包方式生成 image-only PPTX。

ppt-to-editable 的依赖更多，因为它要做 OCR、裁剪、PPTX 打包、可编辑性检查和渲染 QA。README 建议准备 Python 3.10+，并安装 python-pptx、Pillow、rapidocr_onnxruntime、onnxruntime、numpy<2、shapely、opencv-python-headless、pyclipper 等依赖；Windows PowerPoint 可选，但用于导出预览图做视觉检查时很有帮助。

python --version
python -m pip install -r requirements.txt
python skills/ppt-to-editable/scripts/check_ocr_runtime.py --json --output-dir .ocr-check

如果只复制了 ppt-to-editable 目录到 Codex skills 目录，也可以安装该目录内置的依赖文件。第一次 OCR setup 可能比较慢，因为需要准备 OCR 运行时或模型文件；如果 Python 依赖或 OCR 不可用，应该先处理环境，不要临时写简化版 PPTX builder 来替代正式转换链路。

第一次试跑先做小 deck，等蓝图和样页都通过

这个 skill 不鼓励一上来就让模型“做几页好看的 PPT”。它有三个明显的确认点：先确认受众、交付模式、页数、信息密度、视觉风格和输出格式；再确认 core question、working thesis、storyline 和页面列表；最后确认 1 到 2 页样页 brief 和样页效果。没有蓝图确认，不进入样页；样页不过，不进入批量生成。

请使用 rw-consulting-ppt，把这些行业研究材料整理成 6 页中文管理层汇报。

目标受众：业务负责人
交付模式：独立阅读型报告页
信息密度：标准咨询密度
视觉风格：管理层报告风，白底，深绿作为强调色
输出格式：PNG + image-only PPTX

一个小型 5 到 6 页 deck 很适合首次试跑。比较理想的中间结果，会整理核心问题、working thesis、storyline、每页 claim、proof object 和 evidence boundary，而不是马上得到成品图片。样页如果像普通模板、只有漂亮卡片、没有 proof object、文字太空或一色到底，就要回到 brief 或 prompt 层修改，再继续。

结果检查：image-only 与 editable report

默认图片版输出通常包含 slides/slide_01.png、slide_02.png、contact_sheet.png、deck-name-image-only.pptx 和 run_notes.md。其中 deck-name-image-only.pptx 的每页只有一张完整图片，成功标准不是“文本框数量很多”，而是每张 PNG 都是 16:9、能独立阅读、proof object 能承载论证、contact sheet 看起来像一套统一咨询页。

如果启用了关键页可编辑化，输出目录会多出 editable-pages/，例如 slide_02-editable.pptx、slide_02-editability_report.json 和 slide_02-preview.png。这里不要只打开 PPTX 看像不像原图，还要看 editability_report.json：哪些文字变成文本框，哪些结构变成原生形状或表格，哪些复杂视觉仍然是图片裁剪，都应该在报告里说清楚。

需要整份可编辑时，路线要换成 ppt-to-editable

如果只有少数关键页要频繁改字、改数字、改标签，先用 rw-consulting-ppt 生成图片页，再把这些页面交给 ppt-to-editable 的单页省 token 模式会更稳。如果整份 image-only PPTX 都要尽量可编辑，可以用多页多 Agent 高质量模式，它会按页拆分、独立转换，再组装成 final-deck.pptx 和 deck-level-qa-report.json。

不过 ppt-to-editable 也不承诺任意页面都能全对象原生重建。复杂图标、照片、纹理、曲线路径、渐变箭头这类高风险视觉，通常会保留为紧裁剪图片或 textless crop；主要文字、简单矩形、线条、表格和标签更适合恢复成可编辑对象。需要大范围改内容时，回到 slide brief 或 prompt 层重做，通常比在 PPTX 里硬改更可靠。

Pikapika260214/rw-consulting-ppt 更适合先把粗糙商业材料变成有判断、有证据结构、有管理层阅读密度的图片版咨询 deck。安装时分清两个 skill，试跑时先过蓝图和样页，交付时先检查 PNG、contact sheet 和 image-only PPTX；确实需要编辑能力，再把关键页或整份 image-only PPTX 交给 ppt-to-editable，并用 report 判断真实可编辑范围。