codewave-openclaw-installer 2.1.11 → 2.1.13

package/skills/ppt-master/audit_report_model_perf.md

@@ -0,0 +1,213 @@
+# PPT Master — 审计报告 2: 模型兼容性 & 性能分析
+
+> 审计时间: 2026-04-07 | 审计范围: SKILL.md + references/ + 工作流全链路
+
+---
+
+## A. 模型兼容性分析
+
+### A1. 每步骤上下文窗口需求
+
+| Step | 必须加载的文件 | 字符数估算 | 最低上下文窗口 |
+|------|---------------|-----------|---------------|
+| **Step 1** (源内容处理) | SKILL.md | ~32K chars | 低 — 仅执行脚本命令 |
+| **Step 3** (模板选择) | SKILL.md + layouts_index.json | ~35K chars | 低 |
+| **Step 4** (Strategist) | SKILL.md + strategist.md + design_spec_reference.md + shared-standards.md + canvas-formats.md + 源文档内容 | **~80K chars + 源文档** | **🔴 高 — 最大瓶颈** |
+| **Step 4.5** (述标) | + bid-presentation.md + bid-content-template.md | 再加 ~27K chars → **~107K chars** | **🔴 极高** |
+| **Step 5** (图片生成) | SKILL.md + image-generator.md + design_spec | ~60K chars | 中 |
+| **Step 6** (Executor) | SKILL.md + executor-base.md + executor-{style}.md + shared-standards.md + image-layout-spec.md + svg-image-embedding.md + design_spec + 源文档 | **~95K chars + 源文档** | **🔴 高** |
+| **Step 7** (后处理) | SKILL.md（仅脚本命令） | ~32K chars | 低 — 仅运行脚本 |
+
+**严重程度: 🔴 高**
+
+**关键发现**: Step 4 (Strategist) 和 Step 6 (Executor) 是上下文窗口瓶颈。加上源文档内容（一般 10K-50K chars），总输入轻松超过 **150K chars (~60K tokens)**。述标场景 Step 4.5 更是达到 ~107K chars 仅参考文件就有。
+
+**影响**:
+- GPT-3.5 (4K/16K context): ❌ 完全不可用
+- GPT-4 (8K/32K): ❌ 不可用（Strategist 阶段就会溢出）
+- Claude Haiku (200K context): ✅ 窗口够，但质量存疑
+- Claude Sonnet/Opus (200K): ✅ 推荐
+- GPT-4o (128K): ⚠️ 勉强够用，述标场景可能吃紧
+- Gemini 1.5/2.0 (1M+): ✅ 窗口充裕
+
+### A2. 特定模型能力依赖
+
+| 依赖能力 | 用到的地方 | 模型限制 |
+|---------|-----------|---------|
+| **复杂结构化输出 (SVG)** | Step 6 Executor 生成完整 SVG 代码 | 🔴 核心依赖 — 弱模型生成的 SVG 质量极差 |
+| **长文档理解** | Step 4 需理解全文并规划 55 页内容大纲 | 🟡 需要强推理能力 |
+| **精确遵循格式规范** | design_spec.md 模板填写、SVG 坐标计算 | 🟡 弱模型容易偏离规范 |
+| **子代理协作** | Step 6 分批并行生成 SVG | ⚠️ 依赖 OpenClaw subagent 能力，非模型特性 |
+| **JSON 生成** | arch_diagram.py 的输入 JSON | 🟢 大多数模型可胜任 |
+
+**未发现的依赖**: 无 Claude artifact、GPT function calling 等平台特定依赖。Skill 设计为模型无关，但**实际上强依赖高质量代码生成能力**。
+
+### A3. 弱模型可行性评估
+
+| 模型 | Strategist (Step 4) | Executor (Step 6 SVG) | 总体可用性 |
+|------|---------------------|----------------------|-----------|
+| **GPT-3.5** | ❌ 上下文不够 | ❌ SVG 质量极差 | ❌ 不可用 |
+| **Claude Haiku** | ⚠️ 能规划但深度不够 | ❌ SVG 坐标/布局频繁出错 | ❌ 不推荐 |
+| **GPT-4o-mini** | ⚠️ 基本可用 | 🟡 简单页面可以，复杂布局出错率高 | ⚠️ 仅简单 PPT |
+| **Claude Sonnet** | ✅ 良好 | ✅ SVG 质量好 | ✅ 推荐 |
+| **Claude Opus** | ✅ 优秀 | ✅ SVG 质量最佳 | ✅ 最佳选择 |
+| **GPT-4o** | ✅ 良好 | 🟡 SVG 中等，需更多修复 | 🟡 可用 |
+| **Gemini 2.0 Flash** | ✅ 良好 | 🟡 SVG 质量参差 | 🟡 可用 |
+
+**严重程度: 🟡 中**
+
+**建议**: SKILL.md 应明确声明最低模型要求（如 "需要 Claude Sonnet 级别或更高"），避免用户用弱模型尝试后得到垃圾输出。
+
+### A4. SVG 质量与模型关系
+
+SVG 生成是整个 Skill 质量的**核心决定因素**。差异表现在：
+
+1. **坐标精度**: 弱模型频繁出现文字超出 viewBox、元素重叠
+2. **CSS/样式**: 弱模型可能生成 `rgba()` 等不兼容语法（skill 已有 quality checker 处理）
+3. **布局合理性**: 强模型能生成视觉平衡的布局，弱模型倾向于堆砌元素
+4. **代码体积**: 弱模型生成冗余代码，单页 SVG 可能膨胀 2-3 倍
+
+**严重程度: 🔴 高** — 这是用户体验的最大变量
+
+---
+
+## A5. References 文件大小统计
+
+| 文件 | 字节数 | 字符数 | 用于步骤 |
+|------|--------|--------|---------|
+| bid-content-template.md | 31,796 | 18,740 | Step 4.5 |
+| image-generator.md | 24,217 | 24,131 | Step 5 |
+| strategist.md | 18,513 | 18,141 | Step 4 |
+| shared-standards.md | 16,819 | 16,695 | Step 4, 6 |
+| bid-presentation.md | 15,062 | 8,227 | Step 4.5 |
+| executor-consultant-top.md | 10,349 | 9,889 | Step 6 |
+| executor-base.md | 10,129 | 9,951 | Step 6 |
+| executor-consultant.md | 7,180 | 7,122 | Step 6 |
+| template-designer.md | 6,496 | 6,446 | 模板创建 |
+| executor-general.md | 6,070 | 6,046 | Step 6 |
+| svg-image-embedding.md | 6,089 | 6,039 | Step 6 |
+| image-layout-spec.md | 5,620 | 5,600 | Step 6 |
+| company_intro.md | 4,066 | 2,688 | 述标 |
+| drawio-integration.md | 4,200 | 4,173 | Step 5 |
+| canvas-formats.md | 2,902 | 2,828 | Step 4 |
+| **合计** | **169,508** | **146,716** | |
+
+另外：
+- SKILL.md: 37,759 bytes / 32,009 chars
+- design_spec_reference.md: 9,726 bytes
+
+**全部参考材料总计: ~217K bytes / ~188K chars**
+
+### A6. 55 页 PPT Token 估算
+
+假设：1 token ≈ 4 chars (英文) 或 ≈ 1.5 chars (中文混合)
+
+| 阶段 | Input tokens | Output tokens | 说明 |
+|------|-------------|---------------|------|
+| **Step 4 Strategist** | ~80K | ~8K | 读参考文件 + 源文档 → 输出 design_spec |
+| **Step 5 图片生成** | ~5K | ~2K | 仅生成 prompt（架构图是脚本生成） |
+| **Step 6 Executor (55页)** | 55 × ~25K = **~1.4M** | 55 × ~8K = **~440K** | 每页需读 design_spec + 规范 + 生成 SVG |
+| **Step 6 Speaker Notes** | ~60K | ~15K | 读所有 SVG + 生成讲稿 |
+| **Step 7 后处理** | ~5K | ~1K | 仅运行脚本命令 |
+| **总计** | **~1.55M** | **~466K** | |
+
+**严重程度: 🔴 高**
+
+**关键发现**: 
+- 一次完整 55 页 PPT 约消耗 **~2M tokens**（输入+输出）
+- Step 6 占总消耗的 **~90%**
+- 如果用 Claude Opus ($15/M input, $75/M output)，单次生成成本约 **$15 input + $33 output = ~$48**
+- 如果用 Claude Sonnet ($3/$15)，约 **~$11.5**
+- 如果用子代理分 3 批并行，总 token 不变但每个子代理的上下文更小（更高效）
+
+---
+
+## B. 性能瓶颈分析
+
+### B1. 每步骤预估耗时
+
+| Step | 操作 | 快模型 (Sonnet) | 慢模型 (Opus) | 瓶颈类型 |
+|------|------|----------------|---------------|---------|
+| **1. 源内容处理** | 脚本转换 PDF/DOCX→MD | 5-15s | 5-15s | I/O |
+| **2. 项目初始化** | 脚本创建目录 | 2-3s | 2-3s | I/O |
+| **3. 模板选择** | ⛔ 用户交互 | 0s (人工) | 0s | 人工等待 |
+| **4. Strategist** | 读文件 + 八项确认 + 输出 design_spec | 30-60s LLM + ⛔ 用户确认 | 60-120s LLM | **LLM** |
+| **4.5 述标初始化** | bid_init.py 复制 46 SVG | 2-3s | 2-3s | I/O |
+| **5. 图片生成** | arch_diagram.py + 可选 AI 生图 | 5-10s (架构图) + 20-25s/张 (AI) | 同左 | **API/脚本** |
+| **6. Executor (55页)** | 生成 55 个 SVG + speaker notes | **15-25 min** | **30-50 min** | **🔴 LLM 主瓶颈** |
+| **7. 后处理+导出** | 4 个脚本串行 | 20-40s | 20-40s | I/O/脚本 |
+
+### B2. 并行化分析
+
+| 步骤 | 可否并行 | 当前实现 | 改进空间 |
+|------|---------|---------|---------|
+| Step 1-4 | ❌ 严格串行 | 串行 ✅ | 无（依赖上游输出） |
+| **Step 5 图片 + Step 6 SVG** | ⚠️ 部分可并行 | 串行 ❌ | 🟡 架构图生成可与首批 SVG 并行 |
+| **Step 6 SVG 页面间** | ✅ 可并行 | ✅ 已实现子代理 2-3 批 | 🟢 当前设计合理 |
+| **Step 6 SVG + Speaker Notes** | ❌ Notes 依赖所有 SVG | 串行 ✅ | 无 |
+| Step 7 各子步骤 | ❌ 串行依赖 | 串行 ✅ | 无（pipeline） |
+
+**当前并行策略评价**: ✅ 已做了最关键的并行（Step 6 子代理分批生成 SVG），这是正确的。
+
+### B3. 55 页 PPT 总生成时间估算
+
+#### 普通场景（自由设计，55 页）
+
+| 阶段 | 快模型 (Sonnet) | 慢模型 (Opus) |
+|------|----------------|---------------|
+| Step 1-4 (含用户交互) | ~3 min | ~5 min |
+| Step 5 (架构图 × 3) | ~30s | ~30s |
+| **Step 6 (3 批子代理并行)** | **~8 min** | **~18 min** |
+| Step 6 (Speaker Notes) | ~2 min | ~4 min |
+| Step 7 (后处理+导出) | ~1 min | ~1 min |
+| **总计** | **~15 min** | **~28 min** |
+
+#### 述标场景（46 固定 + 9 动态）
+
+| 阶段 | 快模型 | 慢模型 |
+|------|--------|--------|
+| Step 1-4.5 | ~3 min | ~5 min |
+| **Step 6 (仅 9 页，无需子代理)** | **~3 min** | **~6 min** |
+| Step 7 | ~1 min | ~1 min |
+| **总计** | **~7 min** | **~12 min** |
+
+**述标场景的 bid_init.py 优化非常有效**，将 Step 6 耗时削减 80%+。
+
+### B4. 图片生成耗时与优化
+
+| 图片类型 | 当前耗时 | 优化空间 |
+|---------|---------|---------|
+| arch_diagram.py (本地) | ~2-5s/张 | 🟢 已经很快 |
+| drawio_gen.py (本地) | ~3-5s/张 | 🟢 已经很快 |
+| AI 背景图 (API) | ~20-25s/张 | 🟡 已有分类复用策略（6-8 张），合理 |
+| AI 背景图 (全量) | 55 × 25s = ~23 min | ❌ Skill 已避免此情况 ✅ |
+
+**评价**: 图片策略设计得当 — 架构图用本地脚本（快），背景图用分类复用（省），述标禁用 AI 生图（最快）。
+
+---
+
+## 发现汇总与改进建议
+
+| # | 发现 | 严重程度 | 改进建议 |
+|---|------|---------|---------|
+| 1 | **无最低模型要求声明** | 🔴 高 | 在 SKILL.md 顶部添加 `## Prerequisites > Model: Claude Sonnet or equivalent (128K+ context, strong code gen)` |
+| 2 | **Step 6 是绝对瓶颈** (55页 ~8-18min) | 🟡 中 | 当前子代理并行已是最佳方案；可考虑增加到 4-5 批（但受限于并发） |
+| 3 | **单次生成 ~2M tokens** | 🟡 中 | 无法大幅削减（每页 SVG 需要规范上下文）；可考虑让子代理只读 executor-base + 一个精简版 design_spec 摘要，而非全部参考文件 |
+| 4 | **Strategist 阶段上下文过大** (~80K chars) | 🟡 中 | 可将 strategist.md 中不常用的部分拆为"高级参考"按需加载，减少默认上下文 |
+| 5 | **述标场景 references 特别大** (~107K chars 仅参考文件) | 🟡 中 | bid-content-template.md (18K chars) 可拆分为固定模板数据文件 + 精简指引 |
+| 6 | **弱模型 SVG 质量差无降级方案** | 🟡 中 | 可增加"简单模式"：减少页面复杂度、使用更多模板、减少自由布局 |
+| 7 | **子代理上下文重复传输** | 🟢 低 | 每个子代理都需读完整 design_spec + executor 规范；可考虑预生成精简版"子代理指令包" |
+| 8 | **$48/次 (Opus) 成本较高** | 🟢 低 | Sonnet ~$11 已可接受；述标场景 ~$3-5 很经济 |
+| 9 | **Step 5 和 Step 6 可部分并行** | 🟢 低 | 架构图生成可与首批非架构图页 SVG 并行，但收益有限（架构图本身很快） |
+
+---
+
+## 结论
+
+**模型兼容性**: Skill 实际要求 **Claude Sonnet 级别或更高**（128K+ 上下文、强 SVG 代码生成能力）。弱模型不可用但 SKILL.md 未明确声明。
+
+**性能**: Step 6 (Executor) 占总耗时 60-70%，已通过子代理并行优化。述标场景的 bid_init.py 是优秀的性能优化。55 页普通 PPT 约 15-28 分钟，述标 PPT 约 7-12 分钟，均在可接受范围。
+
+**Token 消耗**: 55 页约 2M tokens，成本 $11-48 取决于模型。主要消耗在 Step 6 的重复上下文加载，有一定优化空间。
+
+**最关键的改进**: 在 SKILL.md 中声明最低模型要求，避免用户无效尝试。

package/skills/ppt-master/audit_report_portability.md

@@ -0,0 +1,90 @@
+# PPT Master Skill - 可移植性 & 打包审计报告
+
+**审计日期**: 2026-04-07  
+**审计范围**: `ppt-master` skill 目录
+
+---
+
+## 1. 依赖声明 🔴 阻塞
+
+**问题**: 没有 `requirements.txt` 或任何依赖声明文件。
+
+**扫描到的第三方 Python 依赖**（需 pip 安装）:
+
+| 包名 | 使用位置 |
+|------|----------|
+| `Pillow` (PIL) | `analyze_images.py`, `rotate_images.py` |
+| `PyMuPDF` (fitz) | `pdf_to_md.py` |
+| `numpy` | `scripts/*.py` |
+| `python-pptx` | `svg_to_pptx/pptx_builder.py` |
+| `google-genai` | `image_backends/backend_gemini.py` |
+| `openai` | `image_backends/backend_openai.py` |
+| `requests` | 多个 image backend |
+
+**其他工具依赖**:
+- `pandoc` (外部命令行工具) — `doc_to_md.py` 调用
+- `Node.js` — `web_to_md.cjs` 需要
+
+**修复建议**: 创建 `requirements.txt`，至少包含核心依赖；可选依赖用 `requirements-optional.txt` 或 extras。
+
+---
+
+## 2. 环境配置 🟢 没问题
+
+- `.env.example` 存在且内容完整
+- 列出了所有支持的 image backend 及对应 API key
+- 有清晰的放置说明（`${SKILL_DIR}/../.env`）
+- `config.py` 使用 `Path(__file__).parent.parent` 相对路径，无硬编码
+
+---
+
+## 3. 路径硬编码 🟢 没问题
+
+全面扫描所有 `.py` 和 `.md` 文件，**未发现任何硬编码的绝对路径**（如 `C:\Users\xxx` 或 `/home/xxx`）。
+
+`config.py` 使用 `Path(__file__).parent.parent` 动态计算项目根目录，所有路径基于此相对构建。
+
+---
+
+## 4. 跨平台兼容性 🟢 没问题
+
+- 使用 `pathlib.Path` 处理路径（跨平台安全）
+- `subprocess.run` 仅用于调用 `pandoc`（跨平台工具），且有 `FileNotFoundError` 错误处理和多平台安装提示（macOS/Ubuntu/Windows）
+- 无 Windows-only 或 Unix-only 的系统命令调用
+- `web_to_md.cjs` 使用 Node.js（跨平台）
+
+---
+
+## 5. README / 入门文档 🟡 需改进
+
+**现状**:
+- `scripts/README.md` 有工具索引和 Quick Start 命令
+- `scripts/docs/` 下有分主题文档
+- `.env.example` 有注释说明
+- 多个项目子目录有 `README.md`
+
+**缺失**:
+- **skill 根目录缺少 `README.md`** — 没有顶层入门文档
+- 没有统一的"安装步骤"文档（安装 Python、pip install、pandoc 等）
+- `SKILL.md` 是给 AI agent 看的，不是人类安装指南
+
+**修复建议**: 在 skill 根目录创建 `README.md`，包含：
+1. 项目简介
+2. 系统要求（Python 3.x, Node.js, pandoc）
+3. 安装步骤（pip install -r requirements.txt）
+4. .env 配置说明
+5. 快速开始示例
+
+---
+
+## 总结
+
+| 检查项 | 评级 | 说明 |
+|--------|------|------|
+| 依赖声明 | 🔴 阻塞 | 无 requirements.txt，别人无法知道要装什么包 |
+| 环境配置 | 🟢 没问题 | .env.example 完整清晰 |
+| 路径硬编码 | 🟢 没问题 | 全部使用相对路径 |
+| 跨平台 | 🟢 没问题 | pathlib + 跨平台工具 |
+| 入门文档 | 🟡 需改进 | 缺少根目录 README 和安装指南 |
+
+**整体可移植性评分**: ⚠️ **有阻塞项** — 修复 `requirements.txt` 后基本可打包分发。

package/skills/ppt-master/audit_report_robustness.md

@@ -0,0 +1,192 @@
+# PPT Master Skill 审计报告 3: 健壮性 & 通用性
+
+**审计日期**: 2026-04-07  
+**审计范围**: scripts/*.py, scripts/image_backends/*.py, scripts/svg_finalize/*.py, scripts/svg_to_pptx/*.py, SKILL.md, references/*.md, templates/
+
+---
+
+## A. 健壮性检查
+
+### A1. 异常处理（try/except 覆盖率）
+
+| 指标 | 数值 |
+|------|------|
+| 总脚本数（scripts/*.py） | 24 |
+| 含 try/except 的脚本数 | 15 |
+| **无任何 try/except 的脚本** | **9（37.5%）** |
+| try 语句总数 | 59 |
+| except 语句总数 | 64 |
+
+**❌ 无异常处理的脚本**:
+
+| 脚本 | 风险等级 | 说明 |
+|------|----------|------|
+| `arch_diagram.py` | 🟡 中 | 架构图生成核心脚本，JSON 解析、SVG 写入无保护 |
+| `bid_init.py` | 🟡 中 | 述标初始化脚本，文件复制操作无保护 |
+| `drawio_gen.py` | 🟡 中 | DrawIO 生成脚本，XML 构建无保护 |
+| `drawio_to_svg.py` | 🟡 中 | DrawIO→SVG 转换，外部格式解析无保护 |
+| `error_helper.py` | 🟢 低 | 错误辅助工具本身，可接受 |
+| `gemini_watermark_remover.py` | 🟢 低 | 辅助工具 |
+| `pptx_animations.py` | 🟡 中 | PPTX 动画处理 |
+| `svg_page_gen.py` | 🔴 高 | **SVG 页面生成核心脚本**，文件读写、命令行解析无保护 |
+| `svg_to_pptx.py` | 🔴 高 | **SVG→PPTX 转换入口脚本**，整个流程无保护 |
+
+**建议**: `svg_page_gen.py` 和 `svg_to_pptx.py` 是流水线关键节点，崩溃会导致整个 PPT 生成失败，必须添加 try/except。
+
+### A2. API 调用超时和重试机制
+
+**✅ 图片生成后端（优秀）**
+
+所有 13 个 image_backends 均实现了统一的重试机制：
+- `backend_common.py` 定义 `MAX_RETRIES=3`, `RETRY_BASE_DELAY=10`, `RETRY_BACKOFF=2`
+- 所有后端统一使用 `retry_delay()` 函数计算指数退避延迟
+- HTTP 请求均设置了 `timeout`（180-300秒）
+- 区分 rate-limit 错误和普通错误，分别处理
+- 轮询模式（BFL/Replicate）有 `timeout_seconds=300` 上限
+
+**❌ 非图片生成脚本**
+
+| 脚本 | 问题 |
+|------|------|
+| `web_to_md.py` | ✅ 有 timeout=30 |
+| `doc_to_md.py` | ❌ 调用 subprocess 无 timeout |
+| `pdf_to_md.py` | ⚠️ 部分有 try/except，但无重试 |
+| `arch_diagram.py` | ❌ 无任何超时/重试 |
+| `drawio_gen.py` | ❌ 无任何超时/重试 |
+
+### A3. 文件 I/O 编码处理
+
+**✅ 优秀 — 中文处理全面**
+
+统计发现 **70+ 处**显式使用 `encoding='utf-8'`，覆盖了所有文件读写操作：
+- 所有 SVG 文件读写：✅ `encoding='utf-8'`
+- 所有 Markdown 文件读写：✅ `encoding='utf-8'`
+- PPTX XML 生成：✅ `encoding='UTF-8'`
+- Web 抓取：✅ `response.apparent_encoding` 自动检测
+- Windows 终端输出：✅ `svg_position_calculator.py` 专门处理了 `sys.stdout.reconfigure(encoding='utf-8')`
+- `project_manager.py` 使用 `errors="replace"` 容错读取
+
+**⚠️ 潜在问题**: 项目目录中大量文件名包含乱码（如 `svg_final\01_???????????.svg`），说明 Windows 上中文文件名存在编码问题。这是 Windows+PowerShell 的系统级问题，非脚本 bug，但仍影响可靠性。
+
+### A4. 进程中断恢复能力
+
+**❌ 无中间状态保存机制**
+
+- 没有检查点（checkpoint）文件记录已完成的步骤
+- 没有"增量生成"逻辑（不会跳过已生成的 SVG）
+- 如果在 30 页 SVG 生成到第 15 页时中断，需要全部重新生成
+- `svg_to_pptx.py` 无断点续传能力
+
+**缓解因素**:
+- SKILL.md 中的流程设计将述标场景拆分为只需手动生成 9 页（其余 46 页由 `bid_init.py` 复制），降低了重新生成的成本
+- 图片生成的结果保存在 `images/` 目录，不会丢失
+- SVG 文件逐个保存，已生成的不会被覆盖
+
+**建议**: 在 `finalize_svg.py` 和 `svg_to_pptx.py` 中添加"跳过已存在文件"逻辑。
+
+### A5. SKILL.md 中的 Fallback 策略
+
+| 场景 | 是否有 Fallback | 描述 |
+|------|-----------------|------|
+| 图片生成失败 | ✅ 有 | "falls back to pure SVG design for that page. Image generation failure MUST NOT block the pipeline." |
+| SVG 生成失败（单页） | ⚠️ 隐式 | 无显式 fallback 策略。如果某页 SVG 生成失败，SKILL.md 未说明是跳过还是重试 |
+| 子 Agent 执行异常 | ✅ 有 | "If sub-agents fail, generate the 9 manual pages directly using `write` tool — do NOT retry sub-agents in a loop." |
+| SVG 质量检查失败 | ✅ 有 | 提到 `--fix` 自动修复，以及手动修复指引 |
+| PPTX 导出失败 | ❌ 无 | 无 fallback 策略 |
+
+---
+
+## B. 通用性检查
+
+### B1. 特定项目/公司名称硬编码扫描
+
+**扫描关键词**: 星宇车灯、xingyuche、CodeWave、网易、NetEase
+
+| 文件 | 匹配数 | 性质 |
+|------|--------|------|
+| `SKILL.md` | 1 | 示例中的 `"brand": "CodeWave"` — **仅作为 JSON 示例** |
+| `bid-content-template.md` | **50+** | 🔴 **深度硬编码** — 整个 55 页述标内容模板全部写死为网易/CodeWave |
+| `bid-presentation.md` | **30+** | 🔴 **深度硬编码** — 述标大纲结构中固化了网易公司信息 |
+| `company_intro.md` | **15+** | 🔴 **完全硬编码** — 公司介绍3页全部是网易固定内容 |
+| `references/bid-svgs/` | 55个SVG | 🔴 **完全硬编码** — 预制 SVG 全部包含网易/CodeWave 品牌内容 |
+| `projects/` | 全部项目 | 仅作为历史项目存档，不影响通用性 |
+
+**结论**: 
+
+- **自由设计模式（Free Design）**: ✅ **完全通用**。SKILL.md 的主流程不依赖特定公司，模板系统支持 21 种风格，用户可以用任何主题生成 PPT。
+- **述标模式（Bid Presentation）**: ❌ **完全不通用**。55 页结构中 46 页是网易/CodeWave 的固定内容，仅适用于网易智企投标场景。如果用户要生成"医疗行业方案PPT"，述标模式完全无法使用。
+
+**"医疗行业方案PPT"可行性分析**:
+- 使用 Free Design 模式：✅ 完全可行
+- 使用述标模式：❌ 完全不可行（46页网易公司介绍内容无法替换）
+
+### B2. 模板系统检查
+
+**✅ 模板系统设计良好**
+
+| 维度 | 状态 | 详情 |
+|------|------|------|
+| 目录结构 | ✅ 规范 | `templates/layouts/` 按风格分目录，每个含 5 个标准 SVG + design_spec.md |
+| 模板数量 | ✅ 丰富 | 21 种风格（品牌10 + 通用3 + 场景4 + 政务3 + 特殊1） |
+| 索引文件 | ✅ 有 | `layouts_index.json` 提供机器可读的模板索引 |
+| 标准文件 | ✅ 统一 | 每个模板必含 `01_cover.svg, 02_toc.svg, 02_chapter.svg, 03_content.svg, 04_ending.svg` |
+| 自定义模板 | ✅ 支持 | `workflows/create-template.md` 提供模板创建工作流 |
+| 模板切换 | ✅ 方便 | 只需在 Strategist 阶段选择不同 layout 名称 |
+| 图表模板 | ✅ 丰富 | 33 种标准图表模板 |
+| 图标库 | ✅ 丰富 | 640+ 矢量图标 |
+
+**⚠️ netease_zhiqi 模板特殊性**: 该模板有 16 个 SVG（远多于标准 5 个），包含 `03_content_architecture.svg`、`03_content_bullet.svg` 等扩展页面类型。这些额外变体只在该模板中可用，其他模板不具备。
+
+### B3. bid-presentation.md 适配性分析
+
+**❌ 述标流程极度 specific**
+
+| 问题 | 严重程度 | 说明 |
+|------|----------|------|
+| 55 页固定结构 | 🔴 高 | 页面数量、顺序、章节划分全部写死 |
+| 46/55 页为网易内容 | 🔴 高 | 公司介绍、产品功能、技术优势、案例全部是网易/CodeWave |
+| 固定人名 | 🔴 高 | 项目团队页包含具体人名（如"陈飞"） |
+| 固定客户案例 | 🔴 高 | 康明斯、振华重工案例完全写死 |
+| 固定数据 | 🔴 高 | "28年互联网发展史"、"~32000员工"等数据 |
+| 预制 SVG | 🔴 高 | `references/bid-svgs/` 包含 55 个预制 SVG，全部为网易品牌 |
+
+**能否适配不同类型的投标书？**
+
+| 场景 | 可行性 | 工作量 |
+|------|--------|--------|
+| 网易智企其他项目投标 | ✅ 可行 | 仅需修改 9 个动态页 |
+| 网易其他部门投标 | ⚠️ 部分可行 | 需修改产品介绍、案例等约 20 页 |
+| 非网易公司投标 | ❌ 不可行 | 需重写 46 个固定页 + 所有预制 SVG |
+
+---
+
+## 综合评分
+
+| 维度 | 评分 | 说明 |
+|------|------|------|
+| 异常处理 | ⭐⭐⭐☆☆ (3/5) | 关键脚本缺失，但 image_backends 做得好 |
+| API 超时/重试 | ⭐⭐⭐⭐☆ (4/5) | 图片后端优秀，其他脚本欠缺 |
+| 编码处理 | ⭐⭐⭐⭐⭐ (5/5) | 全面且一致 |
+| 中断恢复 | ⭐⭐☆☆☆ (2/5) | 无检查点机制 |
+| Fallback 策略 | ⭐⭐⭐⭐☆ (4/5) | 覆盖了主要场景 |
+| 自由设计通用性 | ⭐⭐⭐⭐⭐ (5/5) | 模板丰富，完全通用 |
+| 述标模式通用性 | ⭐☆☆☆☆ (1/5) | 完全绑定网易/CodeWave |
+| 模板系统 | ⭐⭐⭐⭐⭐ (5/5) | 设计优秀，可扩展 |
+
+---
+
+## 优先修复建议
+
+### P0（关键）
+1. **`svg_to_pptx.py` 和 `svg_page_gen.py` 添加 try/except**：这两个是流水线出口，任何未捕获异常都会导致整个 PPT 生成失败
+2. **述标模式参数化**：将 `bid-content-template.md` 中的公司信息抽取为变量（公司名、产品名、案例等），支持通过配置文件替换
+
+### P1（重要）
+3. **添加增量生成逻辑**：在 `finalize_svg.py` 中检查 `svg_final/` 是否已有对应文件，跳过已完成的页面
+4. **`arch_diagram.py` 添加异常处理**：JSON 解析失败时给出明确错误信息
+5. **SVG 单页生成失败 fallback**：在 SKILL.md 中明确说明某页 SVG 生成失败时的处理策略（跳过/占位/重试）
+
+### P2（改进）
+6. **述标 SVG 预制件参数化**：将 `references/bid-svgs/` 中的 SVG 改为模板，支持变量替换
+7. **添加进度跟踪文件**：在项目目录中维护 `progress.json` 记录各步骤完成状态
+8. **`doc_to_md.py` subprocess 调用添加 timeout**