中期成果提交：PPT自动生成 Agent（感知-规划-行动-记忆闭环 + aura-ppt 渲染引擎 + Web 交互界面 + 测试用例 + AI 使用日志）

2026-08-31 09:53:11 +08:00
commit 883a89682b
50 changed files with 10355 additions and 0 deletions
@@ -0,0 +1,84 @@
+# aura-ppt 中文排版规范（Chinese Typography Rules）
+
+> 灵感来源：WPS AI 中文理解（9.5分）的排版能力。目标是让生成的PPT在中文场景下"看起来就是中国人做的"。
+
+## 1. 中英混排规则
+
+| 场景 | 规则 | 正确 | 错误 |
+|---|---|---|---|
+| 中文与英文之间 | 加半角空格 | 使用 Python 开发 | 使用Python开发 |
+| 中文与数字之间 | 加半角空格 | 共 25 个项目 | 共25个项目 |
+| 中文与括号之间 | 不加空格 | 系统（SaaS 模式） | 系统 （SaaS 模式） |
+| 全角标点后 | 不加空格 | 项目，包括 | 项目， 包括 |
+
+## 2. 标点规范
+
+- 中文语境：全角标点 `，。：；！？（）「」`
+- 引用书名：`《》`；强调引用：`「」` 或 `“”`
+- 英文/数字语境：半角标点 `,.:;!?()`
+- 列表序号：`1. 2. 3.` 后跟半角空格
+- **禁止**：中文文本中出现半角逗号、句号（`，` 不能写成 `,`）
+
+## 3. 日文文本规则（对日业务）
+
+- 日文与中文之间**不加空格**（区别于中英混排）
+- 日文假名（ひらがな/カタカナ）保持全角原样
+- 日文术语原样保留：`要件定義書`、`テスト仕様書`、`結合テスト`、`納品物`
+- 日文引号用「」；中文引号用「」或“”（两者视觉接近，混排时可统一）
+- 中日双语并列时建议：中文为主行，日文为副行（括号内或下方小字）
+
+## 4. 数字与单位
+
+- 千位分隔：`1,000,000`（四个零以上必须分隔）
+- 百分比：紧贴数字 `96.8%`（**不得四舍五入**，见内容保真规则）
+- 金额：中文用 `万元/亿元`，日文用 `万円/億円`
+- 日期：中文 `2024年3月15日`；日文 `2024年3月15日`（可互用）
+- 版本号：`v1.2.0` 保持原样
+
+## 5. 字体回退链
+
+```
+中文：微软雅黑 (Microsoft YaHei) → 思源黑体 → 系统默认
+日文：Yu Gothic (游ゴシック) → メイリオ (Meiryo) → 微软雅黑
+英文：Segoe UI → Arial → Helvetica
+```
+
+**字体选择逻辑**：
+- 页面文本含中文字符 → 用中文字体（日文字体也能显示中文，但笔画风格不同）
+- 页面文本仅日文 → 用日文字体（Yu Gothic），注意日本汉字与中文字形差异（如 骨/骨、直/直）
+- 页面文本纯英文/数字 → 用英文字体
+- 同一文本框内中日混合 → 统一用中文字体（微软雅黑对日文假名支持良好）
+
+## 6. 字号层级
+
+| 层级 | 字号 | 字重 | 用途 |
+|---|---|---|---|
+| 封面主标题 | 40-44pt | Bold | 仅封面 |
+| 章节页标题 | 32-36pt | Bold | section 页 |
+| 页面标题 | 24-28pt | Bold | header |
+| 小标题 | 18-20pt | SemiBold | 卡片标题 |
+| 正文 | 15-17pt | Regular | 主体内容 |
+| 辅助文字 | 12-13pt | Regular | 图例、注释 |
+| 脚注 | 10-11pt | Regular | 备注、来源 |
+
+## 7. 排版规则
+
+- **行长限制**：每行不超过 28 个中文字符（约 14.5cm 宽度 @16pt）
+- **行距**：正文 1.3-1.5 倍；标题 1.1-1.2 倍
+- **段距**：段间 8-12pt（比行距略大，形成视觉分组）
+- **对齐**：中文正文用左对齐（禁两端对齐导致字距拉伸）；标题左对齐
+- **避头尾**：行首禁标点（。，、；：）——用换行处理
+- **孤行控制**：禁止标题出现在页面最后一行
+
+## 8. 中日双语排版示例
+
+```
+正确示例（中文主行 + 日文副行）：
+テスト工程の品質向上
+测试工程品质提升
+（テスト仕様書 23 件 → 欠陥検出率 96.8%）
+
+错误示例：
+混合排版且无逻辑分组，中英日混杂在一个段落中，
+读者难以快速定位关键信息
+```
@@ -0,0 +1,115 @@
+# aura-ppt 内容保真规则（Content Fidelity Rules）
+
+> 灵感来源：7牛AI PPT"保持原文"模式（内容保真实测最优）。
+> **最高原则：AI只负责结构、排版、设计，绝不改写用户的数据与术语。**
+
+## 为什么内容保真如此重要
+
+对日外包场景的汇报材料通常包含：
+- 客户合同的精确数字（工数、单价、納期）
+- 测试结果数据（欠陥検出率、テストケース数）
+- 日本客户的专业术语（仕様書、結合テスト、納品物）
+- 法律/合规条款原文
+
+**任何一处数字被"润色"，都可能造成客户信任危机或合规问题。** 这正是我们把内容保真设为最高优先级的原因。
+
+## 保真规则（按优先级排序）
+
+### R1. 数字逐字符保留
+
+用户提供的任何数值在最终PPT中必须**逐字符一致**：
+
+```
+输入: 96.8%    输出: 96.8%     ❌ 禁止: 约97% / 近97% / 96.8%左右
+输入: 23.6%    输出: 23.6%     ❌ 禁止: 24% / 23% / 约24%
+输入: ¥5,000万 输出: ¥5,000万  ❌ 禁止: 5000万 / ¥5000万 / 数千万
+输入: 3.14     输出: 3.14      ❌ 禁止: 3 / 3.1 / π
+输入: 2024年3月 输出: 2024年3月  ❌ 禁止: 2024年Q1 / 2024年 / 去年3月
+```
+
+### R2. 术语原样保留
+
+专有名词、产品名、客户名、日文术语**不得意译、不得替换、不得加释义**：
+
+```
+输入: テスト仕様書     输出: テスト仕様書   ❌ 禁止: 测试规格书 / 测试规格说明书
+输入: 要件定義         输出: 要件定義       ❌ 禁止: 需求定义（除非用户明确要求双语）
+输入: [顧客A]         输出: [顧客A]        ❌ 禁止: 客户A / 甲方 / 某客户
+输入: SAP ERP        输出: SAP ERP        ❌ 禁止: SAP / 企业资源计划系统
+```
+
+### R3. 引用与条款原文保留
+
+用户提供的引用、条款、数据来源标注，**一字不改**，包括标点：
+
+```
+输入: 「納品物とは、要件定義書、設計書、テスト仕様書及びプログラム一式をいう。」
+输出: 必须逐字呈现（含「」与日文标点）
+```
+
+### R4. 结构可重组，内容不可改写
+
+允许：
+- ✅ 重新分页、分组、调整层级（把5个要点分到2页）
+- ✅ 提炼副标题、加导航性文字（"本章节将说明…"）
+- ✅ 调整顺序（按逻辑重排用户内容）
+
+禁止：
+- ❌ 改写用户句子含义（保持原意是底线）
+- ❌ 合并/拆分用户数据点
+- ❌ 为"更简洁"删除用户的限定词（如"约"、"可能"、"部分"）
+- ❌ 补充用户未提供且无依据的数据
+
+### R5. AI补充内容必须区分
+
+LLM为连接上下文而生成的新内容（过渡句、总结、建议），必须与用户内容可区分：
+- 方式1：加 `[AI补充]` 前缀（用户可见时）
+- 方式2：放入演讲者备注（notes字段），正文只放用户内容
+- 方式3：内容基调明显不同（如"本章总结"这类导航句）
+
+**推荐方式2**：正文保真，AI的加工藏在备注里。
+
+## 实施机制
+
+### 渲染引擎内置检查（--verify）
+
+```
+验证流程：
+1. 从 plan.json 提取所有源数字（正则: -?\d+[\d,]*\.?\d*\s*[%％]?）
+2. 从输出PPTX提取全部文本
+3. 逐一比对：每个源数字必须出现在输出文本中
+4. 术语检查：含中日文字符的长片段（≥6字符）必须原样出现
+5. 任何缺失 → 验证失败 → 返回缺失清单
+
+运行：
+python scripts/engine.py --verify output.pptx --plan plan.json
+```
+
+### 流程保障
+
+1. **plan.json 是唯一内容源**：渲染引擎只读 plan.json，不产生任何内容
+2. **LLM只负责规划**：LLM把用户内容结构化进 plan.json，不改写内容本身
+3. **渲染零改写**：engine.py 是纯渲染器，代码中不存在任何文本改写逻辑
+4. **生成后必验证**：每次生成自动跑 --verify，偏差立即报告
+
+## 常见违规与正确做法
+
+| 场景 | 错误（违规） | 正确 |
+|---|---|---|
+| 数字美化 | 32个数据点"96.8%"→"约97%" | 96.8% 原样 |
+| 术语翻译 | 要件定義→需求定义 | 要件定義（除非用户要求双语） |
+| 删除限定 | "部分系统不支持"→"系统不支持" | 保留"部分" |
+| 补数据 | 用户没说→AI加"市占率30%" | 不添加无依据数据 |
+| 简化条款 | 合并两条合同条款 | 逐字呈现 |
+
+## 与"AI辅助"的边界
+
+内容保真 ≠ 拒绝一切AI加工。AI可以：
+- ✅ 优化组织（分页、分组、加导航）
+- ✅ 补充演讲者备注（notes）
+- ✅ 生成目录、章节标题、过渡句（明确为AI补充）
+- ✅ 设计排版（字色、字号、图表类型）
+
+AI不可以：
+- ❌ 改用户的数据、术语、引用、限定词
+- ❌ 编造用户未提供的信息
@@ -0,0 +1,296 @@
+# aura-ppt 设计系统规范
+
+> 灵感来源：Gamma 设计质量（9.2分）。内置多套深度定制的设计系统。
+
+## 设计系统清单
+
+| 系统名 | 风格 | 适用场景 |
+|---|---|---|
+| `aura-dark`（默认） | 深色高级（深蓝黑+电光青） | 科技感、对外提案、产品发布 |
+| `business-report` | 浅色商务（白底+火焰蓝+商务红） | **商务报告、管理层汇报、咨询风格** |
+| `report-jp` | 日式商务报告（法人蓝+浅天蓝卡片+Meiryo UI） | **日本客户汇报、本部報告会、对日业务** |
+
+---
+
+## 0. 全局视觉规范（所有设计系统共用）
+
+### 卡片视觉
+- **柔和投影**：所有卡片容器自动带外投影（blur 90000 / dist 45000 / 25%透明度深灰），立体悬浮感
+- **圆角**：radius 8%（圆角矩形 adjustment）
+- 卡片左色条（随图表色板序号变色）
+
+### 图表视觉
+- **渐变柱体**：柱状图垂直渐变（顶部提亮45% → 底部原色），模拟立体感（XML gradFill）
+- **协调色板**：每系统6色光谱序列（冷→暖过渡），相邻柱区分度清晰
+- 水平网格线（3条辅助）+ 数值标签 + 类别标签（防截断）
+
+### 排版层级（typography）
+统一语义化字号，修改只需改设计系统 `typography` 字典：
+
+| 语义 | 字号 | 用途 |
+|---|---|---|
+| cover_title | 38 | 封面主标题 |
+| cover_subtitle | 18 | 封面副标题 |
+| section_title | 34 | 章节页标题 |
+| page_title | 22 | 页面标题 |
+| card_title | 16 | 卡片标题 |
+| body | 15 | 正文 |
+| body_small | 13 | 双栏/卡片内文字 |
+| table_head / table_cell | 13 / 12 | 表格 |
+| chart_label / chart_cat | 12 / 9 | 图表标签 |
+| footer / notes | 9 / 10 | 页脚/辅助 |
+
+### 页面结构装饰
+- report-jp 页眉装饰线（主色细线 + 左端1.6in锚点块）
+- 章节页装饰（左侧竖条 + 底部横线）
+- 内容区背景层（模板模式：body 区极浅色分区，与母版背景区分）
+
+---
+
+## 3. report-jp 设计系统（日式商务报告）
+
+> 参考：日本本部报告会资料（010_【本部長報告会】2026年7月度_AI推進部.pptx）。
+> 法人蓝 #0B3D91 + 浅天蓝卡片 #B7DEE8 + Meiryo UI 字体，日企报告标准样式。
+
+### 设计令牌
+
+| 令牌 | 色值 | 用途 |
+|---|---|---|
+| `page` | **10.83 × 7.5 in**（非标准比例） | 页面画布 |
+| `bg` | `#FFFFFF` | 页面背景（纯白） |
+| `bg2` | `#F5F7FB` | 交替行/次级背景 |
+| `panel` | `#E8EAF6` | 面板（浅蓝灰） |
+| `panel2` | `#DDE3F2` | 面板暗 |
+| `card_fill` | `#B7DEE8` | **卡片填充（浅天蓝）** |
+| `line` | `#C9D4E8` | 分隔线 |
+| `text` | `#1A1A1A` | 正文（黑色，日企惯例） |
+| `text_dim` | `#556070` | 辅助文本 |
+| `primary` | `#0B3D91` | 主色：**法人蓝** |
+| `secondary` | `#1976D2` | 次级：Material蓝 |
+| `accent` | `#C00000` | 强调红（警示/机密） |
+| `success` | `#2E7D32` | 正向（绿） |
+| `danger` | `#C00000` | 警示（红） |
+
+### 图表色板（协调渐变：蓝→青→绿→金→橙）
+
+```
+#0B3D91 深法人蓝 → #2E74B5 中蓝 → #0099CC 青蓝 → #26A69A 青绿 → #F2B134 琥珀金 → #EF6C00 橙
+```
+
+**渐变柱体**：柱状图使用垂直渐变（顶部提亮45% → 底部原色），模拟立体感。
+
+### 字体
+
+```
+日文：Meiryo UI（日企标准，微软雅黑日文版）
+中文：微软雅黑 ｜ 英文：Segoe UI
+```
+
+### 特色组件
+
+1. **日式页眉**：页面 plan 支持 `section_no`（如 "1"），渲染为 `1.  标题（x/y）` 编号格式
+2. **机密标记**：plan 顶层或页面支持 `confidential`（如「機密情報」「社外秘」），右上角红色标签
+3. **流程图**：`flowchart` 页面类型，浅天蓝卡片 + 法人蓝标题 + 箭头（支持横向流程与泳道两种模式）
+4. **卡片式布局**：参考PPT的浅天蓝卡片（#B7DEE8）作为内容容器
+
+### 风格要点
+- 法人蓝（#0B3D91）是日本企业标准的"企业蓝"，庄重、权威
+- 正文用黑色（日企报告惯例，不同于中式报告的深灰）
+- 卡片用浅天蓝而非浅灰——日式报告特有的清爽感
+- 标题字号相对 16:9 版本略小（22pt），因为页面更窄（10.83in）
+- 机密标记红色标签是日企报告标配（機密情報/社外秘/取扱注意）
+
+---
+
+## 1. business-report 设计系统（商务报告风格 · 火焰蓝）
+
+> 灵感来源：麦肯锡/BCG 咨询报告、PowerPoint 商务模板。浅色底、克制的信息层次、清晰可打印。
+> 主色为**火焰蓝**（消防救援标志蓝 `#1E50A2`）——庄重、专业、辨识度高。
+
+### 设计令牌
+
+| 令牌 | 色值 | 用途 |
+|---|---|---|
+| `bg` | `#FFFFFF` | 页面背景（纯白） |
+| `bg2` | `#F5F6FA` | 交替行/次级背景 |
+| `panel` | `#F4F6FA` | 卡片/面板背景（浅灰） |
+| `panel2` | `#ECEFF5` | 面板暗色变体 |
+| `line` | `#D8DEE9` | 分隔线/边框（浅灰） |
+| `text` | `#1F2937` | 主文本（深灰） |
+| `text_dim` | `#6B7280` | 辅助文本（中灰） |
+| `primary` | `#1E50A2` | 主色：**火焰蓝**（标题/强调） |
+| `accent` | `#C00000` | 强调色：商务红（关键数字/警示） |
+| `secondary` | `#3B78C4` | 次级：亮蓝 |
+| `success` | `#228B22` | 正向（墨绿） |
+| `danger` | `#C00000` | 警示（红） |
+
+### 图表色板（火焰蓝系列）
+
+```
+#1E50A2 火焰蓝 → #3B78C4 亮蓝 → #C00000 红 → #ED7D31 橙 → #70AD47 绿 → #7030A0 紫
+```
+
+### 风格要点
+- **白色底 + 火焰蓝标题**：商务报告经典组合，庄重专业，打印友好
+- **商务红点睛**：与火焰蓝形成经典"蓝+红"组合，只用于关键数字、强调语句、风险标识
+- **浅灰卡片**：F4F6FA 面板 + D8DEE9 细边框，层次靠灰阶而非色块
+- **克制的装饰**：无光晕、无渐变背景，纯网格对齐——信息优先
+- **表格**：表头火焰蓝底白字（primary），交替行 bg2/panel
+- **pill 文字**：浅色系统下 pill 上文字用白色（深色系统用底色）
+
+---
+
+## 2. aura-dark 设计系统（深色高级）
+
+### 设计令牌（Design Tokens）
+
+| 令牌 | 色值 | 用途 |
+|---|---|---|
+| `bg` | `#0B0E14` | 页面背景（深蓝黑） |
+| `bg2` | `#11151F` | 交替行/次级背景 |
+| `panel` | `#171D2B` | 卡片/面板背景 |
+| `panel2` | `#121722` | 卡片暗色变体 |
+| `line` | `#273042` | 分隔线/边框 |
+| `text` | `#F0F2F5` | 主文本（近白） |
+| `text_dim` | `#8A93A3` | 辅助文本（灰蓝） |
+| `primary` | `#2ECCFF` | 主色：电光青（强调/标题/链接） |
+| `accent` | `#FFC94D` | 强调色：琥珀金（里程碑/高亮） |
+| `secondary` | `#A78BFA` | 辅助色：霓虹紫（次强调） |
+| `success` | `#3DD68C` | 成功/正向（绿色） |
+| `danger` | `#FF6B6B` | 警示/风险（红色） |
+
+### 图表色板（6色序列）
+
+```
+#2ECCFF → #FFC94D → #A78BFA → #3DD68C → #FF8A65 → #5C9DFF
+```
+
+### 度量
+
+| 令牌 | 值 | 说明 |
+|---|---|---|
+| `margin` | 0.55 in | 页面四边距 |
+| `grid` | 0.2 in | 垂直节奏网格 |
+| `radius` | 6% | 圆角卡片弧度 |
+| `content_w` | 12.23 in | 内容区宽度（16:9） |
+| `page` | 13.333 × 7.5 in | 16:9 画布 |
+
+### 字体
+
+```
+标题: 微软雅黑 Bold（日文场景: Yu Gothic Bold）
+正文: 微软雅黑 Regular（日文场景: Yu Gothic）
+英文/数字: Segoe UI
+```
+
+## 2. 组件库
+
+### 2.1 封面（cover）
+
+```
+[左上光晕装饰]          [kicker 标签: 14pt 主色]
+                       [主标题: 42pt Bold 近白]
+                       [副标题: 18pt 灰蓝]
+                       [内容要点: 15pt 灰蓝, 行距1.5]
+                       [主色横线: 2.8in × 2.5pt]
+[底部深色条: 0.6in 高]  [备注/日期: 11pt]
+```
+
+### 2.2 目录（toc）
+
+```
+[页头: 左侧主色竖条 + 标题 + 分隔线]
+[内容区: 2列网格, 卡片 5.9×1.35in]
+每卡片: [编号 28pt 主色] + [条目 16pt Bold]
+```
+
+### 2.3 章节页（section）
+
+```
+[kicker: "SECTION 01" 14pt 主色]
+[标题: 36pt Bold]
+[内容: 16pt 灰蓝]
+留白为主，营造节奏感（章节间呼吸）
+```
+
+### 2.4 内容页（content）
+
+```
+[页头: 标题 26pt Bold + 可选副标题 + 分隔线]
+[正文: 16pt, 行距1.4, 段距8pt]
+[要点: 每个要点一行, 支持 **加粗** 强调]
+[页脚: 页码 10pt 右下角]
+```
+
+### 2.5 双栏页（two_column）
+
+```
+[两卡片 5.9in 宽, 间隔0.4in]
+每卡片: [栏目标题 18pt Bold 主色] + [内容 14pt 行距1.4]
+```
+
+### 2.6 表格页（table）
+
+```
+[表头: 深色背景 + 主色文字 13pt Bold, 居中]
+[交替行: bg2/panel]
+[单元格: 12pt, 垂直居中]
+[行高: 0.62in, 表头高0.55in]
+```
+
+### 2.7 图表页（chart）
+
+```
+[图表卡片: panel背景, 圆角]
+[图例: 右上角横排, 色块+标签 11pt]
+[数据标签: 11pt Bold 显示实际值（不省略）]
+[柱状图: 圆角柱, 2倍柱宽间距]
+[折线图: 主色3pt线 + 数据点圆点]
+[饼图: 扇区 + 数值标签]
+```
+
+### 2.8 时间线（timeline）
+
+```
+[水平主线: 2pt 灰蓝]
+[节点: 主色圆点 0.16in]
+[阶段标题: 13pt Bold 主色]
+[描述: 10pt 灰蓝, 最多2行]
+```
+
+### 2.9 引言页（quote）
+
+```
+[左侧主色竖条 0.09×2.2in]
+[引言: 26pt Bold, 行距1.4]
+[出处: 13pt Bold 琥珀金]
+```
+
+### 2.10 结束页（end）
+
+```
+[标题: 40pt Bold "谢谢" / "Thank you"]
+[内容: 16pt 灰蓝]
+[主色横线: 2.8in × 2.5pt]
+```
+
+## 3. 布局原则
+
+1. **留白优先**：每页元素不超过 6 个视觉组，大量留白营造高级感
+2. **对齐网格**：所有元素对齐 0.2in 网格，杜绝随意摆放
+3. **主色克制**：主色只用于强调（标题条、关键数字、链接），大面积用中性色
+4. **视觉节奏**：章节页制造呼吸感，内容页信息密度适中
+5. **统一性**：同类型页面必须使用相同组件与布局（可预测性）
+
+## 4. 对比度与可读性
+
+- 正文对比度：`#F0F2F5` on `#0B0E14`（≈15.8:1，远超 WCAG AA）
+- 主色文本 on 深底：`#2ECCFF` on `#0B0E14`（≈9.1:1）
+- 辅助文本 on 深底：`#8A93A3` on `#0B0E14`（≈4.6:1，满足 AA）
+- 琥珀金 on 深底：`#FFC94D` on `#0B0E14`（≈11.5:1）
+- **禁止**：主色/琥珀金作为大面积背景（只用于点缀与强调）
+
+## 5. 扩展设计系统
+
+新增设计系统时，在 `engine.py` 的 `DesignSystem` 类中创建同名子类并重写令牌。
+plan.json 的 `design` 字段引用系统名（默认 `aura-dark`）。