🎉 新課程《Vibe Coding》早鳥報名中 → 看課程
藕記(以前叫 Topoi)

// 盧曼卡片盒筆記法 · 桌面版

藕斷絲連:
卡片拆開寫,想法連起來。

一張無限大的白板,你所有的卡片筆記都攤在同一面上。卡片之間拉線就是連結,拉遠可以一眼看完整張白板。

免費 · 不用註冊 · 卡片是你電腦裡的 .md 純文字檔

// v0.2.1 · Windows 10/11 · macOS(Intel 與 Apple 晶片皆可)

以前裝過 Topoi(0.2.0 以前的版本)?裝好之後電腦裡會同時有「Topoi」和「藕記」,用藕記就好,舊的那個移掉。卡片放在家目錄的資料夾,不受影響。

藕記白板:「一張卡只寫一個想法」「第一性原理」「成本最底層是什麼」等卡片之間拉線連結,右邊一組卡片被「長期主義」群組框圈住
// 所有卡片在同一張白板上,拉線就是連結,幾張相關的卡框成一個群組

// 為什麼做這個

盧曼用一櫃紙卡寫出 70 本書

紙卡做得到、數位筆記反而弄丟的三件事,藕記想把它們做回來。

記得它在哪

每張卡片在同一張白板上有固定位置,像實體桌面,你的手記得「那張在右下角第三排」。

順手翻到舊卡

翻找的路上會撞見忘記的舊卡。時光機和附近的卡,讓早就忘了的想法有機會回來。

連起意思相近的卡

概念相近但用詞不同的想法,搜「第一性原理」,找得到那張寫「成本最底層是什麼」的卡。

兩段切開的蓮藕之間牽著細絲,絲上掛著一張張白色卡片

名字取自「藕斷絲連」。
卡片拆開寫,想法連起來。

// 它真的做得到嗎

打開之後長這樣

拉遠鳥瞰

縮小到 5%,5000 張卡片一眼看完

拉遠之後卡片換成輕量的樣子畫,只留標題和連線,所以平移縮放一樣順。哪一區寫了什麼、哪幾群之間有線連著,一眼就看得到。

藕記拉遠到 5% 的鳥瞰畫面:5000 張卡片只留標題與連線
// 5000 張卡片的鳥瞰

寫卡片

點一下就能寫,游標落在你點的那個字上

打 [[ 叫出卡片清單,選一張就連過去;打 / 叫出區塊選單(標題、清單、表格、程式碼…);打 # 開頭的字會變成標籤。中日韓輸入法組字時不會被打斷。

藕記卡片編輯中打 [[ 叫出卡片清單,選一張就引用過去
// 打 [[ 引用另一張卡

搜尋 · Ctrl+K

全文搜尋找字面,語意搜尋找意思

語意模型在你的電腦上跑,第一次用會下載約 110MB 的模型,之後離線也能搜,筆記內容不會上傳到任何地方。

藕記 Ctrl+K 搜尋畫面,可切換全文與語意
// Ctrl+K 搜尋,上方可以切全文/語意

外觀

深色模式跟著系統切換

也可以在設定裡手動選淺色、深色。Windows 對比主題也看得清楚。「拉遠到多少就換成輕量卡片」也能自己調(設定 → 外觀 → 完整卡片)。

藕記白板的深色模式
// 深色模式

// 功能

做完、測過才放上來的

白板與卡片

  • 單一無限白板,縮小到底可以鳥瞰全部卡片,5000 張卡片照樣順
  • 卡片之間拉線建立連結,可加盧曼編號(例如 21/3d1)
  • 群組框:框選幾張卡按 Ctrl+G,框起來取個名字、換個顏色
  • 選一段文字拖到卡外,那段會剪成一張新卡,並自動連回原本那張
  • 對齊參考線、方向鍵微移、Ctrl + 方向鍵跳到那個方向最近的卡

編輯

  • markdown 編輯:標題、清單、待辦、引用、表格、程式碼、粗體斜體
  • [[ 引用卡片、# 標籤、/ 區塊選單
  • 中日韓輸入法組字時不會被打斷、不會存到一半的字
  • 卡片可以放大成整頁來寫
  • 每張卡有版本紀錄,改壞了可以挑一個舊版還原

找卡片

  • 全文搜尋+本機語意搜尋
  • 時光機:隨機翻出 30 天沒看過的舊卡
  • 卡片庫:所有卡片排成格子,還沒放上白板的卡可以拖上去
  • 標籤庫:列出所有標籤,看每個標籤底下有哪些卡
  • 卡片資訊:看反向連結、連出去的卡、標籤

問 AI(選用)

  • 對選中的卡片提問、整理摘要、找可能相關的卡
  • 只有你按下去才會送出
  • 可以接本機的 Claude Code 或 Codex(用你自己的訂閱額度),或在設定頁填自己的 API key,接任何 OpenAI 相容的服務
  • 沒設定就不會有任何東西送出去

常用操作

工具列「新卡片」 在畫面中央建一張卡
白板空白處按右鍵 在你點的位置建卡
點一下卡片 進入編輯
Esc 或點空白 退出編輯
滾輪 縮放,以游標位置為中心
中鍵拖曳,或按住空白鍵拖曳 平移整張白板
Ctrl+= / Ctrl+- / Ctrl+0 放大、縮小、回到 100%
左鍵拖白板空白處 框選多張卡
拖卡片工具列的連線鈕到另一張卡 建立連線
Ctrl+G 把選中的卡框成群組
Ctrl+K 搜尋
Ctrl+Z 復原上一步白板操作

// macOS 上 Ctrl 換成 ⌘;觸控板雙指滑動是平移,捏合是縮放。完整清單在 app 的「設定 → 快捷鍵」。

// 技術底:React 19 + TypeScript + Vite,無限畫布自己寫,拉遠時改用 Canvas 2D 畫;全白板只有正在編輯的那一張掛編輯器,其他卡只畫靜態內容,5000 張卡也不會卡

// 開始前你該知道的

從下載到寫下第一張卡

  1. 下載Windows 是 .exe,Mac 是 universal .dmg,Intel 和 Apple 晶片都能裝。
  2. 安裝Windows 第一次執行時 SmartScreen 會跳「Windows 已保護您的電腦」,按「其他資訊」→「仍要執行」。Mac 版已簽章並通過 Apple 公證,打開 dmg 拖進「應用程式」就能用。
  3. 開啟按工具列的「新卡片」,或在白板空白處按右鍵,第一張卡就出來了。

你要付出的

費用 免費。沒有付費版、沒有訂閱、沒有卡片數量上限
帳號 不用註冊。沒有登入畫面,沒有伺服器
網路 語意搜尋第一次用會下載約 110MB 的模型,之後離線也能搜
AI 問 AI 是選用的,用你自己的 Claude、ChatGPT 訂閱或 API key。不設定就不送任何東西
資料 一張卡一個 .md 純文字檔,放在你家目錄的 Topoi 資料夾
移除 解除安裝碰不到你的卡片,哪天不用藕記了,筆記照樣打得開

資料存在哪

預設資料夾在家目錄的 Topoi(Windows 是 C:\Users\你的名字\Topoi,macOS 是 ~/Topoi):

Topoi/
  cardbox/
    cards/<卡片 id>.md    每張卡一個檔
    index.json            白板上的位置、連線、群組框
    embeddings.json       語意搜尋用的向量(刪掉會自動重算)
    .versions/            每張卡的舊版
    backups/              升級前的自動備份

「設定 → 資料與備份」可以把資料夾指到 Google Drive、Dropbox、OneDrive 的同步資料夾,兩台電腦開同一份卡片;也可以把卡片匯出成一張張 .md 檔。

目前的版本

現在是 v0.2.1。版本號誠實告訴你:這還在早期,你可能會遇到我還沒抓到的 bug。升級前會自動備份一份到 backups/,升壞了退得回去。

// v0.2.1 · 這是《觀點生產線》課程的學員工具,也單獨開放下載

// 卡住了?

第一次最常撞到的幾個地方

WINDOWS

跳出「Windows 已保護您的電腦」

安裝檔沒有買程式碼簽章憑證,所以 SmartScreen 會攔一下。按「其他資訊」→「仍要執行」就能裝,不是中毒。

升級

電腦裡同時有「Topoi」和「藕記」

0.2.0 和更早的版本,程式名稱是舊代號 Topoi。裝了 0.2.1 之後兩個會並存,用藕記就好,舊的 Topoi 從「設定 → 應用程式」移除(Mac 把 Topoi.app 丟進垃圾桶)。之後的版本直接裝新版蓋過去就能升級。

Windows 移除 Topoi 時,不要勾「Delete the application data」,勾了會清掉藕記的設定。卡片放在家目錄的資料夾,兩種情況都不受影響。

同步

兩台電腦開同一份卡片

把資料夾指到 Google Drive、Dropbox 或 OneDrive 的同步資料夾。同一時間只在一台電腦編輯,避免同步衝突。

// 用得還順嗎?

抓到 bug,或想要新功能?

藕記 還在長大,你的每一句話我都會看到。哪裡怪怪的、哪裡不順、或你希望它多做什麼——跟我說,我才知道下一版要修什麼。

// 隱私權原則

藕記 會存取、收集或傳輸
你的個人資訊嗎?

不收集,但有一件事會離開你的電腦。

沒有帳號、沒有註冊、沒有使用追蹤,也不會自動連回多米——連檢查更新都不會。姓名、電話、Email、位置、聯絡人、相片、通訊內容,這些可以識別你的資料,藕記 一項都不蒐集。

語意搜尋的 AI 模型在你電腦裡跑,卡片是你資料夾裡的 .md 純文字檔。唯一會離開你電腦的,是你主動按「問 AI」時送出的卡片內容,走你自己設定的 Claude Code、Codex 或 API 金鑰。

存取什麼、存在哪、加密方式、會經過哪些第三方、你有哪些控制權—— 讀 藕記 完整隱私權政策 →

// 這一段講的是 藕記 這個程式。本頁的反饋表單是網站功能,名字和 Email 由你選填,只拿來回信給你。