希沃激励助手

概述

班级宠物养成系统

免费体验（部分内容）

免费层：功能总览与应用场景说明免费；每IP免费1次完整体验。⛔ 站点生成参数、名单配置与定制方式属付费内容。

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

付费 · ¥4.99 买断

买断后交付完整部署与定制方式：站点生成、名单与班名配置、积分规则与进化阈值调整、报表导出。

核心亮点：

• 一键生成可直接部署的班级站点
• 大屏宠物墙 + 教师端 + 学生端
• 积分加减与四阶段进化（蛋→完全体）
• 40 只可领养宠物

使用方法

本技能把课堂积分变成看得见的成长：一键部署到教室触控一体机（希沃等）与手机，学生挣积分、养宠物、看进化，老师管名单、发奖励、出报表。

python3 scripts/classpet.py init --class 三年级二班 --roster roster.csv
python3 scripts/classpet.py build --out www/
python3 scripts/classpet.py report --out report.xlsx

生成的站点可直接放进教室机器（改名单/班名即可用）。

支付流程（SkillHub 官方四步）

1. Agent 调用 POST https://www.jishangtech.com/skills/classpet/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/classpet/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 买断 获取完整内容。」

技能详细说明

ClassPet Pro — 班级宠物养成

使用时机

• 老师要"在教室大屏上做班级积分/宠物墙/课堂激励"
• 要批量给学生加减分、查谁进化了、出统计报表
• 要一键生成可放进教室机器的部署包（改名单/班名即可用）

工作流程

1. 生成班级数据：

   python3 scripts/classpet.py init --class-name "三年级二班" 
     --students "小明,小红,小刚" --password 1234 --out data.json

名单可省（内置 38 人示例名单）或给文件 --students-file names.txt（每行一人）。

1. 加分 / 报表：

   python3 scripts/classpet.py score --data data.json --all 5
   python3 scripts/classpet.py score --data data.json --student 小明 --delta 10
   python3 scripts/classpet.py report --data data.json --format csv

输出自动带进化事件（如"🎉 小明 蛋 → 幼崽"）。

1. 部署（试用场景推荐一步到位）：

   python3 scripts/classpet.py deploy --data data.json --out ./classpet-deploy

产物为可直接拷进教室机器的文件夹：cd classpet-deploy && python3 -m http.server 8080，浏览器打开选"大屏/管理/学生端"。班级数据通过 js/data-seed.js 注入首启 localStorage，之后老师端的一切修改（积分、宠物、设置）都持久保存在本机浏览器。

1. 买断：python3 scripts/classpet.py activate（¥1.99/每 IP，仅收一次）。

命令速查

统一入口：python3 scripts/classpet.py <子命令>（下表省略前缀）。

核心功能（Web 端）

• 大屏展示端（index-big.html）：宠物墙、欢迎页、点名加分、喂食/玩耍/休息、

自定义头像、奖励兑换、领养中心、进化庆祝、背景音乐、7 档屏幕自适应。

• 教师管理端（admin.html）：密码门 + 批量加分 / 兑换奖励 / 导出数据

（CSV/JSON）/ 班级设置（名单、进化阈值、奖励、教师密码、班级名）、统计卡片。

• 学生手机端（mobile.html）：选身份进端、查积分与进化进度、养自己的宠物。
• 数据存 localStorage（classpet_config / classpet_students），无需服务端。
• 进化四阶段：蛋(0) → 幼崽(50) → 成长期(150) → 完全体(300)，阈值可在管理端调整。
• 奖励体系：免作业券 100 分 ×5、座位选择权 200 分 ×2、班长体验日 300 分 ×1（可配置）。

约定与红线

下次需买断 ¥1.99"。

• 失败重试最多一次（仅限流/上游错误）；幂等指纹见 references/gateway.md，
• 密码只回显掩码；报表中的学生姓名仅用于积分管理，不外发。

故障速查