业务和功能介绍
一、立项背景和目标
企业内部的历史图书、转码成果与业务资料长期分散在不同系统和共享盘里，检索困难、无法沉淀为可复用的知识资产；而通用大模型无法回答企业私有问题。本项目基于腾讯开源项目 WeKnora（MIT 协议，Go + Vue）做私有化部署与二次开发，建设一套企业级知识库与智能问答平台，把分散文档沉淀为可查询、可推理的知识资产，并承接公司文件资源管理系统（FMS）的归档成果作为知识来源。需要说明的是：平台本体来自腾讯开源社区，本项目的工作是私有化部署、二次开发与业务承接，并非自研该框架。
二、软件功能与核心功能模块
1. RAG 快速问答：基于知识库检索增强生成，回答带引用来源，可定位到具体文档片段。
2. ReAct Agent 智能推理：自主编排知识检索、MCP 工具、技能沙箱与网络搜索，完成多步复杂任务。
3. Wiki 模式：Agent 从原始文档自动生成相互链接的 Markdown 知识页面与知识图谱，支持人工编辑、版本历史与一键回滚。
4. 知识管理：FAQ / 文档 / Wiki 三类知识库，支持文件夹树导入、分块编辑与版本历史、多标签与 URL 导入。
5. 多源数据接入：飞书知识库与云盘、GitLab、Notion、语雀、钉钉文档等外部知识源。
6. 跨会话长期记忆与对话管理。
7. 企业级多空间 RBAC 与空间审计日志。
8. 工具调用与沙箱：内置工具、MCP 工具（含 OAuth2 远程服务）与技能目录，可安装到会话级 Docker / E2B 沙箱中隔离执行。
9. FMS 知识承接（本项目新增）：以只读方式拉取 FMS 发布的知识投影，镜像为本地知识库。
10. 模型与部署：接入二十余家主流模型厂商，支持完全私有化部署与内网离线运行。
三、业务流程与功能路径
管理员私有化部署平台并初始化空间 → 配置模型与知识库 → 导入文档或接入外部知识源 → 系统自动解析、切分、向量化并建立索引 → 用户在对话页提问，系统检索知识库并由大模型生成带引用的回答 → 复杂问题转由 Agent 多步推理完成。FMS 侧路径为：FMS 归档成果生成知识投影 → 桥接服务只读拉取并校验 → 原子写入镜像 → 在 WeKnora 中作为知识库被检索。
企业内部的历史图书、转码成果与业务资料长期分散在不同系统和共享盘里，检索困难、无法沉淀为可复用的知识资产；而通用大模型无法回答企业私有问题。本项目基于腾讯开源项目 WeKnora（MIT 协议，Go + Vue）做私有化部署与二次开发，建设一套企业级知识库与智能问答平台，把分散文档沉淀为可查询、可推理的知识资产，并承接公司文件资源管理系统（FMS）的归档成果作为知识来源。需要说明的是：平台本体来自腾讯开源社区，本项目的工作是私有化部署、二次开发与业务承接，并非自研该框架。
二、软件功能与核心功能模块
1. RAG 快速问答：基于知识库检索增强生成，回答带引用来源，可定位到具体文档片段。
2. ReAct Agent 智能推理：自主编排知识检索、MCP 工具、技能沙箱与网络搜索，完成多步复杂任务。
3. Wiki 模式：Agent 从原始文档自动生成相互链接的 Markdown 知识页面与知识图谱，支持人工编辑、版本历史与一键回滚。
4. 知识管理：FAQ / 文档 / Wiki 三类知识库，支持文件夹树导入、分块编辑与版本历史、多标签与 URL 导入。
5. 多源数据接入：飞书知识库与云盘、GitLab、Notion、语雀、钉钉文档等外部知识源。
6. 跨会话长期记忆与对话管理。
7. 企业级多空间 RBAC 与空间审计日志。
8. 工具调用与沙箱：内置工具、MCP 工具（含 OAuth2 远程服务）与技能目录，可安装到会话级 Docker / E2B 沙箱中隔离执行。
9. FMS 知识承接（本项目新增）：以只读方式拉取 FMS 发布的知识投影，镜像为本地知识库。
10. 模型与部署：接入二十余家主流模型厂商，支持完全私有化部署与内网离线运行。
三、业务流程与功能路径
管理员私有化部署平台并初始化空间 → 配置模型与知识库 → 导入文档或接入外部知识源 → 系统自动解析、切分、向量化并建立索引 → 用户在对话页提问，系统检索知识库并由大模型生成带引用的回答 → 复杂问题转由 Agent 多步推理完成。FMS 侧路径为：FMS 归档成果生成知识投影 → 桥接服务只读拉取并校验 → 原子写入镜像 → 在 WeKnora 中作为知识库被检索。
项目实现
一、整体架构与设计思路
后端 Go 1.26，采用分层 internal/ 包结构，HTTP 路由与业务逻辑分离；前端 Vue 3 + TypeScript + Vite。PostgreSQL 存账号、配置与知识数据，Redis 承担任务队列与缓存，文档解析由独立的 docreader 服务承担，向量检索走独立索引；模型层按"协议 + 目录 + 厂商"分层，以适配二十余家模型厂商。设计上强调模块化解耦、组件可替换，支持本地与私有云部署。FMS 承接采用严格的只读边界：桥接仅消费 FMS 已发布的知识投影 API，绝不读取 FMS 库表、存储路径或源 EPUB，也不复用通用数据源管线（该管线会重新解析文档并触发额外索引）；镜像按完整快照原子提交，任一必需 sidecar 未取到或校验失败就不替换当前版本，因此不会出现半截数据。
二、我负责的模块和结果
我负责该平台的私有化部署与二次开发落地。主要结果：完成 Docker Compose 三容器部署（应用 + PostgreSQL + Redis）与服务器一键部署脚本，并完成国内镜像源适配（Go module proxy、npm、apt、cargo 与 Debian 基础镜像），解决内网构建失败问题；实现 FMS 知识承接桥接 internal/fmsbridge 包（adapter / store / reconciler / runtime / config / types，共 1798 行 Go）及配套单元测试、数据库迁移与前端 FMSBridge 管理页面；打通 /zswek/ 子路径网关，使平台可挂在公司统一域名下；生产环境首次投影同步已进入 running 状态。
三、我遇到的难点、坑和解决方案
1. 边界不能越：若复用 WeKnora 通用数据源管线承接 FMS，会触发文档重新解析和二次索引，破坏 FMS 的权威性。解法是自建只读适配层，只消费 FMS 已发布投影，并在快照齐全、校验通过后才原子替换。
2. 内网构建：镜像构建阶段需要 Go、npm、apt、cargo 多套源，任一不可达即整包失败，最终统一改为国内镜像源并在基础镜像阶段就生效。
3. 端口与误判：宿主机再起一套 go run 会与容器抢 8080 端口，出现"关了容器仍能登录"的假象，改为固定容器入口并在操作手册中写明排查方式。
4. 子路径部署：平台需部署在 /zswek/ 下，静态资源、路由跳转与 API 前缀都要跟随基路径，否则页面白屏或接口 404，通过统一基路径配置解决。
后端 Go 1.26，采用分层 internal/ 包结构，HTTP 路由与业务逻辑分离；前端 Vue 3 + TypeScript + Vite。PostgreSQL 存账号、配置与知识数据，Redis 承担任务队列与缓存，文档解析由独立的 docreader 服务承担，向量检索走独立索引；模型层按"协议 + 目录 + 厂商"分层，以适配二十余家模型厂商。设计上强调模块化解耦、组件可替换，支持本地与私有云部署。FMS 承接采用严格的只读边界：桥接仅消费 FMS 已发布的知识投影 API，绝不读取 FMS 库表、存储路径或源 EPUB，也不复用通用数据源管线（该管线会重新解析文档并触发额外索引）；镜像按完整快照原子提交，任一必需 sidecar 未取到或校验失败就不替换当前版本，因此不会出现半截数据。
二、我负责的模块和结果
我负责该平台的私有化部署与二次开发落地。主要结果：完成 Docker Compose 三容器部署（应用 + PostgreSQL + Redis）与服务器一键部署脚本，并完成国内镜像源适配（Go module proxy、npm、apt、cargo 与 Debian 基础镜像），解决内网构建失败问题；实现 FMS 知识承接桥接 internal/fmsbridge 包（adapter / store / reconciler / runtime / config / types，共 1798 行 Go）及配套单元测试、数据库迁移与前端 FMSBridge 管理页面；打通 /zswek/ 子路径网关，使平台可挂在公司统一域名下；生产环境首次投影同步已进入 running 状态。
三、我遇到的难点、坑和解决方案
1. 边界不能越：若复用 WeKnora 通用数据源管线承接 FMS，会触发文档重新解析和二次索引，破坏 FMS 的权威性。解法是自建只读适配层，只消费 FMS 已发布投影，并在快照齐全、校验通过后才原子替换。
2. 内网构建：镜像构建阶段需要 Go、npm、apt、cargo 多套源，任一不可达即整包失败，最终统一改为国内镜像源并在基础镜像阶段就生效。
3. 端口与误判：宿主机再起一套 go run 会与容器抢 8080 端口，出现"关了容器仍能登录"的假象，改为固定容器入口并在操作手册中写明排查方式。
4. 子路径部署：平台需部署在 /zswek/ 下，静态资源、路由跳转与 API 前缀都要跟随基路径，否则页面白屏或接口 404，通过统一基路径配置解决。
示例图片视频
相似推荐
json解析转换器
1、背景和目标：一、超级快速、安全对json的解析与对象转换；二、支持分布式超高并发
2、json解析转换器，支持分布式高并发，支持百万级别访问。用于快速进行json的解析与对象转换。原有的开源工具，要么安全性不够，要么性能不够强悍，要么不支持定制，很难满足企业日益严苛的业务需求。开发的这个json解析转换器，可以同时满足以上三种需求。
智能仓储 · 立库调度监控系统（RMS 调度中间件 + 监控管理后台）-RmsCC
【1】立项背景与目标
自动化立体库是新能源锂电、汽车零部件等行业的主流仓储形态，库内由四向车、提升机、输送线、接驳口协同完成托盘出入库。上游 WMS/WES 只下发"某个托盘要入库或出库"，而"分配到哪个货位、走哪条路、派哪台车、每一段由谁执行"全部由中间的调度系统（RMS）计算并驱动——本项目就是一个立库调度中间件 + 配套的调度监控管理后台。目标：把"任务下发→货位分配→路径规划→派车→分段执行→库存过账"做成可跑通、可观测、可人工干预的闭环，并解决现场最头疼的三个问题：调度计划与现场执行脱节、设备与货位状态不可见、故障（走不通、卡住）无日志可查。
【2】核心功能模块
①基础数据：仓库/货区/货位（层-x-y 坐标、深浅位）/设备/物料建模。
②权限体系：JWT + RBAC 用户-角色-菜单三级权限，菜单级与接口级双重校验。
③上游任务管理（内置 WES 模拟器）：批量下发出入库任务，一键生成托盘号。
④任务调度与分段：任务状态机（待下发/执行中/已完成/异常/取消），入库按固定拓扑自动拆 3 段（库外输送线→提升机→目标层接驳口→货位），出库镜像反向。
⑤路径规划：库内 A* 网格寻路（巷道四向可走、货架区仅纵向、有货货位视为障碍），按"空闲且电量>40% + 曼哈顿距离最近"自动派车，支持小车避让、等待点与自动移库（倒库）。
⑥设备仿真引擎：无真实 PLC，用定时任务按可配置节拍推进每段任务并驱动设备沿路径移动。
⑦实时监控：WebSocket 每秒推送设备位置、状态与任务进度，地图大屏显示库位占用与小车轨迹，另配小车/设备监控页。
⑧库存与数据中心：托盘维度库存、分层占用统计、库存流水（任务完成自动过账）。
⑨接口日志中心：按上游/RCS/WCS 三个通道记录每次调用的请求与返回报文、方向、结果、耗时，支持按托盘号/任务号全链路检索与改报文重发。
⑩AI 作业助手：接入大模型，自然语言下发任务、异常诊断与智能问答，SSE 流式输出，模型不可用自动降级为本地规则。
⑪单车手动控制：顶升/放下/移动/充电/恢复/释放任务等指令，应急时人工接管。
【3】业务流程与功能路径
上游下发（托盘号 + 出入库类型）→ RMS 自动分配货位（浅位优先、低层优先）→ 生成分段计划 → A* 计算路径并派最近的空闲车 → 仿真引擎按节拍推进各段 → 全段完成后自动过账（货位占用/释放、绑定或解绑托盘、写库存流水与系统日志）→ 任务归档。
功能路径：登录 → 首页看板（货位占用 + 任务趋势）→ 上游任务管理下发任务 → 资源监控中心地图大屏观察执行 → 立库任务中心（任务视图/任务管理）→ 数据中心查库存与流水 → 报表数据中心查接口日志 → AI 助手用自然语言下单。
多端AI问答系统（SSE流式输出）
立项背景：随着大语言模型的普及，传统企业与用户对智能对话的需求激增。旨在构建一个前后端完全解耦的 AI 问答系统，支持多端接入，提供流畅的流式对话体验。
核心功能：支持 SSE 全链路流式对话（包含start/content/reasoning/done/error五类事件）；多会话管理（新建、切换、重命名、置顶、逻辑删除）；Markdown 渲染、思考过程折叠展示、多模型切换、Token 用量统计与 API 调用日志，以及四维 IP 限流。
业务流程：前端发起对话请求 → 后端校验限流 → 组装历史消息并调用大模型 API → SSE 逐字返回前端实时渲染 → 消息落库并记录 Token 与耗时。
CRM客户管理后台
立项背景：针对中小型企业客户信息分散、销售跟进过程不透明、合同管理混乱等痛点，旨在打造一个轻量级的客户全生命周期管理后台，提升销售团队协作与转化效率。
核心功能：涵盖管理员登录鉴权、客户主表管理、联系人维护、跟进记录追踪、合同管理等六大模块。支持客户信息分页查询、关键字搜索、新增编辑与逻辑删除；客户详情页以名片形式集中展示联系人、跟进记录及关联合同。
业务流程：从潜在客户录入，到日常跟进记录，再到最终合同签订与操作日志审计，覆盖完整的销售业务闭环。
ERP管理系统
本项目面向中小企业的采购、销售、仓储、生产及财务协同场景，目标是将分散的业务记录、审批流程和经营数据整合到统一平台，支持业务过程追踪与数据查询。
系统包含客户与供应商、销售、采购、仓储、生产制造、财务、人力资源、项目合同、资产、质量售后、零售门店、数据报表和系统管理，共13个模块、102个配置驱动页面。核心功能包括客户线索与商机管理、采购与销售订单、库存预留及批次追溯、多级物料清单、生产领料与报工、发票与收付款、会计凭证、薪酬、资产折旧和项目成本分析。
业务流程围绕单据流转展开。例如，销售业务支持“线索→商机→报价→销售订单→发货→发票→收款”；采购业务支持采购申请、采购订单、到货验收、入库及付款。单据通过草稿、提交审批、审批通过和过账等状态进行控制，过账时联动库存台账、资金余额及会计分录，并保留操作历史。
系统提供桌面Web端和移动端入口，共用业务接口与权限规则。管理员可配置用户、角色、菜单、字典和审批权限，员工可按权限处理单据、查看通知和查询报表。经营数据支持按日期汇总及来源下钻，方便追踪库存、应收应付和项目收支。
项目预览
https://tomatoxs.cn:18443
https://tomatoxs.cn:18444
账号：demo
密码：demo123
帮助文档
Copyright @ 2021-2024 程聚宝 | 浙ICP备2021014372号
人工客服