开放知识格式 OKF 完整解读（极简主义知识表示规范）

一、知识库目录结构

基于纯文件目录树，无专用数据库，全部使用 Markdown 文件存储：

1. 概念文档： .md ，承载实体、数据表、业务对象完整定义
2. index.md（可选）：目录索引清单，汇总本文件夹所有概念
3. shturl（可选）：版本更新变更日志
4. 多层子目录：实现领域、数据集分层隔离（如 datasets 文件夹存放业务数据集）

二、单份概念文档标准结构

文件分为YAML元数据头 + Markdown正文两段：

1. YAML Frontmatter（必填type字段）
- 类型、标题、业务描述、资源链接、标签、时间戳等标准化元信息
2. Markdown 正文三大模块
- Schema：字段、类型、业务说明，用来定义数据表/实体结构
- Joins：关联关系，通过内部MD路径实现实体之间链路绑定
- Citations：引用资料、数据源备注

三、核心特性与集成优势

1. 底层标准：基于通用 Markdown + YAML，无私有格式、无需专用工具，普通人可直接读写
2. 双向友好：人类可读可编辑，AI/代理可自动解析、检索、比对
3. 强互操作性：支持跨团队、跨工具迁移，便于知识库交换
4. 适配AI Agent：可作为企业本地知识库底座，给大模型提供结构化关联知识
5. 轻量化部署：纯文件存储，版本可用Git管理，轻量化对接RAG、智能体系统

适用场景

企业数据字典、业务实体知识库、数据仓库文档、AI私有知识库、多团队协同知识治理。

OKF 开放知识格式 知识库规范 数据字典 RAG知识库 AI知识底座 Markdown知识库 知识图谱轻量化 企业数据治理