常见用法

下面每一条都给出一句你真的会输入的提示、它会用到的工具，以及能跑起来的最低权限。只授权你实际会用到的那些 —— 每种授权的代价见权限分组。

有一点几乎对所有用法都成立：笔记是按字段 ID 存储的，不是按字段名，所以一个规矩的助手会在第一次写入之前先读笔记库结构。如果它上来就猜，让它先读结构。

收集

把对话里的一个词存成笔记

我们刚聊的 hedge 是金融那个意思。把它存到我的英语笔记库，按现有笔记的格式填。

get_notebase_schema → create_notes · notes:write

助手先读你的字段，再按它们描述的格式写一条笔记。如果你有好几个都说得通的笔记库，明确说是哪一个。这个笔记库上已有的卡片模板会立刻把新笔记变成卡片。

把 PDF 或文章整理成结构化笔记

这是一章的 PDF。挑出 B2 水平大概不认识的词，每个都存到我的英语笔记库，带上释义和它出现的那句原文。

get_notebase_schema → create_notes · notes:write

助手用它自己的文件或浏览能力读文档，陪读蛙只负责保存结果。create_notes 每次最多写 50 条，任何一条冲突就整批回滚，所以一整章会分成几个干净的批次进来，而不是一次全有或全无的写入。

找回一条只记得半截的笔记

我之前存过一个词，意思大概是「漫无目的地走」。在我的英语笔记库里找找。

list_notes · notes:read

搜索是至少两个字符的字面、不区分大小写的子串匹配，一次只搜一个笔记库，而且只看文本类型的字段 —— 数字、日期、勾选和单选的值永远不会被匹配到。需要更模糊的查找，就让助手把笔记库列出来自己判断。

搭结构

让助手设计一个笔记库和它的字段

我要开始学日语。给它建一个笔记库，字段按你觉得词汇学习该有的来 —— 但先把方案告诉我，别直接建。

create_notebase → create_notebase_field · notebases:write

create_notebase 建的是空笔记库，可以带上最初的字段；笔记永远是单独一步。多花一轮先看方案是值得的，因为字段的类型建好之后改不了 —— 能改的只有名称和选项。

生成一个卡片模板

看一下我的日语笔记库，做一个认读卡：正面是词，背面是释义和例句。

get_notebase_schema → create_card_template · card_templates:write 加 notebases:read

模板是按字段 ID 引用字段的，所以要先读结构。新建模板会为笔记库里已有的每一条笔记生成卡片，所以一个 400 条笔记的笔记库，模板落地的瞬间就多出 400 张卡片。

修一个渲染不对的模板

我日语卡片的背面显示的是原始字段而不是例句。看一张卡片，然后把模板修好。

get_card → get_card_template → update_card_template · card_templates:write 加 notes:read 和 study:read

get_card 是这件事能做成的关键：它返回渲染后的正反面，助手能看到实际输出，而不是凭空推理模板。

整理字段

我英语笔记库里的「词性」字段是纯文本，已经乱了。把它改成单选，选项用实际在用的那些。

get_notebase_schema → list_notes → update_notebase_field · notebases:write 加 notes:read

字段类型是固定的，所以这件事是重命名加改配置，不是类型转换。删掉一个单选选项会清空所有持有该值的笔记，而被模板引用的字段根本不能删。

补齐缺的内容

批量补上例句、词性和音标

把我英语笔记库过一遍，凡是缺例句、词性或音标的都补上。其他一律别动。

list_notes → update_note · notes:write

update_note 是合并式的：没提到的字段保持原值，null 表示明确清空。每次修改都会带上这条笔记当前的时间戳，所以如果期间有变化，写入会失败而不是覆盖你的编辑 —— 此时助手应该重新读这条笔记再试。这个工具一次处理一条，所以大笔记库会分批走完。

学习

我今天该复习什么

今天有多少要复习的，大概要花多久？

get_study_stats → list_cards · study:read，要看卡片内容再加 notes:read

get_study_stats 给出指定某一天每个笔记库的队列数量，list_cards 可以按排程状态筛选，看这些数字具体是哪些卡片。

在对话里直接复习

从我的日语笔记库里抽十张到期的卡片考我。先给正面，等我回答，再按我的表现记录评分。

list_cards → record_review → undo_review · study:write 加 notes:read

这确实能做，但也是最需要想清楚的一条。助手记录的每一个评分都是一次真实复习：FSRS 会据此更新卡片的稳定度、难度和下次到期时间，跟你自己按按钮完全一样。提交复习还需要一个时区，因为它决定这次复习属于哪个学习日 —— 如果你的账号从没存过时区，调用会失败并要你提供，而不是猜一个。评错了可以用 undo_review 回滚某一张卡片最近的一次复习，也只有这一次。

搁置或暂停一张太难的卡片

上一张我一直记不住，反复答错。先把它从轮换里拿出来。

set_card_suspended / set_card_buried · study:write

搁置是把卡片藏到当天结束，暂停是把它拿出来直到你放回去。两者都能用同一组工具还原。

看看我最近的进展

过去两周怎么样？有什么是我一直做错的？

get_study_stats → list_review_history · study:read

list_review_history 返回你的复习记录 —— 评分和用时，可按笔记库或卡片筛选 —— 不含笔记内容。想让助手说出你反复记不住的具体是哪些词，再配合 list_cards，那需要加上 notes:read。

改每日上限

每天 20 张新卡太多了，我别的事也不少。日语笔记库的减半。

get_study_settings → update_study_settings · study:write

这两个工具只能触及每日新卡上限、每日复习上限和目标记忆保留率，不能重命名或删除任何东西。

杂事

确认连的是哪个账号

你现在连的是哪个陪读蛙账号？

whoami · account:read

如果你有多个账号，或者在让助手写入任何东西之前，花一轮问一下是值得的。

清掉不想要的内容

我英语笔记库里有重复的条目。列出来、删掉多余的，但先把列表给我看。

list_notes → delete_note · notes:write

这里的删除是永久的，而且会级联：删掉一条笔记会带走它的卡片和这些卡片的复习历史。delete_notebase 走得更远，会整个删掉笔记库 —— 字段、笔记、模板、卡片、复习记录。删之前先要列表。