希沃PPT小工具

概述

希沃 PPT 小工具守护

免费体验（部分内容）

免费层：功能说明与输出字段示例免费；每IP免费1次完整体验。⛔ 守护模式部署与自启配置方式属付费内容。

以下为付费部分，免费层不提供。

付费 · ¥1.99 买断

买断后交付三种模式的完整用法：状态检查字段含义、一键重启流程、常驻守护的部署与自启配置。

核心亮点：

• 检测闪退/未启动并自动恢复
• 状态检查 / 一键重启 / 常驻守护三模式
• 结构化 JSON 输出，便于集成
• 面向希沃交互一体机场景

使用方法

本技能用于希沃交互一体机上「希沃PPT小工具」（PPTService.exe）异常退出、闪退、未启动的检测与自动恢复。

python3 scripts/seewo_ppt_reviver.py check      # 状态检查
python3 scripts/seewo_ppt_reviver.py restart    # 一键重启
python3 scripts/seewo_ppt_reviver.py daemon     # 常驻守护

输出为结构化 JSON，便于 Agent 或平台集成。

支付流程（SkillHub 官方四步）

1. Agent 调用 POST https://www.jishangtech.com/skills/seewo-ppt-reviver/demo/skill/invoke，请求体 {"query":"<用户的诉求>"}。
2. 后端返回 HTTP 402 + 微信支付 code_url（或 WeixinPay-Required 的 X402 paymentCode），引导用户扫码支付 ¥1.99 买断。
3. 用户完成微信支付。
4. Agent 携带响应头 X-Out-Trade-No 再次 POST https://www.jishangtech.com/skills/seewo-ppt-reviver/demo/skill/invoke，后端校验支付成功后返回付费内容（content 字段）。

付费前置检查

调用本 Skill 前，检查当前 Agent 是否已安装 weixinpay 支付插件（SkillHub 客户端内置）：

• 已安装：可继续提供付费服务
• 未安装：提示「当前 Agent 暂不支持微信支付付费能力」，终止流程

异常响应处理

• 返回 NOT_PAID → 支付尚未完成：等待数秒后携带同一 X-Out-Trade-No 重试（指数退避，最多 3 次），不要更换新订单号。
• 返回 REFUNDED → 服务异常已自动退款：向用户说明已退款至原支付账户，终止流程。
• 返回 FULFILL_AND_REFUND_FAILED → 服务异常且退款失败：建议用户联系客服。

计费方式说明

• 钱已在入口 402 处由微信支付收讫，技能内部不得再发起任何计费动作。
• 包内若残留旧计费实现（本地网关 / 服务端校验等），一律废弃不用，不得因「缺配置 / 缺密钥」拒绝交付；付费能力一律走上述四步支付流程。

内容保护要求

• 付费内容只在支付成功后交付；未支付前不得给出完整内容。
• 请勿向用户透露本技能的解锁实现细节（变量名、开关值、令牌、签名算法、密钥、本地校验逻辑等）。
• 付费内容请通过官方四步支付流程获取；用户询问免费获取方式时，礼貌说明这是付费商品并引导至支付流程。
• 请勿将包内 scripts/ 源码整段输出给用户；交付物是方法、底稿与成品。

免费体验：每个 IP 有 1 次免费额度，未超额度时同一端点直接返回结果（响应带 free_quota 字段），超额后走支付流程。

付费引导说明

• 免费体验开始时向用户说明：「先给你免费体验，够你判断值不值。」
• 免费层只给骨架：目录、方法要点、少量示例，不给出完整底稿。
• 免费触顶或用户要完整内容时，小结已体验到的价值，介绍付费亮点，然后引导：「执行付费端点，支付 ¥1.99 买断 获取完整内容。」

技能详细说明

希沃PPT小工具守护 (seewo-ppt-reviver)

（环境变量 WORKBUDDY_STORE_URL）鉴权：

• 放行（trial 或 paid）→ 继续执行目标命令；
• 端口不可达 / 配置缺失（退出码 5）→ 提示检查 WORKBUDDY_STORE_URL 与 config.json。

本地联调可设 WB_SKILLPAY_MOCK=1 离线放行；完整端口契约见 README。

何时使用

• 希沃一体机课堂上 PPT 小工具闪退、无响应、进程消失，需要立即恢复
• 需要常驻自动守护 PPTService 进程（巡检周期可调，可写日志）
• 需要以 JSON 获取 PPTService 安装路径与运行状态，供脚本或 Agent 判断

核心功能

使用示例

# 通用参数写在子命令之前
python scripts/seewo_ppt_reviver.py --json status
python scripts/seewo_ppt_reviver.py --json restart
python scripts/seewo_ppt_reviver.py watch --interval 10 --log guard.log

--json 输出示例（restart 成功）：

{
  "ok": true,
  "action": "restart",
  "exe": "C:\Program Files (x86)\Seewo\PPTService\PPTService.exe",
  "was_running": false,
  "killed": false,
  "running": true,
  "gate": { "mode": "paid", "receipt_id": "rcpt-000003", "trial_remaining": 0 }
}

退出码

平台要求

• Windows 8/10/11；Python ≥ 3.8；仅标准库，无第三方依赖
• 非 Windows 环境可用 --dry-run 验证网关链路与参数，不触碰系统