设计与多媒体

sn-ppt-doctor

试用

Environment diagnostic for the PPT family. Validates sn-image-base, API keys, Node runtime, and optional deps; interactively writes .env for required vars. Runs before sn-ppt-entry; does not modify sn-image-* skills.

它能做什么

Environment diagnostic for the PPT family. Validates sn-image-base, API keys, Node runtime, and optional deps; interactively writes .env for required vars. Runs before sn-ppt-entry; does not modify sn-image-* skills.

技能文档

sn-ppt-doctor

When to use

  • Before the first time you use sn-ppt-entry / sn-ppt-creative / sn-ppt-standard, to verify env is wired
  • After you change .env, to confirm
  • When sn-ppt-entry reports missing-env error and tells you to come here

Hard checks (must pass before sn-ppt-entry can run)

  1. Text chat API key is available via SN_TEXT_API_KEY, shared SN_CHAT_API_KEY, or global SN_API_KEY
  2. Vision chat API key is available via SN_VISION_API_KEY, shared SN_CHAT_API_KEY, or global SN_API_KEY
  3. Image generation API key is available via SN_IMAGE_GEN_API_KEY or global SN_API_KEY
  4. sn-image-base is discoverable and sn_agent_runner.py --help works (auto-resolved as a sibling skill under the same skills/ directory; SN_IMAGE_BASE only needed for non-standard layouts)
  5. node --version >= 18

Soft checks (warnings only)

  • $(pwd)/ppt_decks/ creatable and writable (deck_dir parent; fixed — not configurable via env)
  • sn-ppt-standard/scripts/export_pptx/node_modules exists (run npm install on first use otherwise)
  • Optional env vars (SN_IMAGE_GEN_*, SN_CHAT_*, SN_TEXT_*, SN_VISION_*) — displays current value or "unset"
  • pypdf / python-docx Python deps for doc parsing in sn-ppt-entry

Invocation

Single-file entry; no package imports, no -m, no PYTHONPATH needed.

python $SKILL_DIR/ppt_doctor/check_environment.py                      # interactive
python $SKILL_DIR/ppt_doctor/check_environment.py --non-interactive
python $SKILL_DIR/ppt_doctor/check_environment.py --env-path /custom/.env

When used inside OpenClaw, /skill sn-ppt-doctor runs the same entry.

Output

Plain text report — one line per check — then a summary. On any hard-check failure, enters interactive mode to fill .env (unless --non-interactive).

Does NOT

  • Modify sn-image-* skills or their .env
  • Install packages automatically (prints install commands instead)
  • Run any PPT pipeline

相关技能

sn-image-doctor

Environment diagnostic skill for SenseNova-Skills project. Checks that sn-image-base is properly installed and configured, validates dependencies and environment variables. Prompts user to configure missing required variables and saves them to .env file. After configuration, reloads environment and suggests agent restart if needed.

sn-ppt-workbench

Open the AI PPT editing WebUI for previously generated SenseNova HTML slides. Use when the user asks to preview, inspect, edit, or open an existing/generated PPT deck in the WebUI/workbench without regenerating slides. Accepts an explicit deck_dir or auto-detects the newest local ppt_decks entry containing HTML pages. Does not run style/outline/page-html/export generation.

sn-ppt-entry

Entry point for PPT generation. Asks the user to choose a mode (fast, standard, or creative), then collects role / audience / scene / page_count as needed. For standard mode, also asks how images should be sourced (AI generation, web search, or none), whether charts should use AI-generated infographics or ECharts, and whether the final deliverable should be PPTX or PDF. Parses uploaded pdf/docx/md/txt files, produces task_pack.json + info_pack.json in a new deck_dir, then dispatches to sn-ppt-creative or sn-ppt-standard. Fast mode skips optional questions and gets straight to building. Use when the user asks to make a PPT / presentation / 演示 / PPT. If the user asks to open, preview, inspect, or edit previously generated HTML slides in the WebUI/workbench without regenerating, dispatch to sn-ppt-workbench instead of this generation entry.

sn-ppt-creative

Creative-mode PPT pipeline. One full-page 16:9 PNG per slide. LLM / VLM calls go through sn-ppt-standard/lib/model_client.py (shared thin client). Text-to-image (the actual png rendering) goes through sn-image-base/scripts/sn_agent_runner.py. Falls back to web image search when T2I generation fails. Expects task_pack.json + info_pack.json already written by sn-ppt-entry.

sn-ppt-standard

Standard and fast PPT pipeline. All LLM / VLM / T2I calls are wrapped in a single CLI entry (scripts/run_stage.py). The main agent's job is simple: emit ONE shell command per stage, never write loops, never write prompts. Standard mode plans thoroughly with a three-sample deck preview checkpoint (three concatenated deck images plus a preview URL), web research, image search, and user-selected final output format (PPTX or PDF) for polished, delivery-ready presentations. Fast mode builds a complete draft immediately with autonomous decisions, then provides structured refinement suggestions so the user can iterate quickly. Supports AI-generated infographics (U1) for diagrams and flowcharts, web image search (Serper) for real photos, and ECharts for data charts.

sn-update

Update SenseNova Skills (the sn-* bundle) inside an OpenClaw or hermes-agent install. ALWAYS use this skill when the user says any of: "update SenseNova skills", "update SN skills", "更新 sensenova skills", "更新 sn skills", "刷新 sn-*", "升级 sn-* skills", or names a specific sn-* skill to update (e.g. "更新 sn-ppt-standard", "refresh sn-image-base"). Default scope is the whole sn-* bundle; if the user names specific skills, update ONLY those.