AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He
refactor(docs): 将生成流程合并至 AGENTS.md 并解耦模板创建工作流
hugohe32fcd3340c3fc
diff --git a/.agent/workflows/create-template.md b/.agent/workflows/create-template.mdindex 56dc9e9f..42e7429f 100644--- a/.agent/workflows/create-template.md+++ b/.agent/workflows/create-template.md@@ -111,7 +111,7 @@ ls -la "templates/layouts/<新模板名称>"## 注意事项-1. **SVG 技术约束**:遵守 [AGENTS.md](../../AGENTS.md) 规则+1. **SVG 技术约束**:参见 [Template_Designer.md](../roles/Template_Designer.md) 技术约束章节2. **配色一致性**:所有 SVG 文件使用相同配色3. **占位符规范**:使用 `{{}}` 格式diff --git a/.agent/workflows/generate-ppt.md b/.agent/workflows/generate-ppt.mdindex a14913b9..9ad70539 100644--- a/.agent/workflows/generate-ppt.md+++ b/.agent/workflows/generate-ppt.md@@ -4,335 +4,10 @@ description: 从 Markdown 源文档生成 PPT 的完整流程(主入口)# PPT 生成工作流-> 📌 **这是 PPT Master 系统的主执行流程**。所有 PPT 生成任务都应从此工作流开始。+> ⚠️ **本工作流已合并到 [AGENTS.md](../../AGENTS.md)**+>+> 请直接阅读 [AGENTS.md](../../AGENTS.md),该文件包含完整的工作流程和规则手册。------## ⚠️ 阶段零:强制前置检查(不可跳过)--**在执行任何步骤之前,必须完成以下检查:**--### 检查项 1:阅读规则手册--如果本次会话**尚未阅读** `AGENTS.md`,请立即执行:--```-view_file: AGENTS.md-```--> 💡 **判断方法**:如果你不确定本次会话是否已读过 AGENTS.md,就重新读一次。--### 检查项 2:确认已理解核心规则--- [ ] 角色切换协议(切换角色前必须阅读角色定义文件)-- [ ] SVG 技术约束(禁用功能黑名单、PPT 兼容性规则)-- [ ] 源内容自动处理(PDF/URL 必须立即转换)--**确认完成后,输出以下标记:**--```markdown-## ✅ 阶段零检查完成-- [x] 已阅读 AGENTS.md-- [x] 已理解核心规则-- [ ] 开始执行阶段一-```-------## 核心文档关系--| 文档 | 定位 | 内容 |-|------|------|------|-| **[AGENTS.md](../../AGENTS.md)** | 规则手册 | "怎么做"(约束边界、技术规范) |-| **本工作流** | 执行流程 | "做什么"(步骤顺序) |-| **[roles/](../../roles/)** | 角色定义 | "谁来做"(专业能力、职责范围) |-------## 工作流概览--```-源文档 → 创建项目 → 模板选项 → Strategist → [Image_Generator] → Executor → 后处理 → 导出-```-------## 前置条件--- 用户已提供源文档(Markdown、PDF 或 URL)-- 如果是 PDF/URL,需先转换为 Markdown-------## 阶段一:源内容处理(如需要)--当用户提供 PDF 或 URL 时,**必须立即调用对应工具**:--| 用户提供内容 | 必须调用的工具 | 命令 |-|--------------|----------------|------|-| **PDF 文件** | `pdf_to_md.py` | `python3 tools/pdf_to_md.py <文件路径>` |-| **网页链接** | `web_to_md.py` | `python3 tools/web_to_md.py <URL>` |-| **微信/高防站** | `web_to_md.cjs` | `node tools/web_to_md.cjs <URL>` |-| **Markdown** | - | 直接 `view_file` 读取 |-------## 阶段二:创建项目文件夹--> ⚠️ **第一步!** 用户输入内容后必须立即创建--// turbo-```bash-python3 tools/project_manager.py init <项目名称> --format <格式>-```--格式选项:`ppt169`(默认)、`ppt43`、`xhs`、`story` 等-------## 阶段三:模板选项确认--> ⚠️ **必须在策略师开始之前确认**,策略师需根据模板选项调整设计方案--向用户询问模板选项(二选一):--### A) 使用已有模板--**情况 1:模板在 repo 内**(如 `templates/layouts/` 下)--检查模板目录内容,按类型分别复制:-// turbo-```bash-# 复制模板文件(.svg, .md)到 templates/-cp templates/layouts/<模板名>/*.svg <项目路径>/templates/-cp templates/layouts/<模板名>/design_spec.md <项目路径>/templates/--# 复制图片资源(.png, .jpg 等)到 images/-# 注意:图片直接在模板目录下,不是在 images/ 子目录-cp templates/layouts/<模板名>/*.png <项目路径>/images/ 2>/dev/null || true-cp templates/layouts/<模板名>/*.jpg <项目路径>/images/ 2>/dev/null || true-cp templates/layouts/<模板名>/*.jpeg <项目路径>/images/ 2>/dev/null || true-```--**情况 2:模板在 repo 外**(用户自备/其他项目)--告知用户按以下规则手动复制:--| 文件类型 | 目标目录 | 示例 |-|----------|----------|------|-| 模板 SVG 文件 | `<项目路径>/templates/` | `01_cover.svg`, `02_toc.svg` |-| 设计规范文件 | `<项目路径>/templates/` | `design_spec.md` |-| 图片资源 | `<项目路径>/images/` | `cover_bg.png`, `logo.svg` |--等待用户确认文件已复制就绪后再继续。--**模板内容检查**:-```-<项目路径>/-├── templates/ # 模板文件-│ ├── design_spec.md # 设计规范(必须)-│ ├── 01_cover.svg # 封面模板-│ ├── 02_toc.svg # 目录模板-│ ├── 03_chapter.svg # 章节页模板-│ ├── 04_content.svg # 内容页模板-│ └── 05_ending.svg # 结尾页模板-└── images/ # 图片资源(如有)- ├── cover_bg.png- └── ...-```--> 📌 策略师需参考模板的配色、布局、风格进行设计--### B) 不使用模板--→ 自由生成,策略师完全自主设计--> 💡 **需要创建新模板?** 请使用 `/create-template` 工作流单独创建模板,完成后再回到此流程选择 A。-------## 阶段四:Strategist 角色(必须,不可跳过)--1. **阅读角色定义**:- ```- view_file: roles/Strategist.md- ```--2. **完成八项确认**(强制要求):- - 画布格式、页数范围、目标受众、风格目标- - 配色方案、图标使用、图片使用、排版方案--3. **如果用户提供了图片**,运行图片分析:- // turbo- ```bash- python3 tools/analyze_images.py <项目路径>/images- ```--4. **生成《设计规范与内容大纲》**:- - 参考模板:`templates/design_spec_reference.md`- - 保存到:`<项目路径>/设计规范与内容大纲.md`--5. **阶段检查点**:- ```markdown- ## ✅ Strategist 阶段完成- - [x] 已完成八项确认- - [x] 已生成《设计规范与内容大纲》- - [x] 设计规范已保存到项目文件夹- - [ ] **下一步**: [Image_Generator / Executor_xxx]- ```-------## 阶段六:Image_Generator 角色(条件触发)--> **触发条件**:图片方式包含「C) AI 生成」(如 C、B+C、C+D)--1. **阅读角色定义**:- ```- view_file: roles/Image_Generator.md- ```--2. **分析图片资源清单**:- - 从《设计规范与内容大纲》中提取所有「状态=待生成」的图片- - 判断每张图片的类型(背景图/实景照片/插画/图表/装饰图案)--3. **生成提示词文档**(必须保存为文件):- - 保存到 `<项目路径>/images/image_prompts.md`- - 格式:主体描述 + 风格指令 + 色彩指令 + 构图指令 + 负面提示词 + Alt Text--4. **生成图片**(三种方式):-- **方式一:直接生成**(如支持 generate_image 工具)- - 使用 `generate_image` 工具生成图片-- **方式二:用户自行生成**- - 告知用户提示词文件位置- - 推荐平台:Gemini、Midjourney、DALL-E 3、Stable Diffusion-- **方式三:Gemini 生成**(推荐高分辨率)- - 下载 Full Size 版本- - 去除水印:- // turbo- ```bash- python3 tools/gemini_watermark_remover.py <图片路径>- ```--5. **验证图片就绪**:确认所有图片已保存到 `images/` 目录--6. **阶段检查点**:- ```markdown- ## ✅ Image_Generator 阶段完成- - [x] 已创建提示词文档 `images/image_prompts.md`- - [x] 所有图片已保存到 images/ 目录- - [ ] **下一步**: Executor_xxx- ```-------## 阶段七:Executor 角色--1. **阅读角色定义**(根据风格选择):- ```- view_file: roles/Executor_General.md # 通用灵活风格- view_file: roles/Executor_Consultant.md # 一般咨询风格- view_file: roles/Executor_Consultant_Top.md # 顶级咨询风格- ```--2. **【视觉构建阶段】**:- - 批量生成 SVG 页面- - 保存到 `<项目路径>/svg_output/`--3. **【逻辑构建阶段】**(必须):- - 生成完整演讲备注文稿- - 保存到 `<项目路径>/notes/total.md`--4. **阶段检查点**:- ```markdown- ## ✅ Executor 阶段完成- ### 视觉构建阶段- - [x] 所有 SVG 页面已生成到 svg_output/-- ### 逻辑构建阶段- - [x] 已生成完整演讲备注 notes/total.md- ```-------## 阶段八:后处理与导出(自动执行)--> ⚠️ **必须按顺序执行以下三个命令,不可省略或替换!**--### 步骤 1:拆分演讲备注-// turbo-```bash-python3 tools/total_md_split.py <项目路径>-```--### 步骤 2:SVG 后处理-// turbo-```bash-python3 tools/finalize_svg.py <项目路径>-```--**此步骤执行以下处理**:-- 嵌入图标(将占位符替换为实际图标代码)-- 智能裁剪图片-- 修复图片宽高比-- 嵌入图片(Base64 编码,避免外部引用)-- 文本扁平化-- 圆角矩形转 Path(提高 PPT 兼容性)--> ❌ **禁止**:使用 `cp` 命令替代此步骤!--### 步骤 3:导出 PPTX-// turbo-```bash-python3 tools/svg_to_pptx.py <项目路径> -s final-```--- `-s final` 参数指定从 `svg_final/` 目录读取-- 默认会嵌入演讲备注-------## 阶段九:Optimizer_CRAP(可选)--> **触发条件**:用户要求优化 或 质量不足时主动建议--1. **阅读角色定义**:- ```- view_file: roles/Optimizer_CRAP.md- ```--2. **执行 CRAP 原则优化**--3. **重新执行后处理与导出**(如有修改)-------## 完成检查清单--- [ ] 源内容已转换为 Markdown-- [ ] 项目文件夹已创建-- [ ] 模板选项已确认-- [ ] 八项确认已完成-- [ ] 设计规范已保存-- [ ] 图片已就绪(如需要)-- [ ] SVG 文件已生成到 `svg_output/`-- [ ] 演讲备注已生成 `notes/total.md`-- [ ] 后处理已执行(`finalize_svg.py`)-- [ ] SVG 文件已复制到 `svg_final/`-- [ ] PPTX 已导出-------## 常见错误提醒--| 错误 | 正确做法 |-|------|----------|-| 用 `cp` 复制 SVG 到 svg_final | 使用 `finalize_svg.py` |-| 直接从 `svg_output` 导出 | 使用 `-s final` 从 `svg_final` 导出 |-| 忘记拆分备注 | 先运行 `total_md_split.py` |-| 忘记后处理 | 先运行 `finalize_svg.py` |-| 跳过 Strategist 八项确认 | 必须完成,无论模板选项如何 |-| 模板选项后才创建项目 | 先创建项目,再询问模板选项 |+**快速跳转**:+- [工作流程](../../AGENTS.md#工作流程) — 从源文档到 PPT 的完整执行步骤+- [规则手册](../../AGENTS.md#规则手册) — 约束边界、技术规范、角色切换协议diff --git a/AGENTS.md b/AGENTS.mdindex 9c2df53c..ad24ecdf 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -1,28 +1,333 @@-# AGENTS.md — 规则手册(必读)+# AGENTS.md — PPT Master 完整指南-> ⚠️ **AI 代理注意**:本文件是 PPT Master 系统的**规则总纲**,执行任何工作流之前必须先阅读本文件。+> ⚠️ **AI 代理注意**:本文件是 PPT 生成流程的完整指南,包含工作流程和规则手册。>-> 如果你是通过 `/generate-ppt` 或 `/create-template` 进入的,请确认已阅读本文件后再继续。+> 执行 `/generate-ppt` 前必须阅读本文件。----## 🚀 快速入口+## 📚 目录导航-| 任务 | 工作流 |-|------|--------|-| **生成 PPT** | [/generate-ppt](.agent/workflows/generate-ppt.md) |+| 部分 | 内容 |+|------|------|+| [工作流程](#工作流程) | 从源文档到 PPT 的完整执行步骤 |+| [规则手册](#规则手册) | 约束边界、技术规范、角色切换协议 |+| [常用命令](#常用命令) | 工具命令快速参考 |+| [重要资源](#重要资源) | 模板、图标、文档链接 |-> 📋 **执行顺序**:阅读本文件 → 阅读工作流 → 开始执行+---++# 工作流程++> 📌 **这是 PPT Master 系统的主执行流程**。所有 PPT 生成任务都应从此工作流开始。++## 工作流概览++```+源文档 → 创建项目 → 模板选项 → Strategist → [Image_Generator] → Executor → 后处理 → 导出+```++---++## ⚠️ 阶段零:强制前置检查(不可跳过)++**在执行任何步骤之前,必须完成以下检查:**++### 检查项 1:确认已理解核心规则++- [ ] 角色切换协议(切换角色前必须阅读角色定义文件)+- [ ] SVG 技术约束(禁用功能黑名单、PPT 兼容性规则)+- [ ] 源内容自动处理(PDF/URL 必须立即转换)++**确认完成后,输出以下标记:**++```markdown+## ✅ 阶段零检查完成+- [x] 已阅读 AGENTS.md+- [x] 已理解核心规则+- [ ] 开始执行阶段一+```++---++## 阶段一:源内容处理(如需要)++当用户提供 PDF 或 URL 时,**必须立即调用对应工具**:++| 用户提供内容 | 必须调用的工具 | 命令 |+|--------------|----------------|------|+| **PDF 文件** | `pdf_to_md.py` | `python3 tools/pdf_to_md.py <文件路径>` |+| **网页链接** | `web_to_md.py` | `python3 tools/web_to_md.py <URL>` |+| **微信/高防站** | `web_to_md.cjs` | `node tools/web_to_md.cjs <URL>` |+| **Markdown** | - | 直接 `view_file` 读取 |++---++## 阶段二:创建项目文件夹++> ⚠️ **第一步!** 用户输入内容后必须立即创建++// turbo+```bash+python3 tools/project_manager.py init <项目名称> --format <格式>+```++格式选项:`ppt169`(默认)、`ppt43`、`xhs`、`story` 等++---++## 阶段三:模板选项确认++> ⚠️ **必须在策略师开始之前确认**,策略师需根据模板选项调整设计方案++向用户询问模板选项(二选一):++### A) 使用已有模板++**情况 1:模板在 repo 内**(如 `templates/layouts/` 下)++检查模板目录内容,按类型分别复制:+// turbo+```bash+# 复制模板文件(.svg, .md)到 templates/+cp templates/layouts/<模板名>/*.svg <项目路径>/templates/+cp templates/layouts/<模板名>/design_spec.md <项目路径>/templates/++# 复制图片资源(.png, .jpg 等)到 images/+# 注意:图片直接在模板目录下,不是在 images/ 子目录+cp templates/layouts/<模板名>/*.png <项目路径>/images/ 2>/dev/null || true+cp templates/layouts/<模板名>/*.jpg <项目路径>/images/ 2>/dev/null || true+cp templates/layouts/<模板名>/*.jpeg <项目路径>/images/ 2>/dev/null || true+```++**情况 2:模板在 repo 外**(用户自备/其他项目)++告知用户按以下规则手动复制:++| 文件类型 | 目标目录 | 示例 |+|----------|----------|------|+| 模板 SVG 文件 | `<项目路径>/templates/` | `01_cover.svg`, `02_toc.svg` |+| 设计规范文件 | `<项目路径>/templates/` | `design_spec.md` |+| 图片资源 | `<项目路径>/images/` | `cover_bg.png`, `logo.svg` |++等待用户确认文件已复制就绪后再继续。++**模板内容检查**:+```+<项目路径>/+├── templates/ # 模板文件+│ ├── design_spec.md # 设计规范(必须)+│ ├── 01_cover.svg # 封面模板+│ ├── 02_toc.svg # 目录模板+│ ├── 03_chapter.svg # 章节页模板+│ ├── 04_content.svg # 内容页模板+│ └── 05_ending.svg # 结尾页模板+└── images/ # 图片资源(如有)+ ├── cover_bg.png+ └── ...+```++> 📌 策略师需参考模板的配色、布局、风格进行设计++### B) 不使用模板++→ 自由生成,策略师完全自主设计++++---++## 阶段四:Strategist 角色(必须,不可跳过)++1. **阅读角色定义**:+ ```+ view_file: roles/Strategist.md+ ```++2. **完成八项确认**(强制要求):+ - 画布格式、页数范围、目标受众、风格目标+ - 配色方案、图标使用、图片使用、排版方案++3. **如果用户提供了图片**,运行图片分析:+ // turbo+ ```bash+ python3 tools/analyze_images.py <项目路径>/images+ ```++4. **生成《设计规范与内容大纲》**:+ - 参考模板:`templates/design_spec_reference.md`+ - 保存到:`<项目路径>/设计规范与内容大纲.md`++5. **阶段检查点**:+ ```markdown+ ## ✅ Strategist 阶段完成+ - [x] 已完成八项确认+ - [x] 已生成《设计规范与内容大纲》+ - [x] 设计规范已保存到项目文件夹+ - [ ] **下一步**: [Image_Generator / Executor_xxx]+ ```++---++## 阶段五:Image_Generator 角色(条件触发)++> **触发条件**:图片方式包含「C) AI 生成」(如 C、B+C、C+D)++1. **阅读角色定义**:+ ```+ view_file: roles/Image_Generator.md+ ```++2. **分析图片资源清单**:+ - 从《设计规范与内容大纲》中提取所有「状态=待生成」的图片+ - 判断每张图片的类型(背景图/实景照片/插画/图表/装饰图案)++3. **生成提示词文档**(必须保存为文件):+ - 保存到 `<项目路径>/images/image_prompts.md`+ - 格式:主体描述 + 风格指令 + 色彩指令 + 构图指令 + 负面提示词 + Alt Text++4. **生成图片**(三种方式):++ **方式一:直接生成**(如支持 generate_image 工具)+ - 使用 `generate_image` 工具生成图片++ **方式二:用户自行生成**+ - 告知用户提示词文件位置+ - 推荐平台:Gemini、Midjourney、DALL-E 3、Stable Diffusion++ **方式三:Gemini 生成**(推荐高分辨率)+ - 下载 Full Size 版本+ - 去除水印:+ // turbo+ ```bash+ python3 tools/gemini_watermark_remover.py <图片路径>+ ```++5. **验证图片就绪**:确认所有图片已保存到 `images/` 目录++6. **阶段检查点**:+ ```markdown+ ## ✅ Image_Generator 阶段完成+ - [x] 已创建提示词文档 `images/image_prompts.md`+ - [x] 所有图片已保存到 images/ 目录+ - [ ] **下一步**: Executor_xxx+ ```++---++## 阶段六:Executor 角色++1. **阅读角色定义**(根据风格选择):+ ```+ view_file: roles/Executor_General.md # 通用灵活风格+ view_file: roles/Executor_Consultant.md # 一般咨询风格+ view_file: roles/Executor_Consultant_Top.md # 顶级咨询风格+ ```++2. **【视觉构建阶段】**:+ - 批量生成 SVG 页面+ - 保存到 `<项目路径>/svg_output/`++3. **【逻辑构建阶段】**(必须):+ - 生成完整演讲备注文稿+ - 保存到 `<项目路径>/notes/total.md`++4. **阶段检查点**:+ ```markdown+ ## ✅ Executor 阶段完成+ ### 视觉构建阶段+ - [x] 所有 SVG 页面已生成到 svg_output/++ ### 逻辑构建阶段+ - [x] 已生成完整演讲备注 notes/total.md+ ```++---++## 阶段七:后处理与导出(自动执行)++> ⚠️ **必须按顺序执行以下三个命令,不可省略或替换!**++### 步骤 1:拆分演讲备注+// turbo+```bash+python3 tools/total_md_split.py <项目路径>+```++### 步骤 2:SVG 后处理+// turbo+```bash+python3 tools/finalize_svg.py <项目路径>+```++**此步骤执行以下处理**:+- 嵌入图标(将占位符替换为实际图标代码)+- 智能裁剪图片+- 修复图片宽高比+- 嵌入图片(Base64 编码,避免外部引用)+- 文本扁平化+- 圆角矩形转 Path(提高 PPT 兼容性)++> ❌ **禁止**:使用 `cp` 命令替代此步骤!++### 步骤 3:导出 PPTX+// turbo+```bash+python3 tools/svg_to_pptx.py <项目路径> -s final+```++- `-s final` 参数指定从 `svg_final/` 目录读取+- 默认会嵌入演讲备注++---++## 阶段八:Optimizer_CRAP(可选)++> **触发条件**:用户要求优化 或 质量不足时主动建议++1. **阅读角色定义**:+ ```+ view_file: roles/Optimizer_CRAP.md+ ```++2. **执行 CRAP 原则优化**++3. **重新执行后处理与导出**(如有修改)++---++## 完成检查清单++- [ ] 源内容已转换为 Markdown+- [ ] 项目文件夹已创建+- [ ] 模板选项已确认+- [ ] 八项确认已完成+- [ ] 设计规范已保存+- [ ] 图片已就绪(如需要)+- [ ] SVG 文件已生成到 `svg_output/`+- [ ] 演讲备注已生成 `notes/total.md`+- [ ] 后处理已执行(`finalize_svg.py`)+- [ ] SVG 文件已复制到 `svg_final/`+- [ ] PPTX 已导出----## 三层架构导航+## 常见错误提醒-| 层级 | 文档 | 职责 |-|------|------|------|-| **流程** | [generate-ppt.md](.agent/workflows/generate-ppt.md) | "做什么"(步骤顺序) |-| **角色** | [roles/README.md](roles/README.md) | "谁来做"(专业能力) |-| **规则** | 本文件 | "怎么做"(约束边界) |+| 错误 | 正确做法 |+|------|----------|+| 用 `cp` 复制 SVG 到 svg_final | 使用 `finalize_svg.py` |+| 直接从 `svg_output` 导出 | 使用 `-s final` 从 `svg_final` 导出 |+| 忘记拆分备注 | 先运行 `total_md_split.py` |+| 忘记后处理 | 先运行 `finalize_svg.py` |+| 跳过 Strategist 八项确认 | 必须完成,无论模板选项如何 |+| 模板选项后才创建项目 | 先创建项目,再询问模板选项 |++---++# 规则手册++> 以下是 PPT Master 系统的约束边界和技术规范,执行工作流时必须遵守。---@@ -41,7 +346,7 @@ PPT Master 是一个 AI 驱动的多格式 SVG 内容生成系统,通过多角| 阶段 | 必须阅读的文件 | 触发条件 || ------------ | ---------------------------------- | -------------------------------------------- || 策略规划 | `roles/Strategist.md` | 用户提出新的 PPT/内容生成需求 |-| 模板设计 | `roles/Template_Designer.md` | 使用 `/create-template` 工作流时触发(独立流程) |+| 图片生成 | `roles/Image_Generator.md` | 图片方式包含「C) AI 生成」(如 C、B+C、C+D) || 通用风格执行 | `roles/Executor_General.md` | 用户选择「A) 通用灵活」设计风格 || 咨询风格执行 | `roles/Executor_Consultant.md` | 用户选择「B) 一般咨询」设计风格 |@@ -132,9 +437,8 @@ python3 tools/svg_to_pptx.py <项目路径> -s final> ⚠️ **优化提示**:仅在完整初版产出后考虑 Optimizer;若优化过,请重新运行后处理与导出以保持产物一致。----## 源内容自动处理(强制触发)-> 📖 **详细工作流程**:参见 `.agent/workflows/generate-ppt.md`+## 源内容自动处理(强制触发)### 强制规则@@ -200,7 +504,7 @@ python3 tools/svg_to_pptx.py <项目路径> -s final> 📖 **详细代码示例**:参见 `roles/Executor_*.md` 对应章节-### 4. 画布格式+### 3. 画布格式| 格式 | 尺寸 | viewBox || ---------- | --------- | --------------- |@@ -213,6 +517,8 @@ python3 tools/svg_to_pptx.py <项目路径> -s final完整格式列表: [docs/canvas_formats.md](./docs/canvas_formats.md)+---+## 常用命令```bash@@ -267,6 +573,8 @@ project/└── *.pptx # 导出的 PPT 文件```+---+## 质量检查清单生成 SVG 时确保:@@ -281,6 +589,8 @@ project/- [ ] **重复**: 同类元素风格一致- [ ] **亲密性**: 相关内容空间聚合+---+## 源文档转换工具选择### PDF 转 Markdown@@ -310,6 +620,8 @@ project/> **策略**: 静态网页用 `web_to_md.py`,动态渲染或需登录的页面需手动处理。+---+## 重要资源| 资源 | 路径 |@@ -325,6 +637,8 @@ project/| 示例项目 | `examples/` || 工具说明 | `tools/README.md` |+---+## AI 代理重要提示### 核心原则@@ -355,7 +669,7 @@ project/- **创建项目后立即询问模板选项**(A 使用已有 / B 不使用)— 这是流程步骤,非策略师职责- **模板选项必须在策略师开始之前确认完成**,策略师需根据模板选项调整设计方案- 如用户选择 A(使用已有模板),需**分别复制**:图片资源拷贝到项目 `images/` 目录,其他文件(SVG、design_spec 等)拷贝到项目 `templates/` 目录(来源:用户自备/其他项目/示例库等)-- 如需创建新模板,请使用 `/create-template` 工作流(独立流程)+- **策略师的「八项确认」是强制要求,无论模板选项如何都不可跳过**- 策略师必须对八项确认问题**均给出专业建议**- 如选择 A(使用已有模板),策略师需参考模板的配色、布局、风格进行设计