planners-ppt-hell
制作与持续修改 SVG 页面工作台,从逐页内容稿或 video-idea-system 的 visual-plan.json 与素材出发,输出可编辑 PPT 或视频 SVG 文件。用于直接材料或生产包的页面制作、返修、视觉参考复用及需人工确认的模板提炼入库。
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 15 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/thePlannerIvan/planners-ppt-hell with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/thePlannerIvan/planners-ppt-hell'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/theplannerivan--planners-ppt-hell)HTML
<a href="/listings/theplannerivan--planners-ppt-hell"><img src="/api/listings/theplannerivan--planners-ppt-hell/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
pip install -r scripts/requirements.txt # python-pptx / lxml / Pillow / playwright playwright install chromium # 用于把 SVG 渲染成真实 PNG 预览与目检
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 64 lines
- ---
- name: planners-ppt-hell
- description: 制作与持续修改 SVG 页面工作台,从逐页内容稿或 video-idea-system 的 visual-plan.json 与素材出发,输出可编辑 PPT 或视频 SVG 文件。用于直接材料或生产包的页面制作、返修、视觉参考复用及需人工确认的模板提炼入库。
- ---
- # Planner's PPT Hell
- 由阿祖不看 TVC 创建与维护。https://demyth.info · Lawyif@163.com。
- 署名保留在 Skill 与工作台,不加入客户 PPT、SVG 或 PNG。
- SVG 工作台持续存在。用户改字与模型候选共用版本存储;PPT 与视频快照是可重复输出,不是项目终态。普通页面没有批准门;模板入库保留独立的当前包人工确认。
- ## 1. 接收
- 职责与接口见 [架构](references/architecture.md)。读 [00_pipeline_controller.md](references/workflow/00_pipeline_controller.md),初始化或恢复同一项目。
- 幻灯片可接收 Bypage 逐页稿,也可从用户材料、已有稿件或需求直接整理内容;按复杂度调用 Bypage,不把它设为前置门。见 [02_content_stage.md](references/workflow/02_content_stage.md)。
- 视频可适配 visual-plan.json 与 assets;直接接收只限**作者已有上屏稿(逐页文字已定)**的片子 —— 从材料开始、还没有 `visual-plan.json` 的新片回 `video-idea-system`。已有 screen ID 保持不变。见 [03_video_route.md](references/workflow/03_video_route.md)。
- 接收 Bypage 成品时沿用其 canonical 来源索引和已绑定的事实核查;内容改写后的核查时机与范围见内容输入文档,不把原 audit 扩大为新页面已核查。
- 结束条件:来源可读、稳定页面身份可定位、资产已登记且没有静默遗漏。
- ## 2. 定方向
- 一次确认画幅与视觉来源,用户已指明的直接执行。共同秩序写入 _internal/01_content/design_direction.md。
- 通用判断读 [style_system.md](references/domain/style_system.md);选择信息关系时读 [layout_taxonomy.md](references/domain/layout_taxonomy.md)。模板含义以 [模板契约](references/contracts/template_package.md) 为准;开画前读取所选模板或视频风格文档并实际查看样张;没有模板时查看本次参考,具体构图由当前内容决定。
- 模板是「主题 + 一组具名版式」:主题定 tokens、底壳与 SPEC,版式是某一页的参考骨架。工作台里整套选模板、逐页选版式都只是给模型的一条请求,不是页面自动重绘。
- 提取生产(PPTX / PDF):`extract_template_pack.py` 现在同时产出原生 `layout_catalog.json`;`scaffold_template_pack.py` 写 tokens/SPEC/shell/layouts;`template-select` 由人勾选结构家族,`apply_layout_selection.py` 收窄 `layouts.json`;模型只做被选中的 primitive,最后 `template-review` 批准。
- 幻灯片复用参考、选择库模板或提炼入库时读 [01_template_intake.md](references/workflow/01_template_intake.md);只有入库分支需要模板人工确认。
- 结束条件:方向和画幅明确,必要的源参考已经实际查看。
- ## 3. 工作台
- 读 [04_svg_stage.md](references/workflow/04_svg_stage.md)。模型可以通过 store CLI 新增或删除页面;新增页提交完整 candidate 与 page 元数据,删除页提交 page_key、base_revision 与 base_order。已有页先 checkout 当前页,编辑返回的候选,再提交 author=model、candidate、base_revision。_internal/02_svg_source 是可重建兼容视图,不是生成脚本写入位置。
- 读取 notes、protected 与待办 tasks;冲突时保留候选并重新读取。遗漏用户操作会被拦下,明确改写范围只来自浏览器任务授权。
- 工作台的「模板 / 版式」是请求入口:整套模板与逐页参考版式跟意见一起提交成 store 任务(任务 `template_id`、页面 `layout_id`)。DSH 当场唤醒模型;本地宿主只把任务落盘,等模型下次读到。模型按任务 checkout 该页,以所选版式为参考重排,保存时带 `layout_id`,在回执里说明保留与偏离。版式是参考,不是锁层:内容放不下时,这页的主张与证据优先。
- 用 check --summary 批量检查本轮页面,再逐页查看当前 PNG、记录实际 inspect。打开工作台与反馈恢复见 [07_visual_review.md](references/workflow/07_visual_review.md);反馈不是批准,未完成反馈不阻止独立输出。运行在 DSH 时用 `review_open` 自动加载同一工作台到侧栏;非 DSH 自动启动或复用 `planners-review-core` 本地宿主。两路共用同一份 Workbench Store、草稿和命令回执。
- 结束条件:本轮提交有保存回执,技术问题与实际看图结果可查。工作台可继续修改,没有永久 COMPLETE。
- ## 4. 输出
- PPT 输出或需要固定版本交接时,网页先保存末次输入、页序和页面集合并提交 snapshot;宿主唤醒携带确切 snapshot.path。运行 `python scripts/orchestrate/ppt_pipeline.py <project> export --snapshot <snapshot.json绝对路径>` 消费选定版本;指定无效路径直接报错。未指定路径时,`export` 才固定当前页面、页序与资产。
- 控制器校验冻结画面。slides 的 PPT、notes 与转换报告在 `_internal/06_ppt_output/<snapshot_id>/`;export 的 output_path 指向实际输出,根 final_deck.pptx 只是最新兼容副本。视频默认直接交付已保存的 SVG 与关联素材,见视频路线;需要固定版本交接时可生成快照。
- PPT 用实际渲染预览运行 `export-inspect --snapshot <同一snapshot.json> --previews <实际PNG...> --note "<工具与发现>"`,绑定该次输出,不要求工作台停止编辑。没有渲染工具就报告未复核,保留 EXPORT_VERIFY;快照校验范围见 [项目契约](references/contracts/project_contract.md)。
- 视频交付当前保存版本的 SVG、关联素材、页序与 notes,不要求额外 export;元素 id、步骤钩子、脚本绑定都是可选增强,不要求。如使用快照,报告 content_delta / changed_needs_check;它们不证明新文本与已录音语义一致。动效与合成规范归 Video Craft。
- 结束条件:交付文件与对应版本可定位、技术结果已报告、实际复核工具及限制清楚。随后仍可回到工作台。
- ## 按需读取
- | 分支 | 上下文 |
- |---|---|
- | SVG 特性、缺图或转换错误 | [svg_rules.md](references/domain/svg_rules.md);PPT 再读 [svg_to_ppt_rules.md](references/domain/svg_to_ppt_rules.md) |
- | 版本、候选、反馈恢复或输出溯源 | [project_contract.md](references/contracts/project_contract.md) |
- | 新模板包制作、审阅、替换入库 | [template_package.md](references/contracts/template_package.md);提取生产流程见 [01_template_intake.md](references/workflow/01_template_intake.md) |
- | 视频风格选择(私有风格库挂载与开源通用降级) | [03_video_route.md](references/workflow/03_video_route.md);运行 `python3 scripts/resolve_video_vault.py --style <style_id>` 读取 `~/.config/planners/video-vault/styles/<style_id>/page.md` 与 `anchors/`(无私有库时自动降级为 `default-clean`) |
- | 新视频风格提炼 | [08_video_style_extraction_sop.md](references/workflow/08_video_style_extraction_sop.md) |
- | 文案表达要改(标题、层级、扫读) | `slide-copy`:页面文案的规矩归它,本 Skill 只负责画面 |
- | 论证关系不清楚,需要方法视角 | `planners-method-wiki`:只给论证关系与解释角度,不改字 |
- | 内容改写后要复核事实 | `planners-fact-check`:改过内容的页在出声前核一遍,纯排版不动 |
- | 工程维护与验证 | [ARCHITECTURE.md](docs/ARCHITECTURE.md);命令参数以各脚本 --help 为准 |
- ## 运行后迭代
- 任务后内部自检,仅明确纠正或多次复现的通用缺陷列为候选,项目反馈留在项目;没有可复用发现不增加日志。
- 改之前读 [架构](references/architecture.md);候选记 [GOTCHAS](GOTCHAS.md) 的现象、原因、行为修正、证据、状态与 module;实际升级记 [维护历史](references/maintenance-history.md) 的变化、原因、影响与移除项。
- Skill 改动先确认,冻结候选测试,完成后统一发布;候选验收阶段不改正式来源或 runtime。
README.md · README · 175 lines
- # Planner's PPT Hell
- [](LICENSE)
- [](SKILL.md)
- **先把每一页做成人眼看得见、能按图挑刺的清晰 SVG,再一键变成真正可编辑的 PowerPoint(`.pptx`),或者直接输出给短视频使用的静态关键帧画面。**
- > 作者:阿祖不看 TVC(小红书同名)· [demyth.info](https://demyth.info) · [Lawyif@163.com](mailto:Lawyif@163.com)
- ---
- ## 一句话看懂:它的两个出口与生态卡位
- 很多 AI 生成的 PPT 之所以“不能交稿”,是因为字体叠车、盒子只是死截图、改一个字得全套重生成。**Planner's PPT Hell** 反过来:所有页面先以高可控 SVG 写成,渲染出图自检后再交给你在**可视化审阅台逐页看图返修**,最后通过坐标几何转换出原生可编辑元素:
- ```text
- 输入(任选其一):
- ├─ 路线 A(做幻灯片):planners-bypage 逐页包 / 直接资料 / 已有 PPTX 模板
- │ → 挑模板或现场扒模板 → AI 设计每页 SVG → 看图自查 → 打开审阅台改图
- │ → 出口 ①:原生可编辑 PowerPoint(final_deck.pptx + 演讲者备注)
- │
- └─ 路线 B(做视频静态画面):video-idea-system 的 visual-plan.json(或已定稿上屏稿)
- → 对照风格参考(私有风格库或通用洁净风格)绘制 9:16 / 16:9 静态 SVG
- → 出口 ②:直接交付已保存 SVG 与素材目录 → 交给 video-craft 做动效合成
- ```
- *(注:若你的新视频还没有 `visual-plan.json` 与口播定稿,请先从 [`video-idea-system`](https://github.com/thePlannerIvan/video-idea-system) 开始;只需要写逐页文案先不急着排版,请用 [`planners-bypage`](https://github.com/thePlannerIvan/planners-bypage)。)*
- ---
- ## 开箱自带:4 套旗舰模板库 + “直接从现有 PPT 扒模板”
- 你既不用从零凑样式,也不必被死板的几套默认模板绑死:
- ### 1. 内置 4 套开箱视觉模板
- | 模板包名称 | 视觉风格与适合场景 |
- | --- | --- |
- | `agency-social-proposal` | **整合营销与社媒种草提案**:高对比杂志编辑感 + 实战种草卡片与排期表 |
- | `consulting-product-strategy` | **商业分析与产品战略报告**:深空蓝黑冷峻数据秩序 + KPI 仪表带、2×2 象限与四阶传导 |
- | `dark-titanium-cockpit` | **瑞士先锋排印与暗钛金驾驶舱**:强字阶对比、极细发丝网格与单点高对比破局色 |
- | `planner-simple-default` | **通用简洁商业模板**:克制高对比浅色系,开箱通用不抢戏 |
- ### 2. 从任意旧 PPTX / PDF “扒”出一套品牌模板
- 手上有客户 VI 手册或去年的优秀提案 `.pptx` / `.pdf`?可以直接让它提取配色、字体规范、底壳与可复用版式家族——在网页界面里勾选你想要的那几类版式骨架,一键生成专属模板包并在后续整套复用。
- ### 3. 看图无限返修的工作台
- 在工作台里你可以随时:
- - 给某一页划框提意见(“字太挤 / 换个对比卡片布局 / 重写这页论据”);
- - 整套切换模板,或针对单页请求改换版式骨架;
- - 点击确认导出固定快照的版本,保证“网页里点选的最终版本”就是导出的 `.pptx`。
- *(如果改了某页的核心事实或数据结论,Skill 会按需请 [`planners-fact-check`](https://github.com/thePlannerIvan/planners-fact-check) 复查那一页;仅调整排版时直接快速重渲染。)*
- ---
- ## 什么时候选我 vs 选别的 Skill
- | 你现在手里有什么 | 用哪个 Skill | 原因 |
- | --- | --- | --- |
- | 文档零散、还没定好每页该写什么故事和数字依据 | 先用 [`planners-bypage`](https://github.com/thePlannerIvan/planners-bypage) | 先写出经得起审计的逐页文案与配图,再来做版面 |
- | 内容或结构已有思路,现在要做 SVG 页面、套/提模板、导出可编辑 `.pptx` | **本 Skill (`planners-ppt-hell`)** | 负责视觉呈现、审阅返修、PPTX 导出与视频静态画面 |
- | 静态画面做完了(或手头是实拍视频片段),要剪口播、加动效、出词级字幕、合成最终视频 | 交给 [`video-craft`](https://github.com/thePlannerIvan/video-craft) | 我不制作视频时间轴动画或音频剪辑 |
- ---
- ## 快速开始与安装
- ### 1. DSH 用户(推荐)
- 通过 [Planners Form](https://github.com/thePlannerIvan/planners-form) 在 DSH 设置里勾选 `planners-ppt-hell` 一键安装。
- ### 2. Codex / Claude Code 用户
- ```bash
- npx skills add https://github.com/thePlannerIvan/planners-ppt-hell --skill planners-ppt-hell
- ```
- 或克隆到本地 Skill 目录:
- ```bash
- git clone https://github.com/thePlannerIvan/planners-ppt-hell.git ~/.codex/skills/planners-ppt-hell
- # 或
- git clone https://github.com/thePlannerIvan/planners-ppt-hell.git ~/.claude/skills/planners-ppt-hell
- ```
- ### 3. 安装 Python 渲染依赖
- ```bash
- pip install -r scripts/requirements.txt # python-pptx / lxml / Pillow / playwright
- playwright install chromium # 用于把 SVG 渲染成真实 PNG 预览与目检
- ```
- ### 4. 直接这样调用
- **做 PPT:**
- ```text
- 使用 $planners-ppt-hell 读取这个逐页内容包(或这批项目资料),先用 consulting-product-strategy 模板做出前两页让我看效果。
- ```
- **扒旧 PPT 模板:**
- ```text
- 使用 $planners-ppt-hell 从这份客户参考.pptx 里提取一套可复用模板包,打开网页让我勾选需要的版式。
- ```
- **做视频静态关键帧:**
- ```text
- 使用 $planners-ppt-hell 根据上游的 visual-plan.json 和 assets 生成视频录制前的静态 SVG 画面。
- ```
- ### 真实运行时依赖
- - **核心环境**:Python 3(见 `scripts/requirements.txt` + Playwright Chromium)与 Node.js 20+(审阅宿主)。
- - **代码级自动加载底座**(缺了会自动拉取至 `~/.planners-modules/`):[`planners-review-core`](https://github.com/thePlannerIvan/planners-review-core)(看图审阅台)、按需校验使用的 [`planners-source-index`](https://github.com/thePlannerIvan/planners-source-index) 与 [`planners-fact-check`](https://github.com/thePlannerIvan/planners-fact-check)。(**不依赖 `planners-report-kit`**。)
- - **按需协同的同行 Skill**(环境中存在时自动参考):[`slide-copy`](https://github.com/thePlannerIvan/slide-copy)(微调页面文案)、[`planners-method-wiki`](https://github.com/thePlannerIvan/planners-method-wiki)(补充论证关系)。
- - **视频风格库优雅降级**:若本机配置了私有风格库 `~/.config/planners/video-vault` 会自动挂载;开源无该目录时会自动降级为内置通用洁净风格 `default-clean`。
- ---
- <details>
- <summary>开发者说明:环境变量、输出目录规范、模板校验闸门与单测(普通用户可忽略)</summary>
- ### 公共模组解析与离线开关
- 适配器(`scripts/lib/planners_modules.py`)按顺序查找本地公共模组:
- `$PLANNERS_MODULES_HOME` → `<skills-root>` → `02-skills-library/<分类>` → 用户级目录(`$PLANNERS_MODULES_INSTALL_DIR` → `$PLANNERS_MODULES_HOME` → `~/.planners-modules/`)。设 `PLANNERS_NO_AUTO_INSTALL=1` 可在 CI/离线环境禁用自动克隆。
- ### 导出目录与版本存储
- - 工作台采用 `store checkout → 编辑 candidate → save` 与版本冲突保护;`_internal/02_svg_source` 仅为可重建兼容视图。
- - 固定版本导出产物位于 `_internal/06_ppt_output/<snapshot_id>/`,根目录 `final_deck.pptx` 为最近成功输出的兼容副本;PPT 导出支持 `--previews` 与 `export-inspect` 实图核验。
- ### 验证与模板库完整性闸门
- **在 Skill 根目录运行**(修改过 `assets/template_library/` 后发布前必跑 `verify`):
- ```bash
- python3 scripts/template/template_library.py verify
- python3 -m unittest discover -s scripts/test -p 'test_*.py'
- ```
- ### 目录结构
- ```text
- planners-ppt-hell/
- ├── SKILL.md
- ├── agents/openai.yaml
- ├── assets/ # 4 套内置模板包(template_library/)与审阅页
- ├── docs/ # 架构与历史文档
- ├── evals/
- ├── examples/minimal_deck/
- ├── references/ # 契约、领域排版规则与 00-08 工作流文档
- └── scripts/ # 画布几何、SVG→PPTX 转换、模板提取与工作台服务
- ```
- </details>
- ---
- ## 品牌边界、开源协议与商业合作
- - **许可协议**:以 [AGPL-3.0-only](LICENSE) 发布,可商业使用,修改版或通过网络提供的服务须公开源码。
- - **署名边界**:源码与审阅工作台保留作者标识;默认**不得**把 Planner's PPT Hell、作者或站点信息写入客户最终 `.pptx`、导出 SVG 或 PNG。修改或衍生规范见 [TRADEMARK.md](TRADEMARK.md),归属声明见 [NOTICE](NOTICE)。
- - **商业支持**:企业定制品牌模板包、私有部署、工作流定制或闭源授权,请联系 `Lawyif@163.com` 或访问 [demyth.info](https://demyth.info),详见 [COMMERCIAL.md](COMMERCIAL.md)。
- ## 相关项目
- - [Planners Bypage](https://github.com/thePlannerIvan/planners-bypage) —— 上游多源资料整理、逐页文案与配图包
- - [Video Idea System](https://github.com/thePlannerIvan/video-idea-system) —— 短视频选题、口播稿与 `visual-plan.json` 入口
- - [Video Craft](https://github.com/thePlannerIvan/video-craft) —— 接收静态画面或素材剪辑合成最终成片
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.