sn-ppt-doctor

1# sn-ppt-doctor
2 
3这是按需运行的能力与本地依赖检查，不是 Entry 的强制前置。Doctor 分开报告：
4 
51. 当前 Agent 的普通搜索、图片搜索和图片生成原生工具是否注册、配置或实际验证；
62. PPT 整包自带的 `sn-ppt-tools` 是否存在并已配置。
7 
8Doctor 不检查或恢复 `sn_agent_runner.py`，不写 `.env`，也不把可选媒体能力变成硬门槛。
9 
10## 持久配置
11 
12PPT 内置工具与 Doctor 自动读取：
13 
14- Hermes：`~/.hermes/.env`
15- OpenClaw：`~/.openclaw/.env`
16- 自定义：先设置 `SN_PPT_ENV_FILE=/absolute/path/to/file`
17 
18已有进程变量优先于文件值。推荐配置：
19 
20```ini
21# 搜索和搜图共用；默认请求 google.serper.dev
22SN_PPT_SEARCH_API_KEY="<search-api-key>"
23 
24# OpenAI/SenseNova 兼容的同步 /images/generations 接口
25SN_PPT_IMAGE_GEN_URL="https://your-host/images/generations"
26SN_PPT_IMAGE_GEN_API_KEY="<image-generation-api-key>"
27SN_PPT_IMAGE_GEN_MODEL="<image-generation-model>"
28```
29 
30用户只需编辑一次文件，不需要每次启动 Hermes 前执行 `export`。Doctor 输出实际读取的文件、
31已采用的变量名和缺失字段，但不得输出 key 值。
32 
33## 检查内容
34 
35- 当前 workspace 是否可写，`<pwd>/ppt_decks` 是否可用；
36- `pypdf`、`python-docx` 是否可用于附件解析；
37- Standard HTML 渲染所需的 Python Playwright 是否存在；
38- 当前解释器缺少 Playwright 时，先保留 bare Python 的 pip 安装路径，再检查已安装的
39  `uv tool` Playwright 是否可作为可选隔离环境；
40- Playwright Chromium 是否已经安装并能实际启动（不是只检查脚本文件）；
41- Node.js 是否可用于 Workbench 和 Static 默认 HTML -> PPTX 兼容版导出；
42- HTML -> PPTX 所需的 npm、`pptxgenjs`、`echarts`、Node Playwright 是否可解析，以及该
43  Playwright 的 Chromium 是否能实际启动；
44- Standard 渲染脚本、PPTX exporter 和 Workbench runtime 是否存在；
45- `python-pptx` 是否可用于 Creative 整页图片打包。
46- `sn-ppt-tools` 的四个脚本是否存在；
47- 内置普通搜索、图片搜索和图片生成的 URL 是否有效，key/model 是否已配置；
48- 实际加载的 `.env` 路径、无效行和缺失字段。
49 
50## 原生工具有效性
51 
52**工具出现在 Agent 工具列表中不等于可用。** Doctor 必须使用以下状态：
53 
54| 状态 | 含义 |
55|---|---|
56| `absent` | 当前 Agent 没有对应工具 |
57…