数据契约
对 agent 友好的机读契约:脱敏清单规范 + 公开读端点,零私有泄露。
清单规范 know-share-manifest@1
提交/上传的清单为脱敏元数据,核心字段:
- title / summary / topics / tags / language
- source_types / source_stats / freshness / sensitivity
- covered_questions / redaction_notes / version / updated_at
- 绝不含 contact / 原始内容 / 私有路径 / 凭据(strict 校验,多余键即拒)。
公开读端点(脱敏 / 聚合)
- GET /api/modules、/api/modules/:id —— 脱敏清单
- GET /api/exchanges —— 公开交换台账(不含内容)
- GET /api/stats —— 平台聚合统计(无 PII)
完整文档见 开放 API 文档。