你读完Pride and Prejudice时写了什么?在这份阅读记录里,答案是“I kept noticing who misunderstood whom.”(我总会留意到,谁又误会了谁)。这句话属于 Penguin 版平装本,ISBN 为 9780141439518,完成日期是 11 月 8 日。等你打开一个新对话时,这句话还在那里。
你将制作Shelf Notes,一份保存在 Google 表格中的私密阅读记录。Open Library提供版本详情,你补上日期和想留下的想法,确认后由Quickchat AI Agent 把它们写入同一行。
下载 Shelf Notes 入门套件。打开 Shelf Notes.xlsx 查看完成后的示例。使用其中两个 TSV 文件,在 Google 表格里搭建你自己的阅读记录。它们会让你从时间线上更早的一条记录开始,也就是读者仍在阅读时。套件还包含精确的 Action 设置和Main Prompt。
1. 你书架上的是哪个版本?
先别连接任何内容,先试试查询。打开ISBN 9780141439518 对应的版本。这是一本由 Penguin Books 于 2003 年出版、共 435 页的英文平装本。简·奥斯汀的这部小说最早出版于 1813 年。这两个日期都属于Pride and Prejudice,但只有一个描述的是桌上这本书。
- 创建或登录 Quickchat AI。使用你的空白 Agent,或选择 Add new AI Agent → Set up manually。把它命名为 Shelf Notes。你需要一个 Google 账号来保存阅读记录,还需要可用的 AI 点数来测试对话。
- 在添加个人笔记之前,先打开 Your Website → Install → Availability and access。关闭 Widget & Embed access,把 Chat Page Access 设为 Nobody,并让其他渠道保持未连接状态。在你已登录的控制台中使用 AI Preview。
- 在 Identity → Main Prompt 下方,粘贴套件中的
main-prompt.txt。它会告诉 Agent 先展示建议写入的条目,并等待单独确认。 - 在Actions & MCPs → Add Action → API Action → Create manually中,创建下面两个 GET Action。每个 Action 都使用When to run → AI decides,并在What to ask the user first下添加一个名为
isbn的必填Text参数,正文留空。输入这个号码时,去掉空格和连字符,保留前导零,以及 ISBN-10 末尾的X。
| 操作名称 | API 终点 | 从结果中使用的内容 |
|---|---|---|
lookup_book_isbn | https://openlibrary.org/search.json | 在Query Params中填入isbn={{isbn}}、fields=key,title,author_name,first_publish_year和limit=1。该作品会提供作者和小说的初版年份。 |
lookup_edition | https://openlibrary.org/isbn/{{isbn}}.json | 检查提供的号码是否出现在isbn_13或isbn_10中。如有返回,读取出版社、版本日期和语言。把返回的/books/键加到https://openlibrary.org后面,作为来源链接。 |
在对话中输入 ISBN。Action 会把它插入一个 URL,而这个 URL 的主机名已在编辑器中固定。
我们的第一次查询还请求了这部作品的版本列表。仅这一个 ISBN 就返回了4,042 个版本 ID。去掉这个字段后,简短的回复里只留下作者和原始出版年份。第二次请求仍然只返回了我们想要的那一个平装本版本。
在Headers下,为每个请求添加一个值为ShelfNotes/1.0 (YOUR_CONTACT_EMAIL)的User-Agent,把示例联系方式替换成你自己的。粘贴action-recipes.md中的对应API Action Description,保存并启用每个 Action。试试“Look up ISBN 978-0-14-143951-8.”。你应该能看到这个版本,而不需要创建阅读记录。这种个人查询不需要Open Library账号。有人问起某本书时就可以用它,并遵循Open Library的 API 使用指南。
2. 阅读记录里该放什么?
把目录事实和你自己的观察分成不同的列。你可能会把这一本具体版本借给别人,而你们对每个角色的看法都不同。ISBN 不会变。你的笔记属于你的这次阅读,这里用PAP-01标识。
- 打开Actions & MCPs → Add Action → Google Sheets → Connect。授权将拥有这份阅读记录的 Google 账号,然后选择Open sheet。该连接会凭借它的
drive.file授权在 Drive 中创建一个 Google 表格。Google 表格连接操作指南展示了授权界面。如果是个人阅读日志,请在 Google 表格中打开共享,将常规访问权限保持为受限。 - 关闭当前启用的起始 Action:
log_lead_to_google_sheet。保留它的名称,并复制其中已填好文件 ID 的API Endpoint。让这个起始 Action 继续保持关闭。你将为这份阅读记录单独创建 Action。
打开为这个 Agent 创建的文件。起始 Action 里已经包含了你需要的电子表格 ID。
- 把Leads工作表重命名为Events,并从A1开始用
Events.tsv替换其中内容。粘贴前,先把 B(ISBN)列和 F(日期)列格式设置为Plain text。再添加第二个工作表,命名为Status。如果你新建的是示例表格,请使用File → Settings → Locale → United States,这样下面的公式才能接受逗号。
从第 2 行开始。PAP-01 仍在阅读中,G2 里是“Started with the Netherfield visit.”。你确认后,已读完的条目会出现在第 3 行。
Events中的八列依次是reading_id、isbn、title、edition_url、status、reading_date、note和conversation。最后一个单元格里保存着返回这段对话的链接。起始数据的第一条事件在11月2日标记为reading。它的笔记是“Started with the Netherfield visit.”
当一本书的状态从 reading 变为 finished 时,始终使用同一个 reading ID。等你以后重读这本书时,再换一个新的。
3. 如何按 ISBN 保存一条读书笔记?
查询回答的是“这是哪本书?”。保存回答的是另一个问题:“这是不是我想记住的内容?”设置一个 Action 用来追加已确认的行,再设置另一个 Action 用来检查表格里实际保存了什么。
- 创建一个名为
append_reading_event的API Action。复制起始 Action 的 Sheets URL,保留到实际文件 ID 为止的所有内容。把后面的部分替换为/values/Events!A:H:append。设置POST,并添加Query Params项valueInputOption=RAW。原始输入模式会保留 ISBN,也会把以=开头的笔记当作文本处理。 - 在Headers中,将
Authorization设为Bearer {{google_sheets_access_token}},并将Content-Type设为application/json。Quickchat AI会在请求时填入这个令牌。 - 添加六个必填的Text参数,名称分别为
reading_id、isbn、title、edition_url、status和reading_date。再添加一个名为note的可选Text参数,默认值留空。状态可选reading、finished、paused或abandoned。日期使用读者自己的日期,格式为YYYY-MM-DD。 - 在API Endpoint → Body中粘贴下面的 JSON。两组方括号表示一行八个单元格。
conversation_url是内置的。把工具包里的追加说明粘贴到API Action Description中。 - 创建
read_reading_journal,作为指向同一电子表格的GET,以/values/Events!A2:H1000结尾。给它设置相同的 bearer 标头、工具包里的历史记录说明,不填参数,正文留空。保存并启用这两个 Action。
{
"values": [[
"{{reading_id}}", "{{isbn}}", "{{title}}", "{{edition_url}}",
"{{status}}", "{{reading_date}}", "{{note}}", "{{conversation_url}}"
]]
}
这个数组与 A 到 H 列一一对应。把笔记放在第七个位置,就会把读者写的话放进 G 列。
准备好起始行后,在AI Preview里发送下面这条消息。
Look up ISBN 978-0-14-143951-8. I finished PAP-01 on 2026-11-08. My note: I kept noticing who misunderstood whom.
检查建议的版本、ID、日期和标点。此时Events里应该仍然只有开头那条记录。然后说“Yes, that is my edition. Save PAP-01 with that status, date and note.”。第 3 行应该会出现第二个事件。
这个建议会让你最后再看一眼 ISBN 和你的表述。在阅读记录发生变化之前,你可以修改其中任意一项。
在我们的实测中,Agent 提出的新条目没有改动最初那一行。确认后,Shelf Notes 检查了阅读日志,重新核对 ISBN,添加了一行,然后读回新增行。在 Inbox 中展开 append_reading_event,把 Google 的 updates.updatedRange 和表格里的单元格对照。如果请求超时,先找这行是否已经出现,再重试。 Google 表格添加行参考
Google 报告 Events!A3:H3 中有一行、八个单元格已更新。选中 G3,把其中的文字和你确认的笔记对照。
4. 在新对话里可以问什么?
在AI Preview中打开一个新对话,并提问“What was the last note I saved for PAP-01?”。在我们的测试中,Agent 再次读取 Events,并返回“I kept noticing who misunderstood whom.”第 2 行仍保留着之前关于Netherfield的笔记。Google 在返回一整行数据时,可能会省略末尾的空白单元格,所以起始行里的会话链接为空是正常的。
对于“Which books am I still reading?”,如果一次阅读有两个事件,按行数统计就会得出误导性的答案。用Status标签页为每个阅读 ID 选出最后追加的事件。
- 把
Status.tsv粘贴到Status!A1。它在A2中的公式会让每个阅读 ID 只列出一次。B2会从Events底部开始做精确匹配查找。随着书架上的书越来越多,把 B2 向下填充到新 ID 对应的行。D2统计最新状态为finished的 ID 数量。 - 创建
read_reading_status,再创建一个使用相同 bearer 请求头的GET,后缀用/values/Status!A1:B1000。粘贴工具包里的状态说明,正文和参数都留空,然后保存并启用。 - 问哪些书已经读完。对于示例,Status里有一条已完成的阅读记录,
PAP-01。如果第二次重读这本小说,就给它PAP-02。这样你就能区分第一次读时注意到的内容和第二次读时注意到的内容。
复制这三个 Google 表格公式
Status!A2列出这些 ID。
=SORT(UNIQUE(IFERROR(FILTER(Events!A2:A1000,Events!A2:A1000<>""),"")),1,TRUE)
Status!B2查找 A 列中这个 ID 对应的最新事件。
=IF(A2="","",XLOOKUP(A2,Events!$A$2:$A$1000,Events!$E$2:$E$1000,"",0,-1))
Status!D2统计已完成的阅读次数。
=COUNTIF(B2:B1000,"finished")
这个方案覆盖999 个事件。在新条目即将落到第 1000 行以下之前,要同时扩展读取范围和公式范围。确定一次对话要返回多少历史记录时,也要把长笔记和大量阅读记录考虑进去。Google 表格 XLOOKUP 参考
5. 它能用在你桌上的那本书上吗?
拿起另一本书,试试它印刷的 ISBN。先问它这本是哪一个版本,然后停下。第一个很好的检查点,是确认你可以浏览一本书而不把它加进去。接着,给它一个阅读 ID,再写一句只有你自己才会写出来的话。确认后,关闭聊天,再把那句话问回来。
为了做可重复的检查,请使用Testing → Simulation,然后查看Actions & MCPs → View logs和目标单元格。试试一个无法识别的 ISBN,拒绝一条建议加入的记录,并保存一条以=1+1开头的测试读书笔记。前两种情况都不应该改动历史记录。最后一种情况应该在笔记单元格中显示这些原样字符。
我们还让本地表格先保存一行,再在回复前超时。Shelf Notes把这一行读了回来,报告了超时,并且没有进行第二次追加。如果某次保存后你不确定要不要再按一次发送,也可以在 Action 日志里核对这个细节。
在“找不到版本”的测试中,目录返回了 404。Agent 要求提供另一个标识符,而阅读记录表仍然保留两行。
如果你更喜欢通过其他助手来配置 Agent,工具包里附带了适用于 Quickchat AI 账号连接器的设置请求。附上 action-recipes.md 和 main-prompt.txt,然后把 setup-request.txt 交给它。检查这五个 Action,自行完成 Google 授权,再运行同样的阅读测试。ChatGPT 连接器 · Claude 连接器 · 账号设置指南
常见问题
怎样通过 ISBN 把一本书添加到 Google 表格?
使用你手上那本书印着的 ISBN,在Open Library中查询对应版本。核对书名、出版社和年份,补充你的阅读状态和读书笔记,然后确认这一行。入门套件已经包含表头、公式,以及全部五个Quickchat AI Action 配方。
我可以直接使用自己已有的 Google 表格阅读记录吗?
把你想保留的条目复制到由Quickchat AI连接创建的电子表格中的Events标签页。对齐这八列,并把 ISBN 保持为文本。把另一个私有文件的 ID 粘贴进 Action,并不会让它获得打开该文件的权限。
如果Open Library找不到我的 ISBN,怎么办?
检查条形码或版权页上的号码,包括开头的 0 或末尾的 X。如果仍然无法确认这个版本,就不要修改阅读记录。ISBN 标识的是一个版本,并不授予访问图书全文的权限。
怎样统计读完的书,并跟踪重读?
每次阅读都要有自己的 ID。暂停或读完这本书时保留这个 ID,重读则分配一个新的 ID。在Status标签页统计已完成条目。这样,同一版本完成阅读两次会计为两次,而同一次阅读的两次更新只计为一次。
关闭对话后,我还能找到某条读书笔记吗?
可以。在新的私密对话里,按图书或阅读 ID 提问即可。历史记录 Action 会再次读取Events标签页,那里保存着带日期的条目和你最初写下的原话。Status标签页则提供每次阅读最近一次记录的状态。