K12 题库 API

要解决什么问题

K12 教研、组卷或答疑场景里，题目往往锁在第三方题库的 REST 接口后面：要先查学段学科字典、再沿知识点树或章节树定位 ID，语文/英语与其它科目的「按章节取题」还不是同一条链路。若每次都在浏览器或 Postman 里手工拼 POST 和 X-API-Key，对话式助手很难稳定地「取几道题、补答案、导出成卷」。

技能如何工作

本技能封装学库宝（xuekubao）网关的题库 API，统一用 POST + X-API-Key 鉴权；配套 scripts/qb.py 仅依赖 Python 标准库，从环境变量或 CLI 读取 QB_API_BASE、QB_API_KEY、QB_TIMEOUT（CLI 优先）。

取题主路径与供应商文档 2.1 / 2.6 / 3.x 对齐，可概括为：

• 按知识点：catalog / 知识点树 → by-knowledge，可选题型、试卷类型、难度、年级、年份等筛选。
• 按章节：语文、英语走章节树 → by-chapter；数学、物理等无独立章节接口时，遍历章节叶子取 32 位 oldId 当作 knowledgeId，再走按知识点取题（可用 --max-leaves 控制叶子数量）。
• 按试卷：papers / paper-search → 试卷详情拉全卷。

其它能力包括：search 全文搜题、answer 用题目 md52 取解析（多题会多次计费）、to-word 把 JSON 题目渲染为 docx、report 提交错题反馈。列表默认输出可读摘要，加 --json 拿原始结构；取题后先展示题干与选项，需要时再调 answer。

适用边界与注意

• Key 必须用户自行在 api.xuekubao.com 官方入口申请，勿写死在脚本里；未购 key 时技能无法代你开通。
• 只展示 API 实际返回内容，不臆造题目或答案；errorCode 非 0 或 HTTP 异常应如实反馈，避免无节制重试。
• 大批量取题请用 page 分页；批量取答案前先确认范围，以免消耗过多请求额度。