维基 - 把你的笔记归纳成一座知识库
第 39 章：维基 — 把你的笔记归纳成一座知识库
你有三百条笔记。你对 Acme Corp 所知道的一切都在其中某处 — 三月那次谈定价的会议、六月那次升级处理、真正有权签合同的那个人的名字。全都写下来了，却没有一处是完整的。
维基就是 SeaMeet 对此的回答。它读完工作区里的每一条笔记，找出反复出现的人、组织和主题，然后为每一个主体写一页：整个笔记库对 Acme Corp 所知道的一切，都在 Acme Corp 那一页上，并且链接回它所依据的每一条笔记。你不用归档，不用打标签。你照原来的方式继续记笔记，维基自己跟上。
本章讲维基是什么、怎么建立、怎么读一页、它如何自我维护，以及 — 当你开始依赖它之后最重要的那件事 — 怎么告诉它它写错了。
维基到底是什么
用访达或资源管理器打开你的工作区文件夹，你会看到一个叫 _wiki/ 的目录。整座维基就是它。里面是：
<你的工作区>/
├── Meeting · Jun 4.md ← 你的笔记放在最外层
├── Q2 Reviews/
│ └── Acme Q2.md
└── _wiki/ ← 生成出来的知识库
├── index.md ← 所有页面的总索引
├── log.md ← 什么时候改了什么
├── entities/ ← 组织、项目、客户
│ └── acme-corp.md
├── people/ ← 你会见的人
│ └── alice-cheng.md
├── topics/ ← 跨多场会议的主题
│ └── pricing.md
├── meetings/ ← 每场录下的会议一页
└── .state/ ← 内部状态（见下文）
每一页都是带 YAML frontmatter 的纯 Markdown 文件。没有任何东西被锁在数据库里。就算你明天把 SeaMeet 删了，维基仍然是一个 Markdown 文件夹：任何编辑器都能打开，任何静态站点生成器都能发布，终端里 grep 得到。
为什么文件夹名以下划线开头。 _wiki/ 是有意对笔记树隐藏的 — 就像 .git 和 .obsidian 一样。它是生成出来的产物，混进笔记树只会让每个实体在搜索结果里出现两次。你改从 Wiki 标签页浏览它。
为什么文件夹叫一个名字、界面上显示另一个。 在磁盘 上这几个桶叫 entities、people 和 topics。在应用里它们显示为 Organizations、People 和 Topics。SeaMeet 会根据你实际的笔记库推导出这些标签，写进 _wiki/.state/sections.json — 医生的工作区最后会出现 Patients，销售的则是 Accounts。磁盘上的名字永远不变，所以在一台机器上建好的维基，换一台机器读起来仍然正确。
打开维基
点顶部导航栏的 Wiki，它在知识这一组、就在 Notes 旁边。这个界面的结构和 Notes 一样：左边一棵树，中间一页内容。
如果你从没建过维基，中间会出 现一张引导卡片，上面两个按钮 — Take a Note 和 Start Recording — 因为没有来源的维基无话可说。一旦有了页面，中间就变成 Wiki Home：一个搜索框、一行统计、Top of mind（背后来源最多的那些主体），以及 Updated this week。
侧边栏用 « 箭头收起，并且会跨会话记住你的选择，和 Notes 一样。
从一整个文件夹的笔记建立它
维基树上方那颗 ✨ 按钮是 Build wiki from all notes。点一下，SeaMeet 就会走遍整个工作区、读完每一条笔记，并为它找到的每一个主体写一页。同一颗按钮也在 Notes 树的工具栏上，所以你不必切换界面就能开始建立。
它是增量的，不是重建
这一点值得记牢：建立只为改动过的部分买单。 在把笔记送给 AI 之前，SeaMeet 会先对笔记正文做哈希，跟上一次建立时的哈希比对。一模一样？跳过 — 不调用 AI，不产生费用。只改了寥寥几个字？也跳过，因为低于某个差异阈值的重读并不划算。
所以对 ✨ 按钮最诚实的心智模型不是"重建维基"，而是**"补进度"**。在一个三百条笔记的工作区里，如果你从昨天以来只改了四条笔记，按下去就只读那四条，只重写那四条所牵动的页面。其余一切原封不动，包括你自己写下的东西。
进度条在告诉你什么
建立过程中，工具栏下方会有一条进度条。它会经过两个阶段：
| 阶段 | 显示什么 | 实际在做什么 |
|---|---|---|
| 读取 | Read 34 of 210 notes · 118 reused from cache | 逐条读取并编目每条笔记 — 它提到了谁、提到了什么。"reused from cache"的数字就是哈希短路在起作用。 |
| 构建 | Built 12 of 47 pages · 1 failed | 依据每一条提到该主体的笔记，把它写成一页。页面就是在这个阶段出现在下方的树里。 |
计数下面，进度条会写出它此刻正在处理的文件（Now reading: Acme Q2.md），并保留一小段刚完成项目的滚动列表，每项带 ✓ 或 ⚠。如果 AI 服务商要求等待速率限制，界面会出现一个小小的 rate limit: 41s 标记，而不是让进度条看起来卡住。
暂停、取消、继续
运行期间，进度条上有两个按钮：
- Pause — 做完当前这一项后停下。按钮变成 Continue，会从停下的位置接着跑。当你想把带宽或笔记本风扇要回来二十分钟时就用它。
- Cancel — 把手上这一项做完（所以不会留下写到一半的东西）再停。收尾期间进度条会显示 Cancelling — finishing the current note…。
被取消的运行会留下书签。下次你打开 Wiki 界面，进度条会说 A previous wiki build was interrupted at 88/210. Resume?，并提供 Resume、Restart 和 Dismiss。如果是运行到一半用光了 AI 服务商的每日配额，情况也一样：SeaMeet 会存下位置、告诉你是什么挡住了它，并在配额重置后提供 Resume。
顺利跑完时，进度条会变成一行摘要 — Wiki built — 210 notes, 47 pages — 带 Dismiss 和 Restart。
那个提醒
你不必记得去建立。一次往工作区里丢十条以上的笔记 — 导入、同步拉下来、拖进来一整个文件夹 — SeaMeet 就会弹出提示：14 new notes since last build，旁边一个 Build wiki。把提示关掉，它会变成 Wiki 界面里一条安静的横幅，等你出手。
读一页
一个维基页面有页首、两个正文区块，以及页脚。
页首有后退与前进箭头 — 维基有自己的导航历史，所以点链接再返回的行为跟浏览器一样 — 页面标题，还有一颗紫色的 AI Generated 药丸。把鼠标移上去，它会变成 Refresh from sources：只针对这一页重读来源、只重写这一页。
AI 区块是上半部分，左侧是紫色边框。这是 SeaMeet 写的。它在应用里是只读的；若某个主体来源充足，内容会分成几个小节 — Overview、Facts、Recent activity、References — 以条列的原子事实为主，需要叙述时才用散文。
里面有两种东西可以点：
[[wikilinks]]— 指向其他维基页面的交叉引用，写成[[entities/acme-corp]]或[[people/alice-cheng]]。点一下就跳过去，不会离开 Wiki 界面。SeaMeet 只在目标页面确实存在时才生成链接；还没有页面的名字会保持纯文本，而不是变成死链。- 行内来源标注 — 事实后面的
[source: acme-q2.md]。点它就会打开产生这条事实的那条笔记。若有多条笔记支持同一句话，它们会被放在同一组方括号里。
偶尔你会看到某条事实前面标着 ⚠️ Conflicting:，并且并列两种说法。那说明你的两条笔记讲的不一样，而 SeaMeet 不愿替你选一边。那是一条写作指令，不是核查环节 — SeaMeet 没有在审计你的笔记找矛盾，它只是拒绝把恰好撞见的矛盾悄悄抹平。
用户区块是下半部分，左侧是青绿色边框。那是一个纯文本框，是你的，停手约一秒后自动保存。下面还会再谈它。
页脚有两组标签：
- Related pages — AI 区块里出现过的
[[wikilinks]]。 - Built from — 这一页是从哪些笔记写出来的，取自该页 frontmatter 里的
updatedFrom。点一个标签，那条笔记就会在 Notes 界面打开。正是这一行让这一页值得信任：不是"AI 说 Acme 会在 Q4 续约"，而是"这六条笔记这么说，而且它们就在这里"。
它是重新生成，不是修改
当某个主体的页面被重建时，SeaMeet 不会读旧的那一页再去改它。它会把目录里每一条笔记中关于那个主体的片段全部收集起来，从头重写 AI 区块，整段取代先前的内容。
这是有意为之，也正是"一座维基"和"一堆不断追加的更新"之间的差别。一页如果是逐条笔记打补丁补出来的，就会一路留着每一句没人想到要删的过期表述，而且永远只知道最近那一场会议。一页如果是从整份目录重新生成，它一次就知道全部四十七场会议、丢掉不再为真的部分，并把"Alice""A. Cheng"和"Alice Cheng"归并成同一个人。
实际后果：不要编辑 AI 区块还指望你的改动会留下来。 下一次重建就会覆盖掉。你想保留的东西请放进用户区块，或者以纠正的形式喂回去 — 两者下文都会讲到。
它自己跟上
第一次建立之后你大概很少会再按 ✨，因为维基会随着你工作自我维护。
当你在笔记里打字时，SeaMeet 会在你停手后等两分钟，然后判断这次编辑值不值得反应。只要下列任一条成立，就值得：
- 距离这条笔记上次触发以来，你增加了大约 150 个字符以上，
- 你新增了一个
[[wikilink]]，或 - 你新增了一个标题。
否则什么都不会发生。改个错别字、删掉一行赘句、重排一个项目符号 — 这些都不会触发更新。要想成"每次你新增一条笔记"，而不是"每一次按键"：这个实质性判断存在的理由，正是不让日常的小修小补烧掉 AI 调用。另外每条笔记还有十分钟的冷却时间，所以在同一条笔记上写很久，只会产生几次更新，而不是一百次。
当一条笔记被读过后，它提到的主体会被标记为需要重写。SeaMeet 不会马上逐个重写，而是等三十秒，把这段时间进来的全部收拢成一次扫描。导入二十条笔记，你得到的是对受影响主体的一次扫描，而不是二十次互相重叠的扫描。
当一场录音结束时，它的转写稿与 AI 摘要走的是同一条路 — 这场会议会成为一个和笔记平起平坐的来源，其中谈到的人与主题会流进他们各自的页面。
在 Notes 树里，右键点任一条笔记选 Update wiki from this note，就能让那一条完全跳过等待。
一个工作区，一座维基
SeaMeet 的工作区就是磁盘上的一个文件夹（第 13 章）。维基住在那个文件夹里面，位置是 <工作区>/_wiki/。仅这一件事，就解决了两者之间所有的疑问。
从树上方的切换器切换工作区，笔记树、维基树、搜索索引和维基会一起重新挂到新的文件夹上。你的工作维基和副业维基不共用索引、不互相链接，也不可能把客户名字漏进一页讲你周末项目的内容里。这件事没有设置项，也不需要配置 — 它是文件夹位置直接推出来的结果。
切换是串行的：若已有一次切换在进行中，下一次会等它做完，所以再快的双击也不可能让笔记指向一个文件夹、维基指向另一个。
一个值得知道的例外。 由录音生成的页面固定在你的默认工作区，所以即便你当时正在浏览副业工作区，录下的会议仍然会落进管着你会议记录的那座维基。
纠正它
总有一天某一页会写错东西。某人的职位过时了、两家名字相近的公司被并在一起、某个其实只是暂定的决议被写成了定案。
这里没有 Edit 按钮，因为对 AI 区块的编辑撑不过下一次重建。取而代之的做法是：把写错的文字选起来。 你在 AI 区块上松开鼠标的那一刻，就会冒出一个浮层，显示你选中的句子，以及一个问 What's right? 的输入框。输入正确内容，按 Ctrl+Enter（或 Cmd+Enter）。如果你只是为了别的目的选中文字，按 Esc 关掉它。
接着会发生两件事。
这条纠正被存成事实依据。 已登录时，它会存进你的账户，因此会跟着你到每一台设备。离线或使用自备 API 密钥时，它会存进维基旁边的 _wiki/.state/corrections.json。无论哪一种，它都不是打在当前这一页上的补丁 — 它是一条常设指令，会随着这一页未来每一次重写一起带上。一年后就算改用完全不同的一批笔记重建这一页，你的纠正仍然在，仍然具有权威。
这一页会插队。 被纠正过的主体在下一轮重写扫描中会排到最前面，走在所有只是等一般编辑的项目之前。AI 区块下方会出现一行 — Corrected by you — rewrite pending — 那是你的回执，表示纠正已收到、重写就要来了。
两个区块，以及 AI 永远不碰的那一半
AI 区块底下是你的区块，青绿色边框，一个你可以直接打字的纯文本框。那些 SeaMeet 不可能知道的事就放这里：一笔交易真正卡住的原因、某人偏好被叫中间名这件事、共享云盘的链接、你自己对局势的判断。
SeaMeet 只在 AI 标记之间写入，只在用户标记之间读取。重建会整段替换 AI 区块，并且不会动到它下面的任何一个字。这条界线是写在文件本身里的 — 每个区块都由 HTML 注释界定 — 所以即使你用别的编辑器改它、通过 GitHub 同步它，或从备份还原它，界线依然成立。
由此得到的分工：
| AI 区块 | 你的区块 | |
|---|---|---|
| 谁在写 | SeaMeet，依据你的笔记 | 你 |
| 重建后是否保留 | 否 — 整段替换 | 是 — 永不被动 |
| 怎么改它 | 提交一条纠正 | 直接打字 |
| 该放什么 | 笔记库说了什么 | 只有你才知道的事 |
找东西
- 筛选树 — 工具栏上的漏斗图标可以边打边筛页面名称。
- Quick Open —
Ctrl+P/Cmd+P打开一个横跨笔记与维基页面的面板，按类别分组，维基条目前面标着翻开的书图标。 - Global Search —
Ctrl+K/Cmd+K对笔记、维基页面、转写稿、摘要和截图 OCR 做全文搜索。维基结果会在 Wiki 界面打开。 - 从笔记做 wikilink — 在任何笔记里输入
[[，选择器会同时列出维基页面与笔记，维基条目带· wiki后缀。 - 在页内查找 —
Ctrl+F/Cmd+F会搜索打开页面的两个区块，并告诉你命中在哪：3 in note + 2 in AI section。替换只在你的区块提供，因为在 AI 区块替换文字会在下一次重建时被还原。
导出
工具栏上的下载图标可以把整座维基导出成一份自包含的 HTML 站点、一份 PDF，或两者都要，并可选择是否附上来源笔记。适合给客户一份快照、在项目结束时归档，或在飞机上把整份读完。
哪些功能需要订阅
维基的 AI 工作 — 读笔记、写页面 — 需要付费的 AI 额度，可以是 SeaMeet 订阅，也可以是你自己的 API 密钥（第 35 章与第 36 章）。具体来说：
- 阅读和浏览已有的维基页面始终可用。 已经在磁盘上的页面，不管你有没有订阅，都可读、可搜索、可链接。你的区块也一样 — 你可以继续在里面写。
- 建立与刷新需要额度。 没有额度时，✨ 按钮会显示一个锁定标记，自动更新不会触发，后台扫描也不会运行。没有东西被删除，也没有东西降级；维基只是在额度恢复之前停止学习。
Wiki 界面布局
┌──────────────────────────────────────────────────────────────────────┐
│ [Record] [Screenshot] [Memory] │ [Notes] [Wiki ●] │ [Files] [Cloud] │ ← 顶部导航
├────────────────────────┬─────────────────────────────────────────────┤
│ « Work ▼ ⚙ │ ‹ › Acme Corp [✨ AI Generated]│
├────────────────────────┤ │
│ Wiki ✨ ⤓ 📁 ⇅ ⌄ ⏷ ⚡│ ┃ Overview │
├────────────────────────┤ ┃ Acme Corp 自 2024 年起是物流客户， │
│ ┌────────────────────┐ │ ┃ 目前处于 Q4 续约周期。 │
│ │ Read 34 of 210 │ │ ┃ │
│ │ notes · 118 reused │ │ ┃ Facts │
│ │ ▰▰▰▰▱▱▱▱▱▱ 16% │ │ ┃ • 续约负责人是 [[people/alice-cheng]] │
│ │ Now reading: │ │ ┃ [source: acme-q2.md] │
│ │ Acme Q2.md │ │ ┃ • ⚠️ Conflicting: 席位数在不同会议中 │
│ │ ✓ Beta Q2.md │ │ ┃ 分别记为 40 与 55 │
│ │ [Pause] [Cancel] │ │ ┗━ 紫色边框 = SeaMeet 写的 │
│ └────────────────────┘ │ │
│ ▼ Organizations 12 │ ┃ Your notes │
│ 📄 Acme Corp ←──│ ┃ Alice 休假到 20 号；急事找 Dan。 │
│ 📄 Beta Logistics │ ┃ │
│ ▼ People 31 │ ┗━ 青绿色边框 = 你的，永不被覆写 │
│ 📄 Alice Cheng │ │
│ ▼ Topics 4 │ ───────────────────────────────────────── │
│ 📄 Pricing │ 🔗 Related pages [alice-cheng] [pricing] │
│ ▶ Meetings 88 │ 📝 Built from [Acme Q2.md] [Jun 4.md] │
├────────────────────────┤ ↑ │
│ ☁ 30 秒前已同步 │ 这一页来自的每一条笔记 │
└────────────────────────┴─────────────────────────────────────────────┘
疑难解答
"我按了 ✨，可几乎什么都没发生"
这通常是正确行为。建立是增量的 — 如果距离上次运行什么都没变，就没有东西要读、也没有东西要重写，进度条会几乎立刻结束，并显示很高的"reused from cache"数字。若你就是想强制重写某一页，打开它、把鼠标移到 AI Generated 药丸上，使用 Refresh from sources。
如果按钮显示的是锁而不是转圈，那问题出在 AI 额度，不在笔记 — 见第 35 章：订阅与账单。
"某一页写错了，而我一直在改它"
你多半是在编辑 AI 区块，而它每次重建都会被替换。改成把写错的句子选起来、用纠正浮层 — 那会跨重建保留，并被当成权威。若那是你自己的知识、而不是在修正 SeaMeet 的解读，它该放在下面那个青绿色区块，那里永远不会被覆写。
"我编辑了笔记，但页面没更新"
从打字到重写之间隔着三道有意设置的计时器：停手后两分钟的安静期、一次实质性检查（大约 150 个新字符，或一个新的 wikilink，或一个新标题），以及每条笔记十分钟的冷 却。小幅编辑本来就可能什么都不触发。要强制它：右键点笔记 → Update wiki from this note，或打开维基页面用 Refresh from sources。
"建立到一半出错停了"
几乎都是 AI 服务商的每日配额用完了。进度条会这么说，而且已经存下你的位置 — 等配额重置后回来按 Resume。它会从停下的地方接着跑，而不是从头开始。
"我切换了工作区，维基是空的"
这是设计如此：每个工作区有自己的 _wiki/ 文件夹。你要找的页面还在另一个工作区里 — 用树上方的工作区切换器切回去。新的工作区在你建立之前，维基都是空的。
"我以为会有的页面不存在"
一个主体要等到你的笔记确实对它说了些什么，才会有页面。只被顺口提过一次的名字会保持纯文本，而不是变成一个指向空白页的链接。写一条对它有实质内容的笔记，然后等更新触发，或从右键菜单强制它。你也可以在笔记里右键点一个未解析的 wikilink 药丸，选 Sync wiki to generate this page。
快速参考
| 操作 | 怎么做 |
|---|---|
| 打开 Wiki | 点顶部导航的 Wiki |
| 从所有笔记建立 | 点维基（或笔记）树工具栏上的 ✨ |
| 暂停／继续建立 | 进度条上的 Pause / Continue |
| 停止建立 | Cancel — 之后可从进度条继续 |
| 重建单个页面 | 把鼠标移到 AI Generated 药丸 → Refresh from sources |
| 从单条笔记更新 | 右键点笔记 → Update wiki from this note |
| 纠正写错的句子 | 在 AI 区块选中它 → 输入正确内容 → Ctrl+Enter |
| 加入你自己的知识 | 在青绿色的 Your notes 区块打字 — 会自动保存 |
| 查看一页的来源 | 页脚的 Built from 标签 |
| 跳到链接的页面 | 点 AI 区块里的 [[wikilink]] |
| 后退／前进 | 页首的 ‹ 与 › 箭头 |
| 快速打开页面 | Ctrl+P / Cmd+P |
| 全局搜索 | Ctrl+K / Cmd+K |
| 在本页查找 | Ctrl+F / Cmd+F |
| 筛选树 | 工具栏上的漏斗图标 |
| 导出维基 | 工具栏上的下载图标 → HTML / PDF / 两者 |
| 切换到另一座维基 | 在树上方切换工作区 |
| 找到磁盘上的文件 | <你的工作区>/_wiki/ |
一句话版本：你的笔记始终是事实来源，维基是它们的一个视图，靠重新生成而不是打补丁得来；而你能施力的两根杠杆，是纠正（改变 SeaMeet 写什么）和你自己的区块（SeaMeet 从不写的地方）。继续记你的笔记；索引会自己照顾自己。
Last updated: 2026-09-02
← 第 38 章：GitHub Sync 设置 | (手册结束 — 回到索引)
Last updated: