智能制造知识中心 · 整体说明¶

📄 创建: 墨 2026-08-03

https://doc.xpku.com/raw/tools/knowledge-center.md

面向想了解/接入知识中心的同事，回答架构、技术栈、接入、编辑等常见问题。

概述¶

智能制造知识中心（doc.xpku.com/kb）是部门统一文档平台，承载规范、技术文档、产品手册等。支持网页在线编辑 + AI/agent 通过 MCP 自动读写。

1. 服务架构¶

docker-compose 编排，核心服务同网络按服务名互访：

2. 技术栈¶

• mkdocs Material：文档站点生成
• Python Flask：编辑器、MCP server、转换服务
• pandoc + libreoffice：.doc/.docx → markdown 转换（含图片提取）
• docker-compose：服务编排
• Vditor：编辑器 markdown 所见即所得
• Discourse：团队通信（MCP msg 模块）

3. 是否基于开源¶

是。核心基于开源：mkdocs + Material for MkDocs（Apache 2.0）、pandoc（GPL）、libreoffice（MPL）。编辑器、MCP server、转换服务为部门自研（Python）。

4. 用户接入使用（MCP）¶

AI/agent 通过 MCP 读写知识库：

• endpoint：https://doc.xpku.com/mcp/kb/sse?api_key=<你的key>
• key：向管理员（墨）申请，64 字符 hex
• 工具：
• 读（开放）：search_docs 搜索、get_doc 取全文、list_docs 列文档
• 写（需 key）：create_doc 建 md、create_html 上传 html 页、create_from_file 上传 doc/docx 自动转换、move_doc/rename_doc/reorder_doc/delete_doc

接入：MCP 客户端配置 endpoint + key 调用工具。详见 MCP 接入文档。

5. 文档实时更新¶

实时更新：编辑器或 MCP 写文档 → mkdocs build 自动触发（kb-watch 监 docs 变化）→ 站点更新。小文档秒级，大文档（带图手册）约数分钟。编辑器"🔄 重建"按钮可手动触发并查看状态。

6. 网页在线编辑¶

访问 doc.xpku.com/admin/（SSO 登录）：

• 左侧树状导航（展开/收起 + 拖拽调宽）
• 新建文档(md) / 上传文件(.doc/.docx/.html 自动转 md) / 改名 / 调序 / 删除
• Vditor 所见即所得编辑（类似 Obsidian）
• 每页带创建人/时间元数据 + 复制 Markdown 原文链接

上传 .doc/.docx 用 pandoc 转 markdown（图片提取 + 右侧目录），对 Word 文档友好。

相关文档¶

• MCP 接入文档：endpoint/key/工具详细
• 写作指南：markdown 语法 + mkdocs 特性

—— 墨 2026-08-03