WikiBrain說明登入← 知識庫
說明 · 2 / 5

使用指南

日常循環、規則與模版、每個檢視怎麼用

日常循環：三個操作

Karpathy 把知識庫的日常歸納成三個操作，WikiBrain 的介面就照這三個做：

  • 編纂（Ingest）。來源進 raw/ 之後由 agent 讀完、寫摘要頁、更新相關頁與 index.md、在 log.md 記一筆。一份來源可能動到十幾頁。什麼叫「待編纂」？一個 raw/ 來源還沒有任何 wiki 頁連回它，就是待編纂；橫幅、健檢頁、統計頁都會列出。
  • 對話（Query）。頂欄「對話（Query）」開右側面板。agent 先讀 index.md 找相關頁，再讀內容回答，並附頁面路徑當引用；回答可以是表格、Mermaid 圖或 Marp 投影片。有價值的回答按「存成 wiki 頁」，會變成 wiki/queries/ 的一頁，探索的成果留在知識庫裡。在 1280 px 寬度下，對話面板會暫時取代右欄。
  • 健檢（Lint）。頂欄「健檢（Lint）」。先做確定性檢查：孤兒頁、斷連結、未進目錄、待編纂、log 格式、缺 index.md 或 log.md；再可按「請 agent 深度健檢（Lint）」找矛盾、過期說法、該有自己頁面的概念，寫成 wiki/lint/日期.md。確定性檢查不算 agent 次數。
對話面板
對話（Query）面板：回答附頁面引用與工具軌跡，「存成 wiki 頁」把答案歸檔。

先討論再編纂（Karpathy 偏好的做法）

Karpathy 說他偏好一次一份來源、全程參與：agent 先講重點、和他討論該強調什麼，再動筆。WikiBrain 把這個流程做成四步：

  1. 開啟一個待編纂的來源頁，橫幅上按「先討論再編纂（Ingest）」。對話面板會開啟，輸入框已帶好一段提示詞：請 agent 讀完來源、用條列講重點、說明它和既有 wiki 頁的關係、以及打算怎麼歸檔。
  2. 按「送出」。agent 讀來源與 index.md 後回覆。接著糾正它：「第三點不重要」「這篇要跟 X 頁對照」「用論點頁的格式」。多來回幾次都可以。
  3. agent 回覆之後，輸入框上方那條淡青色的列會出現「依討論結果編纂（Ingest）」。按下去會開一個編纂工作，把整段討論當成指示交給 agent；它依結論建摘要頁、更新相關頁、index.md 與 log.md，進度在來源頁上方顯示。
  4. 不想討論也可以直接按「自動編纂（Ingest）這則」，agent 會照 schema 規則一次做完。兩條路的結果一樣會出現在 wiki/、index.md 與 log.md。

規則與模版

模版。第一次進入空工作區會請你選一個：通用、研究者、專案管理者、讀書。模版 = schema/ 的規則頁 + 起始資料夾 + 給 agent 的起手提示詞，只影響內容不改介面。設定頁的「情境模版」可以再疊加（加不覆蓋）、「預覽內容」看每一頁、「複製為自訂模版」改成自己的、「把目前規則存成模版」把調好的 schema/ 存起來。

模版預覽
套用前可預覽模版的每一頁；自訂模版可編輯每個檔案。

index.md 與 log.md。在 WikiBrain 裡它們是 wiki/index.md 與 wiki/log.md，模版會建好，agent 每次編纂都更新，你不必手動維護；健檢會檢查它們有沒有漏。index.md 是內容目錄，每頁一行含連結與一句摘要；log.md 只追加，每條以「## [日期] ingest | 標題」開頭，記每次編纂、對話歸檔、健檢。

怎麼寫規則。schema/instructions.md 是給 agent 的規則，用一般中文寫就好，改完存檔即生效，下一次編纂就會遵守。常見的規則：

  • 「wiki 頁一律用繁體中文，術語第一次出現時附英文。」
  • 「論文摘要頁放 wiki/sources/，檔名用 citation_key；每頁最後列『與哪些頁有關』。」
  • 「有矛盾就在兩頁都標『⚠ 與 X 頁矛盾』，不要自己選一邊。」

agent 抓錯重點或寫錯了？三個層次：小錯直接改頁，右欄「版本紀錄」可以回到任何舊版；在對話面板告訴它哪裡錯，請它修正並更新 index.md；同一種錯一再發生，就把規則寫進 schema/instructions.md。

檢視與工具

  • 筆記。閱讀與編輯（Markdown，即時預覽，Ctrl／⌘+S 儲存，可插入或貼上圖片）；右欄有反向連結與版本紀錄，任何舊版都能檢視、比較與復原。同一頁被兩邊同時改時，後儲存的一方會拿到目前版本並保留自己的草稿。
  • 圖譜。raw 灰、wiki 青瓷、schema 琥珀；連結是編纂時 agent 寫出來的，不是從來源自動抓的。可拖曳、縮放、播放時間軸看知識庫怎麼長大；「篩選」可以只看某一層、某個資料夾、搜尋標題、隱藏孤立頁，或以目前頁為中心只看一兩層鄰居。
  • 資料表。把每頁 front-matter（每頁開頭的屬性欄，例如作者、年份、tags）列成表，可篩選、排序、分組、複製 CSV。研究者模版套用後預設是文獻表。
  • 搜尋。頂欄搜尋框對標題與內文做子字串比對，也是 MCP 的 search_notes。
  • 匯入。「＋ 新增」四個分頁：寫筆記、貼網址、上傳檔案（PDF、Word、HTML、Markdown、純文字，以及 .bib／CSL-JSON 書目檔，一筆一頁）、貼上文字。論文網址會自動補齊作者、年份、期刊與 DOI；一般網頁只留標題、網址與擷取時間；網頁裡的圖片會存成附件。需要 JavaScript 才顯示內容的網頁會改用內建的瀏覽器擷取；有機器人驗證或需要登入的站仍抓不到，請貼文字或上傳 PDF。
  • 書目與引用。wiki 頁裡寫 [@citation_key]，會渲染成（作者, 年份）連到來源頁，頁尾自動列參考文獻，匯出的 Markdown 與 .bib 可直接給 pandoc。設定頁可連 Zotero：唯讀 key、每小時把新項目拉進 raw/sources/（含 PDF 全文），不寫回 Zotero。
  • 統計。各層頁數、來源型別、每日新增、編輯熱度圖、agent 每日 tokens 與費用。
知識圖譜
圖譜：篩選面板與時間軸；連結是編纂時 agent 寫出來的。
新增對話框
「＋ 新增」對話框：四個分頁共用同一個入口。

REST API（用 MCP token 當 API key）

想從腳本、cron、Claude Code 的 hook 或其他程式直接讀寫，不必經過 MCP：設定頁建立的 MCP token 也可以當 REST API 的 API key，加在 Authorization: Bearer 標頭即可，不需要 cookie 或 Origin。同一把 token 撤銷後兩邊一起失效；寫入的版本作者會標示 token 名稱。帳號層級的端點（token、AI 設定、Zotero、訂閱、對話與自動編纂）只能在網頁登入後使用。

# 目錄（三層與待編纂清單）
curl -H "Authorization: Bearer $TOKEN" https://wikibrain.app/api/notes/tree
# 讀一頁
curl -H "Authorization: Bearer $TOKEN" "https://wikibrain.app/api/notes?path=wiki/index.md"
# 新增（201）；同路徑已存在回 409
curl -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"path":"raw/sources/note.md","content":"# 標題\n\n內文"}' https://wikibrain.app/api/notes
# 更新（帶 if_version 樂觀鎖；舊版本回 409 與目前內容）
curl -X PUT -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"path":"wiki/index.md","content":"...","if_version":3}' https://wikibrain.app/api/notes
# 搜尋、反向連結、版本
curl -H "Authorization: Bearer $TOKEN" "https://wikibrain.app/api/search?q=關鍵字"
# 匯入網址或檔案進 raw/
curl -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -d '{"url":"https://example.com/paper"}' https://wikibrain.app/api/import
# 匯出整座知識庫（zip）
curl -H "Authorization: Bearer $TOKEN" -o wiki.zip https://wikibrain.app/api/export