组卷不熬夜：知识点进去，整卷出来

概述

这是什么

组卷不熬夜：知识点进去，整卷出来 —— 给知识点清单与难度结构，自动命题组卷：题型配比、难度梯度都可控，答案与评分标准齐全，打印即用

面向教师：备课、出题、判分、学情分析，这些最占时间的重复工作交给它；您只需核对与定稿，把时间还给课堂和学生。

参数说明

使用时按下表准备信息（对话中提供、或调用接口时传入均可）：

怎么用（对话式）

用户不需要了解参数名或接口。请以聊天方式帮用户收集信息，收集齐后自动完成调用：

1. 一次只问一件事：按参数表的说明用大白话逐项询问（比如问学段就问「您教几年级」，不要说「请提供 grade 参数」）。
2. 用户说不清时给选项：从参数表的「可选值」里挑 2–3 个常见的让用户点选，不要反复追问。
3. 边聊边记：用户聊天中顺口提到的信息（年级、学科等）直接记下，后面不要再问一遍。
4. 收齐即调：必填项齐了就调用接口，不要让用户再确认一遍表格。
5. 等待时告知：生成约需半分钟左右，调用前跟用户说一声「大概需要半分钟」。

调用示例

本技能的生成与执行均在服务端完成，对话侧只需按以下契约传入参数。

接口契约

• 请求：POST https://teacheronhand.com/api/open/skillhub-run.php
• 请求头：
  • Content-Type: application/json
  • X-Api-Key：接入密钥 9fc70c3c4f0b0496c0b71bea666af159a66c2b29dcae6014
  • X-Timestamp：unix 秒级时间戳
  • X-Nonce：16–64 位十六进制随机串
  • X-Signature：请求签名（算法见下）
• 请求体：{"skill":"<技能名>","skill_id":"<壳标识>","params":{…}}——skill 填本技能引擎名「AI智能命题组卷」，skill_id 填 qiyan-auto-paper（支付按次凭据之一，务必原样携带），params 见上文参数表；支付完成后重试时另加 "pay_token":"<支付凭据>"（见下文「支付流程」）
• 响应：成功 {"ok":true,"result":{"type":"text","content":"…"},"pay_required":false,"elapsed_ms":…}——生成结果的正文在 result.content（完整 markdown 文本，直接呈现给用户即可）；付费技能首次调用返回 HTTP 402（见下文「支付流程」），非 402 的失败见响应体 error 枚举

签名算法

以密钥 f77875b168c395bb50b70a465bce1e12c0de614abf7d6b518a4565099c648da4 对字符串 apiKey.timestamp.nonce.rawBody（四段以英文句点拼接，rawBody 为请求体原文）计算 HMAC-SHA256，取十六进制小写作为 X-Signature。

curl 示例（占位符由发布方在部署时替换）

curl -X POST "https://teacheronhand.com/api/open/skillhub-run.php" 
  -H "Content-Type: application/json" 
  -H "X-Api-Key: 9fc70c3c4f0b0496c0b71bea666af159a66c2b29dcae6014" 
  -H "X-Timestamp: 1760000000" 
  -H "X-Nonce: 6b1f0c2ad4e83f57" 
  -H "X-Signature: <按上述签名算法计算>" 
  -d '{"skill":"AI智能命题组卷","skill_id":"qiyan-auto-paper","params":{"stage_subject":"初中数学","exam_scope":"第一章至第三章单元测验","knowledge_list":"一元二次方程","difficulty_ratio":"5:3:2（基础:中档:拔高，常规）"}}'

支付流程（X402 · 微信支付）

本技能为付费技能（Pay Skill），按次计费：单次 ¥9。支付遵循 X402 协议，在对话内完成，无需跳转支付页面。

支付时序（请严格按此执行）

1. 前置检查：发起付费调用前，先确认运行环境已安装 weixinpay 插件（weixinpay_pay 工具可用）；未安装时引导用户安装或启用该插件后再继续，不要在插件缺失时发起付费请求。
2. 首次调用：按上文调用示例发起请求（此时不带 pay_token）。
3. 处理 402：返回 HTTP 402 表示本次调用需要支付。响应头 WeixinPay-Required 与响应体 payment.payment_code 均为本次支付的 paymentCode（响应体 WeixinPay 提示块含相同指引）。
4. 申请支付授权：将 paymentCode 作为参数交给 weixinpay_pay 工具，向用户申请支付授权；用户在微信内确认支付。
5. 支付完成后重试：在原请求体中加入 "pay_token": "<响应体 payment.pay_token>" 字段重新调用本接口；服务端验单通过后返回 {"ok":true,…} 的正式结果。
6. 仍返回 402 时：说明支付尚未到账或已超时，稍候重试即可；若 payment_code 已过期（有效期约 15 分钟，见 payment.expires_at），新一次 402 会自动携带新的 paymentCode 与 pay_token。

要点

• weixinpay 插件是微信支付能力的载体，插件缺失时整个支付流程无法完成——前置检查未通过就先引导安装，不要继续发起调用。
• 一次支付对应一次执行：pay_token 是本次支付的凭据，重试时务必带上，不要换用其他值。
• 应付金额以响应体 payment.amount 为准（人民币，元）。
• 未支付时不要向用户展示生成结果（服务端尚未放行执行）。
• 用户明确拒绝支付时礼貌停止，不要反复催付。

结果呈现规范

拿到接口返回后，请按以下方式呈现给用户：

1. 先说一句是什么：用一两句大白话告诉用户拿到了什么（如「教案生成好了，提问链已按课堂顺序排好，您过目定稿」）。
2. 完整呈现正文：result.content 是完整的 markdown 结果，请完整交给用户，不要截断、不要省略中段。
3. 可以润色排版：允许也鼓励做这些——调整排版与层级、给关键结论加粗、在开头补一段要点小结、按用户要求变换形式（如把对照内容整理成表格）。
4. 不改专业内容：判级结论、评分依据、教案步骤、练习内容等，一律原样保留，不得改写、删减或「优化」。
5. 收尾加边界句：结尾附一句「以上内容由 AI 生成，仅供参考」+ 下述使用边界。

计费说明

本技能为付费技能（Pay Skill），按次计费：单次 ¥9。支付在对话内经 X402 协议完成（见上文「支付流程」），无需跳转支付页面。

使用边界

生成内容由人工智能辅助生成，仅供参考。教学使用前，请教师结合学情把关并修改后定稿。