Humanize PPT v1.1.1 · --out 安全加固 + PPTX fail-closed

安全加固版本，源于 Open Design 社区插件 PR（nexu-io/open-design#5655）的 review 意见，双侧同步为 v1.1.1。

修复 / Fixes

• --out 数据保护：brief 模式不再无条件清空已存在的 --out 目录。只有目录缺失、为空、是上一次 Humanize PPT 运行（根下有 run_manifest.json / style_gallery_plan.json）或显式传 --force 时才会清空重建，否则报错退出、内容原样保留。Brief mode no longer wipes a non-empty --out unless it is a previous Humanize run or --force is passed.
• PPTX 输入 fail closed：.ppt/.pptx 不再被静默转成占位文本产出空壳大纲；现在明确报错并指引先提取文本（渲染产物请走 --qa-from 演讲体检）。read_source fails closed on .ppt/.pptx with extraction guidance.
• smoke_check 兜底：examples/ 缺失时自动改用内联 fixture，不再 file-not-found。
• 顺带修复：--source 文件不存在时不再输出裸 traceback。

验证：122/122 pytest；脏目录拒绝/--force 覆盖/假 PPTX 拒绝/重跑自有运行目录四条手测全过。

升级建议：所有通过 npx skills add 或 Claude plugin marketplace 安装的用户建议更新——v1.1.0 及更早版本存在把非空 --out 整目录删除的风险。

Humanize PPT v1.1.0 · PPT Master 原生渲染

v1.1.0 — PPT Master 原生渲染 + PPTX QA

• PPT Master 原生渲染器（scripts/humanize_ppt_v2.py，+1039 行）：原生 PPTX 路由、raw-template 填充
• PPTX 质量检查工具（scripts/pptx_qa.py）：OOXML 层体检
• 渲染器注册表扩展（registry/renderer_registry.json）
• 新增 5 组测试，全量 122 tests passed
• 详细说明：docs/versions/v1.1.0-ppt-master.md

🤖 Generated with Claude Code

v1.0.0 — Full English Support + Humanize-Side Presenter Shell

v1.0.0 — Full English Support + Humanize-Side Presenter Shell

Date: 2026-06-20 · Branch: feat/v0.9-next → tag v1.0.0

What changed

English renderers reach full

frontend-slides and beautiful-html-templates are now support_level: full in registry/renderer_registry.json. The remaining gap from v0.9 was 0 renderer-specific failure-mode rules. Five static rules are now added for both English renderers:

Rule	What it catches
english-horizontal-overflow	overflow-x:auto/scroll/visible or viewport widths above 100vw
english-low-contrast	Explicit hex color pairs with contrast ratio below 3.0:1
english-hyphenation-noise	hyphens:auto, word-break:break-all, overflow-wrap:anywhere
english-font-contract-missing	No web font or @font-face source — deck falls back to generic system font
english-image-alt-missing	<img> elements without an alt attribute

Full mode means: brief exit works + checkup verified on real rendered output + image generation wired in + renderer-specific failure modes recorded. Screenshot review is retained for occlusion, clipping, and visual alignment failures that static HTML cannot detect.

Humanize-side presenter shell

write_presenter_shell() now produces outputs/presenter/presenter-shell.html from slide_plan.json + speaker_intent.md without requiring the downstream deck to exist. Features: current/next slide labels, speaker notes panel, slide counter, keyboard navigation (← →), S toggle, and timer. When the downstream deck is ready, downstream native consoles (guizang, Neo-Grid) can take over the full stage view; the shell stays as a functional baseline.

--presenter-adapter no longer returns missing-deck when no deck is supplied — it falls back to standalone shell mode.

Version bumps

• scripts/humanize_ppt_v2.py VERSION → 1.0.0
• SKILL.md frontmatter version → 1.0.0
• SPEC.md header → Version: 1.0

Tests

109 passing (up from 103 at v0.9.0 baseline). New coverage:

• test_write_presenter_adapter_creates_presenter_shell_with_notes
• test_write_presenter_adapter_renders_standalone_shell_without_deck
• test_module_entrypoint_can_render_presenter_shell_without_deck
• test_qa_loop_runs_english_specific_failure_modes
• test_english_specific_modes_are_registered_for_both_english_renderers
• test_english_showcase_deck_passes_presentation_checkup

Showcase added

docs/showcase/codex-starter-frontend-en/ — an English-path true-rendered deck (Codex Starter Guide · Frontend Slides Vol.01), dark editorial style, Fraunces serif + Spline Sans Mono.

What did not change

• All v0.6.4 invariants hold: brief-only output, no post-processing of downstream HTML, 3-round checkup cap.
• Screenshot review is still required for the failure classes static scan can't reach (occlusion, clipping, weight downgrade, visual misalignment).
• Downstream template ownership is unchanged: guizang / frontend-slides / beautiful-html-templates own native rendering. Humanize owns the talk structure, per-page media decisions, checkup, and now the presenter baseline.

Upgrade from v0.9.0

No breaking changes. If you were treating the English path as second-tier, it no longer is — all three production renderers are full.

v0.9.0 — 为演讲而生的 PPT 系统

Humanize PPT v0.9.0 — a presentation system, born for the talk.

亮点 / Highlights

• 风格画廊 Style gallery：出大纲前下游真渲 ≥4 张封面供挑（零依赖 style_gallery.html 选择器）。
• 视觉增强 Visual enhancement（真产出）：baoyu-image-gen 走本地 Codex CLI 真出配图（无需 API key）+ Remotion 真渲说明视频 + 确定性 SVG 图表。
• 演讲体检 Presentation checkup：渲染后逐页核对大纲、自动揪「只能看不能讲」的页、写 fix prompt（3 轮封顶）。
• 演讲模式 Presenter mode：按 S 切到 presenter console（下游原生，Humanize 出 speaker_intent 源）。
• 英文路径与中文同档：frontend-slides + beautiful-html-templates 均 brief+qa-verified（真实渲染产物过完演讲体检）。
• 定位重写「为演讲而生」+ 新增 SPEC.md + 失败模式英文版 + README 中英重排 + 首装推荐全套下游 skill。

安装 / Install: `npx skills add LearnPrompt/humanize-ppt -g` 或把仓库链接发给 Agent。

v0.6.5 — 简报编排器架构定稿 + House 打包

架构(v0.6.4 起)

• Humanize 定型为简报编排器:O/P/Q/C 四段工作流,自己不渲染任何 HTML
• 主交付物 <renderer>-production-prompt.md,下游 skill(guizang / frontend-slides / beautiful-html-templates)100% 原生渲染
• --qa-from QA 循环:扫失败模式 → 写 fix_prompt.md → 最多 3 轮,不收敛标 needs-human

v0.6.5

• requires-skills 下游依赖声明;brief writer 未检测到下游 skill 时输出 stderr 警告

本次打包(House 对齐)

• 修复 README 弯引号 bug(首行 div 排版失效、CLI 示例复制即挂)
• Hero 区重排:引语钩子 + 徽章(skills.sh 安装计数/Release/MIT)+ 锚点导航
• 效果展示产物前置:嵌入已知合格品三页 preview 截图
• 新增:触发方式 / 它和同类有什么不同(模板库是上下游不是竞品)/ 安全边界
• plugin marketplace 双通道(.claude-plugin/marketplace.json)
• 安装行规范化:npx skills add LearnPrompt/humanize-ppt -g

完整版本说明:docs/versions/

Humanize PPT v0.6.3

Summary

Humanize PPT now has two stable showcase paths:

• Chinese path: Humanize PPT -> guizang -> material QA -> presenter -> static deploy
• English path: Humanize PPT -> theme brief -> 5-style gallery -> selected style full deck -> presenter/deploy

Highlights

• Fixed the English PPT workflow gate: English decks now generate at least five visible style candidates before producing a final selected-style deck.
• Added the English Neo-Grid Bold Hermes Agent Mastery showcase.
• Published English deck and presenter mode under GitHub Pages:
  • https://learnprompt.github.io/humanize-ppt/showcase/hermes-agent-mastery/en/ppt/
  • https://learnprompt.github.io/humanize-ppt/showcase/hermes-agent-mastery/en/presenter/
• Preserved the Chinese guizang showcase as the stable Chinese production path.
• Added material production evidence for the English case, including GPT Image 2 still material and a Remotion MP4 slot.
• Updated docs, registry metadata, and tests for the V0.6.3 English style-gallery rule.

Validation

• python3 -m py_compile scripts/humanize_ppt.py scripts/humanize_ppt_v1.py scripts/humanize_ppt_v2.py scripts/humanize_ppt_v3.py scripts/humanize_ppt_v4.py scripts/humanize_ppt_v5.py
• python3 scripts/smoke_check.py
• GitHub Pages deployment succeeded.
• Online checks confirmed the English showcase index, deck, presenter, GPT Image 2 image reference, and Remotion MP4 asset.

Note

pytest was not run in the local release pass because the available Python environments do not include the pytest module.

v0.6.0

Humanize PPT v0.6.0

This release turns Humanize PPT from a versioned-runner demo surface into a cleaner single-entry workflow.

Added

• Added scripts/humanize_ppt.py as the stable recommended entrypoint.
• Added scripts/smoke_check.py for no-dependency core contract validation.
• Added docs/smoke-test.md with reproducible smoke-check instructions.
• Added release-readiness checklist for the v0.6 line.
• Added version metadata consistency test.

Changed

• Bumped Skill/script/renderer registry metadata to 0.6.0.
• Simplified README.md and README.en.md around the current recommended workflow.
• Moved historical V0.x notes into docs/versions/.
• Updated SKILL.md references to the new historical docs location.

Kept compatible

• Kept scripts/humanize_ppt_v1.py through scripts/humanize_ppt_v5.py as compatibility entrypoints.
• Kept existing examples, contracts, registry, demos, and GitHub Pages paths.

Deferred

• No module split of scripts/humanize_ppt_v2.py in this release.
• No new renderer integration.
• No video-generation pipeline.
• No deployment-platform automation.
• No WorkBuddy/CodeBuddy team package publishing automation.

Verification

• python3 scripts/smoke_check.py
• pytest -q
• python3 -m py_compile scripts/humanize_ppt.py scripts/humanize_ppt_v1.py scripts/humanize_ppt_v2.py scripts/humanize_ppt_v3.py scripts/humanize_ppt_v4.py scripts/humanize_ppt_v5.py scripts/smoke_check.py

v0.1.0 Public Preview

Humanize PPT v0.1.0 Public Preview

Initial public preview of Humanize PPT, an AST-based outline director for human-centered AI presentation workflows.

Includes

• AST theory: Audience-State-Transfer
• OPC workflow: Outline / Produce / Complete
• Local deterministic demo runner
• Style exploration HTML deck outputs
• Shell-style Presenter Adapter
• Static deploy package and GitHub Pages demo
• Output contracts for deck brief, AST outline, slide plan, speaker intent, assets, and video slots

Demo

• Site: https://learnprompt.github.io/humanize-ppt/
• Style exploration: https://learnprompt.github.io/humanize-ppt/demo/styles/index.html
• Presenter mode: https://learnprompt.github.io/humanize-ppt/demo/presenter/index.html