Humanize→Guizang 演讲PPT流水线

概述

Humanize → Guizang 演讲 PPT 流水线

把两个已装技能串成一条"输入材料 → 能讲的 PPT"流水线。

• humanize-ppt：不做渲染。它把原始材料 → AST 观众状态转移大纲 → 逐页视觉增强决策 → 生产简报（commands/guizang-agent.md + 一整套 AST 文件）。它也不是 Web 应用，是本地 Python CLI（仅标准库，零第三方依赖）。
• guizang-ppt-skill：下游渲染器。读 humanize 的生产简报，按 guizang 模板产出 单文件 HTML 网页 PPT 或 可编辑 .pptx。

边界铁律：humanize 自己绝不渲染页面，只到"生产简报"为止。真出 PPT 这一步由本流水线调用 guizang 完成。详见 references/workflow.md。

三段式流程

[材料] → ① Brief（humanize） → ② Render（guizang） → ③ Checkup（humanize --qa-from）
            AST 大纲 + 简报           HTML 单文件 / .pptx        演讲体检（揪出只能看不能讲的页）

阶段 0 · 前置确认（动手前必做）

确认两个技能已安装：

ls ~/.workbuddy/skills/humanize-ppt/SKILL.md            # 必须存在
ls ~/.workbuddy/skills/guizang-ppt-skill__skillhub/SKILL.md   # 必须存在（__skillhub 变体）

若缺 guizang，本流水线无法产出真实 PPT——只能停在简报阶段，需提示用户先安装 guizang-ppt-skill。

.pptx 导出前置（仅当阶段 2 要出 PPTX 时）：

# 用 WorkBuddy 管理的 python3.13 装 python-pptx（隔离环境，勿污染系统）
PY="$HOME/.workbuddy/binaries/python/versions/3.13.12/python.exe"
"$PY" -m venv "$HOME/.workbuddy/binaries/python/envs/default"   # 已存在可跳过
"$PY" "$HOME/.workbuddy/binaries/python/envs/default/bin/pip" install python-pptx

阶段 1 · Brief（humanize-ppt 出大纲 + 简报）

用管理版 Python 跑（路径用正斜杠或 Windows 绝对路径，不要在 Git Bash 里用反斜杠）：

PY="$HOME/.workbuddy/binaries/python/versions/3.13.12/python.exe"
HUMANIZE="$HOME/.workbuddy/skills/humanize-ppt"
cd "$HUMANIZE"
"$PY" scripts/humanize_ppt.py 
  --source "D:/path/to/material.md" 
  --out "D:/path/to/out" 
  --renderer guizang 
  --title "你的 deck 标题" 
  --no-render

关键参数：

• --renderer guizang：锁定中文 HTML 路线，产出 commands/guizang-agent.md 作为渲染入口。
• --no-render：humanize 本身不渲染，必须加（否则它会尝试调下游但本环境不自动跑）。
• --out：输出目录会被 humanize 清空重建，只在该目录为空/不存在/已是 Humanize 产物时。

跑完校验产物（缺一不可）：

• ast_outline.md — 观众状态转移大纲（每页推进观众的哪一步）
• slide_plan.json — 逐页计划（标题/信息/可见内容/媒体决策/layout_hint）
• commands/guizang-agent.md — 渲染权威契约，写明读取哪些 AST 文件、写到 outputs/guizang-rendered、用哪个 guizang 风格/主题

阶段 2 · Render（guizang-ppt-skill 出 HTML/PPTX）

读取 commands/guizang-agent.md 作为入口，再按 guizang 的 SKILL.md 执行：

1. 风格选择（问用户，或按内容推荐）：
   • 风格 A 电子杂志风（默认，人文/行业/商业发布）→ assets/template.html
   • 风格 B 瑞士国际主义风（科技/数据/工程）→ assets/template-swiss.html
2. 拷模板到目标目录 ppt/index.html，同级建 images/。
3. 选主题色（风格 A 5 套 / 风格 B 4 套，只能选预设，不允许自定义 hex）。
4. 严格按 guizang 的 layouts.md / layouts-swiss.md 填内容——不要从零写 slide，类名以模板 <style> 为唯一来源（缺类整页崩）。
5. 把 humanize 的 slide_plan.json 每页 visible_content + speaker_intent 落到对应 guizang 布局骨架。

输出 HTML（无需服务器，浏览器直接打开）：

ppt/index.html   ← 单文件横向翻页 deck

若要可编辑 .pptx（PowerPoint/WPS 二次编辑）：

GZ="$HOME/.workbuddy/skills/guizang-ppt-skill__skillhub"
# 方案 A：Python 脚本（无需浏览器，★☆☆ 精度，按类名推断）
"$PY" "$GZ/scripts/html_to_pptx.py" "ppt/index.html" "ppt/output.pptx" A 墨水经典
# 风格 B 用：B IKB蓝

浏览器高精度方案（Playwright + pptxgenjs，★★★★★）见 guizang references/pptx-guide.md，需 npm install + npx playwright install chromium，本环境按需启用。

阶段 3 · Checkup（humanize 演讲体检，可选但推荐）

渲染完把真实产物回灌 humanize 跑"演讲体检"，揪出"只能看不能讲"的页：

"$PY" scripts/humanize_ppt.py --qa-from "D:/path/to/out/outputs/guizang-rendered/index.html" 
  --out "D:/path/to/out" --renderer guizang

每轮产出 qa_report.md + fix_prompt.md，最多 3 轮；仍有失败会标记 needs-human。把 fix_prompt.md 交给 guizang 重渲对应页即可。

触发语

• "用 humanize 做一份中文演讲 PPT"
• "humanize→guizang 跑一下这份材料"
• "先出 AST 大纲，再渲染成 HTML/PPTX"
• "给这份 deck 做演讲体检"

关键坑点（已实测）

1. humanize 不渲染：必须本流水线补 guizang 渲染这一段，否则只拿到简报。
2. 路径分隔符：在 Git Bash 下 --source/--out 用正斜杠或 Windows 绝对路径（D:/x/...），反斜杠 会被当成转义导致 "Source not found"。
3. Python 解释器：必须用管理版 3.13.12/python.exe，且 humanize 脚本零三方依赖（仅标准库），无需 venv/pip。但 guizang 的 .pptx 导出要 python-pptx，如上装。
4. git 直连 github.com 在沙箱被拦：若要从源仓库更新 humanize/guizang，需用户本地下载解压后同步到 ~/.workbuddy/skills/，不要依赖 git clone。
5. guizang 风格 A/B 互斥：一份 deck 只选一套模板 + 一套主题色，不能混用类名。

依赖技能路径（本机实测）