火一五 PPT 技能 v3.2

Design tokens + 11 页面模板 + 21 套生产级审美方案 — 青岛火一五信息科技有限公司

一、核心理念

v2.x 是「色卡游戏」——只改 primary/accent 两个颜色就叫一个新风格。v3.0 重写成真正的设计系统：

StylePack = Palette + Typography + Spacing + Elevation + Decoration + Canvas

每一层都是独立的 tokens，单一风格对应一整组 tokens。例如「Apple 发布会」不只是「黑底」，而是：

• Palette：纯黑 #000000 底 + 4 级灰阶文字 + Apple 蓝 #0A84FF
• Typography：SF Pro Display + hero 160pt + 负字距 -3% + 行高 0.95
• Spacing：8pt grid + hero 页左右留白 1.2"
• Elevation：完全 flat，无阴影
• Decoration：居中对齐、英文全大写、不显示页脚

v3.1 在 Decoration 层追加了六件套科技装饰，每个 pack 都能独立开关：

科技风由此而来——每张 slide 都能直接当品牌海报/社媒头图使用。

二、6 套审美方案

2.1 apple-keynote —— 真·发布会

• 配色：纯黑 #000000（不是深蓝！）+ 白灰文字 + Apple 品牌蓝
• 字体：SF Pro Display + SF Pro Text
• hero 字号：160pt（是 v2 的 2.5 倍，带自动 fit 避免 CJK 溢出）
• 装饰：完全居中、英文小字全大写（INTRODUCING / SCALE）、不显示页脚
• big_stat 字号：280pt — "2B" 一张页的视觉锚点

2.2 apple-light —— 产品页白场

• 配色：纯白 + Apple.com 的卡片灰 #F5F5F7 + 链接蓝 #0071E3
• 字体：SF Pro Display
• hero 字号：120pt
• 卡片：无描边，圆角 0.18"，靠填色区分
• 装饰：居中对齐、英文不全大写

2.3 xiaohongshu-creator —— 奶油生活博主

• 配色：奶油 #FBF7F0 底 + 焦糖咖 #3E2E1F 主文字 + 鼠尾草绿 #9FAE8B 点缀
• 字体：Noto Serif SC（衬线！）+ PingFang SC 正文
• hero 字号：72pt + 正字距 +2%（衬线字撑开）
• 装饰：左对齐、标题左侧竖条 accent bar、圆角 0.22" 卡片 + 微阴影
• 特色：文字不用纯黑而用焦糖咖色，配 sage green accent 做博主的温度

2.4 xiaohongshu-vintage —— 复古胶片

• 配色：复古米 #F2EAD9 + 深栗咖 #4A3526 文字 + 雾霾蓝 #A8B8C6 accent
• 字体：Noto Serif SC（标题和正文都衬线，强化胶片感）
• hero 字号：64pt + 更松字距 +3% + 高行高 1.2
• 装饰：封面顶/底装饰横线、卡片直角 0.08" 有描边（胶片边框感）

2.5 tech-neon —— 科技霓虹（赛博黑蓝）🆕

• 配色：深蓝黑 #050510 底 + 冷灰蓝文字 + 电青 #00D9FF 主 accent + 电紫 #7C3AED 辅 accent
• 字体：Inter（SF Pro 兜底）+ JetBrains Mono 做 caption/metadata
• hero 字号：144pt + 左对齐 + 负字距 -2.5%
• 装饰：全系六件套全开——对角微渐变背景 + 细线网格 + 四角 L 型刻度 + hero/stat 辉光 halo + 左下 BUILD · 日期 dev badge + 等宽小字 metadata
• accent_gradient：#00D9FF → #7C3AED（电青→电紫），PowerPoint/Keynote 下 hero 大字显示渐变
• big_stat 字号：260pt + 辉光叠加——"42ms" 这种数字直接发光
• 场景：AI 发布会、基础设施产品、赛博朋克叙事、黑客马拉松

2.6 tech-minimal —— 科技极简（Vercel/Linear 风）🆕

• 配色：近黑 #0A0A0F 底 + 暖白文字 + 电紫 #8B5CF6 单色 accent
• 字体：Inter + JetBrains Mono
• hero 字号：120pt + semibold（不过粗）+ 左对齐
• 装饰：点阵背景（不是网格） + subtle halo + 左下 V2026 · BUILD XXXX 等宽版本戳 + 无四角刻度（更克制）
• 卡片：细描边 #1F1F28 + 轻量圆角 0.1"——Vercel/Linear 文档感
• 场景：SaaS 产品主页、DevTool 推销、企业级软件 landing page、B 端销售 pitch

三、11 个页面模板

所有模板自动：

• 按 StylePack 的 tokens 绘图 — 换 pack 整套风格变
• 自动 fit 大字号 — hero/section/big_stat/kpi/cta 的大字按宽度约束自动缩放，避免 CJK 长文本溢出换行
• 按 decoration 切换布局 — 居中/左对齐/accent bar/装饰线 都由 pack 控制
• 科技风 pack 下，hero_cover / section_divider / big_stat 会自动叠加 glow halo + dev badge + accent gradient（Keynote/PowerPoint 渲染端）
• 支持 6 个 v3 pack + 3 个 v2.x legacy pack 全兼容

四、JSON deck 规约

{
  "year": "2026",
  "slides": [
    { "type": "hero_cover",
      "eyebrow": "INTRODUCING",
      "title": "M4 Ultra.",
      "subtitle": "地球上最强的芯片。",
      "footnote": "Apple · Cupertino · 2026" },

    { "type": "section_divider",
      "number": "01",
      "title": "Performance",
      "subtitle": "性能" },

    { "type": "big_stat",
      "caption": "CPU PERFORMANCE",
      "value": "2x",
      "unit": "比 M3 Ultra 快",
      "footnote": "基于实际应用工作负载",
      "accent": true },

    { "type": "kpi_triple",
      "title": "重要数字",
      "en_sub": "Key Metrics",
      "items": [
        { "value": "192", "label": "GB 统一内存", "caption": "整张内存池共享" },
        { "value": "80B",  "label": "晶体管",      "caption": "3nm 工艺" },
        { "value": "4TB/s","label": "内存带宽",    "caption": "AI 推理飞起" }
      ] },

    { "type": "quote_card",
      "quote": "One more thing…",
      "author": "Tim Cook",
      "role": "Apple CEO" },

    { "type": "content_list",
      "title": "我们做了什么",
      "en_sub": "What We Did",
      "numbered": true,
      "items": [
        { "label": "重构设计系统", "desc": "把审美分解成 tokens" },
        { "label": "10 个语义模板", "desc": "hero / section / stat / ..." }
      ] },

    { "type": "compare_columns",
      "title": "升级对比",
      "en_sub": "Before vs After",
      "emphasize": "right",
      "left":  { "label": "BEFORE", "title": "色卡游戏", "items": ["..."] },
      "right": { "label": "AFTER",  "title": "审美方案", "items": ["..."] } },

    { "type": "product_shot",
      "title": "产品页",
      "kicker": "NEW",
      "subtitle": "Apple.com 风的大图 + 侧栏叙事",
      "bullets": ["图占大块面积", "文字简洁克制"],
      "image": "/tmp/shot.png",
      "layout": "right" },

    { "type": "timeline",
      "title": "产品演进",
      "en_sub": "Timeline",
      "events": [
        { "time": "2024", "label": "v1.0", "desc": "乔布斯暗蓝" },
        { "time": "2026", "label": "v3.0", "desc": "tokens + 4 pack" }
      ] },

    { "type": "code_block",
      "title": "Quickstart",
      "en_sub": "5 LINES OF CODE",
      "filename": "app.py",
      "language": "python",
      "code": "from synapse import Client\
\
client = Client(api_key=\"sk-...\")\
resp = client.chat(model=\"synapse-ultra\", messages=[{\"role\": \"user\", \"content\": \"Hi\"}])\
print(resp.content)",
      "highlight_lines": [4],
      "caption": "pip install synapse-ai · 官方 Python SDK" },

    { "type": "call_to_action",
      "title": "Thank You.",
      "subtitle": "一起做有设计感的幻灯片",
      "cta": "[email protected]",
      "footnote": "火一五 · openclaw-ppt v3.1" }
  ]
}

code_block 字段

• filename：文件名标签（如 app.py）
• language：语言提示，仅用于 UI 显示（python / shell / ts / go / ...）
• code：原始代码字符串（\ 分行，保留缩进，自动用不换行空格还原）
• highlight_lines：要高亮的行号数组（1-based），会在该行涂一层 accent_soft
• caption：代码块下方小字说明

五、命令行

# 列出所有 pack
python3 scripts/create-pptx.py --list-packs

# 列出所有 template
python3 scripts/create-pptx.py --list-templates

# 1. 按 JSON 生成完整 deck（推荐）
python3 scripts/create-pptx.py \
  --pack apple-keynote \
  --spec ./deck.json \
  --output /tmp/deck.pptx

# 2. 快速试样封面
python3 scripts/create-pptx.py \
  --pack 博主风 \
  --cover "关于做幻灯片这件小事|写给刚入行的小伙伴" \
  --year 2026 \
  --output /tmp/cover.pptx

# 3. 老的 --style 兼容（等价于 --pack）
python3 scripts/create-pptx.py --style jobs-dark --spec deck.json -o out.pptx

公司名解析顺序：--company > ~/.huo15/company-info.json > 青岛火一五信息科技有限公司（默认）。

六、示例 decks

examples/decks/ 提供 6 份对应 6 套 pack 的完整样例：

对应的渲染预览放在 examples/previews/*.png（共 39 张）。科技风 deck 的任意单张都可以直接导出当品牌海报或 LinkedIn/小红书头图使用。

七、触发词

• 做 PPT / 生成 PPT / 制作 PPT / 写 PPT
• Apple 发布会 / 发布会风 / 苹果风格 / 官网风
• 小红书博主 / 博主风 PPT / 生活博主 / 奶油风
• 复古胶片 / 胶片风 / 复古 PPT / 文艺风
• 科技风 / 霓虹 / 赛博 / 赛博朋克 / cyberpunk / AI 发布会
• 极简科技 / Vercel / Linear / SaaS / DevTool pitch / 品牌海报
• 封面 / 分章页 / 大字页 / KPI / 对比页 / 时间线 / 代码块 / 封底
• 第 X 页 / 继续 / 加一页

八、选 pack 指南

科技风两兄弟的区别：

• tech-neon = 品牌海报级装饰全开（渐变背景 + 网格 + 四角刻度 + glow halo + dev badge + 等宽 metadata），电青/电紫双 accent，适合对外宣发
• tech-minimal = 产品官网级克制装饰（点阵 + 微光 + 左下版本戳），单色紫 accent，适合对内汇报/产品主页

九、技术细节

9.1 Design tokens 层次

StylePack
├── Canvas       画布尺寸（默认 13.33×7.5" 16:9）
├── Palette      3 级背景 + 4 级文字 + accent + accent_soft + border/divider
├── Typography   display/body/mono 三字体 stack + 6 级字号阶梯 + 字重 + 字距 + 行高
├── Spacing      8pt grid — gutter/stack_sm/md/lg/xl + margin_x/margin_x_hero
├── Elevation    card_radius + stroke + 假阴影（python-pptx 无真阴影）
└── Decoration   cover 对齐、accent bar、tag_style、stat_hero_size、image_treatment
                 ▼ v3.1 新增六件套科技装饰字段：
                 ├── gradient_bg: (from, to, angle)   对角线性渐变铺满底板
                 ├── accent_gradient: (from, to)      大字文字渐变（PowerPoint/Keynote 端）
                 ├── grid_overlay / grid_*            细线网格层（色/间距/粗细可调）
                 ├── dot_grid / dot_*                 点阵背景层（替代 grid）
                 ├── glow_accent / glow_strength      accent 大字辉光 halo
                 ├── corner_marks / corner_*          四角 L 型取景框刻度
                 ├── dev_badge / dev_badge_template   左下等宽版本戳（{year}/{date}/{build}）
                 ├── mono_font / mono_fallbacks       JetBrains Mono / Menlo / Monaco stack
                 └── scanline / scanline_color        水平扫描线（CRT 怀旧）

9.2 字距（tracking/letter-spacing）

python-pptx 官方 API 不支持字距。v3.0 在 templates/helpers.py::_set_run_spacing 里用 OOXML XML 注入 \x3Ca:rPr spc="N">，单位是 1/100 pt。hero 大字用 -3% em（收紧），衬线字用 +2% em（展开）。

9.3 Auto-fit 大字号

hero/section/big_stat/cta 的文本在 fit_font_size(text, width, base_size) 里自动缩放，防止 CJK 长文本换行撞副标题。宽度估算按 CJK 1.1em / 大写 0.75em / 小写 0.62em / 标点 0.38em，留 12% 安全余量。

9.4 假阴影

xhs-creator 开启 use_fake_shadow=True，在卡片下方偏移 0.06" 画一个比卡片色深的色块模拟阴影。python-pptx 没有真阴影 API。

9.5 与 v2.x 兼容

• --style 参数保留，等价于 --pack
• legacy pack（jobs-dark, xiaohongshu, xiaohongshu-portrait）仍可用
• JSON 字段 en_subtitle 自动映射到 en_sub，sub 自动映射到 subtitle
• slide type cover/section/list/quote/end 仍能跑，走 templates 注册表的别名

9.6 科技风装饰实现（v3.1）

六件套装饰都通过 OOXML XML 直接注入实现（python-pptx 的 dataclass API 覆盖不全）。核心函数在 templates/helpers.py：

已知限制：

• apply_text_gradient 只在 PowerPoint/Keynote 下可见；LibreOffice/Impress 渲染会回落成 solid（因为 Impress 不支持文字 gradFill）——生成 PDF 预览时 hero 大字看上去是单色 accent，但实际 pptx 打开在 mac Keynote/Windows PowerPoint 下会显示渐变。
• glow_accent 的 halo 用多层半透明椭圆模拟，不是 PowerPoint 真正的 glow effect（python-pptx 没暴露 effect API）。视觉效果在 PDF/PNG 预览下接近真 glow。
• 装饰层都是画在背景之上、文本之下（new_slide 里按顺序绘制），不会遮挡正文。

十、版本历史

• v3.2.0（当前）：生产级审美升级 — 21 套预设精品风格
  • 新增 12 套预设 pack（对应历史名作 / 经典设计运动 / 苹果最新 OS）：
    • 🍎 liquid-glass — Apple macOS 26 / iOS 26 液态玻璃风（半透磨砂卡 + 七彩光球 + 大圆角 + 浮空层叠 + 蓝紫粉极淡渐变背景，hero 大字蓝→紫渐变文字）
    • ⬜ muji — 原研哉极简（米白 #FAF7EB 纸感 + 朱红 #7F0019 印章 + 细衬线 Noto Serif SC + 70% 留白 + 0.25pt 发丝线 + 极轻字重）
    • 🖋 ink-wash — 中国水墨（宣纸 #FDFBF5 + 墨分五色五级灰 + 朱砂 #A62828 印章 + 飞白笔触 + 楷宋衬线 + 行高 1.85）
    • 🏮 guofeng — 国风故宫（朱砂宫墙红 #E60012 + 藤黄金瓦 #FFB61E + 群青 + 米黄绢本底 + 万字纹双线金边框 + 朱→金渐变 + 墨色文字）
    • 🌃 cyberpunk-vivid — 赛博朋克绚彩（深紫黑 #0A0014 + 热粉 #FF2DAA + 电青 #00E5FF + 赛博黄 + 银翼橙 + Orbitron + 强霓虹辉光 + 扫描线 + 粉色霓虹边描卡）
    • 🎨 van-gogh — 梵高油画（星夜深蓝 #0E2A47 + 麦田金 #FFE082 + 鸢尾紫 + Cormorant Garamond 衬线 + 1.5pt 粗描边 + 金光渐变文字）
    • 📜 da-vinci — 达芬奇手稿（羊皮纸 #E8D9B5 + 棕墨 #3D2817 + 朱砂红标注 + 黄金分割辅助网格 + 文艺复兴衬线 + 顶底品牌线 + 角标 L 刻度）
    • 👜 xhs-fashion — 小红书时尚（莫兰迪藕粉 #F5EAE5 + 摩卡咖 + 香槟金细描边 + Playfair Display + 中心对称构图）
    • 🎭 morandi — 莫兰迪高级灰（米灰 #E8E3D9 + 莫兰迪绿 #9AAB9C + 莫兰迪粉 + 极轻字重 + 大留白 1.1in 边距）
    • 🔺 memphis — 孟菲斯 80s（粉 #FF3399 + 黄 + 黑白条纹 + 粗 2pt 黑描边 + 偏移黑投影 + 不规则圆/三角/菱形几何）
    • 🟦 bauhaus — 包豪斯（红 #D32F2F + 黄 + 蓝 #1565C0 + 象牙底 + 1.5pt 黑边 + 几何块面 + 等宽编号 №）
    • 🍰 wes-anderson — 韦斯安德森（糖果粉 #F4D5C2 + 复古薄荷 #3D6E5B + 蜜桃粉 + Playfair 衬线 + 中心对称 + 顶底品牌线 + 角标）
  • 新增 8 个视觉原语（templates/helpers.py）：
    • add_color_orb — 多层半透椭圆叠加模拟高斯模糊后的彩色光球（Liquid Glass 招牌）
    • add_orb_cluster — 一组 6 颗 Apple system color 光球随机分布
    • add_glass_card — 半透磨砂玻璃卡（ROUNDED_RECTANGLE + 90% alpha 白 + 0.5pt 白边）
    • add_seal_stamp — 朱砂方印/圆印（自动字数适应字号，原研哉/水墨/国风共用）
    • add_brushstroke_band + add_brushstroke_cluster — 飞白笔触矩形 + 5 道叠加（水墨）
    • add_paint_stroke + add_paint_stroke_cluster — 油画粗笔触圆角矩形 + 8 道随机叠加（梵高）
    • add_geometric_decoration — 撞色几何（圆/三角/菱形/五边形 + memphis/bauhaus/minimal 三模式）
    • add_chinese_pattern_border — 国风万字纹双线金边框
    • add_offset_shadow_block — 孟菲斯偏移黑投影块
    • add_golden_ratio_guide — 达芬奇黄金分割辅助网格（0.382 / 0.618 双向）
  • REGISTRY 别名扩展：从 v3.1 的 ~50 个增至 138 个 alias 键，覆盖中英双语 + 历史名作绰号（"星夜"/"墨分五色"/"banger 大饭店"/"3D 印象"等都能命中）
  • all_packs() 接口：批量预览生成器返回所有 21 套 pack 实例
  • smoke 验证：12 套新 pack 各自渲染 5 页 PPT 全部 OK，文件大小 33–58 KB（cyberpunk-vivid / memphis 因装饰多最大）
  • 目标：让"原研哉极简"和"赛博朋克绚彩"放在同一个 deck.json 里只换 --style 就能切两种完全不同的视觉语言，每张 slide 都能直接当品牌海报/小红书封面/LinkedIn 头图
• v3.1.0：科技风品牌海报级装饰系统
  • 新增六件套 Decoration token：gradient_bg / accent_gradient / grid_overlay / dot_grid / glow_accent / corner_marks / dev_badge / mono_font / scanline，每项独立开关
  • 新增 2 套科技风 pack：tech-neon（赛博黑蓝，装饰全开，电青/电紫双 accent）+ tech-minimal（Vercel/Linear 风，点阵 + 微光克制装饰）
  • 新增 code_block 模板：macOS 圆点 + 文件名 tab + 语言标签 + 行号 + 关键词上色 + 行高亮 + 代码自动缩放
  • 新增 helpers 装饰原语：add_gradient_rect / apply_text_gradient / add_glow_halo / _draw_grid_overlay / _draw_dot_grid / _draw_corner_marks / add_dev_badge / add_mono_text / format_dev_badge
  • hero/section/stat 自动带 glow + gradient：科技风 pack 下大字自动叠辉光与渐变文字（Keynote/PowerPoint 端显示）
  • 修复 KPI 数字溢出：kpi_triple 现在对 value 做 fit_font_size，"99.97%"/"$4.8M" 不再换行
  • 新增 2 套科技风示例 deck：tech-neon-ai-launch.json（10 页 AI 产品发布）+ tech-minimal-saas.json（7 页 Vercel 风部署 pitch）
  • 目标：让每一张 slide 都能单张导出当品牌海报/LinkedIn 头图/小红书封面
• v3.0.0：重写为 design tokens 架构。
  • 新增 design_system.py：Palette + Typography + Spacing + Elevation + Decoration + Canvas 六层独立 tokens
  • 新增 style_packs.py：4 个 v3 审美方案（apple-keynote / apple-light / xiaohongshu-creator / xiaohongshu-vintage）+ 3 个 legacy pack
  • 新增 templates/：10 个语义化页面模板 + helpers 共享原语
  • 新增字距：OOXML XML 注入 \x3Ca:rPr spc="N"> 实现 letter-spacing（python-pptx 不支持）
  • 新增 auto-fit：大字号自动缩放避免 CJK 溢出换行
  • 新增 4 套示例 deck：examples/decks/.json + examples/previews/.png
  • 向后兼容：--style 参数、v2 字段名、legacy pack 全保留
• v2.1.0：扩展 7 种风格（ocean/forest/sunset/minimal/pastel/github/tech-blue）
• v2.0.0：styles 注册表 + pptx_toolkit 绘图原语 + create-pptx.py CLI + 小红书配色
• v1.x：深蓝乔布斯单页脚本集合

技术支持： 青岛火一五信息科技有限公司