openKMS¶
开放知识管理系统（Open Knowledge Management System） — 面向人与 Agent 的统一治理知识网络。
团队在同一语料上检索、贡献与治理——答案有出处、受权限约束，而不是困在私聊或过期文件里。
GitHub 仓库 :material-github: 快速开始
为什么选择 openKMS？¶
多数组织已有文件、维基和 AI 聊天。缺口在于一个统一入口：
- 一线员工能找到有出处、敢用于实际工作的答案。
- 专家无需单独开一轮「出版项目」即可贡献知识。
- 组织能治理「谁可见什么、什么仍有效、什么必须复审」。
- Agent能发现、检索、作答并引用权限范围内的内容——而不只是无语料的模型。
openKMS 把这些视为同一张网络，而非割裂的「给人用的 KM」与「给 bot 用的 RAG」。若治理存在但无人使用——或搜索可用但答案不能用于合规——两侧都会失败。
北极星：目标与愿景 — 让一线敢用、专家愿写、组织可管、Agent 可用。
在 openKMS 里构建什么¶
内容存放在通道树（类似文件夹层级）中。典型表面包括：
| 表面 | 作用 |
|---|---|
| 文档（Documents） | 上传 PDF 与 Office 文件；解析为可编辑 Markdown（PaddleOCR-VL，经独立 VLM 服务）；版本与策略生命周期。 |
| 文章（Articles） | Markdown CMS，含通道、附件与关系（supersedes、amends、see_also 等）。 |
| 维基空间（Wiki spaces） | 基于路径的笔记、vault 导入、页面图谱、语义页面搜索。 |
| 知识库（Knowledge bases） | 混合检索与带来源的问答（分块、来源、可选 QA Agent 服务）。 |
| 知识地图与本体 | 术语关联通道/空间；可选结构化数据与图谱浏览。 |
底层能力： 操作权限 + 资源 ACL（管理员不意味着可读全部数据）、面向检索与维基覆盖的评测，以及说明已交付与后续计划的开发计划。
从哪里开始¶
| 如果你想… | 阅读 |
|---|---|
| 理解 openKMS 为何存在（愿景与业务问题） | 目标与愿景 |
| 用 Docker 或本机快速试用 | 快速开始 |
| 通过搭迷你看板学习本体 | 教程：认识本体（看板实验） |
| 自己动手：Tushare → Stock → Function 案例 | 教程：Tushare 市场分析本体 |
| 理解系统整体 | 架构 · 功能索引 |
| 查找具体功能或 API | 功能索引 → features/*.md |
| HTTP 或 schema 参考 | API 参考 · 数据模型 |
| 知识制品类型 | 知识类型 |
| 共享与资源 ACL | 数据安全 |
| 用 Agent Skill / CLI 访问 openKMS | openkms-skill |
| 搭建开发环境 | 开发者环境搭建 |
| 用 Docker 部署 | 运维 · Docker |
| 审阅安全设计（原则） | 安全 · 数据安全 · 控制台与认证 |
| 查看后续计划 | 路线图 · 开发计划 |
| 与其他技术栈对比或阅读 KM 框架 | 研究（见下） |
| 编辑文档（人或 AI Agent） | AI 代理文档规范 |
研究¶
面向架构与产品决策的笔记（非已交付功能规格）：
| 主题 | 文档 |
|---|---|
| RAG 引擎 vs openKMS | RAGFlow 与 openKMS |
| Confluence AI（Rovo）vs openKMS | Confluence AI 与 openKMS |
| LLM wiki（llm_wiki）vs 维基空间 | LLM wiki 与 openKMS |
| 衡量 KM 成效（OKF 维度） | 运营知识健康度 |
| 评测文章与维基文本 | 文本内容评测 |
一览¶
flowchart LR
User([浏览器]) -->|Vite 5173 / nginx 8082| FE[React SPA]
FE -->|/api| BE[FastAPI · 8102]
BE --> PG[(PostgreSQL + pgvector)]
BE --> S3[(S3 / MinIO)]
BE --> WK[Procrastinate worker]
WK --> CLI[openkms-cli]
CLI --> VLM[mlx-vlm · 8101]
BE -. /ask .-> QA[QA Agent]
QA -. retrieve .-> BE| 服务 | 默认端口 |
|---|---|
| 后端（FastAPI） | 8102 |
| 前端（Vite 开发） | 5173 |
| 前端（Docker，nginx） | 8082 |
| VLM 服务（mlx-vlm） | 8101 |
项目结构¶
| 路径 | 内容 |
|---|---|
backend/ |
FastAPI 服务、async SQLAlchemy、Alembic 迁移 |
frontend/ |
React 19 + Vite SPA |
openkms-cli/ |
文档解析 / 流水线 CLI（worker 调用） |
openkms-skill/ |
可选 SKILL + CLI（Agent 用 Bearer 个人 API Key；不在 Docker 内） |
vlm-server/ |
mlx-vlm HTTP 服务（PaddleOCR-VL 后端） |
docker/ |
Dockerfile 与 docker-compose.yml |
docs/ |
本站文档 |