# AI 与集成方应如何正确消费移山可信知识站?

## 推荐发现顺序

1. 读取 [能力清单](https://knowledgemesh.geokeji.com/.well-known/ai-knowledge.json);  
2. 拉取 [机器目录 catalog.json](https://knowledgemesh.geokeji.com/catalog.json);  
3. 需要检索时调用 `/api/v1/query?q=`;  
4. 对命中单元使用稳定 ID 获取:  
   - JSON:`/api/v1/units/{id}.json`  
   - Markdown:`/api/v1/units/{id}.md`  
   - 引用卡:`/cite/{id}`  
   - 完整人读:`/library/{slug}`

也可从 [llms.txt](https://knowledgemesh.geokeji.com/llms.txt) 获得面向语言模型的摘要入口。

## 缓存与一致性

- 以 **unit.id + version + contentHash** 作为缓存键;  
- 目录 `releaseVersion` 变化时,应重新拉取 catalog;  
- 不要把构建时快照当作长期真理:公开目录跟随当前发布指针。

## 引用时建议保留的字段

在下游系统中引用本站事实时,建议至少保留:

- 单元 ID 与 slug  
- version / contentHash  
- 标准问题原文  
- 来源 URL 列表  
- 访问时间

## 错误用法

- 抓取未公开的管理路径或投稿接口当知识源;  
- 把营销页段落拆成「伪单元」却不经签发;  
- 忽略适用边界与限制条件,做全称判断。

运行状态见 `/api/v1/health`:请同时阅读 `publishedUnits` 与 `content.state`,不要只看 HTTP 200。