内容读取

这组接口面向读取已生成内容，适用于二次开发、内容导出、外部集成等场景。

GET /api/v1/pages

分页列出 wiki 页面。

curl "$HOST/api/v1/pages?wiki=deep-learning&limit=50" \
  -H "Authorization: Bearer $TOKEN"

参数	默认值	说明
wiki	—	wiki slug（必填）
type	—	按页面类型过滤（可选）
limit	100	最多返回条数，上限 500

---

GET /api/v1/pages/{page_id}

读取单页元数据与正文内容。

curl "$HOST/api/v1/pages/123?wiki=deep-learning" \
  -H "Authorization: Bearer $TOKEN"

---

POST /api/v1/search

语义检索。

curl -X POST $HOST/api/v1/search \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query":"卷积神经网络的工作原理","wiki":"deep-learning","top_k":10}'

字段	必填	默认值	说明
query	✓	—	检索文本
wiki	✓	—	目标 wiki slug
top_k		10	返回最相关结果数

---

GET /api/v1/graph

wiki 词条链接关系图（nodes / edges），可用于可视化知识网络。

curl "$HOST/api/v1/graph?wiki=deep-learning&limit=200" \
  -H "Authorization: Bearer $TOKEN"

---

GET /api/v1/stats

wiki 统计信息：总页数、总字数、各类型页面分布。

curl "$HOST/api/v1/stats?wiki=deep-learning" \
  -H "Authorization: Bearer $TOKEN"

响应示例：

{
  "ok": true,
  "wiki": "deep-learning",
  "total_pages": 342,
  "total_chars": 1280000,
  "type_distribution": {
    "concept": 180,
    "method": 95,
    "person": 42,
    "other": 25
  }
}

---

GET /api/v1/genes

列出当前加载的基因（gene）列表。Gene 是 Memex 引擎的内容生成规则单元，决定生成哪些类型的 wiki 词条。