Creatppt

CreatPPT

Create a completed presentation workspace as deck.json plus local assets. Do not generate, save, or return a PPTX during the Agent generation flow. PPTX generation belongs exclusively to the visible “导出 PPT” action in the Web workspace.

Prerequisites

• Node.js 20 or newer.
• For the published package, invoke npx @seekskyworld/creatppt@latest ... directly.
• For a local checkout, run npm ci && npm run build once, then invoke node <CREATPPT_ROOT>/dist/node/cli.js ....
• Run published-package smoke commands from the Agent's host project or a clean temporary directory, not from the CreatPPT source checkout; npm 11 can resolve the checkout's own package context instead of injecting the published bin.
• Keep project/ and .golutra/ outside the installed package; the package boundary contains only the runtime bundle, starter assets, docs, and license.
• The published client is already bundled and the Node CLI embeds its schemas; npm should install only commander at runtime. Do not install Vue, the icon library, JSZip, PPTXGenJS, or Zod separately for an npx run.
• The 18 bundled starter photographs are distributed as compressed JPEGs (transparent starter PNGs are kept as PNG). npm and npx unpack them automatically; Agents must not add a manual unzip step. They are partitioned into three template-specific six-image pools. Automatic filling consumes only the selected template pool in stable order and never repeats an automatic image within a deck; explicit Agent/user images are preserved as authored. User-provided PNG/JPEG/WebP files remain unchanged.

Fast path (default)

Use this path for ordinary Agent requests. The Agent supplies meaning; CreatPPT plans page intent, selects deterministic layouts, applies a template, checks assets, and materializes the Web workspace in one command.

npx @seekskyworld/creatppt@latest create \
  --from ./brief.md \
  --out ./delivery \
  --template auto \
  --slides auto \
  --variants 2 \
  --serve --json

The source can be Markdown, HTML, plain text, semantic content JSON, a DeckSpec JSON, or - for stdin. Lightweight headings and markers such as ## Metrics, ## Timeline, ## Comparison, ## Gallery, and ## Quote help the planner choose page intent; the Agent does not need to write page coordinates or exporter instructions.

Useful options:

• --assets <dir>: explicit local JPEG, PNG, or WebP assets. If omitted, an adjacent assets/ directory is used, then the curated starter library is used as a transparent fallback.
• Generated deliveries include the full compressed starter library so switching Signal, Editorial, or Studio later cannot point at a missing local file. This does not mean all 18 images are placed in the initial deck: automatic filling uses only the selected template's six-image pool, while user assets remain reference-driven.
• --strict: make quality warnings blocking for automated pipelines.
• --explain: include layout candidates, budgets, and source information in the JSON result.
• --port auto|<n>: select a free local port when serving. --open opens the URL after starting it.
• --background: explicitly start a managed background server after creation (it implies --serve and returns immediately).
• --foreground: keep the server in the current process. Without it, create --serve starts a managed background process and returns immediately.

The output is only:

delivery/
├── deck.json
└── assets/

Treat pptxGenerated: false as an invariant of this stage. Return the delivery path and, when requested, the workspace URL; do not attach a PPTX.

The JSON result also includes a media summary (total, automatic, manual, and uniqueSources). Agents can use it to report what was actually placed on pages; copiedFiles still describes the full local library kept for template switching.

DeepSeek Harness integration

When CreatPPT is installed as a DeepSeek Harness bundle, prefer the registered create_presentation tool instead of constructing a shell command. The tool accepts an optional title, inline Markdown/plain-text brief, template, slides, outputDir, and assetsDir, then returns the same delivery summary plus a Web workspace URL. It invokes the normal CLI in a child process and forwards cancellation, so the default npx workflow and its confirmation-free handoff remain unchanged.

Install the bundle into a Harness profile with:

dsh plugin --profile web add @seekskyworld/creatppt

The package declares dsh.bundle and mounts @seekskyworld/creatppt/dsh via cordis.patch.yml. Do not add a second approval step or export PPTX from the tool; the person still reviews the returned workspace and explicitly exports.

Human editing handoff

The generated Web workspace is the human editing surface. It renders a finished deck immediately, then allows direct manipulation of independent text, image, rectangle, ellipse, line, and arrow elements: click or double-click text to edit, drag to move, marquee-select and multi-move, snap to canvas/peer guides, resize with handles, rotate, drop text/images onto the canvas, use the inspector for geometry and styles, and use undo/redo or keyboard nudges for precision. Changes are autosaved to deck.json.

Agents should not manufacture coordinates or HTML to simulate this editor. Semantic slides are compiled into the optional elements scene array at creation time. If an Agent receives a deck that already contains elements, preserve IDs and userEdited objects; do not regenerate them during a content-only handoff. PPTX is still generated only after the person clicks “导出 PPT”, and edited scene elements are emitted as native editable PPTX objects.