---
name: wiki-ingest
description: "OmegaWiki 知識庫管理。三模式：(1) 攝入 — 新內容經三原則審查後編入 wiki；(2) 健檢 — 掃描孤立頁、壞連結、缺 frontmatter；(3) 查詢 — 搜尋 wiki 回答問題。觸發詞：攝入、ingest、健檢、lint、wiki、查詢 wiki。"
---

# 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 格式

```yaml
---
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 目錄 → 攝入時只新增，不修改現有檔案（除非衝突解決）
- 健檢只報告，不自動修復
- 來源檔案 → 不修改
- 已存在的實體 → 先報告衝突，等用戶確認