ppt-template-reuse 0.4.0-rc.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NEU-ZHA
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE.md

@@ -0,0 +1,8 @@
+# Notice
+
+`ppt-template-reuse` does not distribute third-party presentation templates,
+logos, fonts, or course materials. Users are responsible for obtaining and
+using source templates under appropriate permissions.
+
+Generated local template capsules retain source paths and hashes for fidelity
+validation and must not be included in public plugin distributions.

package/README.md

@@ -0,0 +1,233 @@
+# PPT Template Reuse
+
+`ppt-template-reuse` is a local-first, host-neutral engine that learns what a
+native PowerPoint template is for and turns user material into a
+content-complete, editable deck with speaker notes and rendered QA.
+
+The package is one system with four layers:
+
+1. `core`: deterministic source extraction, template inspection, adaptive
+   planning, native OOXML editing, rendering, and validation;
+2. `ppt-reuse`: a resumable command-line interface;
+3. MCP: nine stable tools for any compatible AI host;
+4. Skill adapters for Codex, Claude Code, Kimi Code, Kimi Work, and WorkBuddy.
+
+The host AI supplies semantic judgment. The local engine keeps every source
+anchor, freezes the plan, edits PPTX objects, and enforces quality gates. It
+does not need a separate model API key.
+
+## Status
+
+The current package version is `0.4.0-rc.2`. It is a release candidate for
+macOS and Windows. Linux is covered by core/protocol CI but is not yet a
+declared desktop compatibility target.
+
+## Requirements
+
+- Node.js 20 or 22;
+- LibreOffice for final rendering and acceptance;
+- a native `.pptx` or `.potx` template;
+- one of `.docx`, `.pdf`, `.pptx`, `.md`, or `.txt` as source material.
+
+Macro-enabled `.pptm` files are rejected and macros are never executed.
+Scanned PDF pages are returned to the host AI as visual-analysis tasks.
+
+## Install
+
+For a local checkout:
+
+```bash
+npm install
+npm install -g .
+ppt-reuse doctor --host all
+ppt-reuse install --auto
+```
+
+After the release candidate is published to npm:
+
+```bash
+npm install -g ppt-template-reuse@next
+ppt-reuse install --auto
+```
+
+`install --auto` detects supported hosts, shows and records the files it
+changes, creates timestamped backups, merges MCP configuration idempotently,
+and installs the same Skill workflow. Kimi Work and WorkBuddy still require
+one explicit import/trust confirmation in their UI.
+
+### Codex plugin
+
+The repository also remains a Codex Marketplace:
+
+```bash
+codex plugin marketplace add NEU-ZHA/ppt-template-reuse --ref v0.4.0-rc.2
+codex plugin add ppt-template-reuse@ppt-template-reuse
+```
+
+The plugin calls the public local MCP engine; it no longer depends on Codex's
+built-in Presentations Skill or `@oai/artifact-tool`.
+
+### Claude Code
+
+`adapters/claude/` contains `.claude-plugin/plugin.json`, a Skill, and
+`.mcp.json`. It can be distributed through a Claude Code plugin marketplace or
+installed by `ppt-reuse install --auto`.
+
+### Kimi Code and Kimi Work
+
+`adapters/kimi/` contains `kimi.plugin.json` with the Skill and MCP declaration.
+`adapters/kimi-work/` is an import-ready local Skill plus a separate MCP file.
+
+### WorkBuddy
+
+`adapters/workbuddy/` contains the uploadable Skill and local MCP declaration.
+The release builder emits a Skill-only WorkBuddy ZIP plus a separate MCP JSON,
+so the Skill importer receives the expected `SKILL.md` package.
+
+## Natural use
+
+After the one-time installation and trust confirmation, the user can simply
+say:
+
+```text
+参考这个模板和这些材料，做一份内容完整、可编辑、带讲稿的PPT。
+根据材料多少自动决定页数；缺图片就先集中告诉我；逐页显示真实预览。
+```
+
+The Skill drives this sequence automatically:
+
+```text
+create session → inspect → submit semantics → freeze plan
+→ supply required assets → generate → poll previews → validate
+```
+
+Users do not need to know the MCP tool names or write JSON.
+
+## CLI
+
+```bash
+ppt-reuse create \
+  --template "/absolute/path/template.pptx" \
+  --source "/absolute/path/source.docx" \
+  --output "/absolute/path/result.pptx" \
+  --root "/absolute/path" \
+  --duration 12-15 \
+  --density rich
+
+ppt-reuse status <session-id>
+ppt-reuse resume <session-id>
+ppt-reuse mcp --stdio
+ppt-reuse serve --host 127.0.0.1 --port 8765
+
+# Import a previously reviewed, SHA-bound template capsule:
+ppt-reuse import-capsule \
+  --capsule "/absolute/path/reviewed-capsule" \
+  --template "/absolute/path/template.pptx" \
+  --opening 3 \
+  --closing 10 \
+  --approve 26
+```
+
+Sessions live under `~/.ppt-template-reuse/sessions/`. Template profiles live
+under `~/.ppt-template-reuse/library/`. Existing
+`~/.codex/ppt-template-reuse/library/` capsules are indexed as read-only legacy
+references and are never moved or deleted.
+
+The CLI exposes the mechanical engine. In normal use, an AI host completes the
+semantic packages returned by `ppt_inspect` before planning.
+
+## MCP contract
+
+- `ppt_create_session`
+- `ppt_inspect`
+- `ppt_submit_semantics`
+- `ppt_plan`
+- `ppt_supply_assets`
+- `ppt_generate`
+- `ppt_status`
+- `ppt_validate`
+- `ppt_cancel`
+
+Long generation uses persistent `sessionId`/`jobId` values and polling, not
+experimental MCP task APIs. Frozen plans, QA reports, outputs, and page previews
+are also available as `ppt://session/...` resources. Both stdio and loopback
+Streamable HTTP are supported.
+
+## Content completeness
+
+- deterministic extraction records every paragraph, heading, table, slide, or
+  PDF page with an immutable id and anchor, then splits oversized blocks into
+  300–400-character child units with preserved parent anchors;
+- host semantics cannot omit, replace, or invent those ids;
+- slide count grows with original character volume, independent claims,
+  evidence, argument chains, template capacity, and speaking time;
+- `critical` coverage must be 100%; weighted relevant coverage must be at least
+  95%;
+- every included unit must trace to matching visible text or notes; original
+  source-text trace coverage and critical visible coverage must both be 100%,
+  while weighted visible coverage must be at least 90%;
+- structured `displayFragments` carry dates, labels, steps, metric labels, and
+  concise descriptions into timeline, process, comparison, and multi-item
+  slots instead of forcing every page into generic claim/evidence boxes;
+- original source text is stored in a clearly marked non-spoken trace block;
+  speaking time is calculated from the talk track, and short material is not
+  padded just to reach a requested minimum;
+- every analysis page needs claim, evidence, why-it-matters, and native notes;
+- counterarguments require mapped rebuttals;
+- overloaded content is split instead of compressed with smaller fonts;
+- missing visual assets block generation instead of becoming gray placeholders.
+
+A previous 19-page deck is a private regression fixture for one source volume,
+not a global page target.
+
+Public pressure tests cover 500–50,000 source characters, 1–100 pre-segmented
+semantic units, clustered and argument-chain structures, and one-, two-, and
+three-body-slot templates. They require monotonically increasing extraction and
+page counts, 100% traceable source coverage, and deterministic output in the
+same rendering environment.
+
+The baseline scale test uses 5, 30, and 100 semantic units and currently yields
+8, 33, and 103 pages on the synthetic three-body template. The character-volume
+test currently yields 4, 10, 19, 35, 66, and 160 pages for 500, 2,000, 5,000,
+10,000, 20,000, and 50,000 source characters. These are regression observations,
+not hard-coded targets.
+
+## Fidelity and safety
+
+The native OOXML layer rebuilds the presentation slide sequence while preserving
+untouched package parts, masters, layouts, themes, animations, SmartArt, media,
+and protected objects. It can rewrite declared text slots, replace inherited
+images, update matching table cells, and append native speaker notes.
+
+Chart editing is fail-closed until both the visible cache and embedded workbook
+can be synchronized and rendered. Flattened decks are `hybrid-locked` and are
+never described as fully editable. Exact native generation never executes
+macros.
+
+The engine only accepts declared roots, the current workspace, and temporary
+directories. It does not connect to the internet or upload templates and
+materials. A host may separately search or generate images when the user
+authorizes it.
+
+## Validation
+
+```bash
+npm run check:all
+npm run privacy
+npm run release:build
+```
+
+The test suite covers adaptive page growth, complete source coverage,
+three-run determinism, native notes, OOXML structure, optional real rendering,
+MCP schemas/resources, stdio and loopback HTTP, path rejection, macro rejection,
+installer idempotency, uninstall, and an environment-gated private golden
+fixture.
+
+Final acceptance requires real LibreOffice rendering plus rendered-text
+fidelity checks between native PPTX text and exported PDF text. Missing or
+substituted glyphs keep the deck in `validation-failed` even when protected
+pixels pass. In that case WPS/PowerPoint compatibility remains
+manual-review-required until a person opens and smoke-tests the result.
+
+Public release packages contain no user templates, course materials, local
+capsules, generated decks, personal paths, or platform tokens.

package/adapters/README.md

@@ -0,0 +1,13 @@
+# Host adapters
+
+All adapters use the canonical workflow in
+`skills/ppt-template-reuse/SKILL.md` and the same local
+`ppt-template-reuse-mcp` command.
+
+- `claude/`: Claude Code plugin manifest, Skill, and MCP declaration.
+- `kimi/`: Kimi Code plugin manifest with the Skill and MCP declaration.
+- `kimi-work/`: local Skill plus MCP files prepared for one-time UI import.
+- `workbuddy/`: uploadable Skill plus local MCP files.
+
+Kimi Work and WorkBuddy keep their required host trust/import step. The
+installer prepares these folders but never bypasses host confirmation.

package/adapters/claude/.claude-plugin/plugin.json

@@ -0,0 +1,16 @@
+{
+  "name": "ppt-template-reuse",
+  "version": "0.4.0-rc.2",
+  "description": "Content-complete editable PPTX generation from native templates through a local host-neutral MCP engine.",
+  "author": {
+    "name": "NEU-ZHA"
+  },
+  "license": "MIT",
+  "keywords": [
+    "pptx",
+    "powerpoint",
+    "template",
+    "speaker-notes",
+    "mcp"
+  ]
+}

package/adapters/claude/.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "ppt-template-reuse": {
+      "command": "ppt-template-reuse-mcp",
+      "args": []
+    }
+  }
+}

package/adapters/claude/skills/learn-ppt-template/SKILL.md

@@ -0,0 +1,105 @@
+---
+name: learn-ppt-template
+description: Create a content-complete, editable PowerPoint from a user-provided PPTX/POTX template and DOCX, PDF, PPTX, Markdown, or text material. Use whenever the user asks to make, imitate, learn, follow, or reuse a presentation template. Identify what every template page is for, adapt page count to source volume, preserve reasoning in native speaker notes, request missing visuals, expose real page previews, and stop on unresolved layouts, unsafe object edits, incomplete source coverage, or failed rendering. Works through the host-neutral ppt-template-reuse MCP or ppt-reuse CLI.
+---
+
+# Learn PPT Template
+
+Use the `ppt-template-reuse` MCP server as the normal execution path. Do not ask
+the user to prepare JSON, choose a page count, or run commands.
+
+## Default behavior
+
+For a request such as “参考这个模板和这些材料做一份内容完整、可编辑、带讲稿的
+PPT”:
+
+1. Call `ppt_create_session` with the template, material, output path, current
+   workspace roots, and stated audience/duration.
+2. Call `ppt_inspect`.
+3. Read every extracted source unit. Submit every original `id` and `anchor`
+   through `ppt_submit_semantics`; label facts, chronology, issues, rules,
+   evidence, analysis, counterarguments, rebuttals, conclusions, and
+   recommendations. Preserve `parentAnchor`, `segmentIndex`, and `segmentCount`
+   when a long paragraph, table, slide, or PDF page was deterministically
+   segmented. Never silently merge away or omit a unit.
+   For structured layouts, also supply short `displayFragments` with roles such
+   as `date`, `label`, `step`, `metric-label`, `body`, or `description`. These
+   are source-grounded slot values, not invented decoration. A timeline needs
+   dates and node labels; a multi-item grid needs one label/body pair per item.
+4. Review only template slides returned as unresolved. Classify each page's
+   purpose, safe slots, capacity, required assets, protected elements, and
+   editability. Never approve uncertain SmartArt, chart, media, animation, icon,
+   or flattened-object edits. If several opening or closing variants are
+   returned, approve exactly one for each role and block the alternatives; do
+   not choose by page order.
+5. Call `ppt_plan`. Let source volume, argument structure, slot capacity, and
+   requested speaking time determine page count. If planning returns
+   `template-selection`, show the returned full-size candidates, approve one
+   source slide for that role, block the competing candidates in the frozen
+   template profile, resubmit semantics, and plan again. Never break a tie by
+   page number.
+6. If assets are required, use the host's image search or generation capability
+   when authorized; otherwise ask once for all missing assets. Register them
+   with `ppt_supply_assets`. Never permit gray blocks or temporary placeholders.
+7. Call `ppt_generate`, then poll `ppt_status`. Show new real page previews in
+   order. Stop when the status contains `actionRequired`.
+8. Call `ppt_validate` when generation did not already validate. Deliver only
+   when state is `completed`.
+
+## Content rules
+
+- Preserve 100% of `critical` units and at least 95% weighted relevant content.
+- Require every included source unit to have a verified destination trace.
+  Preserve 100% of original source text in speaker notes, visibly represent
+  100% of critical units, and visibly represent at least 90% of weighted
+  relevant units. A `sourceUnitId` without matching field or notes text is not
+  coverage.
+- Put source-verification text in a clearly marked
+  `[来源追踪，不逐字朗读]` notes block. Estimate duration from the spoken
+  explanation, not from that reference block. Do not add filler slides merely
+  because a short source finishes below the requested minimum time.
+- Each analysis slide needs a claim, evidence, why-it-matters explanation, and
+  native speaker notes.
+- Pair each represented counterargument with a response.
+- Split overloaded material across more approved layouts; never shrink inherited
+  typography or delete reasoning to force a target page count.
+- Use `core`, `appendix`, and `exclude` deliberately. An explicit duration
+  conflict requires a user choice between more time, narrower scope, or multiple
+  decks.
+- A prior 19-page deck is only a regression example, never a fixed length.
+- Do not infer length from unit count alone. Use original character volume,
+  argument nodes, counterargument chains, requested time, and the approved
+  template slot capacity. Very long material may legitimately produce dozens
+  or more than one hundred pages; stop for a duration/scope decision instead of
+  compressing it to a familiar deck length.
+
+## Template and object rules
+
+- Exact native mode supports `.pptx` and `.potx`; `.pptm` is rejected and macros
+  are never executed.
+- Treat flattened templates as `hybrid-locked`. Do not call them fully editable.
+- Edit only declared slots. Preserve masters, layouts, themes, logos, page
+  chrome, animations, SmartArt, media, and all untargeted objects.
+- Replace inherited images in place. Update tables only when dimensions match.
+  Update charts only when the embedded workbook and rendered result can both be
+  validated; otherwise stop.
+- “插入图片”, “相关图片”, “ICON”, sample copy, and gray image blocks are
+  requirements, not audience-facing content.
+- If an older reviewed template capsule is available, import it only when its
+  source SHA256 matches. Keep deny-by-default safety, preserve the old
+  preview/review bindings, approve exactly one opening and closing, and never
+  re-guess already reviewed slots.
+
+## Completion gate
+
+Completion requires a frozen content plan and frame map, native speaker notes,
+no residual examples or placeholders, matching slide/render counts, real
+LibreOffice rendering, rendered-text fidelity, and a passing QA report. If
+LibreOffice is missing or its PDF contains missing/substituted glyphs, analysis
+and planning may complete but the PPTX must remain `validation-failed` until a
+manual WPS or PowerPoint review confirms text, line breaks, images, notes, and
+masters.
+
+The engine is local-first: it only reads declared roots/current workspace and
+temporary files, does not upload templates or material, and does not use the
+network by itself.

package/adapters/kimi/kimi.plugin.json

@@ -0,0 +1,12 @@
+{
+  "name": "ppt-template-reuse",
+  "version": "0.4.0-rc.2",
+  "description": "学习原生PPT模板用途，并根据材料体量生成内容完整、可编辑、带讲稿和真实预览的演示文稿。",
+  "skills": "./skills/",
+  "mcpServers": {
+    "ppt-template-reuse": {
+      "command": "ppt-template-reuse-mcp",
+      "args": []
+    }
+  }
+}

package/adapters/kimi/skills/learn-ppt-template/SKILL.md

@@ -0,0 +1,105 @@
+---
+name: learn-ppt-template
+description: Create a content-complete, editable PowerPoint from a user-provided PPTX/POTX template and DOCX, PDF, PPTX, Markdown, or text material. Use whenever the user asks to make, imitate, learn, follow, or reuse a presentation template. Identify what every template page is for, adapt page count to source volume, preserve reasoning in native speaker notes, request missing visuals, expose real page previews, and stop on unresolved layouts, unsafe object edits, incomplete source coverage, or failed rendering. Works through the host-neutral ppt-template-reuse MCP or ppt-reuse CLI.
+---
+
+# Learn PPT Template
+
+Use the `ppt-template-reuse` MCP server as the normal execution path. Do not ask
+the user to prepare JSON, choose a page count, or run commands.
+
+## Default behavior
+
+For a request such as “参考这个模板和这些材料做一份内容完整、可编辑、带讲稿的
+PPT”:
+
+1. Call `ppt_create_session` with the template, material, output path, current
+   workspace roots, and stated audience/duration.
+2. Call `ppt_inspect`.
+3. Read every extracted source unit. Submit every original `id` and `anchor`
+   through `ppt_submit_semantics`; label facts, chronology, issues, rules,
+   evidence, analysis, counterarguments, rebuttals, conclusions, and
+   recommendations. Preserve `parentAnchor`, `segmentIndex`, and `segmentCount`
+   when a long paragraph, table, slide, or PDF page was deterministically
+   segmented. Never silently merge away or omit a unit.
+   For structured layouts, also supply short `displayFragments` with roles such
+   as `date`, `label`, `step`, `metric-label`, `body`, or `description`. These
+   are source-grounded slot values, not invented decoration. A timeline needs
+   dates and node labels; a multi-item grid needs one label/body pair per item.
+4. Review only template slides returned as unresolved. Classify each page's
+   purpose, safe slots, capacity, required assets, protected elements, and
+   editability. Never approve uncertain SmartArt, chart, media, animation, icon,
+   or flattened-object edits. If several opening or closing variants are
+   returned, approve exactly one for each role and block the alternatives; do
+   not choose by page order.
+5. Call `ppt_plan`. Let source volume, argument structure, slot capacity, and
+   requested speaking time determine page count. If planning returns
+   `template-selection`, show the returned full-size candidates, approve one
+   source slide for that role, block the competing candidates in the frozen
+   template profile, resubmit semantics, and plan again. Never break a tie by
+   page number.
+6. If assets are required, use the host's image search or generation capability
+   when authorized; otherwise ask once for all missing assets. Register them
+   with `ppt_supply_assets`. Never permit gray blocks or temporary placeholders.
+7. Call `ppt_generate`, then poll `ppt_status`. Show new real page previews in
+   order. Stop when the status contains `actionRequired`.
+8. Call `ppt_validate` when generation did not already validate. Deliver only
+   when state is `completed`.
+
+## Content rules
+
+- Preserve 100% of `critical` units and at least 95% weighted relevant content.
+- Require every included source unit to have a verified destination trace.
+  Preserve 100% of original source text in speaker notes, visibly represent
+  100% of critical units, and visibly represent at least 90% of weighted
+  relevant units. A `sourceUnitId` without matching field or notes text is not
+  coverage.
+- Put source-verification text in a clearly marked
+  `[来源追踪，不逐字朗读]` notes block. Estimate duration from the spoken
+  explanation, not from that reference block. Do not add filler slides merely
+  because a short source finishes below the requested minimum time.
+- Each analysis slide needs a claim, evidence, why-it-matters explanation, and
+  native speaker notes.
+- Pair each represented counterargument with a response.
+- Split overloaded material across more approved layouts; never shrink inherited
+  typography or delete reasoning to force a target page count.
+- Use `core`, `appendix`, and `exclude` deliberately. An explicit duration
+  conflict requires a user choice between more time, narrower scope, or multiple
+  decks.
+- A prior 19-page deck is only a regression example, never a fixed length.
+- Do not infer length from unit count alone. Use original character volume,
+  argument nodes, counterargument chains, requested time, and the approved
+  template slot capacity. Very long material may legitimately produce dozens
+  or more than one hundred pages; stop for a duration/scope decision instead of
+  compressing it to a familiar deck length.
+
+## Template and object rules
+
+- Exact native mode supports `.pptx` and `.potx`; `.pptm` is rejected and macros
+  are never executed.
+- Treat flattened templates as `hybrid-locked`. Do not call them fully editable.
+- Edit only declared slots. Preserve masters, layouts, themes, logos, page
+  chrome, animations, SmartArt, media, and all untargeted objects.
+- Replace inherited images in place. Update tables only when dimensions match.
+  Update charts only when the embedded workbook and rendered result can both be
+  validated; otherwise stop.
+- “插入图片”, “相关图片”, “ICON”, sample copy, and gray image blocks are
+  requirements, not audience-facing content.
+- If an older reviewed template capsule is available, import it only when its
+  source SHA256 matches. Keep deny-by-default safety, preserve the old
+  preview/review bindings, approve exactly one opening and closing, and never
+  re-guess already reviewed slots.
+
+## Completion gate
+
+Completion requires a frozen content plan and frame map, native speaker notes,
+no residual examples or placeholders, matching slide/render counts, real
+LibreOffice rendering, rendered-text fidelity, and a passing QA report. If
+LibreOffice is missing or its PDF contains missing/substituted glyphs, analysis
+and planning may complete but the PPTX must remain `validation-failed` until a
+manual WPS or PowerPoint review confirms text, line breaks, images, notes, and
+masters.
+
+The engine is local-first: it only reads declared roots/current workspace and
+temporary files, does not upload templates or material, and does not use the
+network by itself.

package/adapters/kimi-work/mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "ppt-template-reuse": {
+      "command": "ppt-template-reuse-mcp",
+      "args": []
+    }
+  }
+}

package/adapters/kimi-work/skills/learn-ppt-template/SKILL.md

@@ -0,0 +1,105 @@
+---
+name: learn-ppt-template
+description: Create a content-complete, editable PowerPoint from a user-provided PPTX/POTX template and DOCX, PDF, PPTX, Markdown, or text material. Use whenever the user asks to make, imitate, learn, follow, or reuse a presentation template. Identify what every template page is for, adapt page count to source volume, preserve reasoning in native speaker notes, request missing visuals, expose real page previews, and stop on unresolved layouts, unsafe object edits, incomplete source coverage, or failed rendering. Works through the host-neutral ppt-template-reuse MCP or ppt-reuse CLI.
+---
+
+# Learn PPT Template
+
+Use the `ppt-template-reuse` MCP server as the normal execution path. Do not ask
+the user to prepare JSON, choose a page count, or run commands.
+
+## Default behavior
+
+For a request such as “参考这个模板和这些材料做一份内容完整、可编辑、带讲稿的
+PPT”:
+
+1. Call `ppt_create_session` with the template, material, output path, current
+   workspace roots, and stated audience/duration.
+2. Call `ppt_inspect`.
+3. Read every extracted source unit. Submit every original `id` and `anchor`
+   through `ppt_submit_semantics`; label facts, chronology, issues, rules,
+   evidence, analysis, counterarguments, rebuttals, conclusions, and
+   recommendations. Preserve `parentAnchor`, `segmentIndex`, and `segmentCount`
+   when a long paragraph, table, slide, or PDF page was deterministically
+   segmented. Never silently merge away or omit a unit.
+   For structured layouts, also supply short `displayFragments` with roles such
+   as `date`, `label`, `step`, `metric-label`, `body`, or `description`. These
+   are source-grounded slot values, not invented decoration. A timeline needs
+   dates and node labels; a multi-item grid needs one label/body pair per item.
+4. Review only template slides returned as unresolved. Classify each page's
+   purpose, safe slots, capacity, required assets, protected elements, and
+   editability. Never approve uncertain SmartArt, chart, media, animation, icon,
+   or flattened-object edits. If several opening or closing variants are
+   returned, approve exactly one for each role and block the alternatives; do
+   not choose by page order.
+5. Call `ppt_plan`. Let source volume, argument structure, slot capacity, and
+   requested speaking time determine page count. If planning returns
+   `template-selection`, show the returned full-size candidates, approve one
+   source slide for that role, block the competing candidates in the frozen
+   template profile, resubmit semantics, and plan again. Never break a tie by
+   page number.
+6. If assets are required, use the host's image search or generation capability
+   when authorized; otherwise ask once for all missing assets. Register them
+   with `ppt_supply_assets`. Never permit gray blocks or temporary placeholders.
+7. Call `ppt_generate`, then poll `ppt_status`. Show new real page previews in
+   order. Stop when the status contains `actionRequired`.
+8. Call `ppt_validate` when generation did not already validate. Deliver only
+   when state is `completed`.
+
+## Content rules
+
+- Preserve 100% of `critical` units and at least 95% weighted relevant content.
+- Require every included source unit to have a verified destination trace.
+  Preserve 100% of original source text in speaker notes, visibly represent
+  100% of critical units, and visibly represent at least 90% of weighted
+  relevant units. A `sourceUnitId` without matching field or notes text is not
+  coverage.
+- Put source-verification text in a clearly marked
+  `[来源追踪，不逐字朗读]` notes block. Estimate duration from the spoken
+  explanation, not from that reference block. Do not add filler slides merely
+  because a short source finishes below the requested minimum time.
+- Each analysis slide needs a claim, evidence, why-it-matters explanation, and
+  native speaker notes.
+- Pair each represented counterargument with a response.
+- Split overloaded material across more approved layouts; never shrink inherited
+  typography or delete reasoning to force a target page count.
+- Use `core`, `appendix`, and `exclude` deliberately. An explicit duration
+  conflict requires a user choice between more time, narrower scope, or multiple
+  decks.
+- A prior 19-page deck is only a regression example, never a fixed length.
+- Do not infer length from unit count alone. Use original character volume,
+  argument nodes, counterargument chains, requested time, and the approved
+  template slot capacity. Very long material may legitimately produce dozens
+  or more than one hundred pages; stop for a duration/scope decision instead of
+  compressing it to a familiar deck length.
+
+## Template and object rules
+
+- Exact native mode supports `.pptx` and `.potx`; `.pptm` is rejected and macros
+  are never executed.
+- Treat flattened templates as `hybrid-locked`. Do not call them fully editable.
+- Edit only declared slots. Preserve masters, layouts, themes, logos, page
+  chrome, animations, SmartArt, media, and all untargeted objects.
+- Replace inherited images in place. Update tables only when dimensions match.
+  Update charts only when the embedded workbook and rendered result can both be
+  validated; otherwise stop.
+- “插入图片”, “相关图片”, “ICON”, sample copy, and gray image blocks are
+  requirements, not audience-facing content.
+- If an older reviewed template capsule is available, import it only when its
+  source SHA256 matches. Keep deny-by-default safety, preserve the old
+  preview/review bindings, approve exactly one opening and closing, and never
+  re-guess already reviewed slots.
+
+## Completion gate
+
+Completion requires a frozen content plan and frame map, native speaker notes,
+no residual examples or placeholders, matching slide/render counts, real
+LibreOffice rendering, rendered-text fidelity, and a passing QA report. If
+LibreOffice is missing or its PDF contains missing/substituted glyphs, analysis
+and planning may complete but the PPTX must remain `validation-failed` until a
+manual WPS or PowerPoint review confirms text, line breaks, images, notes, and
+masters.
+
+The engine is local-first: it only reads declared roots/current workspace and
+temporary files, does not upload templates or material, and does not use the
+network by itself.

package/adapters/workbuddy/mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "ppt-template-reuse": {
+      "command": "ppt-template-reuse-mcp",
+      "args": []
+    }
+  }
+}