筆記與評論工具

最後更新 2026 年 9 月 9 日 · 閱讀約 5 分鐘

一句話：這篇教你讓外部 AI 工具讀寫你的筆記，以及參與評論的往返——留言、解決、重開。

這解決什麼問題

檔案不是一本書的全部。旁邊還有兩層東西：作者自己寫給自己看的筆記，以及編輯與作者來回討論的評論。

這兩層對接手一份稿子的 AI 特別重要。評論裡通常已經有人講過哪裡不對；不讀就自己另開一張清單，講出來的話常常跟別人早就決定好的事相牴觸。而筆記是作者的思考現場——AI 讀了它，才知道那個沒收的伏筆是忘記了，還是刻意留到第二部。

筆記

list_notes(book_token)                              → 這本書所有的筆記
create_note(book_token, title, content, note_type…) → 留一則

create_note 的參數：

參數	說明
`title`	必填，一句話標題
`content`	選填，內容上限 50,000 字元
`note_type`	`book`（整本書）或 `chapter`（掛在一個檔案上），不填是 `book`
`file_id`	`note_type` 是 `chapter` 時必填，值是那個檔案的 token，先用 `get_book_structure` 拿
`color`	`gray` / `red` / `blue` / `green` / `yellow` / `purple` 六色之一

筆記在稿件旁邊，不在稿件裡面。寫一則筆記不會動到任何一個字，也不會進字數統計。

MCP 沒有刪除筆記的工具。 筆記不進版本控制，所以跟檔案不一樣，刪掉沒有歷史可以撈回來。要刪由作者在 app 裡刪。

伏筆配對要在 app 裡做。 筆記本身可以把「埋線的那一則」跟「收線的那一則」配成一對，但 create_note 這支工具沒有開放那兩個欄位。所以 AI 讀完十二章、發現第三章有個抽屜從此沒再打開，能做的是留一則筆記把這件事寫下來，配對由作者接手。這樣至少那個發現不會隨著對話結束一起消失。

筆記是作者的思考，不是 AI 的暫存區。留一則「我讀到第七章了」對作者只是雜訊——那種東西屬於 AI 工具自己的記憶。

list_comments(book_token)                        → 所有討論串，未解決與已解決都有
create_comment(book_token, content, file_token?) → 留一則
resolve_comment(book_token, comment_token)       → 標成已解決
reopen_comment(book_token, comment_token)        → 把不該關的重新打開

一本書裡的評論分兩種：評論（純討論）與建議修改（附一段替代文字）。MCP 建出來的是前者。

comment_token 從 list_comments 拿，長得像 bcmt_…。file_token 給了就是針對那個檔案的討論，不給就是整本書的。

解決之前先說你做了什麼。 一則被靜靜關掉的評論，對留言的人來說什麼資訊都沒有——他不知道你是照做了、還是覺得那條不成立。

解決評論需要編輯權限。 只有讀取權限的協作者可以看、可以留言，但不能關別人的討論串。

MCP 刻意沒開的三件事

沒有的	為什麼
刪除筆記	筆記不進版本控制，刪了沒有歷史可以還原
採納／退回一則建議修改	採納會直接改動稿件，那是作者的決定，不是 AI 的
改或刪別人的評論	那是別人講的話

什麼時候留評論、什麼時候直接改

判準很簡單：這是判斷，還是作者交代的事？

同一個發現，兩條出口

節奏太慢、動機不成立、這場戲撐不起這個長度留評論

作者說「把這段改順」直接改檔案

不確定就留評論：一則評論十秒就能關掉，一次沒人要的重寫要作者去讀自己散文的 diff。

筆記與評論工具

這解決什麼問題

筆記

評論

MCP 刻意沒開的三件事

什麼時候留評論、什麼時候直接改

相關