📖 Knowledge Base 使用指南¶

Allen 的知識整理系統 - Obsidian 整合版

🚀 快速開始¶

1. 安裝 Obsidian¶

# Ubuntu/Debian
wget https://github.com/obsidianmd/obsidian-releases/releases/download/v1.5.3/obsidian_1.5.3_amd64.deb
sudo dpkg -i obsidian_1.5.3_amd64.deb

# 或使用 Snap
sudo snap install obsidian --classic

2. 開啟知識庫¶

啟動 Obsidian
選擇「Open folder as vault」
選擇路徑：/home/allen/.openclaw/workspace/knowledge-base

3. 安裝必要插件¶

方法 A：自動安裝（推薦） - Obsidian 會自動偵測 .obsidian/community-plugins.json - 到設定 → Community plugins → 開啟 Dataview

方法 B：手動安裝 1. Settings → Community plugins → Browse 2. 搜尋 "Dataview" 3. Install → Enable

📁 目錄結構¶

knowledge-base/
├── .obsidian/          # Obsidian 配置
├── threads/            # Threads 文章（28 篇）
├── articles/           # 一般文章（11 篇）
├── Home.md             # 首頁（入口）
├── INDEX.md            # 完整索引
├── TAGS.md             # 標籤總覽
├── TEMPLATE.md         # 文章範本
├── pending-threads.md  # 待處理清單
└── README.md           # 本文件

🎯 核心功能¶

📊 Dataview 動態查詢¶

已內建多個 Dataview 查詢模板：

依瀏覽數排序¶

TABLE views, date, author
FROM "threads" OR "articles"
SORT views DESC
LIMIT 10

依標籤篩選¶

LIST
FROM "threads" OR "articles"
WHERE contains(tags, "AI")
SORT date DESC

月度統計¶

TABLE length(rows) as "文章數"
FROM "threads" OR "articles"
GROUP BY dateformat(date, "yyyy-MM")

🔗 雙向連結¶

在文章中使用 [[文章名稱]] 建立連結： - 自動補全檔案名稱 - 滑鼠懸停預覽 - 右側面板顯示反向連結

📈 圖譜視圖¶

點擊左側工具列的 Graph View 圖示
查看所有文章的關聯網路
可依標籤、資料夾篩選

🛠️ 維護操作¶

添加新文章¶

選項 A：使用範本

cp TEMPLATE.md threads/2026-02-27-new-article.md
# 編輯內容

選項 B：自動抓取

node fetch-threads.js "https://threads.com/..."
# 自動生成 Markdown 文件

批次添加 Frontmatter¶

如果有舊文章需要添加 YAML frontmatter：

chmod +x add-frontmatter.js
node add-frontmatter.js

更新索引¶

索引文件使用 Dataview 動態查詢，自動更新，無需手動維護。

📌 推薦工作流¶

日常瀏覽¶

開啟 [[Home|首頁]]
查看「最新文章」或「熱門文章」
點擊感興趣的文章

主題研究¶

開啟 [[TAGS|標籤總覽]]
選擇主題標籤
瀏覽相關文章

探索關聯¶

開啟任一文章
查看「相關文章」區塊
或使用 Graph View 視覺化

🔧 進階配置¶

自訂查詢¶

建立自己的 Dataview 查詢：

TABLE 
  views as "瀏覽數",
  author as "作者"
FROM "threads"
WHERE contains(category, "美食")
SORT views DESC

快捷鍵¶

功能	快捷鍵
快速開啟	`Ctrl/Cmd + O`
全文搜尋	`Ctrl/Cmd + Shift + F`
命令面板	`Ctrl/Cmd + P`
返回上一頁	`Ctrl/Cmd + Alt + ←`
圖譜視圖	`Ctrl/Cmd + G`

主題設定¶

Settings → Appearance → Themes → Browse

推薦主題： - Minimal - Things - Blue Topaz

📊 統計資訊¶

總文章數：39 篇
Threads 文章：28 篇
一般文章：11 篇
標籤數：約 50+ 個
最高瀏覽數：1.5M（日本御守大賽）

🆘 疑難排解¶

Dataview 查詢沒有結果¶

確認 Dataview 插件已啟用
檢查文章是否有 frontmatter
執行 node add-frontmatter.js 批次添加

連結顯示為紅色¶

紅色連結 = 檔案不存在
確認檔案名稱拼寫正確
使用 [[檔名|顯示文字]] 格式

圖譜視圖空白¶

需要文章之間有 [[連結]] 才會顯示關係
逐步在文章中添加相關連結

🎓 學習資源¶

Obsidian 官方文件
Dataview 文件
Obsidian Skills（knowledge-base 已收錄）

📝 下一步¶

✅ 安裝 Obsidian
✅ 開啟知識庫
✅ 啟用 Dataview 插件
✅ 執行 node add-frontmatter.js（為現有文章添加 frontmatter）
✅ 開啟 [[Home|首頁]] 開始探索！

最後更新：2026-02-27
維護者：Allen + 多多