[codex] Add guizang presenter deploy path

README.md

@@ -122,19 +122,27 @@ out/
 
 Humanize PPT 当前重点是稳定“资料 → AST生产契约 → 风格预览/完整deck → presenter/export → QA”的工作流。更多renderer自动化、视频生成、部署平台集成和团队包上传会放到后续版本，不塞进这次目录整理。
 
+V0.6.1 补充了 guizang downstream 工作流经验：Humanize PPT 先产出 AST 契约，guizang 负责中文稳定渲染，素材生产和视觉 QA 作为独立 pass 记录。文字精确的信息图优先用 SVG/HTML 等确定性素材；Remotion 用作短流程视频素材，不替代 PPT 页面本体。
+
+V0.6.2 固定中文 PPT 的下一段默认路径：`Humanize PPT → guizang → material QA → presenter → static deploy`。当内容是中文且没有显式要求多风格探索时，优先把 guizang 当作稳定成稿路径；成稿后再补演讲模式和部署包，而不是把 presenter 当成另一种视觉风格。
+
 ## 在线预览
 
 - 首页：https://learnprompt.github.io/humanize-ppt/
 - Skill分享PPT展示页：https://learnprompt.github.io/humanize-ppt/showcase/skill-share/
+- Hermes Agent Mastery 演讲模式：https://learnprompt.github.io/humanize-ppt/showcase/hermes-agent-mastery/presenter/
+- Hermes Agent Mastery PPT：https://learnprompt.github.io/humanize-ppt/showcase/hermes-agent-mastery/ppt/
 
-风格探索、演讲者模式和其他生成模式还在调试中，公开入口先隐藏。稳定后再恢复在线Demo入口。
+风格探索和其他生成模式还在调试中，公开入口先隐藏。中文 guizang → presenter 路径先作为稳定样例开放。
 
 ## 参考文档
 
 - [AST理论](docs/AST-theory.md)
 - [OPC工作流](docs/OPC-workflow.md)
 - [Agent Teams](docs/agent-teams.md)
 - [Smoke Test](docs/smoke-test.md)
+- [Guizang material QA](references/guizang-material-qa.md)
+- [Guizang presenter deploy](references/guizang-presenter-deploy.md)
 - [版本历史](docs/versions/)
 - [发版前审查清单](docs/plans/2026-05-25-release-readiness-checklist.md)
 

SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: humanize-ppt
 description: AST-based outline director and router for human-centered AI presentation workflows. Use before generating PPT/HTML slides from raw material, or as the single entrypoint that routes to downstream PPT Skills.
-version: 0.6.0
+version: 0.6.2
 author: LearnPrompt
 license: MIT
 metadata:
@@ -101,19 +101,26 @@ C — Complete / Control
 10. When `beautiful-html-templates` is the preview-first route, do not stop at a planned command file. A connected path must produce real `outputs/beautiful/previews/index.html`, three candidate title-slide previews, `preview_manifest.json`, a render report, and a QA-visible route status. Treat this as V0.3+ capability, because it changes the user-facing workflow from routing advice to visible style selection.
 11. When the user chooses a Beautiful candidate, run V0.4+ `--selected-template <slug>` and produce a real full deck at `outputs/beautiful/selected/index.html` plus `selected_manifest.json`. Do not call this complete if only the preview gallery exists.
 12. In V0.5, presenter/export are post-processing adapters. They require a rendered final deck (`outputs/<renderer>/index.html` or `outputs/beautiful/selected/index.html`), not just a preview gallery.
+13. When routing to `guizang-ppt-skill`, treat guizang as the stable Chinese production renderer, then run a separate visual/material QA pass before presenter or deploy. Check that template class names actually exist in the copied template CSS; do not trust layout docs blindly. If an SVG, GPT image, screenshot, or Remotion clip is inserted, it must support the page instead of repeating the page title, and all internal text must fit within its own safe area.
+14. For Swiss-style guizang decks, use Remotion as a material producer for short process clips and deterministic SVG/HTML diagrams for text-heavy Chinese information graphics. Prefer GPT image generation for non-textual photos, mood images, or visual concepts; use deterministic SVG/HTML when exact Chinese labels, grid alignment, or validation-friendly text is required.
+15. For Chinese PPT production, the default stable path is `Humanize PPT → guizang → material QA → presenter → static deploy` unless the user explicitly requests preview-first style exploration, PPTX conversion, or another renderer. Presenter mode is a completion path after the guizang deck is finalized.
 
 ## Operational references
 
 - `references/agent-teams-public-preview.md` — Agent Teams architecture, specialist-agent command protocol, public preview release loop, and README split convention.
 - `references/humanize-ppt-public-writing.md` — Public-facing positioning and article/script patterns: Humanize PPT as adaptable outline/director layer, not a fixed 4-Skill bundle.
 - `references/workbuddy-team-packaging-and-video-materials.md` — WorkBuddy/CodeBuddy team upload zip structure, validation script, scenario rules shape, and the Remotion/HyperFrames-as-material-producers pitfall.
+- `references/guizang-material-qa.md` — Guizang downstream workflow, material production rules, Swiss visual QA checklist, and failure patterns learned from a full Humanize PPT → guizang deck pass.
+- `references/guizang-presenter-deploy.md` — Default Chinese PPT production path: guizang stable deck, material QA, presenter shell, and static deploy checks.
 - `references/beautiful-preview-first-adapter.md` — Durable adapter pattern for connecting `beautiful-html-templates`: version boundary, template selection, real title-slide previews, manifests, QA, and pitfalls.
 - `references/selected-template-full-deck-adapter.md` — Durable adapter pattern for V0.4 selected-template full deck generation: required artifacts, routing, QA, and TDD coverage.
 - `references/presenter-export-adapter.md` — Durable adapter pattern for adding V0.5-style presenter shell and export package after a final deck exists.
 - `docs/versions/v0.2-router-edition.md` — V0.2 Router Edition notes kept for history.
 - `docs/versions/v0.3-preview-first.md` — V0.3 Preview-First implementation notes: real `beautiful-html-templates` preview gallery, template selection, manifests, and version boundary.
 - `docs/versions/v0.4-selected-template-full-deck.md` — V0.4 Selected Template Full Deck notes: `--selected-template`, selected deck output, manifests, QA, and current boundaries.
 - `docs/versions/v0.5-presenter-export-adapter.md` — V0.5 Presenter / Export Adapter notes: `--presenter-adapter`, `--export-adapter`, output artifacts, and boundaries.
+- `docs/versions/v0.6.1-guizang-material-qa.md` — V0.6.1 Guizang material QA notes: downstream artifact recording, Remotion-as-material, SVG-safe Chinese diagrams, and visual review rules.
+- `docs/versions/v0.6.2-guizang-presenter-deploy.md` — V0.6.2 Guizang presenter deploy notes: Chinese default path, `postMessage` presenter shell, and public static showcase.
 - `docs/smoke-test.md` — No-dependency smoke check for validating the stable entrypoint on machines without pytest.
 - `docs/plans/2026-05-25-release-readiness-checklist.md` — V0.6 release-readiness checklist and release-note draft.
 

docs/index.html

@@ -127,12 +127,13 @@
       <div>
         <p class="eyebrow">Humanize PPT · Preview</p>
         <h1>把 AI 从聊天框带进真实工作流</h1>
-        <p class="lead">Humanize PPT 是基于 AST 理论的 PPT 大纲导演 Skill。当前公开页先展示已调好的 Skill 分享 PPT；风格探索、演讲者模式和导出适配器继续稳定后再开放公开入口。</p>
+        <p class="lead">Humanize PPT 是基于 AST 理论的 PPT 大纲导演 Skill。当前公开页展示已调好的 Skill 分享 PPT，以及中文 guizang → presenter 的稳定样例。</p>
       </div>
       <div class="panel">
-        <h2>Skill 分享 PPT</h2>
-        <p>HTML PPT 发布版，适合现在作为线上展示页面使用。</p>
-        <a class="button" href="showcase/skill-share/">打开展示</a>
+        <h2>Hermes Agent Mastery</h2>
+        <p>中文 guizang 成稿 + 演讲模式，作为 V0.6.2 的稳定路径样例。</p>
+        <a class="button" href="showcase/hermes-agent-mastery/presenter/">打开演讲模式</a>
+        <a class="button secondary" href="showcase/skill-share/">Skill 分享 PPT</a>
         <a class="button secondary" href="https://github.com/LearnPrompt/humanize-ppt/blob/main/docs/agent-teams.md">Agent Teams</a>
       </div>
     </header>
@@ -142,8 +143,8 @@ <h2>Roadmap</h2>
       <ul>
         <li>稳定 Humanize PPT 的最小输出链路。</li>
         <li>调试风格探索页面，确认多风格结果的阅读与展示质量。</li>
-        <li>调试演讲者模式，补齐讲稿、翻页和演示控制体验。</li>
-        <li>补齐可移植 HTML 包和 PDF 导出脚本后，再恢复在线 Demo 入口。</li>
+        <li>中文 PPT 默认走 guizang 稳定成稿，再进入素材 QA、演讲模式和静态部署。</li>
+        <li>补齐可移植 HTML 包和 PDF 导出脚本后，再扩大在线 Demo 入口。</li>
       </ul>
     </section>
 

docs/index.md

@@ -3,4 +3,6 @@
 Public preview docs. The current public preview shows the tuned Skill sharing deck first.
 
 - Showcase: `showcase/skill-share/`
-- Roadmap: style exploration, presenter mode, and other demo modes are hidden until the workflows are stable.
+- Hermes Agent Mastery presenter: `showcase/hermes-agent-mastery/presenter/`
+- Hermes Agent Mastery PPT: `showcase/hermes-agent-mastery/ppt/`
+- Roadmap: style exploration and other demo modes are hidden until the workflows are stable.

docs/showcase/hermes-agent-mastery/README.md

@@ -0,0 +1,21 @@
+# Agent 从入门到精通 Hermes 版
+
+这是一次 Humanize PPT → guizang-ppt-skill → material QA → presenter mode 的中文稳定生产样例。
+
+## 在线路径
+
+合并到 `main` 并由 GitHub Pages 发布后：
+
+- PPT：`https://learnprompt.github.io/humanize-ppt/showcase/hermes-agent-mastery/ppt/`
+- 演讲模式：`https://learnprompt.github.io/humanize-ppt/showcase/hermes-agent-mastery/presenter/`
+
+## 本地路径
+
+- `ppt/index.html`：完整 guizang Swiss HTML PPT。
+- `presenter/index.html`：讲者控制台。
+- `presenter/notes.json`：逐页讲者备注。
+- `presenter/presenter_manifest.json`：演讲模式产物记录。
+
+## 说明
+
+这个样例固定中文 PPT 的推荐后处理路径：先用 guizang 做稳定中文成稿，再做素材/视觉 QA，最后补 presenter/deploy。

docs/showcase/hermes-agent-mastery/index.html

@@ -0,0 +1,20 @@
+<!doctype html>
+<html lang="zh-CN">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width,initial-scale=1">
+  <title>Agent 从入门到精通 Hermes 版</title>
+  <meta http-equiv="refresh" content="0; url=presenter/">
+  <style>
+    body{margin:0;min-height:100vh;display:grid;place-items:center;background:#f6f8fa;color:#0f2537;font-family:-apple-system,BlinkMacSystemFont,"PingFang SC",sans-serif}
+    main{max-width:680px;padding:32px}
+    a{color:#0647c9;font-weight:700}
+  </style>
+</head>
+<body>
+  <main>
+    <h1>Agent 从入门到精通 Hermes 版</h1>
+    <p>正在打开演讲模式。也可以直接进入 <a href="presenter/">Presenter</a> 或 <a href="ppt/">PPT</a>。</p>
+  </main>
+</body>
+</html>

docs/showcase/hermes-agent-mastery/ppt/README.md

@@ -0,0 +1,7 @@
+# Agent 从入门到精通：Hermes 版
+
+Guizang PPT Skill Swiss Style output.
+
+- Open: ./index.html
+- Style: Swiss Internationalism / IKB
+- Slides: 8