uv add "io-openagent-sdk[pptx]"还需要系统级依赖：Python ≥3.11、Node.js ≥18、npm、markitdown（Python 包）。首次运行时，CLI 会检测并引导你安装缺项。
pptx-agent new [--topic "..."] [--slug ...]— 开始新 deckpptx-agent resume <slug>— 恢复一个被中断的 deckpptx-agent memory list [--section ...]— 列出已保存的用户偏好pptx-agent memory forget <entry_id>— 删除某条偏好pptx-agent memory --section ...— 旧写法，等同memory list --section ...
- Intent Analysis — LLM 把你的自然语言描述转成结构化
IntentReport；CLI 展示所有字段，允许你在confirm / edit field / regenerate / abort间选择。选edit field后可修改topic / audience / purpose / tone / slide_count_hint / language / required_sections / visuals_hint / research_queries，列表字段支持add / remove / reorder / edit-item。确认后可选 "save as preference" 把偏好写入user_goals。 - Environment Check — 检查 Python / Node / npm / markitdown / API keys，缺项交互修复（密钥用 password 输入，写入用户级
.env）。 - Research — 用 Tavily MCP（或 REST fallback）联网搜索；结果按 source 展示，可多选保留。确认后可选 "save as preference" 写入
references。 - Outline — 生成 slide-by-slide 大纲，菜单：
accept / add slide / remove slide / reorder slides / edit slide / regenerate all / abort。编辑后索引会自动压实。regenerate all前会确认丢弃本地改动。 - Theme — agent 产出 3–5 个候选主题，Rich
Columns并列展示（5 色色块 + 字体对 + style + badge）。菜单pick 1..N / regenerate / custom editor / abort；custom editor会逐字段引导 hex + 字体 + style + badge，hex 输入会自动去掉前缀#。选定后可选 "save as preference" 写入decisions。 - Slide Generation — 每张 slide 独立的 agent run，按
concurrency=3并行生成。返回的SlideIR会按 slide 类型的 slot schema 严格校验；失败后最多重试 2 次，仍失败则 fallback 成freeform+ 基础脚本。Live 表格实时展示每张 slide 的状态（queued / running / retry-N / ok / fallback / failed）。完成后给出N ok / M fallback / K failed汇总，允许对任一失败索引手动rerun。 - Compile + QA — 写入 JS 模板 →
npm install（node_modules已存在则跳过）→node compile.js→markitdown回读校验。
每次 wizard 运行，都会在终端顶部显示一个 4 区域的 Rich Layout：
┌ pptx-agent · <slug> · stage n/7 · mm:ss ────────────────┐
│ ✓ 1 意图 │ │
│ ▶ 2 环境 │ (当前阶段内容面板) │
│ ○ 3 研究 │ │
│ ○ 4 大纲 │ │
│ ○ 5 主题 │ │
│ ○ 6 切片 │ │
│ ○ 7 编译QA │ │
├────────────────┴────────────────────────────────────────┤
│ Log (tail, 最近 5 行) │
└──────────────────────────────────────────────────────────┘
- 侧边栏 7 步用
✓ / ▶ / ○实时反映project.stage。 - 底部 Log tail 绑定
examples.pptx_generatorlogger（通过RingLogHandler），只保留最近 5 行。 - 不使用
rich.Live：每次阶段切换或子步骤推进时手动重绘一次，确保在 Windows 上与questionary交互不会串线。如果需要 ticker 式秒表更新，是设计中明确舍弃的（换取 Windows 兼容）。 - Ctrl+C 退出前会额外重绘一次 Layout，终端最后一帧与磁盘上
project.stage保持一致。
每次 pptx-agent new / resume 都会把事件流追加到 outputs/<slug>/events.jsonl（NDJSON，{"name","payload","ts"} 格式，敏感字段自动脱敏）。直接用 SDK 内置的 openagents replay 回放：
openagents replay outputs/<slug>/events.jsonl
openagents replay outputs/<slug>/events.jsonl --turn 2日志路径可以用 PPTX_EVENTS_LOG 环境变量临时覆盖。
如果你想基于 SDK 的内置脚手架开始类似项目，openagents init --template pptx-wizard 会生成一个两-Agent 最小切片（intent-analyst + slide-generator，chain memory + markdown 持久化），直接对 mock provider 可跑。它不是完整的 7 阶段 wizard ——真实 pipeline 仍在 examples/pptx_generator/，scaffold 的 README 会指向那里。
所有项目状态持久化在 outputs/<slug>/project.json（atomic write，每次写入前备份成 project.json.bak）。任何阶段 Ctrl+C 退出后，都可以 pptx-agent resume <slug> 从该阶段恢复，退出码 130。
如果 project.json 损坏或通不过 pydantic 校验，CLI 会打印错误并弹出交互菜单：
- 从
project.json.bak恢复 - 删除当前
project.json重新来过 - Abort
- 必需：
LLM_API_KEY、LLM_API_BASE、LLM_MODEL - 可选：
TAVILY_API_KEY（启用联网研究） - 用户级
.env：~/.config/pptx-agent/.env（跨项目共享） - 项目级
.env：outputs/<slug>/.env（覆盖用户级）
跨会话记忆基于 MarkdownMemory，文件落在 ~/.config/pptx-agent/memory/：
MEMORY.md 索引
user_goals.md 意图阶段确认的偏好
user_feedback.md 其他反馈规则（兜底分类）
decisions.md 主题 / 切片阶段确认的决策
references.md 研究阶段保留的引用
下一次运行同一 agent 时，这些条目会通过 memory_view 注入到上下文里，让 LLM 按你之前的偏好输出。pptx-agent memory forget <id> 可以随时撤销某条偏好。