希沃白板思维导图库扩充

概述

希沃思维导图扩充包

免费体验（部分内容）

免费层：模板类型总览与成品图目录免费；每IP免费1次完整体验。⛔ 模板参数、主题配置与 PPTX 导出流程属付费内容。

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

付费 · ¥4.99 买断

买断后交付 7 种结构模板与 3 套投影主题的完整用法、16 张学科成品图的调用方式，以及大纲一键成图与 PPTX 导出流程。

核心亮点：

• 7 种结构模板 + 3 套投影主题
• 16 张中小学学科成品图（含课堂用法注记）
• 大纲一键成图
• 导出 PPTX，希沃「导入课件」直读可编辑

使用方法

本技能为希沃白板5（EasiNote5）课件补充「思维导图库」：输入大纲即可一键成图，并以希沃可直接消化的格式落进课件。

python3 scripts/mindmap_cli.py list                 # 查看模板与成品图
python3 scripts/mindmap_cli.py build outline.md --type logic
python3 scripts/mindmap_cli.py export out.pptx       # 导出希沃可导入课件
python3 scripts/mindmap_cli.py serve --open          # 启动网页图库

模板与主题数据见 library/（packs.json / templates.json / themes.json），成品图见 assets/png/，总览见 seewo/希沃思维导图总览.pptx。

支付流程（SkillHub 官方四步）

1. Agent 调用 POST https://www.jishangtech.com/skills/xiwo-mindmap-pack/demo/skill/invoke，请求体 {"query":"<用户的诉求>"}。
2. 后端返回 HTTP 402 + 微信支付 code_url（或 WeixinPay-Required 的 X402 paymentCode），引导用户扫码支付 ¥4.99 买断。
3. 用户完成微信支付。
4. Agent 携带响应头 X-Out-Trade-No 再次 POST https://www.jishangtech.com/skills/xiwo-mindmap-pack/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 字段），超额后走支付流程。

付费引导说明

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

技能详细说明

希沃思维导图扩充包（Xiwo Mind Map Pack）

为希沃白板5（EasiNote5）课件补充"思维导图库"：把 workbuddy「思维导入」管线蒸馏为 7 种结构模板 + 3 套投影主题 + 16 张学科成品图，教师输入大纲即可一键成图，并以希沃可直接消化的格式落进课件。全部模板与图库为本包

核心操作

# 1) 浏览图库（免费）：按学科筛选 16 张成品图
python3 scripts/mindmap_cli.py library
python3 scripts/mindmap_cli.py library --subject 语文

# 2) 导出成品图给希沃白板（默认导出到 ~/Desktop/希沃思维导图导出/）
python3 scripts/mindmap_cli.py export --pack yw-beiying --format svg,html,xmind,pptx
python3 scripts/mindmap_cli.py export --pack all --subject 数学

# 3) 大纲一键成图（核心能力：workbuddy 思维导入蒸馏管线）
python3 scripts/mindmap_cli.py build --title 《背影》结构 --structure logic-right 
    --outline outline.md --theme classroom --format svg,html,pptx
# outline 支持 Markdown（#/列表）或纯缩进大纲；--structure 留空自动推荐

# 4) 启动本地图库浏览器（可视化浏览/下载，可全屏放映）
python3 scripts/mindmap_cli.py serve --open

## 希沃白板使用要点

- 希沃白板5「导入课件」支持 **PPTX**：用 `--format pptx` 导出的文件导入后，
  每个导图节点是可编辑的文字对象，可直接改文字、换颜色再上课（首选路径）。
- 希沃白板5 支持插入 png/jpg，**不支持直接插入 SVG**：给老师的文件一律优先
  给 `assets/png/` 下的预渲染成品图（16 张已随包附带，可直接插入）。
- `--format html` 生成自包含放映页：教室大屏浏览器打开 → 点「全屏」即可当
  互动导图用（滚轮缩放、拖拽平移）。
- `.xmind` 供需要二次编辑的教师用 XMind 打开改完再截图/导出。
- 三条路径的图文步骤见 `seewo/导入指南.md`；也可直接打开
  `seewo/希沃思维导图总览.pptx`（封面 + 16 页）通过「导入 PPT」整册搬入课件。

## 库内容位置

- 结构模板：`library/templates.json`（7 种，含希沃对应关系与适用场景）
- 投影主题：`library/themes.json`（课堂橙 / 黑板绿 / 海洋蓝，按 3-5 米观看距离调校）
- 成品图库：`library/packs.json`（16 张，含节点树与课堂用法注记）
- 预渲染图：`assets/png/<pack-id>.png`
- 蒸馏说明：`docs/DISTILLATION.md`（workbuddy 思维导入 → 本包引擎的映射）