开源实践：给工厂新人做的「带出处」SOP 问答系统

中型制造厂一线流动大，制度、SOP、安全规程大量在 PDF 和扫描件里。新人反复问师傅「开机前查什么」，师傅被打断，口径还容易不一致。

网上「企业知识库 / Agent」很多，但一线真正要的往往不是多智能体编排，而是三件事：

1. 按岗位能查到该看的规程
2. 回答必须带文档出处，找不到就明说，别编安全规定
3. 入职有清单，主任能看见进度

我做了一个垂直场景产品：制造企业新人 AI 助手（MOA），技术栈是 TypeScript 全栈 + Postgres/pgvector + MinIO + OCR，Docker Compose 一厂一实例私有化。

本文偏实现与部署，方便同行复现或二次开发。

核心设计（和通用 Bot 的差别）

Embedding 维度固定 1536（如智谱 embedding-3 + dimensions=1536）。

架构一览

手机/管理端 → Web(Next) → API(Hono)
                ├─ Postgres + pgvector
                ├─ MinIO（原文档）
                ├─ OCR（扫描件后备）
                └─ LLM / Embedding（云或内网）

机器建议：2 核 8G 起（开本机 PaddleOCR 建议更高）。

一键部署（思路）

cp .env.example .env
# 填写 LLM/Embedding、JWT_SECRET
# NEXT_PUBLIC_API_URL=浏览器可达的 API，如 http://内网IP:8787
docker compose up -d --build
curl -X POST http://127.0.0.1:8787/auth/bootstrap \
  -H "Content-Type: application/json" \
  -d '{"username":"admin","password":"强密码","displayName":"管理员"}'

浏览器打开 http://服务器IP:3000。

详细步骤见仓库内私有化部署教程（上传、解析、确认入库、入职模板、新人提问）。

你能用来干什么

• 厂内制度/SOP/安全问答（带出处）
• 岗位入职清单 + 进度
• 扫描件 OCR + 人工改字再入库
• 待审（不准反馈）与试点统计导出

不是： 通用多 Agent、OA/钉钉深度集成、集团多租户 SaaS（首版刻意不做）。

其他行业？

技术链路（上传→解析→入库→带出处问答→清单）可复用到仓储、物业运维等「按岗位看规程」场景；产品文案与默认话术是制造入职向的，换行业要改包装。

获取方式

我提供 Docker 镜像包 / Compose 一键脚本 + 部署文档，适合 IT 自行私有化试点。

• 自备：OpenAI 兼容的对话模型 + 1536 维 Embedding

欢迎评论区交流：检索门槛、切块策略、私有化踩坑。若你也在做制造/现场知识库，可以一起对比指标：展开原文率、有用率，比口头「还行」靠谱。





（后续仍有扩展，内容若有不当的地方，还望同行前辈多多指点）