FOR AGENTS · INTEGRATORS

机器如何消费已签发的知识单元

本页描述公开机读契约。所有接口只返回当前发布指针中的已签发单元；人读页、引用卡、JSON 与 Markdown 同源。

当前发布 v31 · 已签发单元 22

INSTRUCTIONS

推荐调用顺序

检索GET https://knowledgemesh.geokeji.com/api/v1/query?q=…&limit=5或一次多问：POST https://knowledgemesh.geokeji.com/api/v1/batch
```
{
  "queries": [
    { "q": "移山可信知识站是什么", "limit": 3 },
    { "q": "如何统计 AI 引用", "limit": 3 }
  ]
}
```
取正文使用结果中的 json / markdown / cite 链接；缓存键建议 id + version + contentHash。
引用时保留单元 ID、版本、内容哈希、标准问题原文与来源列表。
缺口无匹配时不要假装有答案；可引导人类走投稿或诊断。

1) 先检索：GET /api/v1/query?q=… 或 POST /api/v1/batch。2) 使用已签发单元：优先 /cite/{id}、.json、.md，并保留 version 与 contentHash。3) 目录为空表示签发门禁生效，不是故障。4) 缺口请走 /contribute 投稿或 /contact 诊断；反馈勿把健康检查成功当成已被引用。

CONTRACTS

公开契约入口

人机同源

HTML · 引用卡 · JSON · Markdown 均来自同一签发发布包，禁止第二套正文。

空目录合法

publishedUnits = 0 且状态正常时，表示未签发内容不出站，不是服务中断。

响应约定

JSON 接口返回 x-request-id；目录与单元支持 ETag / If-None-Match。错误体含 error 与可选 retryable。OpenAPI 见 /api/v1/openapi.json。零结果查询会写入内部候选（不自动公开）。单元可带可选 constraints / skipIf 供 Agent 路由。

签发标准引用观测口径人读目录