文档越来越多真正的问题却不是“存在哪里”而是谁能看、能不能快速找到、AI 回答有没有依据、内部知识能否继续转化为内容。本项目是一套可私有化部署的多部门权限企业知识库。它用 Spring Boot React 管理文档与权限用关键词和向量检索定位知识用 DeepSeek 完成 RAG 问答并通过火山方舟生成可审校的微信公众号文章初稿。一句话看懂文档入库 → 部门隔离 → 分块索引 → 语义检索 → 有来源问答 → 公众号内容复用。当前版本2.1核心技术Spring Boot 2.7、React 18、MySQL 8、DeepSeek、火山方舟、可选 Milvus本文参考 2026 年 IT 技术内容常见的移动端编辑方式结论前置、标题明确、短段落、少堆概念、关键步骤可执行。不存在微信官方统一的“爆款评分标准”因此本文不做夸大承诺。一、项目背景及简介1.1 为什么要做企业知识管理经常卡在四个地方资料散制度、手册和项目经验分散在网盘、群文件与个人电脑。检索慢文件名记不清关键词不一致知道“有这份资料”却找不到。回答虚通用大模型不了解企业内部事实答案听起来合理却无法核验。复用难内部资料很多对外写案例、公众号和项目介绍时仍要重新整理。这个项目没有再造一个网盘而是让文档进入一条可持续使用的知识链路上传原文 ↓ 解析并分块 ↓ 关键词 / 向量检索 ↓ RAG 问答与来源引用 ↓ 公众号文章初稿与人工终审1.2 项目能解决什么目标系统能力存得进单文件/批量上传Tika 解析正文找得到关键词检索 Embeddings 语义检索问得准DeepSeek RAG 问答返回相关来源管得住RBAC 多部门数据隔离写得出基于权限内资料生成公众号初稿可上线MySQL、Nginx、可执行 jar支持私有化部署1.3 产品边界系统提供可核验的知识入口不替代正式制度原文。公众号功能生成的是可编辑初稿不替代人工事实核验。微信能力只同步到草稿箱不自动群发。小规模知识库可直接使用内存向量检索大规模场景再接入 Milvus。二、目标客户2.1 适合谁中大型企业需要部门级资料隔离和统一知识入口。技术团队需要检索规范、API 文档、故障记录与项目经验。制造与工程企业需要复用设备手册、SOP、项目案例和维保资料。咨询与项目制团队需要快速查找历史方案与行业案例。内容运营团队希望基于企业真实资料生成公众号文章初稿。2.2 不适合谁只需要个人笔记语雀、Notion 等工具更轻。需要复杂 Agent/Workflow 编排应选择专门的 AI 应用平台。希望完全无人审核自动发文本系统明确保留人工终审环节。三、平台定位3.1 一句话定位企业知识资产的“存、搜、问、写”中台。它位于文件存储与通用大模型之间先解决权限和知识检索再让 AI 基于可见资料回答和写作。3.2 与普通网盘、通用大模型的区别对比项普通网盘通用大模型本系统文档管理有无有部门权限基础目录权限无企业边界全链路部门过滤语义检索通常较弱不检索企业资料关键词 向量回答依据无问答依赖模型记忆优先引用知识条目内容复用人工整理容易脱离企业事实权限内取材后生成初稿部署方式SaaS/私有化多为外部服务支持私有化部署3.3 核心差异权限不是页面筛选而是后端接口级约束。问答不是裸聊而是检索增强生成RAG。写稿不是凭空创作而是优先复用企业知识。AI 能力可选关键词检索等基础链路仍可独立工作。四、平台技术与系统架构4.1 整体架构flowchart LR U[浏览器] -- N[Nginx /knowledgeWeb] N -- F[React 18 管理后台] N -- B[Spring Boot 2.7 API] B -- DB[(MySQL 8 / H2)] B -- FS[本地文件存储] B -- AI[DeepSeek / 火山方舟 / Embeddings] B -- V[(可选 Milvus)] B -- WX[可选微信草稿箱]4.2 核心技术栈层级技术主要职责前端React 18、TypeScript、MUI、Axios管理后台、路由、表单、状态与 API 调用后端Java 8、Spring Boot 2.7.17REST API、业务逻辑与可执行 jar安全Spring Security、JWT、BCrypt登录认证、角色授权与接口保护数据JPA、MySQL 8、H2业务数据、本地开发与测试文档Apache Tika 2.9PDF、Office、TXT、HTML 等正文抽取AIDeepSeek、火山方舟、Embeddings问答、写稿与语义向量向量内存余弦相似度 / Milvus小库检索与可选大规模 ANN工程Maven、Playwright、Nginx构建、自动化测试与生产部署4.3 四条核心业务链路文档入库上传 → Tika 解析 → 文档落库 → process-and-index → KnowledgeEntry 分块 → 可选向量化智能搜索查询 → 部门权限过滤 → 关键词/向量召回 → 相似度排序 → 返回来源智能问答问题 → 检索知识条目 → 组装上下文 → DeepSeek 生成 → 保存会话与来源公众号写作主题 → 权限内取材 → 火山方舟生成 → 富文本复制/草稿箱 → 人工终审4.4 权限与配置登录后由 JWT 标识用户PreAuthorize控制角色PermissionUtil继续按department_id过滤数据。运行时配置保存在data/runtime-settings.json系统配置页保存后生效DeepSeek 智能问答火山方舟公众号写稿Embeddings 语义检索微信公众号草稿同步OCR五、平台核心业务功能5.1 用户与部门权限角色权限范围SUPER_ADMIN全系统、全部门、用户、配置与审计ADMIN本部门文档、搜索、问答等业务USER所属部门内的日常查询与使用用户可关联多个部门。文档、搜索、问答和公众号取材均按可见部门过滤。5.2 文档管理与知识索引支持 PDF、Office、TXT、Markdown、HTML 等常见格式。支持单文件与批量上传。上传后调用process-and-index生成知识条目。支持分类、部门归属、索引状态与删除操作。Embeddings 不可用时仍可使用关键词检索。5.3 智能搜索与 RAG 问答关键词检索负责稳定兜底。向量检索解决“意思相同、措辞不同”的召回问题。问答支持多轮会话和来源引用。会话按用户隔离不能读取他人的sessionId。DeepSeek 未配置或不可用时可退回本地知识片段整理。5.4 公众号文章助手系统先检索用户权限范围内的知识再调用火山方舟生成文章。默认模型doubao-seed-2-1-turbo-260628深度思考默认关闭codeplan.thinkingdisabled当前体验包括预计生成进度条今天/昨天/更早的历史分组与折叠单条历史删除富文本“复制到公众号”Markdown 复制可选同步到微信草稿箱当前生成接口为非流式。固定业务开销较小等待时间主要取决于模型输出字数。进度条是体验层估算并非真实 Token 进度。5.5 工作台与系统管理总文档、知识条目、未索引文档、用户/部门等统计。今日问答、上传、登录及存储占用。统计卡片可点击进入对应业务页面。用户、部门、运行时配置和审计日志集中管理。六、平台独特优势6.1 权限贯穿完整链路部门权限不仅作用于文档列表也覆盖搜索、问答和公众号取材避免前端隐藏但后端仍可访问的问题。6.2 AI 可增强也可降级Embeddings 或 DeepSeek 暂时不可用时系统仍保留关键词检索与本地知识整理能力避免所有功能绑定单一外部服务。6.3 对内知识可以继续对外复用同一批经过权限管理的资料既服务内部查询也可用于公众号初稿减少重复整理素材。6.4 适合 Java 技术体系私有化落地后端为 Spring Boot 可执行 jar前端为静态资源生产环境可使用 MySQL Nginx对于已有 Java 运维体系的企业上手路径清晰。6.5 小库轻量大库可扩展小型知识库无需先部署 Milvus数据量增长后可通过-Pwith-milvus构建并接入 Milvus ANN 检索。七、平台安装使用7.1 环境要求JDK 8Maven 3.6Node.js 16MySQL 8本地开发可使用 H2Nginx 1.18生产推荐7.2 本地启动# 后端H2默认 8080 cd backend mvn spring-boot:run -Dspring-boot.run.profileslocal # 前端默认 3000 cd frontend npm install npm start访问http://localhost:3000/本地账号admin / admin1237.3 生产构建# 后端默认包 cd backend mvn clean package -DskipTests # 产物backend/target/knowledgebase.jar # 前端 cd ../frontend npm install npm run build # 产物frontend/build/需要 Milvus SDK 时cd backend mvn clean package -DskipTests -Pwith-milvus7.4 生产运行java -Xms512m -Xmx1024m \ -jar backend/target/knowledgebase.jar \ --spring.profiles.activeprod建议通过环境变量提供数据库密码、JWT Secret 和外部 API Key不要提交到仓库。关键配置server.port13085 deepseek.api.key${DEEPSEEK_API_KEY:} codeplan.api.key${CODEPLAN_API_KEY:} codeplan.model${CODEPLAN_MODEL:doubao-seed-2-1-turbo-260628} codeplan.thinking${CODEPLAN_THINKING:disabled} embeddings.enabled${EMBEDDINGS_ENABLED:true} milvus.enabled${MILVUS_ENABLED:false}7.5 Nginx 核心配置location /knowledgeWeb/ { alias /etc/www/website/knowledgeWeb/; try_files $uri $uri/ /knowledgeWeb/index.html; } location /knowledgeWeb/api/ { proxy_pass http://127.0.0.1:13085/api/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; }完整示例见nginx.conf。7.6 验证与测试# 健康检查 curl http://127.0.0.1:13085/api/auth/health # 后端测试 cd backend mvn test # 前后端 E2E cd e2e npm install npx playwright install chromium npm test产品操作手册docs/product-manual/企业知识中台-产品使用操作手册.pdf八、应用场景及使用案例说明8.1 制造业设备手册与 SOP资料设备说明书、工艺文件、质量标准、维修记录。路径批量入库 → 部门隔离 → 员工提问 → 查看来源原文。价值减少翻找长篇 PDF 和重复咨询安全与质量要求仍以正式文件为准。8.2 工程与设备服务项目内容复用资料设备参数、项目案例、施工方案、维保能力。路径搜索历史案例 → 生成项目介绍或公众号初稿 → 核对参数 → 复制到公众号。价值减少重复整理提高企业对外内容的一致性。8.3 技术团队规范与故障经验资料API 文档、编码规范、部署手册、故障复盘。路径按项目入库 → 语义搜索 → RAG 问答 → 来源核验。价值帮助新人快速定位资料让经验留在知识库而不是聊天记录里。8.4 咨询与培训案例和制度查询资料历史方案、培训课件、员工手册、流程与 FAQ。路径按部门/行业隔离 → 搜索相似内容 → 提炼要点 → 人工调整。价值提高资料复用率建立统一知识入口。8.5 落地建议先统一分类、命名和部门边界再批量迁移。优先导入高频、正式、仍有效的文档。问答效果不好时先检查知识条目和来源不要只调模型。定期清理过期资料避免新旧制度同时被召回。公众号文章必须核对数字、型号、客户名称和敏感信息。知识库体验知识库新版已经部署 https://jinhuitech.top/knowledgeWeb/管理员账号manager 密码 admin123普通账号user 密码 user123