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
feat(visual-styles): align catalog with image-renderings, grows to 14
hugohe33fd619fc988b
diff --git a/docs/roadmap.md b/docs/roadmap.mdindex aaed4376..d19b06d7 100644--- a/docs/roadmap.md+++ b/docs/roadmap.md@@ -48,7 +48,7 @@ The past two months' structural capability growth. Single flags / incremental po- **Three executors retired → mode + visual-style dual catalogs** ([`references/modes/`](../skills/ppt-master/references/modes/) + [`references/visual-styles/`](../skills/ppt-master/references/visual-styles/)) — the old three `executor-*.md` (general / consultant / consultant-top) entangled domain · audience · persuasion · narrative on one axis; split into two orthogonal catalogs (following the `image-renderings` pattern: flat dir + `_index` + on-demand read + Strategist locks one). **mode** = narrative skeleton (`pyramid` / `narrative` / `instructional` / `showcase`; consultant + top merge into pyramid since their narrative core is identical); **visual-style** = SVG layout aesthetic (`swiss-minimal` / `editorial` / `soft-rounded` / `dark-tech`, each paired with an image-rendering, **zero HEX** — color truth stays in confirmation e + image-palettes). Strategist `§d` locks `mode` + `visual_style` independently into `spec_lock`; Executor loads the two locked files; any mode × any style. Render coordinates stay in `templates/charts/`- **Prompt constraint-strength decoupling** ([`docs/rules/prompt-style.md`](rules/prompt-style.md) §4) — three explicit strength tiers — rule (`Hard rule` / `Forbidden`) / default (`Default — … may override`) / reference (`Reference — not a constraint`) — plus an "objective failure vs taste" test and a checker boundary, so the model can tell "must keep vs may deviate" at a glance; the visual-style catalog is Reference-strength throughout-- **visual-style catalog grows to 8** — four new entries distilled from the [examples library](../examples/)'s already-realized aesthetics: `brutalist` (newsprint density / ruled boxes / flat) · `blueprint` (dark schematic line work / isometric / annotation language) · `memphis` (clashing color blocks / geometric confetti / bold outlines) · `zine` (riso misregistration / halftone / limited palette). Same discipline — zero HEX, Reference strength, each paired with an image-rendering — with `_index` catalog table + auto-selection updated+- **visual-style catalog grows to 14, aligned with image-renderings** — first four distilled from the [examples library](../examples/) (`brutalist` / `blueprint` / `memphis` / `zine`), then six more filling in the hand-drawn / textured renderings that have a layout twin: `sketch-notes` (warm paper + soft pastel blocks) · `ink-notes` (white field + black ink + sparse semantic accent) · `chalkboard` (dark slate + chalk) · `paper-cut` (layered cut-paper + soft inter-layer shadow) · `vintage-poster` (mid-century flat blocks + halftone) · `pixel-art` (pixel grid). Each style pairs with the same-named / same-temperament rendering, and the catalog is grouped into four families (structured-graphic / expressive-print / hand-drawn-educational / specialty). Photographic / painterly renderings (corporate-photo / nature / warm-scene / fantasy-animation / watercolor) deliberately get no layout twin — they describe how an *image* looks, not a deck layout, so they pair with a layout style instead. Zero HEX, Reference strength throughout---@@ -56,7 +56,6 @@ The past two months' structural capability growth. Single flags / incremental poDirections actively underway or up next, with no committed timeline.-- **visual-style catalog — continued alignment with image-renderings** — the examples-library distillation pass has landed (→ 8 styles); the remaining direction is to align the catalog further with the full [`image-renderings`](../skills/ppt-master/references/image-renderings/) set so every layout style has a naturally paired illustration style- **mode catalog refinement** — how the four narrative skeletons (pyramid / narrative / instructional / showcase) draw their boundaries, and whether to add more, are still under consideration; recorded here as a preliminary direction only---diff --git a/docs/zh/roadmap.md b/docs/zh/roadmap.mdindex 5a28506e..224a24e5 100644--- a/docs/zh/roadmap.md+++ b/docs/zh/roadmap.md@@ -48,7 +48,7 @@- **三个 executor 退役 → mode + visual-style 双 catalog**([`references/modes/`](../../skills/ppt-master/references/modes/) + [`references/visual-styles/`](../../skills/ppt-master/references/visual-styles/)) — 原三个 `executor-*.md`(general / consultant / consultant-top)把「领域 · 受众 · 说服 · 叙事」捆在一条线;拆成两个正交 catalog(照 `image-renderings` 范式:扁平目录 + `_index` + 按需读 + Strategist 锁一个)。**mode** = 讲解骨架(`pyramid` / `narrative` / `instructional` / `showcase`,consultant + top 因叙事内核相同合并为 pyramid);**visual-style** = SVG 排版美学(`swiss-minimal` / `editorial` / `soft-rounded` / `dark-tech`,各 paired 一个 image-rendering,**零 HEX**——颜色真值守在 confirmation e + image-palettes)。Strategist `§d` 双层独立锁定 `mode` + `visual_style` 进 `spec_lock`,Executor 加载两个 locked 文件;任意 mode × 任意 style 自由组合,渲染坐标仍留 `templates/charts/`- **提示词约束强度三档解耦**([`docs/rules/prompt-style.md`](../rules/prompt-style.md) §4) — 规则(`Hard rule` / `Forbidden`)/ 默认(`Default — … may override`)/ 参考(`Reference — not a constraint`)三档显式化 + 「客观失败 vs 品味」判据 + checker 边界,让模型对「该守 vs 可破」一目了然;visual-style catalog 全程用 Reference 强度-- **visual-style catalog 扩充至 8 个** — 从[示例库](../../examples/)已成型的视觉风格提炼出 4 个新条目:`brutalist`(报章满版密度 / 框线 / 全平)· `blueprint`(深底蓝图线稿 / 等距投影 / 标注语汇)· `memphis`(撞色块 / 几何碎片 / 粗描边)· `zine`(riso 套色错位 / 半色调 / 限定调色)。同样零 HEX、Reference 强度、各 paired 一个 image-rendering,`_index` catalog 表 + auto-selection 同步登记+- **visual-style catalog 扩充至 14 个,与 image-renderings 对齐** — 先从[示例库](../../examples/)提炼 4 个(`brutalist` / `blueprint` / `memphis` / `zine`),再补齐 [`image-renderings`](../../skills/ppt-master/references/image-renderings/) 里有排版对应物的手绘 / 纹理风格 6 个:`sketch-notes`(暖纸涂鸦 + 柔彩块)· `ink-notes`(白底黑墨 + 稀疏语义色)· `chalkboard`(深石板 + 粉笔)· `paper-cut`(分层剪纸 + 层间软阴影)· `vintage-poster`(中世纪平涂块 + 半色调)· `pixel-art`(像素网格)。每个 style 与同名 / 同气质 rendering 配对,catalog 按 结构图形 / 表现印刷 / 手绘教育 / 特殊 四组归类。摄影 / 绘画类 rendering(corporate-photo / nature / warm-scene / fantasy-animation / watercolor)刻意不建 layout 孪生——它们描述「图」的样子而非版面,配对某个 layout style 即可。全程零 HEX、Reference 强度---@@ -56,7 +56,6 @@明确在做或下一步要做的方向,不承诺时间窗口。-- **visual-style catalog 继续对齐 image-renderings** — 示例库提炼一轮已落地(→ 8 个 style);剩下的方向是把 catalog 与 [`image-renderings`](../../skills/ppt-master/references/image-renderings/) 全集进一步对齐,让每个排版风格都有自然配对的插图风格- **mode catalog 完善** — 4 个讲解骨架(pyramid / narrative / instructional / showcase)的边界划分、以及是否扩档仍在斟酌,此处仅记初步方向---diff --git a/skills/ppt-master/references/visual-styles/_index.md b/skills/ppt-master/references/visual-styles/_index.mdindex bb8ae1f6..e9b32946 100644--- a/skills/ppt-master/references/visual-styles/_index.md+++ b/skills/ppt-master/references/visual-styles/_index.md@@ -10,18 +10,41 @@ A **visual style** is how the deck **looks** — shape language, decoration dens## 1. Catalog-Each style has its own file with: shape & decoration, typography character, color-usage discipline (no HEX), texture / elevation, and the paired image-rendering. **Read only the file for the style you lock** — never glob the directory.+Each style has its own file with: shape & decoration, typography character, color-usage discipline (no HEX), texture / elevation, and the paired image-rendering. **Read only the file for the style you lock** — never glob the directory. The catalog mirrors [`image-renderings`](../image-renderings/_index.md): each style's "Paired rendering" names the illustration family that shares its aesthetic.++### 1.1 Structured / graphic| Visual style | Character | Best for | Paired rendering ||---|---|---|---|| [`swiss-minimal`](./swiss-minimal.md) | Grid-locked, sharp, aggressive whitespace, no decoration | High-end consulting, architecture, type-led | `minimalist-swiss` || [`editorial`](./editorial.md) | Magazine hierarchy, rules & columns, serif/sans interplay | Finance, journalism, analysis, explainers | `editorial` || [`soft-rounded`](./soft-rounded.md) | Rounded cards, gentle elevation, approachable | Product, SaaS, training, consumer | `flat` / `glassmorphism` |-| [`dark-tech`](./dark-tech.md) | Dark canvas, glow accents, geometric precision | Tech, AI, data products, launches | `digital-dashboard` / `blueprint` |-| [`brutalist`](./brutalist.md) | Newsprint density, ruled boxes, raw structure, flat | Annual reviews, research digests, manifestos | `screen-print` / `editorial` |+| [`dark-tech`](./dark-tech.md) | Dark canvas, glow accents, geometric precision | Tech, AI, data products, launches | `digital-dashboard` || [`blueprint`](./blueprint.md) | Schematic line work on dark paper, isometric, annotated | Technical briefings, architecture, engineering | `blueprint` |+| [`brutalist`](./brutalist.md) | Newsprint density, ruled boxes, raw structure, flat | Annual reviews, research digests, manifestos | `screen-print` / `editorial` |++### 1.2 Expressive / print++| Visual style | Character | Best for | Paired rendering |+|---|---|---|---|| [`memphis`](./memphis.md) | Clashing color blocks, geometric confetti, bold outlines | Festivals, consumer, youth, launch hype | `flat` || [`zine`](./zine.md) | Riso misregistration, halftone, limited palette, print grit | Culture, design talks, indie brands | `screen-print` |+| [`vintage-poster`](./vintage-poster.md) | Mid-century flat blocks, halftone, retro-geometric warmth | Heritage, hospitality, cultural, anniversaries | `vintage-poster` |+| [`paper-cut`](./paper-cut.md) | Layered cut-paper sheets, soft inter-layer shadow, tactile | Cultural / folk, children, festival, sustainability | `paper-cut` |++### 1.3 Hand-drawn / educational++| Visual style | Character | Best for | Paired rendering |+|---|---|---|---|+| [`sketch-notes`](./sketch-notes.md) | Warm paper, doodle line work, soft pastel blocks | Education, training, onboarding, knowledge | `sketch-notes` |+| [`ink-notes`](./ink-notes.md) | Pale field, black hand-ink, sparse semantic accent | Methodology, before/after, manifestos | `ink-notes` |+| [`chalkboard`](./chalkboard.md) | Dark slate, chalk strokes, powdery pastel accents | Teaching, tutorials, classroom, academic | `chalkboard` |++### 1.4 Specialty++| Visual style | Character | Best for | Paired rendering |+|---|---|---|---|+| [`pixel-art`](./pixel-art.md) | Strict pixel grid, blocky forms, limited palette, flat | Gaming, retro-tech, nostalgic, game-flavored | `pixel-art` |---@@ -33,12 +56,20 @@ Each style has its own file with: shape & decoration, typography character, colo| Finance / journalism / research / long-form analysis | `editorial` | `swiss-minimal` || Product / SaaS / training / consumer / friendly | `soft-rounded` | `editorial` || Tech / AI / dev tools / data / futuristic | `dark-tech` | `soft-rounded` |-| Annual review / manifesto / max-density editorial | `brutalist` | `editorial` || Engineering / systems / architecture walkthrough | `blueprint` | `dark-tech` |+| Annual review / manifesto / max-density editorial | `brutalist` | `editorial` || Festival / consumer brand / youth / loud launch | `memphis` | `soft-rounded` || Indie publishing / design / culture / printed feel | `zine` | `editorial` |+| Heritage / hospitality / retro brand / 老字号 / 周年 | `vintage-poster` | `zine` |+| Cultural / folk / festival / children / sustainability | `paper-cut` | `sketch-notes` |+| Education / training / onboarding / 教学 | `sketch-notes` | `paper-cut` |+| Methodology / before-after / manifesto / 方法论 | `ink-notes` | `editorial` |+| Classroom / tutorial / academic / 课堂 | `chalkboard` | `sketch-notes` |+| Gaming / retro / 8-bit / 复古游戏 | `pixel-art` | `vintage-poster` |> When the deck has AI images, align style with rendering: a `swiss-minimal` layout reads best with a `minimalist-swiss` rendering, so page and illustrations share one aesthetic. The "Paired rendering" column is the default pairing; override when content demands.+>+> Not every image-rendering has a layout twin: photographic / painterly renderings (`corporate-photo`, `nature`, `warm-scene`, `fantasy-animation`, `watercolor`) describe how an *image* looks, not how a deck is laid out — they pair with one of the layout styles above rather than being one.---diff --git a/skills/ppt-master/references/visual-styles/chalkboard.md b/skills/ppt-master/references/visual-styles/chalkboard.mdnew file mode 100644index 00000000..03abd836--- /dev/null+++ b/skills/ppt-master/references/visual-styles/chalkboard.md@@ -0,0 +1,32 @@+# Visual style: chalkboard++Classroom chalkboard — a dark slate field, soft chalk-stroke line work, powdery pastel accents. Nostalgic and instructional. For teaching decks, tutorials, school / academic content, retro-classroom atmosphere.++---++## 1. Shape & decoration++- Shape language: chalk-stroke line work with slightly diffused, dry-medium edges; sketched boxes, brackets, arrows in chalk. Confident but never mechanical.+- Decoration: underlines and emphasis marks; a few sprinkled chalk stars / dots. Blackboard pedagogy — organized sections, a clear central focus.+- Whitespace: the dark board reads as room; let chalk marks breathe rather than crowd.++## 2. Typography character++- Hand-lettered chalk character for titles; legible body. Dry, nostalgic, classroom-warm.++> Families are chosen at confirmation `g`; this style asks for a hand-lettered chalk title *character*.++## 3. Using the deck's colors++- Dark slate field; off-white chalk carries most marks; the deck's colors appear as soft, powdery pastel chalk accents, used sparingly.+- Restrained and powdery — never saturated fills.++> HEX values come from confirmation `e`; this style only governs the chalk-on-slate, powdery-accent discipline — it names no colors. (Dark-field legibility: [`shared-standards.md §6`](../shared-standards.md).)++## 4. Texture / elevation++- Flat — depth from chalk-stroke weight, not material. Chalk-dust grain texture across the board is on-brand; no drop shadows.++## 5. Paired image-rendering++`chalkboard` — chalk-on-slate imagery with the same classroom feel.diff --git a/skills/ppt-master/references/visual-styles/ink-notes.md b/skills/ppt-master/references/visual-styles/ink-notes.mdnew file mode 100644index 00000000..3f0e36af--- /dev/null+++ b/skills/ppt-master/references/visual-styles/ink-notes.md@@ -0,0 +1,33 @@+# Visual style: ink-notes++Whiteboard-ink minimalism — a pale field, confident black hand-ink line work, sparse semantic color. Considered and manifesto-clear, the professional end of hand-drawn. For methodology, before/after essays, mindset-shift narratives, technical manifestos.++---++## 1. Shape & decoration++- Shape language: hand-drawn line work with slight, intentional wobble — boxes, arrows, dividers and brackets sketched as if on a thoughtful whiteboard; never mechanically straight. Line defines structure; no filled cards.+- Decoration: minimal — a few doodle marks (stars, dashes, dots, underlines) for emphasis. Restraint is the look; clutter breaks the "considered" feel.+- Whitespace: generous and empty; the pale field carries most of the canvas, elements float with room around them.++## 2. Typography character++- Hand-lettered / humanist character for titles — bold, slightly oversized, confident. Plain legible sans for body.+- Reads as written-by-hand-but-deliberate, not corporate-precise.++> Families are chosen at confirmation `g`; this style asks for a humanist / hand-lettered title *character*.++## 3. Using the deck's colors++- Near-monochrome: ink-dark line work on a pale field does ~85% of the work; the deck's accent appears only as a semantic mark (risk / positive / highlight) under ~10% of canvas.+- Color carries meaning, not decoration — one or two accents, used where they signify.++> HEX values come from confirmation `e`; this style only governs the monochrome-with-semantic-accent discipline — it names no colors.++## 4. Texture / elevation++- Strictly flat — no shadows, no paper grain (the field stays clean). Depth reads from line weight and spacing alone.++## 5. Paired image-rendering++`ink-notes` — black-ink visual-note imagery on a clean field, matching the considered hand-drawn aesthetic.diff --git a/skills/ppt-master/references/visual-styles/paper-cut.md b/skills/ppt-master/references/visual-styles/paper-cut.mdnew file mode 100644index 00000000..5b80d1ca--- /dev/null+++ b/skills/ppt-master/references/visual-styles/paper-cut.md@@ -0,0 +1,32 @@+# Visual style: paper-cut++Layered paper-craft — scissor-cut shapes stacked in tactile layers, soft shadow where layers overlap. Warm, hand-made, child-friendly without being childish. For education, children's content, cultural / folk topics, festival, sustainability.++---++## 1. Shape & decoration++- Shape language: forms defined by crisp, slightly-irregular cut edges (no outlines); simplified, stylized shapes that read as cut paper rather than illustration.+- Decoration: layering itself is the device — each element is a "sheet" stacked over the one beneath; small cut-out accents on the top layer.+- Whitespace: cozy, composed — the backing sheet shows through as breathing room.++## 2. Typography character++- Clean friendly sans; warm, not severe. Titles can sit on a cut-paper banner shape.++> Families are chosen at confirmation `g`; this style asks for a warm, rounded, approachable sans *character*.++## 3. Using the deck's colors++- Each color reads as one sheet of paper — the primary is the dominant foreground sheet, the secondary the backing field, the accent a small top-layer cut-out.+- Layering and overlap drive emphasis more than proportion: even a small primary sheet in front of a large secondary reads as primary-led.++> HEX values come from confirmation `e`; this style only governs the each-color-is-a-sheet, layering discipline — it names no colors.++## 4. Texture / elevation++- Real layered depth — a soft 8-12% drop shadow under each cut layer is core here (the one style where layered shadow is the point, not a violation). Matte paper grain on each sheet. (Shadow rules: [`shared-standards.md §6`](../shared-standards.md).)++## 5. Paired image-rendering++`paper-cut` — layered cut-paper imagery sharing the tactile, hand-made depth.diff --git a/skills/ppt-master/references/visual-styles/pixel-art.md b/skills/ppt-master/references/visual-styles/pixel-art.mdnew file mode 100644index 00000000..e4568b4b--- /dev/null+++ b/skills/ppt-master/references/visual-styles/pixel-art.md@@ -0,0 +1,32 @@+# Visual style: pixel-art++8-bit retro game — strict pixel grid, chunky blocky forms, a limited palette, no anti-aliasing. Playful and nostalgic. For gaming decks, retro-tech decks, nostalgic or game-flavored education / entertainment.++---++## 1. Shape & decoration++- Shape language: everything aligns to a visible pixel grid — blocky shapes, stepped edges, sharp transitions, no smooth curves; optional 1-pixel darker outlines for definition.+- Decoration: classic game framing — HUD bars, tile floors, sprite icons, chunky pixel borders. References NES / SNES / arcade composition.+- Whitespace: grid-disciplined; let blocks sit on clean tiled ground rather than crowd.++## 2. Typography character++- Pixel / bitmap display character for headlines; keep body in a clean legible face — full-pixel body type strains at reading length.++> Families are chosen at confirmation `g`; this style asks for a pixel / bitmap display *character* for titles, legible body alongside.++## 3. Using the deck's colors++- Colors used as palette slots: primary the dominant object, secondary the terrain / background, accent the highlights and markers; a darker shade of the primary serves as outline pixels.+- Flat blocks only — shading comes from palette layering (lighter top, darker bottom), never gradients.++> HEX values come from confirmation `e`; this style only governs the palette-slot, flat-pixel discipline — it names no colors.++## 4. Texture / elevation++- No texture beyond the pixel grid itself; strictly flat blocks. Depth reads from lighter-top / darker-bottom pixel shading, not drop shadows.++## 5. Paired image-rendering++`pixel-art` — 8-bit imagery on the same grid, sharing the retro-game aesthetic.diff --git a/skills/ppt-master/references/visual-styles/sketch-notes.md b/skills/ppt-master/references/visual-styles/sketch-notes.mdnew file mode 100644index 00000000..ccd9769a--- /dev/null+++ b/skills/ppt-master/references/visual-styles/sketch-notes.md@@ -0,0 +1,32 @@+# Visual style: sketch-notes++Warm hand-drawn sketchnote — soft paper field, black ink doodle line work, gentle pastel blocks. The most approachable style, friendly over precise. For education, training, onboarding, science communication, knowledge content.++---++## 1. Shape & decoration++- Shape language: rounded shapes drawn with a slight wobble; pastel block fills that slightly overshoot their outlines (hand-painted feel); simple cartoon icons.+- Decoration: small doodles — stars, sparkles, dots, underlines — sprinkled sparingly for warmth; wavy hand-drawn arrows connecting ideas with short inline labels.+- Whitespace: airy and well-organized; generous gaps between elements keep it friendly, never dense.++## 2. Typography character++- Friendly hand-lettered titles; clear humanist body. Warmth and legibility over corporate severity.++> Families are chosen at confirmation `g`; this style asks for a warm hand-lettered / humanist *character*.++## 3. Using the deck's colors++- Warm, soft paper field; the deck's colors rendered as gentle pastel tints inside the blocks rather than full saturation; one accent reserved for a key arrow or emphasis.+- Generous but gentle — soft tints, never high-chroma or rainbow.++> HEX values come from confirmation `e`; this style only governs the soft-pastel, warm-field discipline — it names no colors.++## 4. Texture / elevation++- Flat 2D — sketchnote is intentionally flat. Optional subtle paper grain for warmth; no drop shadows.++## 5. Paired image-rendering++`sketch-notes` — cream-paper hand-drawn imagery with soft pastel fills, sharing the friendly note aesthetic.diff --git a/skills/ppt-master/references/visual-styles/vintage-poster.md b/skills/ppt-master/references/visual-styles/vintage-poster.mdnew file mode 100644index 00000000..e85328f2--- /dev/null+++ b/skills/ppt-master/references/visual-styles/vintage-poster.md@@ -0,0 +1,32 @@+# Visual style: vintage-poster++Mid-century print poster (1950s–1970s) — bold rounded-geometric shapes, limited flat color blocks, halftone / paper grain, retro warmth. For cultural decks, brand storytelling, hospitality, retro-tech narratives, anniversaries, heritage brands.++---++## 1. Shape & decoration++- Shape language: bold geometric shapes with rounded organic edges, often slightly off-axis for retro tension; overlapping flat blocks; thick hand-aware lines; stylized, reduced iconography (a stylized sun, an angular mountain).+- Decoration: the print artifacts — halftone dot overlays, slight ink misregistration — carry the character; imagery stays reduced and graphic, never photoreal.+- Whitespace: confident poster composition — a few large blocks, deliberate negative space.++## 2. Typography character++- Retro display character for headlines (mid-century geometric, confident); a simple legible body by contrast.++> Families are chosen at confirmation `g`; this style asks for a mid-century display *character*.++## 3. Using the deck's colors++- Applied as limited flat blocks (a small set of colors): the primary dominates large blocks, the secondary reads as a warm paper field, the accent marks small shapes or tints the halftone.+- Flat color only — no gradients; depth comes from overlap, not blending.++> HEX values come from confirmation `e`; this style only governs the limited-flat-block, halftone discipline — it names no colors.++## 4. Texture / elevation++- Flat — depth implied via overlapping shapes, never via shadow. Halftone dot pattern or paper grain at low opacity gives printed age; slight ink-offset character is on-brand.++## 5. Paired image-rendering++`vintage-poster` — mid-century poster imagery with matching halftone and retro-geometric warmth.