OmegaWiki 管理
Wiki 路徑與結構
根目錄:wiki/(已在專案目錄內,透過 symlink 指向 /home/openclaw/shared/ΩmegaWiki/wiki/)
wiki/ ├── papers/ # 論文摘要 (YYYY-MM-DD-topic.md) ├── concepts/ # 概念定義 (kebab-case-term.md) ├── claims/ # 聲明斷言 (claim-name.md) ├── topics/ # 主題追蹤 (kebab-case-topic.md) ├── summaries/ # 領域綜述 (topic-summary.md) ├── graph/ # edges.jsonl(知識圖譜) ├── backlinks.md # 雙向連結對照表 ├── log.md # 操作日誌 └── index.md # 索引
模式判定
| 用戶說 | 模式 |
|---|---|
| 「攝入」「ingest」「新增論文」 | 攝入模式 |
| 「健檢」「lint」「wiki health」「結構檢查」 | 健檢模式 |
| 「查詢」「wiki 裡有沒有」「XX 是什麼」 | 查詢模式 |
模式一:攝入(Ingest)
步驟 1:解析來源
讀取用戶提供的來源(URL、文字、或 raw/papers/ 中的檔案),提取核心主張、數據、結論。
步驟 2:三原則審查
| 原則 | 分數 | 評估標準 |
|---|---|---|
| 原創性 | 1-5 | 新架構/算法/觀點?有一手實踐? |
| 可信度 | 1-5 | 機構評價、實驗嚴謹度、寫作動機? |
| 影響力 | 1-5 | 對讀者認知或行動的貢獻? |
門檻:總分 < 8 → 拒絕攝入,記錄到 wiki/summaries/discarded.md
步驟 3:衝突檢測
- 搜尋
wiki/claims/檢查是否與現有 claims 矛盾 - 若矛盾 → 報告用戶,等確認後才寫入
- 在雙方 frontmatter 標註
contradicts: [[opposing-claim]]
步驟 4:建立實體
| 類型 | 目標目錄 | 命名 |
|---|---|---|
| 論文摘要 | wiki/papers/ |
YYYY-MM-DD-topic.md |
| 概念定義 | wiki/concepts/ |
kebab-case-term.md |
| 聲明斷言 | wiki/claims/ |
claim-name.md |
| 主題追蹤 | wiki/topics/ |
kebab-case-topic.md |
| 領域綜述 | wiki/summaries/ |
topic-summary.md |
步驟 5:Frontmatter 格式
---
date: YYYY-MM-DD
type: article|claim|summary|concept|topic
tags: [tag1, tag2]
source: 來源 URL 或檔名
related: [[linked-page]]
review:
originality: 1-5
credibility: 1-5
impact: 1-5
total: N
contradicts: [[opposing-claim]]
---
步驟 6:建立連結
- frontmatter related 欄位建立 wikilink
- 記錄到 wiki/graph/edges.jsonl:
{"source": "paper/slug", "target": "concept/slug", "type": "builds_on", "weight": 1}
- 邊類型:builds_on(1)、extends_concept(1)、asserts(1)、contradicts(-1)、related_to(0.5)
步驟 7:更新日誌
- [YYYY-MM-DD] [INGEST] 新增 papers/filename.md [[related-link]]
模式二:健檢(Lint)
執行 scripts/wiki-lint.sh 或手動檢查:
# 檢查項目
1 孤立頁
2 壞連結
3 缺 Frontmatter
4 過時內容
5 索引不完整
健檢完成後:
1. 重建 wiki/backlinks.md
2. 輸出報告
3. 更新 wiki/log.md
健檢只報告、不自動修復。等用戶確認後才執行修復。
模式三:查詢(Query)
1. 讀 wiki/topics/index.md 定位領域
2. 跟隨 wikilinks 到 papers/concepts/summaries
3. 用 grep 跨 wiki/ 搜尋關鍵詞
4. 綜合回答,來源用 [[wikilink]] 標記
若 wiki 無相關內容 → 提示用戶「說『攝入』補充此主題」。
命名規範
- Wikilink:全小寫、連字符([[ai-agent]] ✓)
- 檔名:kebab-case,論文加日期前綴
- Frontmatter:必須有 date + type + tags
⛔ 安全邊界
- Wiki 目錄 → 攝入時只新增,不修改現有檔案(除非衝突解決)
- 健檢只報告,不自動修復
- 來源檔案 → 不修改
- 已存在的實體 → 先報告衝突,等用戶確認