zcbot/skills/ppt/templates/icons
caoqianming e3a432dcdd feat(ppt): skill 重构为 SVG-first(移植 ppt-master,弃 python-pptx 版式件)(bump 0.33.0)
旧 python-pptx 固定组合版式件是版面单调/AI 味的架构天花板。改为 SVG-first:
AI 逐页手写 SVG 设计稿 → 纯 Python 转换器逐元素译成原生可编辑 DrawingML。

- 搬引擎:svg_to_pptx/ 转换器 + finalize_svg/svg_finalize + svg_quality_checker + total_md_split + update_spec(依赖闭包干净,只需 python-pptx)
- 搬知识:references(shared-standards/executor-base/strategist/image-layout-*/canvas-formats)+ 5 叙事骨架 + 19 视觉风格
- 搬模板:templates(layouts/decks/brands/charts + 图标库 1.1w+ + spec 骨架)
- 换 GUI:浏览器 Confirm UI → 聊天 BLOCKING 八条确认;live preview → svg_preview.py(无头 Chrome 渲 SVG→PNG);配图走 zcbot imagegen skill
- 默认主题改自由设计(商务红降为候选之一)
- 修 Windows GBK 控制台 UnicodeEncodeError:6 个入口脚本加 sys.stdout.reconfigure(utf-8) shim
- 端到端验证通过:4 页材料领域 deck,质检 0 error → finalize 嵌图标 → 导出原生 pptx → 渲图肉眼验收(swiss-minimal 设计级,非 AI 味)

移植自 github.com/hugohe3/ppt-master (MIT),适配 zcbot task_dir/聊天确认/imagegen 工作流。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-29 16:38:58 +08:00
..
chunk-filled feat(ppt): skill 重构为 SVG-first(移植 ppt-master,弃 python-pptx 版式件)(bump 0.33.0) 2026-06-29 16:38:58 +08:00
phosphor-duotone feat(ppt): skill 重构为 SVG-first(移植 ppt-master,弃 python-pptx 版式件)(bump 0.33.0) 2026-06-29 16:38:58 +08:00
simple-icons feat(ppt): skill 重构为 SVG-first(移植 ppt-master,弃 python-pptx 版式件)(bump 0.33.0) 2026-06-29 16:38:58 +08:00
tabler-filled feat(ppt): skill 重构为 SVG-first(移植 ppt-master,弃 python-pptx 版式件)(bump 0.33.0) 2026-06-29 16:38:58 +08:00
tabler-outline feat(ppt): skill 重构为 SVG-first(移植 ppt-master,弃 python-pptx 版式件)(bump 0.33.0) 2026-06-29 16:38:58 +08:00
README.md feat(ppt): skill 重构为 SVG-first(移植 ppt-master,弃 python-pptx 版式件)(bump 0.33.0) 2026-06-29 16:38:58 +08:00

README.md

SVG Icon Library

This directory provides 11,600+ high-quality SVG icons across five libraries that can be directly embedded into SVG files generated by PPT Master. Four are stylistic libraries (pick one per deck); one is a brand-logo library (simple-icons) used as an inset alongside the chosen stylistic library.

Libraries

Library Style Count viewBox Prefix
chunk-filled fill · straight-line geometry (sharp corners, rectilinear) 640 0 0 16 16 chunk-filled/
tabler-filled fill · bezier-curve forms (smooth, rounded contours) 1000+ 0 0 24 24 tabler-filled/
tabler-outline stroke / line 5000+ 0 0 24 24 tabler-outline/
phosphor-duotone duotone · single color + 0.2 opacity backplate (soft depth) 1200+ 0 0 256 256 phosphor-duotone/
simple-icons brand logos (real company / product marks) — single-color silhouettes, color in via fill 3400+ 0 0 24 24 simple-icons/

Per-project icons folder

This directory is the global library. At selection time the Strategist copies the chosen icons into the deck's own <project>/icons/<lib>/ with icon_sync.py:

python3 skills/ppt-master/scripts/icon_sync.py <project_path> chunk-filled/home tabler-outline/bulb

A name the library does not have is reported and the command exits non-zero — re-pick a real one then, not at export. finalize_svg.py embed-icons embeds project-first (from <project>/icons/), falling back to this global library per-icon.

Custom icons: drop your own .svg into <project>/icons/<lib>/ (any <lib>, e.g. custom/) and reference it as data-icon="<lib>/<name>" — it embeds like any library icon.

Usage

Use placeholder syntax during SVG generation:

<!-- chunk-filled (sharp, geometric — tech/engineering/enterprise tone) -->
<use data-icon="chunk-filled/home" x="100" y="200" width="48" height="48" fill="#0076A8"/>

<!-- tabler-filled (rounded, organic — lifestyle/health/home tone) -->
<use data-icon="tabler-filled/home" x="100" y="200" width="48" height="48" fill="#0076A8"/>

<!-- tabler-outline (light, line-art — refined screen-only showcases) -->
<use data-icon="tabler-outline/home" x="100" y="200" width="48" height="48" fill="#0076A8"/>

<!-- phosphor-duotone (soft depth — single color renders the backplate at 20% opacity) -->
<use data-icon="phosphor-duotone/house" x="100" y="200" width="48" height="48" fill="#0076A8"/>

<!-- simple-icons (brand logo — used alongside the deck's primary library, not as a substitute) -->
<use data-icon="simple-icons/github" x="100" y="200" width="48" height="48" fill="#181717"/>

Attributes:

  • data-icon<library>/<icon-name> (filename without .svg)
  • x, y — Position
  • width, height — Size (recommend 3248px for legibility)
  • fill — Color

finalize_svg.py auto-embeds all placeholders during post-processing. To run manually:

python3 scripts/svg_finalize/embed_icons.py svg_output/*.svg

Searching for Icons

Use ls | grep — zero token cost:

ls skills/ppt-master/templates/icons/chunk-filled/ | grep home
ls skills/ppt-master/templates/icons/tabler-filled/ | grep home
ls skills/ppt-master/templates/icons/tabler-outline/ | grep chart
ls skills/ppt-master/templates/icons/phosphor-duotone/ | grep house
ls skills/ppt-master/templates/icons/simple-icons/ | grep github

Style Rules

No default library — actively choose based on the deck's visual needs. Read the source material first, then pick the library whose visual character best serves the presentation. Each library has a distinct visual personality:

  • chunk-filledfill style, built from straight-line commands only (M/L/H/V/Z). Sharp, precise right angles; rectilinear geometry; structured and highly legible at small sizes. Visual weight: heavy, solid, architectural.
  • tabler-filledfill style, built from bezier curves and arcs (C/A). Smooth, rounded, organic contours; warmer and softer than chunk-filled. Visual weight: medium, approachable.
  • tabler-outlinestroke style (line art, default stroke-width 2). Airy, refined, lightweight; uses negative space. Visual weight: light, elegant. Best for screen-only viewing since thin strokes may become hard to read when printed or projected.
  • phosphor-duotoneduotone style; main shape at full opacity plus a backplate of the same color at 20% opacity, producing a soft sense of depth. Visual weight: medium, layered, contemporary.

Two axes to consider when choosing:

  1. Geometry: straight lines (chunk-filled) vs. curves (tabler-filled / phosphor-duotone) vs. open strokes (tabler-outline)
  2. Visual weight: heavy solid (chunk-filled) → medium solid (tabler-filled) → medium layered (phosphor-duotone) → light stroke (tabler-outline)

One presentation = one stylistic library. Pick chunk-filled / tabler-filled / tabler-outline / phosphor-duotone at the start and use it exclusively throughout for generic icons (home, chart, users, etc.). If the chosen library doesn't have an exact icon, find the closest available alternative within that same library — never cross stylistic libraries to fill a gap.

Brand-logo exception (simple-icons). simple-icons is not a stylistic library and does not participate in the "one library" rule. Its job is brand recognition — Slack's purple, GitHub's cat, AWS's color — which is intentionally heterogeneous. Use it alongside the chosen stylistic library, but only for actual company / product / service brand marks. Do not reach for it as a substitute when the chosen stylistic library lacks a generic icon.

Use simple-icons for Do NOT use simple-icons for
Customer / partner / ecosystem logos on a "trusted by" page Generic concepts (home, chart, settings, etc.)
Tech stack icons on architecture / integration diagrams Replacing a missing icon in chunk-filled / tabler-* / phosphor-duotone
Social media handles in a footer Decorative / illustrative purposes

⚠️ Do not mix icons from different stylistic libraries (chunk-filled / tabler-filled / tabler-outline / phosphor-duotone). simple-icons is the sole exception and may co-exist as a brand-logo inset — see the brand-logo exception above.