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
fix(authoring): keep catalog selection fit-driven
hugohe3d8dfea39b24e
diff --git a/AGENTS.md b/AGENTS.mdindex ae7230c8..11fe26ae 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -69,7 +69,9 @@ python3 skills/ppt-master/scripts/project_manager.py validate <project_path># Icon selection — copy chosen library icons into <project>/icons/ (missing names reported + non-zero = re-pick)python3 skills/ppt-master/scripts/icon_sync.py <project_path> <lib/name> [<lib/name>...]-# Sounds+# Sounds — after a concrete cue job, read the complete vocabulary:+# skills/ppt-master/templates/sounds/sound-vocabulary.md+# list is optional exact filteringpython3 skills/ppt-master/scripts/sound_sync.py list [--query term]python3 skills/ppt-master/scripts/sound_sync.py <project_path> <namespace>/<id>...diff --git a/docs/animations.md b/docs/animations.mdindex 0cae81f2..b475aa99 100644--- a/docs/animations.md+++ b/docs/animations.md@@ -126,25 +126,26 @@ audio/video workflows because they require media or bookmark targets.## Add Sound After Choosing Motion-Sound effects are off by default. PPT Master includes a global CC0 discovery+Sound effects are off by default. PPT Master includes a global CC0 soundlibrary, but it is not copied during strategy or ordinary project setup. Firstfinish the SVG pages and choose the visual transition/object motion. Only when-one of those resolved beats has a specific auditory job should you discover and-sync a cue:+one of those resolved beats has a specific auditory job should you read the+complete objective [sound vocabulary](../skills/ppt-master/templates/sounds/sound-vocabulary.md),+select one exact id, and sync the cue:```bash-python3 skills/ppt-master/scripts/sound_sync.py list --query whooshpython3 skills/ppt-master/scripts/sound_sync.py \<project> bigsoundbank/1797 kenney-interface/click_001```-The second command copies only the selected files into+The command copies only the selected files into`<project>/sounds/<namespace>/`. With no selected cue, PPT Master creates no-project sound directory and copies nothing. The `recommended` catalog flag is-a discovery shortlist, not an automatic choice:+project sound directory and copies nothing. After reviewing the vocabulary,+the CLI may narrow an already-considered label, tag, or context without deciding+fit:```bash-python3 skills/ppt-master/scripts/sound_sync.py list --query recommended+python3 skills/ppt-master/scripts/sound_sync.py list --query whoosh```Configuration always references the copied project-local path, never thediff --git a/docs/templates-architecture.md b/docs/templates-architecture.mdindex 3d09c949..22fae1fc 100644--- a/docs/templates-architecture.md+++ b/docs/templates-architecture.md@@ -312,7 +312,7 @@ kind owns this segment”.## 3. The four index files-Each of these four indexes maps one-to-one with its physical directory, and its fields are trimmed to what Strategist needs to select a reusable workspace. Visualization uses a separate boundary: Chart planning reads the objective [`chart-vocabulary.md`](../skills/ppt-master/templates/charts/chart-vocabulary.md), while [`charts_index.json`](../skills/ppt-master/templates/charts/charts_index.json) remains the machine registry; the small [Table registry](../skills/ppt-master/templates/tables/tables_index.json) serves both roles directly. Qualitative Structure has no index because Executor generates it from page relationships.+Each of these four indexes maps one-to-one with its physical directory, and its fields are trimmed to what Strategist needs to select a reusable workspace. Visualization uses a separate boundary: planning reads the objective [`chart-vocabulary.md`](../skills/ppt-master/templates/charts/chart-vocabulary.md) and [`table-vocabulary.md`](../skills/ppt-master/templates/tables/table-vocabulary.md), while [`charts_index.json`](../skills/ppt-master/templates/charts/charts_index.json) and [`tables_index.json`](../skills/ppt-master/templates/tables/tables_index.json) remain machine registries. Qualitative Structure has no index because Executor generates it from page relationships.These indexes cover library scope only. A project-root workspace is intentionally absent from all four indexes and remains usable through its explicit `projects/<name>/` path. Because both scopes use the same workspace shape, moving or copying the complete core workspace between them does not require asset-path rewriting; only library registration changes.diff --git a/docs/zh/animations.md b/docs/zh/animations.mdindex e2a1c4d4..3626747d 100644--- a/docs/zh/animations.md+++ b/docs/zh/animations.md@@ -115,22 +115,23 @@ Wipe 方向名统一映射到 `entrance_wipe`;方向会保留为参数,而## 在确定动效后添加声音-音效默认关闭。PPT Master 内置了全局 CC0 音效检索库,但不会在策略阶段或普通+音效默认关闭。PPT Master 内置了全局 CC0 音效库,但不会在策略阶段或普通项目初始化时把它复制进项目。先完成 SVG 页面并确定视觉转场 / 对象动画;只有-其中一个已确定的节拍确实需要听觉提示时,才检索并同步声音:+其中一个已确定的节拍确实需要听觉提示时,才完整读取客观的+[声音词汇表](../../skills/ppt-master/templates/sounds/sound-vocabulary.md),选定一个+准确 id 并同步声音:```bash-python3 skills/ppt-master/scripts/sound_sync.py list --query whooshpython3 skills/ppt-master/scripts/sound_sync.py \<project> bigsoundbank/1797 kenney-interface/click_001```-第二条命令只会把选中的文件复制到 `<project>/sounds/<namespace>/`。没有选中-声音时,PPT Master 不创建项目 `sounds/` 目录,也不复制任何文件。-`recommended` 只是便于检索的保守推荐集合,不会自动添加声音:+该命令只会把选中的文件复制到 `<project>/sounds/<namespace>/`。没有选中声音时,+PPT Master 不创建项目 `sounds/` 目录,也不复制任何文件。完整阅读词汇表后,可以+用 CLI 缩小已经考虑过的名称、标签或语境范围,但它不负责判断适配性:```bash-python3 skills/ppt-master/scripts/sound_sync.py list --query recommended+python3 skills/ppt-master/scripts/sound_sync.py list --query whoosh```配置始终引用复制后的项目相对路径,不直接引用全局 `templates/sounds/` 路径,diff --git a/docs/zh/templates-architecture.md b/docs/zh/templates-architecture.mdindex a35ae328..65f23b00 100644--- a/docs/zh/templates-architecture.md+++ b/docs/zh/templates-architecture.md@@ -269,7 +269,7 @@ Template Overview 写明可重复演示类型、目标受众与结果、交付/## 三、四套 index 文件-这四份 index 都与各自物理目录一一对应,字段只保留 Strategist 选择可复用 workspace 所需的信息。Visualization 采用另一条边界:Chart 规划读取客观的 [`chart-vocabulary.md`](../../skills/ppt-master/templates/charts/chart-vocabulary.md),[`charts_index.json`](../../skills/ppt-master/templates/charts/charts_index.json) 只保留为机器 registry;小型 [Table registry](../../skills/ppt-master/templates/tables/tables_index.json) 则直接同时承担两种职责。定性 Structure 没有 index,因为 Executor 会根据当前页关系现场生成。+这四份 index 都与各自物理目录一一对应,字段只保留 Strategist 选择可复用 workspace 所需的信息。Visualization 采用另一条边界:规划读取客观的 [`chart-vocabulary.md`](../../skills/ppt-master/templates/charts/chart-vocabulary.md) 与 [`table-vocabulary.md`](../../skills/ppt-master/templates/tables/table-vocabulary.md),[`charts_index.json`](../../skills/ppt-master/templates/charts/charts_index.json) 和 [`tables_index.json`](../../skills/ppt-master/templates/tables/tables_index.json) 只保留为机器 registry。定性 Structure 没有 index,因为 Executor 会根据当前页关系现场生成。四套索引只覆盖全局库范围。项目根工作区有意不进入任何索引,仍可通过显式 `projects/<name>/` 路径使用。因为两种范围采用相同工作区形态,完整核心工作区可在两者之间移动或复制,不需要重写素材路径;只有全局库注册不同。diff --git a/skills/ppt-master/references/animations.md b/skills/ppt-master/references/animations.mdindex 18f62831..0fc293af 100644--- a/skills/ppt-master/references/animations.md+++ b/skills/ppt-master/references/animations.md@@ -254,14 +254,13 @@ copy its global-library file into the project and reference that local copy.| Source | Action ||---|---|-| Bundled CC0 library | Discover ids with `sound_sync.py list`, sync only the selected ids, then use the corresponding `sounds/<namespace>/<file>.wav` paths |+| Bundled CC0 library | Read the complete objective [`sound-vocabulary.md`](../templates/sounds/sound-vocabulary.md), select one exact id from the resolved auditory job, sync only that selection, then use the corresponding `sounds/<namespace>/<file>.wav` path || User-provided audio already inside the project | Reference its existing project-relative `.m4a`, `.mp3`, or `.wav` path for object animation; a transition sound uses `.wav` || External absolute file | The low-level object-animation path remains compatible, but new generated projects should copy or sync the intended file into the project and use a relative path || No concrete auditory cue job | Keep `sound` omitted; do not create `<project>/sounds/` and do not copy the library |```bash-# Inspect ids only after the visual motion solution exists-python3 skills/ppt-master/scripts/sound_sync.py list+# Optional exact filtering only after the complete vocabulary is in contextpython3 skills/ppt-master/scripts/sound_sync.py list --query <term># Materialize only the chosen idsdiff --git a/skills/ppt-master/references/image-generator.md b/skills/ppt-master/references/image-generator.mdindex e99d0bf2..442f7d7b 100644--- a/skills/ppt-master/references/image-generator.md+++ b/skills/ppt-master/references/image-generator.md@@ -54,7 +54,7 @@ Every AI image uses one deck-wide rendering, the deck's stable color anchors/sem| Reference | Loaded ||---|---|-| [`image-renderings/_index.md`](./image-renderings/_index.md) — rendering catalog + auto-selection table | Always (Step 1 below) |+| [`image-renderings/_index.md`](./image-renderings/_index.md) — complete rendering catalog + objective selection boundary | Always (Step 1 below) || [`image-type-templates/_index.md`](./image-type-templates/_index.md) — type catalog + auto-selection table | Always (Step 1 below) || `image-renderings/<chosen>.md` | After Step 2 resolves the rendering — one preset file, or every exact reference listed for `custom` || `image-type-templates/<chosen>.md` | After Step 3 picks the type per image — only the types actually used |@@ -101,11 +101,12 @@ This fallback covers a missing key only. An empty or invalid value stops for loc| Signal | Maps to ||---|---|-| `design_spec.md d. Style` mode + descriptor | Rendering (consult renderings `_index.md` auto-selection table) |+| `design_spec.md d. Style` mode + descriptor plus intended image jobs | Rendering (compare the complete objective catalog; no keyword or paired style decides the result) || Existing `spec_lock.md colors` rows | Deck color anchors; interpret them with the completed `design_spec.md`, never replace confirmed identity from a second palette || Existing `spec_lock.md icons.library` | Sanity check: chosen rendering should be compatible with the icon library's visual weight |-If rendering inference surfaces multiple candidates, pick the first; do not present another choice after confirmation.+If rendering inference surfaces multiple candidates, choose the strongest+whole-deck fit; do not present another choice after confirmation.If the table returns `custom`, stop and repair the lock: authoring `image_rendering_behavior` is a planning decision this fallback cannot make, and the deck's SVG style prose is not an image-rendering description.diff --git a/skills/ppt-master/references/image-renderings/_index.md b/skills/ppt-master/references/image-renderings/_index.mdindex 4cea2a1b..db2ab9c9 100644--- a/skills/ppt-master/references/image-renderings/_index.md+++ b/skills/ppt-master/references/image-renderings/_index.md@@ -14,7 +14,7 @@ Each rendering keeps its own authoritative file with: style paragraph, line / te### 1.1 Modern / commercial (the corporate-PPT main field)-| Rendering | One-liner | Best for |+| Rendering | One-liner | Typical image job ||---|---|---|| [`vector-illustration`](./vector-illustration.md) | Clean flat vector with bold shapes, no gradients | Consulting / SaaS / general professional decks || [`flat`](./flat.md) | Modern geometric blocks, slightly more design-forward than vector | Brand / product showcase decks |@@ -28,7 +28,7 @@ Each rendering keeps its own authoritative file with: style paragraph, line / te### 1.2 Hand-drawn / educational-| Rendering | One-liner | Best for |+| Rendering | One-liner | Typical image job ||---|---|---|| [`sketch-notes`](./sketch-notes.md) | Warm cream paper, black hand-drawn lines, pastel fills | Education / training / onboarding || [`ink-notes`](./ink-notes.md) | Pure white, black ink, sparse semantic color | Methodology / Before-After / manifestos |@@ -37,7 +37,7 @@ Each rendering keeps its own authoritative file with: style paragraph, line / te### 1.3 Narrative / atmospheric-| Rendering | One-liner | Best for |+| Rendering | One-liner | Typical image job ||---|---|---|| [`watercolor`](./watercolor.md) | Painterly soft edges, color bleeding | Illustrative lifestyle / travel story / brand story || [`warm-scene`](./warm-scene.md) | Golden-hour cinematic warmth | Personal growth / origin story |@@ -46,7 +46,7 @@ Each rendering keeps its own authoritative file with: style paragraph, line / te### 1.4 Specialty-| Rendering | One-liner | Best for |+| Rendering | One-liner | Typical image job ||---|---|---|| [`fantasy-animation`](./fantasy-animation.md) | Ghibli/Disney hand-drawn warmth | Children / storybook / brand fable || [`pixel-art`](./pixel-art.md) | 8-bit retro game aesthetic | Gaming / retro tech / nostalgic |@@ -75,38 +75,30 @@ Write `image_rendering_references` only when the confirmed custom direction actu----## 2. Selection recall — confirmed style + image job → rendering+## 2. Selection Boundary-**Reference — not a constraint**: Resolve the direction's intended image jobs and visual style before using this table. A topic keyword alone never selects the deck-wide rendering or turns a named real-world subject into an AI row. Travel planning and other documentary work keeps verifiable places in `provided` / `web`; its AI rendering applies only to complementary invented or deliberately stylized roles. Choose the strongest task-and-style match. **No row matches** → use `custom` per §1.5 rather than force-fitting `vector-illustration`. When the visual style names a paired rendering, prefer that for aesthetic alignment only when the intended image jobs still fit.+**Reference — not a constraint**: Resolve the intended image jobs and visual+style before choosing. Compare every catalog row through the image's required+line quality, texture, depth, material, mood, documentary identity, and role in+the page. A topic or industry keyword never selects the deck-wide rendering or+turns a named real-world subject into an AI row. A paired visual-style+rendering is one coherence candidate, not a default answer. When no preset+describes the intended treatment, use `custom` per §1.5.-| `d. Style` signal | Recommended rendering | Alternates |-|---|---|---|-| Strategic / MBB / board | `editorial` or `vector-illustration` | `blueprint`, `minimalist-swiss` |-| Corporate report / analysis | `vector-illustration` | `flat`, `digital-dashboard` |-| High-end consulting / luxury / 高端 / design-firm | `minimalist-swiss` | `editorial`, `vector-illustration` |-| Tech / SaaS / AI / system / architecture | `3d-isometric`, `blueprint`, or `digital-dashboard` | `flat`, `vector-illustration` |-| Modern SaaS / fintech / health-tech / premium app | `glassmorphism` | `digital-dashboard`, `flat` |-| Product launch / brand / marketing | `flat`, `3d-isometric`, or `corporate-photo` | `vector-illustration` |-| Education / training / onboarding / 教学 | `sketch-notes` | `vector-illustration` (if school is corporate), `paper-cut` |-| Children / story / storybook / 儿童 | `fantasy-animation` | `paper-cut`, `watercolor`, `sketch-notes` |-| Cultural / folk / festival / 文化 / 节日 | `paper-cut` | `vintage-poster`, `screen-print` |-| Methodology / Before-After / manifesto / 方法论 | `ink-notes` | `editorial` |-| Government / formal / official report | `editorial` or `corporate-photo` | `vector-illustration` |-| Finance / data journalism / 财经 | `editorial` or `digital-dashboard` | `vector-illustration` |-| Personal story / 个人成长 / lifestyle | `watercolor`, `warm-scene` | `corporate-photo`, `paper-cut` |-| Cultural / media / opinion / cinematic | `screen-print`, `vintage-poster` | `editorial`, `warm-scene` |-| Brand heritage / historic hospitality identity / 老字号 / 周年 | `vintage-poster` | `screen-print`, `editorial` |-| Gaming / retro / 8-bit / 复古 | `pixel-art` | `vintage-poster` |-| Environment / wellness / 环保 / 户外 | `nature` | `watercolor`, `paper-cut` |-| Classroom / blackboard / 课堂 | `chalkboard` | `sketch-notes` |-| Team / company / product photo | `corporate-photo` | — |+| Decision dimension | Evidence to compare |+|---|---|+| Subject identity | Documentary likeness, invented expression, metaphor, atmosphere, or abstract structure |+| Mark language | Photographic detail, vector edges, hand-drawn line, halftone, pixel grid, or material contour |+| Depth and material | Flat fields, layered paper, glass, isometric volume, wash, grain, or natural light |+| Page role | Full composition, local illustration, reusable transparent element, or supporting visual cue |+| Deck coherence | Fit with the resolved visual system and color roles without replacing the page's actual communication job |---## 3. How to use-1. From `design_spec.md` extract `d. Style` mode + descriptor.-2. Find the matching row above; pick the primary recommendation.+1. Read the resolved visual system and the deck's intended AI image jobs.+2. Compare the complete catalog and choose the strongest whole-deck fit, or use a warranted `custom` treatment.3. For a preset, read `image-renderings/<chosen>.md`. For `custom`, read every file named in `image_rendering_references`, then synthesize them under the confirmed behavior; with no references, use the novel behavior directly. Apply the result when assembling prompts per [`image-generator.md`](../image-generator.md) §4.**Lock for the whole deck.** Don't change rendering between images in the same deck.diff --git a/skills/ppt-master/references/modes/_index.md b/skills/ppt-master/references/modes/_index.mdindex fc6b17d5..f6986863 100644--- a/skills/ppt-master/references/modes/_index.md+++ b/skills/ppt-master/references/modes/_index.md@@ -10,7 +10,7 @@ A **mode** is the deck's **narrative + persuasion skeleton** — how the argumenEach mode keeps its own authoritative file with: narrative skeleton, page-structure tendencies, speaker-notes register, and a page skeleton example. Read this index alone while choosing a direction. Only after a preset or custom bases are fixed may the active role read the selected sibling files: one file for a preset, every exact `mode_references` file for a catalog-based custom, and none for a novel custom. Never glob the directory or read an unselected sibling.-| Mode | Narrative skeleton | Best for |+| Mode | Narrative skeleton | Typical communication context ||---|---|---|| [`pyramid`](./pyramid.md) | Conclusion first; structured arguments; data contextualized with supported comparisons where useful | Decision support, analysis, strategy, board / exec reports || [`narrative`](./narrative.md) | Story arc — situation → tension → resolution; suspense and turns | Pitches, case studies, brand journeys, fundraising |@@ -24,19 +24,17 @@ Each mode keeps its own authoritative file with: narrative skeleton, page-struct----## 2. Auto-selection — communication contract + source signal → mode+## 2. Decision Distinctions-| Contract / source signal | Recommended mode | Alternates |-|---|---|---|-| Decision / recommendation outcome; analysis, board, investor; criteria and trade-offs must land | `pyramid` | `narrative` |-| Persuasion or mobilization lands through a case, tension, transformation, or origin arc | `narrative` | `showcase`, `pyramid` |-| Understanding or capability must build step by step; course, onboarding, how-to, explainer | `instructional` | `pyramid`, `briefing` |-| Attention / emotion / launch moment is primary; sparse presenter-led delivery | `showcase` | `narrative` |-| Complete reference, status, record, hand-off, FAQ, meeting pack; no thesis dominates | `briefing` | `pyramid`, `instructional` |--> No keyword decides the mode. Read `communication_intent`, `audience_outcome`, `core_message`, delivery context / afterlife, source texture, and any user-authored outline together. When several purposes coexist, follow the dominant **argument movement of the body pages**, not the cover and not the first purpose word. A data review can legitimately run almost entirely `pyramid`; a progress report whose durable hand-off matters more than persuasion may stay `briefing`.+**Reference — not a constraint**: Read `communication_intent`,+`audience_outcome`, `core_message`, delivery context / afterlife, source texture,+and any user-authored outline together. The catalog exposes complete argument+strategies; it does not rank them or map a topic keyword to a result. When+several purposes coexist, judge the dominant argument movement of the body+pages, not the cover or the first purpose word.-**Close calls** — the genuinely adjacent pairs; every other pair is far enough apart that the auto-selection signal decides.+The following adjacent pairs expose their structural difference without+selecting one for the current deck:| Torn between | …the first when | …the second when ||---|---|---|diff --git a/skills/ppt-master/references/strategist.md b/skills/ppt-master/references/strategist.mdindex a32764ef..1dddae79 100644--- a/skills/ppt-master/references/strategist.md+++ b/skills/ppt-master/references/strategist.md@@ -182,7 +182,7 @@ The base icon style is one single-select identity, not a material whitelist:| Option | Approach | Suitable Scenarios ||--------|----------|-------------------|| **A** | Emoji | Casual, playful, social media |-| **B** | Built-in generic icon library | Professional scenarios (recommended) |+| **B** | Built-in generic icon library | Recurring compact semantic cues in one coherent SVG style || **C** | Custom project icons | Supplied, template-carried, or imported assets || **D** | No base icons | Illustration, typography, shapes, or data already carry the compact cues |@@ -344,7 +344,7 @@ editable-only requirements win. Execution follows1. Before authoring Stage-2 directions, load the workflow's complete fixedplanning-capability batch. It includes this module, the image-layoutauthorities, all compact decision maps, the icon-library contract, the- complete Chart expression vocabulary, and the Table registry. After the+ complete Chart and Table expression vocabularies. After thethree whole-direction intents exist and their mode/style/rendering referenceids are frozen, read onlythose exact detail siblings once and author one complete custom rendering@@ -415,13 +415,13 @@ Classify by information model, never source PowerPoint object type:|---|---|| Qualitative `order`, `link`, `parent`, `membership`, `contrast`, or `overlap` | Preserve units, relationship, and reading path as free §IX prose; no catalog key || Values/dates/durations determine geometry | Chart; compare the complete loaded chart expression vocabulary |-| Row header × column header addresses each fact | Table; compare the complete loaded table registry |+| Row header × column header addresses each fact | Table; compare the complete loaded Table expression vocabulary |**Mandatory — relationship handoff**: keep every qualitative relationship in §IX free prose; never serialize grammar atoms, coordinates, or named models. Executor makes the per-page Structure decision at runtime.**Mandatory — complete Chart/Table capability review**: During the same §IXroster composition, compare every page's information model against every entry-in the already-loaded Chart expression vocabulary and Table registry. These+in the already-loaded Chart and Table expression vocabularies. Thesecomplete capability maps expose what can be selected; their descriptions donot rank candidates or replace judgment from the actual information. They areneither usage quotas nor whitelists. Skip custom objects and qualitativediff --git a/skills/ppt-master/references/visual-styles/_index.md b/skills/ppt-master/references/visual-styles/_index.mdindex 8d81ea02..5563eb74 100644--- a/skills/ppt-master/references/visual-styles/_index.md+++ b/skills/ppt-master/references/visual-styles/_index.md@@ -29,7 +29,7 @@ Each style keeps its own authoritative file with: shape & decoration, typography### 1.1 Corporate / product-| Visual style | Character | Best for | Paired rendering | Illus. |+| Visual style | Character | Typical context | Paired rendering | Illus. ||---|---|---|---|---|| [`swiss-minimal`](./swiss-minimal.md) | Grid-locked, sharp, aggressive whitespace, near-zero ornament | High-end consulting, architecture, type-led | `minimalist-swiss` | sparse || [`soft-rounded`](./soft-rounded.md) | Rounded cards, gentle elevation, approachable | Product, SaaS, training, consumer | `flat` | supportive |@@ -39,7 +39,7 @@ Each style keeps its own authoritative file with: shape & decoration, typography### 1.2 Editorial / publication-| Visual style | Character | Best for | Paired rendering | Illus. |+| Visual style | Character | Typical context | Paired rendering | Illus. ||---|---|---|---|---|| [`editorial`](./editorial.md) | Magazine hierarchy, rules & columns, serif/sans interplay | Finance, journalism, analysis, explainers | `editorial` | supportive || [`photo-editorial`](./photo-editorial.md) | Full-bleed photography dominates, text points & captions | Architecture, design, fashion, culture, travel / destination, photo-led | `corporate-photo` | sparse |@@ -48,7 +48,7 @@ Each style keeps its own authoritative file with: shape & decoration, typography### 1.3 Expressive / print-| Visual style | Character | Best for | Paired rendering | Illus. |+| Visual style | Character | Typical context | Paired rendering | Illus. ||---|---|---|---|---|| [`memphis`](./memphis.md) | Clashing color blocks, geometric confetti, bold outlines | Festivals, consumer, youth, launch hype | `flat` | core || [`zine`](./zine.md) | Riso misregistration, halftone, limited palette, print grit | Culture, design talks, indie brands | `screen-print` | core |@@ -57,7 +57,7 @@ Each style keeps its own authoritative file with: shape & decoration, typography### 1.4 Hand-drawn / brush-| Visual style | Character | Best for | Paired rendering | Illus. |+| Visual style | Character | Typical context | Paired rendering | Illus. ||---|---|---|---|---|| [`sketch-notes`](./sketch-notes.md) | Warm paper, doodle line work, soft pastel blocks | Education, training, onboarding, knowledge | `sketch-notes` | core || [`ink-notes`](./ink-notes.md) | Pale field, black hand-ink, sparse semantic accent | Methodology, before/after, manifestos | `ink-notes` | supportive |@@ -66,39 +66,32 @@ Each style keeps its own authoritative file with: shape & decoration, typography### 1.5 Specialty-| Visual style | Character | Best for | Paired rendering | Illus. |+| Visual style | Character | Typical context | Paired rendering | Illus. ||---|---|---|---|---|| [`pixel-art`](./pixel-art.md) | Strict pixel grid, blocky forms, limited palette, flat | Gaming, retro-tech, nostalgic, game-flavored | `pixel-art` | core |----## 2. Selection recall — communication task + content signal → style--**Reference — not a constraint**: Resolve the audience task, outcome, delivery context, required carriers, and artifact afterlife before using this table. A topic or industry word alone never selects a style. Reject a candidate that weakens the audience's practical task or cannot integrate required real-world imagery. A travel itinerary or destination decision aid is not retro merely because its subject is cultural or hospitality-related; choose retro only when nostalgia / heritage storytelling or an explicit user direction makes it part of the communication job.--| Signal | Recommended style | Alternates |-|---|---|---|-| High-end consulting / architecture / luxury / minimal | `swiss-minimal` | `editorial` |-| Finance / journalism / research / long-form analysis | `editorial` | `data-journalism` |-| Photography-led / architecture / design / fashion / 大图 | `photo-editorial` | `editorial` |-| Itinerary / destination guide / trip planning / 旅游计划 / 行程 | `photo-editorial` | `editorial`, `soft-rounded` |-| Data report / market review / 财经 / Bloomberg / Economist | `data-journalism` | `editorial` |-| Product / SaaS / training / consumer / friendly | `soft-rounded` | `editorial` |-| Modern SaaS / fintech / health-tech / premium app | `glassmorphism` | `dark-tech` |-| Tech / AI / dev tools / data / futuristic | `dark-tech` | `glassmorphism` |-| Cultural / philosophy / heritage / 新中式 / 东方 | `ink-wash` | `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 brand / historic hospitality identity / 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.+## 2. Selection Boundary++**Reference — not a constraint**: Resolve the audience task, outcome, delivery+context, required carriers, and artifact afterlife before choosing. Compare the+complete catalog's character, composition language, density, typography, and+texture with the project as a whole. A topic, industry, or style keyword never+selects a row; the same subject may support different visual systems when its+communication job changes.++| Decision dimension | Evidence to compare |+|---|---|+| Shape and space | Contour language, grid behavior, whitespace, and boundary strength |+| Information texture | Sparse presence, editorial hierarchy, dense evidence, or hand-made expression |+| Carrier integration | How the system accommodates the page's actual photos, illustrations, charts, tables, and native geometry |+| Typography character | The role editable type plays inside the composition, independent of exact font choice |+| Delivery and afterlife | Viewing distance, projection/print behavior, reuse, and expected editing |++> When the deck has AI images, the "Paired rendering" column exposes an+> aesthetically related option. It does not select the rendering or create an+> AI image job; compare it with the actual image roles before using it.>> Not every image-rendering becomes its own visual style. A rendering earns a layout twin only when it defines a whole-page layout language (shape, whitespace, composition, texture) — not merely how an inserted image looks. Purely atmospheric renderings (`nature`, `warm-scene`, `fantasy-animation`) stay imagery-only: they pair with whichever layout style fits rather than being one. (Note the distinction `photo-editorial` draws: photography as a *rendering* is image-look, but photo-*led composition* is a real layout language — so the style exists, paired with `corporate-photo`.)diff --git a/skills/ppt-master/scripts/README.md b/skills/ppt-master/scripts/README.mdindex e15fb252..2329639d 100644--- a/skills/ppt-master/scripts/README.md+++ b/skills/ppt-master/scripts/README.md@@ -55,7 +55,7 @@ python3 scripts/update_repo.py| SVG pipeline | `preset_shape_svg.py`, `shape_boolean_svg.py`, `svg_authoring_view.py`, `compact_svg_coordinates.py`, `mirror_template_materialize.py`, `finalize_svg.py`, `svg_to_pptx.py`, `template_preview_pptx.py`, `total_md_split.py`, `svg_quality_checker.py`, `extract_svg_assets.py`, `extract_svg_pictures.py`, `animation_config.py`, `notes_to_audio.py`, `narration_sync.py` | [docs/svg-pipeline.md](./docs/svg-pipeline.md); [native shape authoring](../references/native-shape-authoring.md) || PPTX transitions | `pptx_transitions.py` | [docs/pptx-transitions.md](./docs/pptx-transitions.md) || PPTX animations | `pptx_animations.py`, `animation_config.py` | [docs/pptx-animations.md](./docs/pptx-animations.md) |-| Animation resources | `sound_sync.py` | [sound catalog](../templates/sounds/README.md); [docs/pptx-animations.md](./docs/pptx-animations.md) |+| Animation resources | `sound_sync.py` | [sound vocabulary and sync](../templates/sounds/README.md); [docs/pptx-animations.md](./docs/pptx-animations.md) || Spec maintenance | `update_spec.py`, `visualization_recall.py`; legacy `chart_recall.py` | [docs/update_spec.md](./docs/update_spec.md); [docs/visualization-recall.md](./docs/visualization-recall.md) || Image tools | `image_gen.py`, `image_treat.py`, `analyze_images.py`, `gemini_watermark_remover.py` | [docs/image.md](./docs/image.md) || Maintenance smokes | Inline temporary-project commands | [advanced image and motion](./docs/advanced-image-motion-smoke.md); [mask and gradient](./docs/mask-gradient-smoke.md); [multilingual text](./docs/multilingual-text-smoke.md) |diff --git a/skills/ppt-master/scripts/docs/svg-pipeline.md b/skills/ppt-master/scripts/docs/svg-pipeline.mdindex 73def5c1..c165b43e 100644--- a/skills/ppt-master/scripts/docs/svg-pipeline.md+++ b/skills/ppt-master/scripts/docs/svg-pipeline.md@@ -691,7 +691,7 @@ Behavior:supplies the default gap between successive non-trigger-shape rows in`after-previous` mode (default `0.5`)- Optional object-level overrides live in `<project>/animations.json` or a path passed via `--animation-config`; build and validate them with `animation_config.py scaffold|validate`. The scaffold is neutral (`defaults.animation.effect: none`, untouched groups `{}`). A populated group uses either the fully compatible legacy single-effect fields or a non-empty `effects[]`, never both; every `effects[]` row names an explicit effect-- Transition/object sound remains off by default. After SVG and visual motion are complete, discover bundled ids with `sound_sync.py list [--query <term>]` and copy only selected ids with `sound_sync.py <project> <namespace>/<sound_id> [...]`. `transition.sound` references a project-relative `.wav`; object-animation `sound` accepts the existing `.m4a`/`.mp3`/`.wav` path contract, while bundled selections use the synced project-relative `.wav`. With no selected cue, do not create `<project>/sounds/`. Export never resolves ids or reads `templates/sounds/` directly+- Transition/object sound remains off by default. After SVG and visual motion are complete and one row has a concrete auditory job, read the complete [`sound-vocabulary.md`](../../templates/sounds/sound-vocabulary.md), then copy only selected ids with `sound_sync.py <project> <namespace>/<sound_id> [...]`; `list --query <term>` is optional exact filtering after that review. `transition.sound` references a project-relative `.wav`; object-animation `sound` accepts the existing `.m4a`/`.mp3`/`.wav` path contract, while bundled selections use the synced project-relative `.wav`. With no selected cue, do not create `<project>/sounds/`. Export never resolves ids or reads `templates/sounds/` directly- One `effects[]` row becomes one Animation Pane record on the group's shape target. Each row may independently set sequence `order`, `delay`, `duration`, `trigger`, and `trigger_shape`; ordinary rows use page-wide order, while `trigger_shape` rows keep relative order in separate interactive sequences and imply `on-click`- Animation configuration is strict: unknown effects/modes/triggers, invalid finite/range/order values, missing slides/groups, and structural-layer targets fail export without fallback or silent omission- Generated export reads every slide back and verifies animation row order, including repeated rows on one shape target, trigger, shape target, resolved effect tuple and native behavior signature, duration, and offset. Package validation then checks timing placement, `p:cTn` ids, and `p:spTgt` references before publicationdiff --git a/skills/ppt-master/scripts/docs/visualization-recall.md b/skills/ppt-master/scripts/docs/visualization-recall.mdindex c8ff1c25..30bb951a 100644--- a/skills/ppt-master/scripts/docs/visualization-recall.md+++ b/skills/ppt-master/scripts/docs/visualization-recall.md@@ -1,7 +1,7 @@# Visualization Candidate RecallDefault Strategist and the Quick Generate main agent read the complete Chart-expression vocabulary and Table registry before planning.+and Table expression vocabularies before planning.`visualization_recall.py validate` resolves their selected canonicalreferences. Its `recall` command remains an optional deterministic diagnosticacross the machine Chart and Table registries; it is not the runtime@@ -11,6 +11,7 @@ or keyword index:- `templates/charts/chart-vocabulary.md` — planning capability map, not read by this tool- `templates/charts/charts_index.json`+- `templates/tables/table-vocabulary.md` — planning capability map, not read by this tool- `templates/tables/tables_index.json`Qualitative Structure does not enter recall. Default records its relationshipdiff --git a/skills/ppt-master/scripts/sound_sync.py b/skills/ppt-master/scripts/sound_sync.pyindex 8aa7b0db..370b5f6b 100644--- a/skills/ppt-master/scripts/sound_sync.py+++ b/skills/ppt-master/scripts/sound_sync.py@@ -2,8 +2,10 @@"""PPT Master - Sound Sync-List the bundled CC0 sound catalog or copy explicitly selected sounds into a-project-local `sounds/` directory. The global library is never copied in bulk.+Inspect the bundled CC0 sound catalog or copy explicitly selected sounds into a+project-local `sounds/` directory. Review `templates/sounds/sound-vocabulary.md`+before using list filters for a resolved auditory job. The global library is+never copied in bulk.Usage:python3 scripts/sound_sync.py list [--query TERM]@@ -216,7 +218,8 @@ def _build_sync_parser() -> argparse.ArgumentParser:parser = argparse.ArgumentParser(description=("Copy explicitly selected library sounds into a project's sounds/ folder. "- "Use `sound_sync.py list [--query TERM]` for discovery."+ "Review `templates/sounds/sound-vocabulary.md` first; use "+ "`sound_sync.py list [--query TERM]` only for optional exact filtering."),formatter_class=argparse.RawDescriptionHelpFormatter,)@@ -266,8 +269,9 @@ def _run_sync(argv: list[str]) -> int:for sound_id in missing:print(f" x {sound_id}", file=sys.stderr)print(- "Run `python3 skills/ppt-master/scripts/sound_sync.py list --query <term>` "- "and select a listed ID.",+ "Review `skills/ppt-master/templates/sounds/sound-vocabulary.md`, then "+ "optionally run `python3 skills/ppt-master/scripts/sound_sync.py list "+ "--query <term>` to locate an exact ID.",file=sys.stderr,)return 1diff --git a/skills/ppt-master/templates/README.md b/skills/ppt-master/templates/README.mdindex eb84a225..f39416f3 100644--- a/skills/ppt-master/templates/README.md+++ b/skills/ppt-master/templates/README.md@@ -122,11 +122,12 @@ kinds:| Family | Owns | Planning map | Machine index ||---|---|---|---|| Chart | Value-driven geometry (33) | [`chart-vocabulary.md`](./charts/chart-vocabulary.md) | [`charts_index.json`](./charts/charts_index.json) |-| Table | Row × column fact grid (6) | [`tables_index.json`](./tables/tables_index.json) | [`tables_index.json`](./tables/tables_index.json) |+| Table | Row × column fact grid (6) | [`table-vocabulary.md`](./tables/table-vocabulary.md) | [`tables_index.json`](./tables/tables_index.json) |[`VISUALIZATION_TEMPLATE_AUTHORING.md`](./VISUALIZATION_TEMPLATE_AUTHORING.md)is the shared authoring contract. Each machine index owns family membership;-the Chart vocabulary is its complete objective planning projection.+the Chart and Table vocabularies are their complete objective planning+projections.Qualitative Structure is a Slide-local Executor method rather than a catalog:Default and Quick both derive its relationship model and compose shapes for the@@ -151,5 +152,7 @@ The `icons/` directory contains 12,027 vector icons across five libraries:## Sound Library-[`sounds/`](./sounds/) is post-motion discovery, not a template or-Strategist resource. Sync selected cues only; see [usage](./sounds/README.md).+[`sounds/`](./sounds/) is a post-motion selection resource, not a template or+Strategist resource. Its complete+[cue vocabulary](./sounds/sound-vocabulary.md) is read only after a concrete+auditory job exists; sync selected cues only. See [usage](./sounds/README.md).diff --git a/skills/ppt-master/templates/VISUALIZATION_TEMPLATE_AUTHORING.md b/skills/ppt-master/templates/VISUALIZATION_TEMPLATE_AUTHORING.mdindex 706d4bf4..000b8f6f 100644--- a/skills/ppt-master/templates/VISUALIZATION_TEMPLATE_AUTHORING.md+++ b/skills/ppt-master/templates/VISUALIZATION_TEMPLATE_AUTHORING.md@@ -324,7 +324,7 @@ Catalog 模板本身只有一个主 Chart,可保留上述 unscoped marker 与| 分类 | 目录 | 机器索引 | 规划词汇表 ||---|---|---|---|| `chart` | `charts/` | `charts_index.json` → `charts` | `chart-vocabulary.md` |-| `table` | `tables/` | `tables_index.json` → `tables` | 同一份紧凑注册表 |+| `table` | `tables/` | `tables_index.json` → `tables` | `table-vocabulary.md` |每个 `<key>.summary` 使用相同的选择句合同:@@ -335,12 +335,12 @@ Catalog 模板本身只有一个主 Chart,可保留上述 unscoped marker 与````summary` 保留 `Pick for ... Skip if ...` 句式,供可选的机器召回诊断使用;-规划主路径不读取这些记录。Chart 的 `chart-vocabulary.md` 必须完整列出同一组-canonical `chart/<key>`,只说明信息关系,不写 SVG 实现、布局参数或选择结论。+规划主路径不读取这些记录。Chart 与 Table 的规划词汇表必须完整列出各自同一组+canonical `family/<key>`,只说明信息关系,不写 SVG 实现、布局参数或选择结论。**Hard rule**: `key` 与同 family 文件名一致,`meta.total` 与该 family catalog-数量一致;Chart vocabulary 与 index 的成员集合必须精确一致。除此以外不要建立-跨 family 的第二份成员清单。+数量一致;每份 planning vocabulary 与 owning index 的成员集合必须精确一致。+除此以外不要建立跨 family 的第二份成员清单。---diff --git a/skills/ppt-master/templates/sounds/README.md b/skills/ppt-master/templates/sounds/README.mdindex 6858552d..7f8d59f1 100644--- a/skills/ppt-master/templates/sounds/README.md+++ b/skills/ppt-master/templates/sounds/README.md@@ -11,7 +11,8 @@ CC0 sound effects prepared as PowerPoint-compatible WAV files:Source snapshots, license declarations, and modifications are recorded in[THIRD_PARTY_NOTICES.md](./THIRD_PARTY_NOTICES.md). Machine-readable metadata-for every sound lives in [sounds_index.json](./sounds_index.json).+for every sound lives in [sounds_index.json](./sounds_index.json). The complete+planning-side identity map is [sound-vocabulary.md](./sound-vocabulary.md).## Project-local selection@@ -20,11 +21,10 @@ does not create a `sounds/` directory or copy the library. Copy only the soundsexplicitly selected for a deck:```bash-python3 skills/ppt-master/scripts/sound_sync.py list --query whooshpython3 skills/ppt-master/scripts/sound_sync.py projects/deck bigsoundbank/1797 kenney-interface/click_001```-The second command copies only those files to:+The command copies only those files to:```textprojects/deck/sounds/bigsoundbank/1797.wav@@ -38,19 +38,21 @@ preflight rejects a destination that escapes the resolved project root througha symlink, as well as an existing project file whose content differs from theselected library ID; the tool never silently overwrites that conflict.-## Discovery+## Vocabulary and optional filtering-List the full catalog or filter it by stable ID, label, tag, or context:+After a resolved motion row has a concrete auditory job, read+[sound-vocabulary.md](./sound-vocabulary.md) completely. It groups all 186+canonical ids by objective cue context and includes each label, duration, and+registered context without a recommendation ranking.++Use the CLI only to locate an already-considered id, label, tag, or context:```bash-python3 skills/ppt-master/scripts/sound_sync.py listpython3 skills/ppt-master/scripts/sound_sync.py list --query transition-python3 skills/ppt-master/scripts/sound_sync.py list --query recommended```-The `recommended` flag is a conservative discovery shortlist for presentation-use; it does not add sounds automatically. Sound remains opt-in, and the full-catalog stays available when another cue better fits the design.+The filter is optional and never replaces complete vocabulary review or current+motion judgment. Sound remains opt-in, and silence is valid.## Format boundarydiff --git a/skills/ppt-master/templates/tables/README.md b/skills/ppt-master/templates/tables/README.mdindex f8bbb75e..c73b830f 100644--- a/skills/ppt-master/templates/tables/README.md+++ b/skills/ppt-master/templates/tables/README.md@@ -12,15 +12,20 @@ Master/Layout systems belong in [`layouts/`](../layouts/).## Source of truth-[`tables_index.json`](./tables_index.json) is the sole table registry. Its-`tables` object maps each canonical key to one selection-rule `summary`; keys-match `<key>.svg`, and `meta.total` matches the canonical SVG roster.+[`tables_index.json`](./tables_index.json) is the machine registry. Its+`tables` object maps each canonical key to one diagnostic-recall `summary`;+keys match `<key>.svg`, and `meta.total` matches the canonical SVG roster.+[`table-vocabulary.md`](./table-vocabulary.md) projects the same six keys as+objective planning-side information relationships without execution details or+selection conclusions.-Default Strategist and Quick read this complete compact registry together with-the Chart registry before planning. They compare every selection rule, then use+Default Strategist and Quick read the complete Table vocabulary together with+the Chart vocabulary before planning. They compare every objective+relationship, then use[`visualization_recall.py`](../../scripts/visualization_recall.py) `validate`to resolve selected canonical references. Its `recall` mode remains an optional-diagnostic helper, not the runtime capability gate. Default writes+diagnostic helper over the machine registry, not the runtime capability gate.+Default writes`table/<key>` to `page_visualizations`; Quick keeps the selected reference inactive context.diff --git a/skills/ppt-master/workflows/generate-pptx.md b/skills/ppt-master/workflows/generate-pptx.mdindex 7dbe9f51..b1c53880 100644--- a/skills/ppt-master/workflows/generate-pptx.md+++ b/skills/ppt-master/workflows/generate-pptx.md@@ -281,7 +281,7 @@ Read references/visual-styles/_index.mdRead references/image-renderings/_index.mdRead templates/icons/README.mdRead templates/charts/chart-vocabulary.md-Read templates/tables/tables_index.json+Read templates/tables/table-vocabulary.md```This is a capability map, not a usage checklist: retain zero-use outcomes anddiff --git a/skills/ppt-master/workflows/profiles/quick-generate.md b/skills/ppt-master/workflows/profiles/quick-generate.mdindex 7e9b03b3..52972017 100644--- a/skills/ppt-master/workflows/profiles/quick-generate.md+++ b/skills/ppt-master/workflows/profiles/quick-generate.md@@ -256,7 +256,7 @@ Read references/visual-styles/_index.mdRead references/image-renderings/_index.mdRead templates/icons/README.mdRead templates/charts/chart-vocabulary.md-Read templates/tables/tables_index.json+Read templates/tables/table-vocabulary.md```This batch is the complete capability map for planning, not a usage checklist:@@ -422,7 +422,7 @@ Resolving one visual style, `Illus.` propensity, or generated-image rendering re**Mandatory — complete Chart/Table capability review**: During that samecarrier resolution, compare every page's information model against every entry-in the already-loaded Chart expression vocabulary and Table registry. These+in the already-loaded Chart and Table expression vocabularies. Thesecomplete capability maps expose what exists; their descriptions do not rankcandidates or replace judgment from the actual information, and they areneither usage quotas nor whitelists. Do not select a catalog reference fordiff --git a/skills/ppt-master/workflows/stages/customize-animations.md b/skills/ppt-master/workflows/stages/customize-animations.mdindex db9f476b..74126e21 100644--- a/skills/ppt-master/workflows/stages/customize-animations.md+++ b/skills/ppt-master/workflows/stages/customize-animations.md@@ -313,10 +313,11 @@ post-processing state: do not recover it from or write it back to| Need | Action ||---|---|| No resolved cue needs sound | Omit every `sound` field; do not create `<project_path>/sounds/` |-| A bundled cue fits one resolved transition or animation row | Discover with `sound_sync.py list [--query <term>]`, then sync only the chosen namespaced id(s) into the project |+| A bundled cue fits one resolved transition or animation row | Read the complete [`sound-vocabulary.md`](../../templates/sounds/sound-vocabulary.md), choose from the resolved auditory job, then sync only the selected namespaced id(s) into the project || The project already contains user-provided audio | Use its project-relative path when its format is valid; no library sync is required |```bash+# Optional exact filtering after reviewing the complete vocabularypython3 skills/ppt-master/scripts/sound_sync.py list --query <term>python3 skills/ppt-master/scripts/sound_sync.py \<project_path> <namespace>/<sound_id> [<namespace>/<sound_id> ...]