跳到主要内容

Wiki 操作

预览站点​

job 到达 ready 状态后，可启动本地站点服务预览生成的 wiki。

POST /api/v1/wiki/{slug}/serve​

curl -X POST $HOST/api/v1/wiki/deep-learning/serve \
  -H "Authorization: Bearer $TOKEN"

响应：

{ "ok": true, "slug": "deep-learning", "url": "http://<your-server>:8668/preview/deep-learning/", "pid": 12345 }
备注

端口取自该 wiki 的 local/config.md 中的 PORT 字段。未配置时返回 400。

其他站点控制​

方法路径说明
POST/wiki/{slug}/serve/stop停止站点进程
POST/wiki/{slug}/serve/restart重启站点进程

Butler 持续维护​

grow 完成后，butler 在后台按轮次持续补全、提质 wiki 词条。

POST /api/v1/wiki/{slug}/butler​

curl -X POST $HOST/api/v1/wiki/deep-learning/butler \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"rounds": 5, "auto": true}'
字段默认值说明
rounds0（不限）运行轮次，1–1000；0 不限轮次
autotrue自动决策维护策略
model系统默认指定 AI 模型（可选）
方法路径说明
POST/wiki/{slug}/butler/stop停止管家
GET/wiki/{slug}/butler/log管家运行日志
PUT/wiki/{slug}/butler/config动态调整配置

概览与统计​

GET /api/v1/wikis-overview​

所有 wiki 的状态概览：页数、覆盖率、最近复核时间、serve/butler 运行状态。

GET /api/v1/wiki/{slug}/growth​

词条增长曲线。

curl "$HOST/api/v1/wiki/deep-learning/growth?granularity=day&days=7" \
  -H "Authorization: Bearer $TOKEN"
参数可选值说明
granularityhour / day / week统计粒度
days整数查询过去 N 天

GET /api/v1/wiki/{slug}/search​

wiki 内全文检索：?q=卷积神经网络