SuperAPI AI 工具集

sn-ppt-doctor

前端与建站

查看项目

更新于 10-16 03:11

技能介绍

用途:按需诊断 PPT Skill 的配置与失败问题,覆盖源解析、Playwright/Chromium 渲染、HTML 转 PPTX、Workbench 启动和内置工具。它是可选检查,不是强制前置。

主要能力:分别报告当前 Agent 原生搜索、图片搜索、图片生成工具的注册与验证状态(absent、present_unverified、misconfigured、available、failed),并检查整包自带的 sn-ppt-tools 是否配置。检查 workspace 可写性、ppt_decks 目录、pypdf 与 python-docx、Python Playwright、Playwright Chromium 能否实际启动、Node.js、npm/pptxgenjs/echarts、Node Playwright Chromium、渲染与导出脚本、python-pptx、四个 sn-ppt-tools 脚本及搜索/生图 URL、key、model。

使用方式:运行 python3 "$SKILL_DIR/ppt_doctor/check_environment.py",默认不联网。显式探测搜索加 --probe-search;探测图片生成可能收费,需用户明确同意后加 --probe-image-generation 与 --probe-output-dir "/absolute/existing/directory"。配置读取 ~/.hermes/.env 或 ~/.openclaw/.env,可先用 SN_PPT_ENV_FILE 指定文件,进程变量优先。

限制:不检查或恢复 sn_agent_runner.py,不写 .env,不安装依赖,不把可选媒体能力设为硬门槛。本地脚本无法读取 Agent 工具注册表,只报告内置配置事实并返回 agent_inspection_required。standard_html 与 html_to_pptx_environment 仅在对应脚本和 Chromium 实际启动通过时为 available。缺少依赖时仍以退出码 0 报告并显示应编辑的 .env 路径与缺失项。