修 理 课(特教版)——两个很简单很简单的问题,老师牵着你的小手,一 起 修

🏫 谷 歌 工 程 师 幼 儿 园 · 中 班

给山景城的小朋友们:今天不上品牌课,不开会课,不发新闻稿课。
今天做手工——修两个 bug。修好了老师给你贴小红花。修不好,继续留堂。

🔔 叮铃铃——上课啦,小手放好,嘴巴闭闭好 🔔

📋 课前须知:宝贝们,今天只修两个东西(别怕,真的只有两个)

有一位大朋友在你家产品的评论区,贴了一篇一万两千字的信。老师读了,从第一个字读到最后一个字,气得小铃铛都摇不响了。

告状信说,你们花了几百个工时开会,把 NotebookLM 的名字改成了 Gemini Notebook。Logo 的渐变色讨论了好多轮呢,好棒棒哦。可是呢——

📌 原文贴纸

"源端已经不存在了。副本端却永远残留。而且没有删除按钮。"

"AI 生成的二手垃圾可以导出,用户亲手喂进去的一手来源不能导出。"

——《谷歌在造垃圾》"
所以今天的作业只有两题:

老师问:做得到吗?要大声回答!——好,老师听见了(假装听见了)。拉钩钩,上吊,一百年,不许变。🤙

🧸 第一课 · 听故事:先来搞清楚,"幽灵"是个什么东西呀?

小朋友们,竖起小耳朵,老师讲故事了哦。

从前呀,有两个小朋友。一个叫小G(Gemini),一个叫小N(Notebook)。你们做大哥哥大姐姐的,教他们手拉手"同步":小G 说的话,会"复制粘贴"到小N 的笔记本里。听起来很美好,对不对呀?

然后有一天,小G 的妈妈让小G 把说错的话擦掉。小G 擦掉了。可是——

用户小朋友坐在屏幕前面,点呀点,找呀找,发现——真的没有删除。网上好多小朋友都在喊(reddit 幼儿园的 r/notebooklm 班):"我删不掉!"更可怜的是,有小朋友要另外装一个叫 ExtendLM 的第三方小玩具,才能把垃圾捡走。你们的作业,要别人家的孩子帮忙写,羞不羞呀?

📌 原文贴纸

"Reddit 上 r/notebooklm 早就有人在喊了——I can't delete the chats from Gemini in NotebookLM。评论区冷冰冰一句:They forgot to add a button to delete it directly from Notebook。"

—— 《谷歌在造垃圾》原文

老师告诉你哦,这些幽灵不只是"难看"那么简单。它们还会继续当上下文活着,天天给模型喂旧话题,让回答"自我指涉、胡言乱语、缠着旧话题不放"。就好像——你擦不掉的鼻涕,还一直往嘴里流。恶不恶心呀?

🔨 第二课 · 手工课(1~3 天):第一步,给幽灵做一个"删除按钮"

这是最简单的做法,老师保证:一个礼拜都用不了。原文的大朋友都说了,这叫"A 方案",1 到 3 天级。跟着老师,一二三四——

1. 找一找:打开小N 的笔记本,找到那条"从小G 复制来的"条目。它身上有个小标签写着 synced,看到了吗?对,就是它。
2. 点一点:在它右边的"⋯"小菜单里,加一行字:删除。对,就加一行。不用开会讨论渐变色。
3. 问一问:点下去之后,跳一个小窗口:"宝贝,确定要扔掉吗?"一个"确定",一个"取消"。这个叫确认弹窗,跟老师念:确——认——弹——窗——
4. 递一递:后端的小朋友开一个小窗口(这个叫 API,就是"递东西的小窗口"),把这条死数据从索引里扔掉。先只在笔记本这侧扔(本地删除),不用管小G 那边。

🔤 代码识字卡 · 跟老师念

# 跟老师念最后一个单词:删——除——
DELETE /notebooks/{notebookId}/synced-chats/{chatId}

# 回应里记得说"扔掉啦",不要说"已记录您的反馈"
{ "status": "deleted" }

老师批改:到这里,用户至少能把自己屋里的尸体抬出去了。界面干净了,上下文不吃毒药了。这才 1~3 天哦。你们改个名要几百个工时,老师说,这些工时够把这个按钮做好几百遍了,还能顺手给全组买个冰淇淋。

🚩 第三课 · 手工课(1~2 星期):第二步,玩"小纸条"游戏(它的学名:墓碑 tombstone)

光删自己屋里还不够。真正的好孩子,要懂得"你擦了,我也擦"。这个游戏叫墓碑同步,听起来吓人,其实就是传小纸条。规则老师写在黑板上:

1. 第一步:任意一边的小朋友说"我不要啦"(点了删除)。
2. 第二步:系统不急着扔,先写一张小纸条贴在黑板上:{ id, 什么时候扔的 }。这张小纸条就叫 tombstone(墓碑)。跟老师念:汤——姆——斯——通——
3. 第三步:另一边同步的时候,先抬头看黑板:哎呀,有我的小纸条!那我就乖乖把自己这边那份也扔掉。
4. 第四步:过三十天,保洁阿姨(GC,垃圾回收)把小纸条也烧掉。黑板干干净净。
5. 规则约定:如果两边同时改、同时删,听谁的?——听用户最后一次操作的。写下来,贴墙上,不许耍赖。

🔤 代码识字卡 · 跟老师念

# 小纸条长得很简单,小班小朋友都写得出来
{
  "type": "tombstone",
  "objectId": "chat_8842",
  "deletedAt": "2026-07-17T22:09:00Z",
  "deletedBy": "user",
  "ttlDays": 30
}

老师批改:这叫分布式系统 101,原文大朋友的原话——"这是分布式系统 101"。一百零一,是第一节课哦,不是第一百零一节。你们把"创建/导入"做了,把"删除/回收"忘了,用原文的话骂——算了,这句太凶,老师待会儿单独念给你们听。

🧹 第四课 · 大扫除(一个迭代):第三步,做一个"孤儿清理器",大扫除!

那些已经死了好几个月的幽灵怎么办呢?做一次大扫除!

1. 找:定期巡逻,找出所有"小G 那边已经没有了"的同步条目。它们叫孤儿,很可怜的。
2. 亮:做一个管理页,列出来:"这里有 17 个孤儿哦,要不要一起送走?"
3. 清:一个按钮:一键清理全部孤儿。点完放个小烟花 🎆,用户会很感动的。
4. 选:删除的时候给三个选择:①只删笔记本 ②两边都删 ③先归档。这叫"产品完整",C 方案,一个迭代就能做完。

📌 原文贴纸

"他们选了 D:几个月不修。不是做不到。是懒,是蠢,是没人被这个 Bug 的用户痛苦考核。"

—— 《谷歌在造垃圾》原文 · 这句话老师原样抄的,没有加字

📦 第五课 · 手工课(第二题!):把玩具箱带回家,做一个"导出来源"按钮

宝贝们,老师现在要划重点了。来源是什么呀?来源是用户小朋友一片片亲手喂进笔记本的:PDF、网页、笔记。它是这个产品的本体——"没有来源,Notebook 就是空壳"(原文语)。可是你们做了什么呀?AI 生成的二手 PPT 可以导出,用户自己喂的一手来源,不·能·导·出。要导出?还得去装第三方插件,让人家碰自己的资料库。

这个,羞耻程度,老师给五颗星★★★★★。来,手工课开始——这个按钮更简单:

1. 第一步:在来源面板右上角,放一颗按钮,写三个字:导出来源。就放那里。不用品牌部审批。
2. 第二步:点下去,给三个小篮子选:zip 打包 / JSON 清单 / Markdown 清单。小孩子才做选择,用户全都要。
3. 第三步:清单里写上:文件名、URL、类型、什么时候加的、备注。就五个字段,老师数给你看:一、二、三、四、五。
4. 第四步:原文能下的,装原文件;是链接的,装着陆页地址。打包,递给用户,说"拿好哦"。

🔤 代码识字卡 · 跟老师念

# sources_manifest.json —— 跟着描一遍就会了
{
  "notebook": "我的研究笔记本",
  "exportedAt": "2026-07-17",
  "sources": [
    {
      "title": "论文.pdf",
      "type": "pdf",
      "addedAt": "2026-07-01",
      "file": "sources/论文.pdf"
    },
    {
      "title": "某网页",
      "type": "url",
      "url": "https://example.com",
      "addedAt": "2026-07-02"
    }
  ]
}

老师问:难吗?难吗??一个按钮、一个打包、一份五个字段的清单。原文四连问,老师替它再问一遍:"1. 能不能导出备份?2. 换电脑能不能带走?3. 能不能批量核对脏数据?4. 同步出 bug 后,能不能导出活来源重建干净笔记本?"——每一个,都比"要不要叫 Gemini Notebook"更像产品问题。

📌 原文贴纸

"加个下载来源功能有什么难的。这种最重要的功能 tmd 还没搞出来。……我感觉你们根本就没用过这产品吧。"

—— 《谷歌在造垃圾》原文(老师把语气词轻轻涂掉了两个,意思没变)

📖 第六课 · 写字课:最后,写一张"游戏规则说明书"贴墙上

好孩子会把自己游戏怎么玩,写得清清楚楚。你们要贴出来的,叫同步语义文档,只有五行,跟老师描:

1. 身份(identity):两边的对象,是不是同一个 ID?还是导入快照?写明白。
2. 所有权(ownership):谁是 source of truth(说了算的那个)?写明白。
3. 删除语义(deletion):硬删、软删、墓碑、还是仅本地隐藏?写明白——写完你们就再也不能装忘了。
4. 冲突(conflict):两边同时动手怎么办?写明白(上次课说了:听用户最后的操作)。
5. 权限(ACL):笔记本侧的用户,有没有独立处置权?必须有。写明白。

有没有发现呀?这五道题,每一道幼儿园中班都听得懂。听不懂的不是题,是"为什么全球市值顶流的公司,2026 年了还要别人来教"。

🌸 放学前检查表:做完一项,自己打勾,老师给你贴小红花

• [ ] ① 每条 Gemini 同步条目,笔记本侧出现"删除"菜单 + 确认弹窗(A 方案 · 1~3 天 · 立刻动手)
• [ ] ② DELETE /notebooks/{id}/synced-chats/{chatId} 接口上线(后端小窗口 · 跟老师念:删——除——)
• [ ] ③ 墓碑(tombstone)双向删除 + 30 天 GC + 冲突规则写清(B 方案 · 1~2 周 · 源删副本清)
• [ ] ④ "孤立同步对象"管理页:一键清理所有源已死的残留(C 方案 · 大扫除 · 点完放烟花)
• [ ] ⑤ "导出来源"按钮:zip / JSON / Markdown 三篮子,五个字段(不再逼用户装第三方插件刮自己的资料)
• [ ] ⑥ 公开《同步语义文档》:身份 / 所有权 / 删除 / 冲突 / 权限(五行而已 · 贴墙上 · 不许耍赖)

一朵小红花都还没有哦。老师看着你们呢。👀

🤫 老师的悄悄话(嘘——小朋友们凑近一点,老师要说重话了)

其实老师知道,你们不是不会。你们是不考。改名字能开会、能发通稿、能让 VP 写博客,有人背 KPI;修删除按钮没有新闻、没有头条、没人被"用户的痛苦"考核,所以按钮就不存在。原文那句话,老师一个字都不想改:

"这就是当代大厂的病理:用可度量的仪式,替代不可度量的质量。"

"谷歌现在只是在造垃圾而已。什么都不干。股价跌像坨屎,反应都没有。"

"你们有人类他妈在工作吗?"

(最后这句是原文原话。老师平时不许小朋友说脏字,但是——先把那坨删不掉的垃圾修了,再来讲礼貌。)

哦对了,窗外的操场上,Z.AI 家的 GLM-5.2 小朋友考了 51 分(Artificial Analysis Intelligence Index),你家 Gemini 3.1 Pro Preview 考了 46 分;你家开源的 Gemma 妹妹,被媒体写"lag behind Chinese competitors"。先把屋里的按钮修好吧,补习班的事,老师下次再谈。

——爱你们的(但快没有耐心了的)班主任
留堂结束。鞠躬。放学。记得,拉过钩的。