六个工具怎么用

六个工具：四个读、两个写。

平时不用记这些名字，直接说「这周数学练得怎么样」「帮我把那个库再加一章」就行。这一页是对照表。

四个读的

list_kbs 分两段返回：你创建的库（带「在学」或「未开始」）、以及你在学的别人的库和系统精选。每条带 id、学科年级、章数点数。后面几个工具要的 kbId 都从这儿来。

get_kb 只传 kbId 时给章节目录和每章的知识点名称（一章超过 60 个点会截断）；再传一个 chapterId，给那一章知识点的完整释义。要改哪一章，先这样读一遍——章节序号就是改顺序时要用的位次。

get_study_report 是学情的总入口：连续打卡天数、题数余额，每个在学库的五档熟练度分布、到期待复习的点数、最近练习时间，累计错得最多的知识点排行，以及最近 14 个打卡日各练了多少题。传 kbId 时会多给一段按章的熟练度全景，回答「哪一章还不行」。

get_wrong_book 读某个库的错题，最近答错的在前，默认 20 条、最多 50。每条带题面、选项和答案、你当时的错误作答、这个知识点现在的熟练度、这道题已经重练过几次。题面和答案都做了截断。它是用来归纳错因的，不是用来把整份卷子搬过去的。

错题的范围和应用里的错题本完全一致：跨会话、按题面去重、练熟了自动出池。

两个都只能动你自己创建的库。建出来的库是私有的，而且不会自动开学——工具返回一个链接，你在应用里打开、点「开始学习」，它才进首页的「学习中」。

一次提交完整结构：库名、学科、年级、章节列表，每章内联它的知识点（term + definition）。不要先建空库再逐章补。

几个字段值得单说：

默写只能配语文库，听力只能配英语或小语种库。 经这条通道设了不匹配的，服务端会把它回落成单选并在返回里提示一句——这是接口这一侧的兜底，应用里的表单压根不会让你选到不适用的题型。

规模上限：

硬限制在单次提交：一次 create_kb 最多 60 章、600 个知识点，超出直接报错，一个字都不写。库本身没有总量上限，建完用 update_kb 往里加即可（add_points 每次最多 200 条）。
建议值：单次调用不超过 100 个知识点。这是防模型输出被截断，不是服务端校验。范围更大就先建前几章，剩下的用 update_kb 逐章补。

中途失败会把半成品库整个清掉，整包重试即可。

传 kbId 和一串操作，按顺序执行：

操作	做什么
`set_meta`	改库名、出题侧重点、学科、年级、默认题型
`add_chapter`	加一章，可以内联知识点；同名章节自动复用
`add_points`	往某章加知识点，单次最多 200 条
`update_point` / `remove_point`	改 / 删某个知识点
`remove_chapter`	删一章，连同章下全部知识点
`move_chapter` / `reorder_chapters` / `rename_chapter`	调位次 / 一次排定全部顺序 / 改章名

位次从 1 数起，和 get_kb 输出的章节序号一致。补漏章之前先 get_kb 看一眼现有顺序，别凭印象给位次。

add_points 是幂等的：同一章里 term 相同的会自动跳过。所以超时之后整章重传是安全的，不会出现两份。

remove_chapter 连带删掉章下全部知识点，且没有撤销。

出题、打印、批阅、扣题数、改账号、付钱，通道里都没有对应的工具，令牌也打不开那些接口。想让 AI 帮你出一组题练，做不到；它能做的是把练什么规划好，出题回应用里点。

不用。直接说要干什么，客户端会自己挑。这一页是给「它没挑对」或者你想精确指挥时用的。

服务端在接入说明里要求它先把完整方案列出来、得到你同意再写。但那是对模型的约束，不是接口层的强制——真要拦住，靠你自己在对话里不点头。所有写入都只发生在你自己创建的库上。

分批建。一次 create_kb 最多 600 点，超了直接报错，所以先提交前面几章，其余用 update_kb 的 add_chapter 一章一章补，库的总量不卡。按模块拆成几个库也行，练习是按库挑知识点的，拆开更好安排。

不会。create_kb 中途出错会把刚建的库整个删掉，你重试一次即可。update_kb 是按顺序执行的，失败点之前的操作已经生效，重传整章不会重复——同一章里 term 相同的知识点会自动跳过。

打开懒人学霸　注册即用，建库免费，新账号送 10 题。