常見用法

下面每一條都給出一句你真的會輸入的提示、它會用到的工具，以及能跑起來的最低權限。只授權你實際會用到的那些 —— 每種授權的代價見權限分組。

有一點幾乎對所有用法都成立：筆記是按欄位 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 走得更遠，會整個刪掉筆記庫 —— 欄位、筆記、模板、卡片、複習記錄。刪之前先要清單。