源码系统概览
文章正文
触达云枢(HiveMTK,Hive Marketing Toolkit)是一套面向中文私域与出海运营场景的 AI 营销智能体中台源码。
它的后端是 Go 1.26 写的 user-server,前端是 Vue 3 写的 user-web,全仓内置约 94 个业务模块。
项目里的智能体不是写死的 if-else 工作流,而是 ReAct 循环:感知、规划、调工具、反思,可挂接本地或云端 LLM。
源码简介
整套系统按单仓库前后端加 Docker Compose 组织,除后端与前端外,还带一个嵌入 SDK 和一个官网子项目。
后端 3600 多个文件里绝大多数是 Go 代码,路由用 Gin,数据访问走 GORM,业务数据全部落在本地。
数据库用 PostgreSQL 15 以上做唯一数据源,script 目录从 init-user-db.sql 到 054_rag_hybrid_index.sql 共 56 个 SQL 文件,按版本顺序增量迁移。
知识库检索用 pgvector 做 1024 维向量召回,再接 BGE Reranker 精排,中间用 Redis 加一层 LRU 缓存。
嵌入 SDK 是零依赖的原生 JavaScript,打包成 IIFE 与 ESM 双产物,一行 script 标签就能给任意站点加上客服浮标。
推理栈被单独拆出一层:宿主机直接跑 llama.cpp,容器里只留 PostgreSQL 和 Redis,省 CPU 也省内存。
适用场景
需要把抖音、小红书、闲鱼、企微、飞书、WhatsApp、Telegram 等分散入口收拢到一个工作台的运营团队。
想给坐席配一个能查知识库、能按 SOP 谈单的 AI 客服,又不愿把客户对话放到第三方 SaaS 上的团队。
金融、医疗、政企这类过不了数据出境与内控审计、必须私有化交付的场景。
研究 ReAct 智能体工程化、多智能体编排与 RAG 检索链路的开发者。
功能亮点
统一收件箱把全渠道会话聚合到一处,配合待办中心处理转人工、审批与升级类工单。
客户中心做 OneID 身份归一与客户 360 画像,再叠加 RFM 分层与标签分层来圈人触达。
触达运营覆盖邮件、短信、WhatsApp、Telegram、飞书与社媒卡片,短链和活码负责投放归因。
GEO 模块把关键词蒸馏、内容生产、多模型验证与发布监控串成一条获客链路。
智能卡片针对抖音、快手、小红书、闲鱼、TikTok 五个平台生成卡券,并追踪转化漏斗。
相关源码推荐:联枢企业AI中台智能体源码、云渠通全域智能客服系统源码和UNCUT编码智能体框架源码。
技术架构与部署指南
技术栈与运行环境
后端是 Go 1.26 加 Gin 与 GORM,前端是 Vue 3 加 Element Plus 与 Vite,两端通过 REST 接口通信。
数据层为 PostgreSQL 15 以上加 Redis,向量检索依赖 pgvector 扩展。
本地推理栈走 llama.cpp,LLM 服务默认 8207 端口,Embedding 走 8208,Rerank 走 8209。
浏览器桥接与浏览器自动化是两个独立的 Chrome 扩展,基于 Manifest V3,用 esbuild 打包。
安装与部署提示
部署文档分了本地与生产两条路径,本地用 docker-compose.dev.yml,生产用 docker-compose.prod.yml。
数据层可以全放 Docker,后端、前端与推理栈留在宿主机上跑,这样改代码不用重建镜像。
后端内置 air 热重载,make dev 一行启动,保存 Go、YAML 或 env 文件就会自动重编重启。
数据库迁移要按脚本编号顺序执行,先跑 init-user-db.sql 建扩展与核心表,再依次应用增量脚本。
初始化状态记录在本机 install.lock 文件里,判断是否装好的唯一依据是其中的 initialized 字段。
截图与演示说明
仓库 docs 目录下的用户手册带了完整功能截图,下面按模块说明值得看的页面。
经营驾驶舱是进入后台的第一屏,汇总客户、线索、会话、触达与近 24 小时消息量。
统一收件箱页面把企微、飞书、WhatsApp 与社媒会话并列展示,是坐席日常停留最久的一屏。
客户 360 页面把跨渠道身份、行为事件时间线与 RFM 分层放在一起,便于判断跟进优先级。
知识库工作台提供分块编辑、批量导入与检索命中率统计,是 RAG 效果的调优入口。
智能卡片的统计页会画出各平台卡券的转化漏斗,适合做投放复盘。
AI 智能体管理页可配置人设、知识库、SOP 与 LLM 路由,是整套系统最核心的配置面。
常见问题
问:这套系统能直接商用吗?
可以用于二次开发与私有化交付,但上线前请自行核对所用模型与各渠道平台的授权条款。
问:必须用本地大模型吗?
不是,本地推理栈是可选项,也可以直接接云端 LLM,两者通过统一的模型路由切换。
问:数据会不会出内网?
默认全部本地存储,对话与向量化都可以留在内网,这也是它主打私有化部署的原因。
问:支持哪些渠道?
官方列出十多个入口,包含抖音、快手、小红书、闲鱼、TikTok、企微、微信、飞书、Telegram、WhatsApp、邮件与短信。
安全风险提示
脚本目录里的模拟压测说明与 Helm 说明留有示例凭据,正式环境必须替换成高强度随机值。
后端 .env.example 与 config.yaml 列出大量连接信息与密钥项,部署时不要连同示例值一起提交到公开仓库。
多渠道账号桥接依赖本机浏览器登录态,一旦宿主机被入侵,社媒账号可能连带失陷。
AI 智能体会自主调用触达类工具,批量群发前建议先设频率上限并开启审计日志。
仓库内未见 LICENSE 文件,二次分发或商用前请先与作者确认授权范围。
下载说明
本文仅做技术介绍与项目推荐,打包文件在文末下载区获取。
源码压缩包不设解压密码,下载后按文档顺序导入数据库即可启动。
使用前请完整阅读仓库内的部署文档与安全说明,并替换所有示例凭据。
源码仅供学习研究与技术参考,请勿用于任何违法违规用途。