{"ok":true,"data":{"service":"village-vault","village":"湖南长铺子乡动雷村","version":"1.0.0","auth":"Authorization: Bearer <token>（READ / WRITE / REVEAL / UPLOAD 四级能力，非高低顺序）","endpoints":["GET    /api/v1/health","GET    /api/v1/guide   ← 给 AI 的完整使用说明（markdown），新接入先读这个","GET    /api/v1/manifest","GET    /api/v1/files?q=&category=&tag=&sensitivity=&limit=&cursor=","GET    /api/v1/files/{id}","GET    /api/v1/files/{id}/text  ← 云端解析后的正文，AI 读内容用这个","GET    /api/v1/files/{id}/raw[?download=1]  (原始字节，支持 Range)","POST   /api/v1/upload  (multipart: file,category,tags,note,sensitivity | raw body + ?name=)","PATCH  /api/v1/files/{id}  (JSON: category/tags/note/sensitivity)","DELETE /api/v1/files/{id}","GET    /api/v1/persons?q=&household_id=&tag=&limit=&cursor=","GET    /api/v1/persons/{id}[?reveal=1]   (reveal 需 REVEAL 权限，写审计)","POST   /api/v1/persons/reveal-batch  (JSON: ids,fields —— 仅本机脚本调用，勿暴露给 AI)","GET    /api/v1/search?q=&type=all|file|person|text","GET    /api/v1/audit?limit=100","GET    /upload  (内嵌上传网页)"]}}