🐝 HiveMtk · 开源私域营销 AI 系统
把销冠的能力,复制给团队里每一个普通人。
一个工作台管所有社媒,一个 AI 智能体谈所有客户,数据一寸不出门。
开源 SCRM · ReAct 自主智能体 · 10+ 渠道触达 · 数据零出域 · 5 分钟自托管部署
📖 英文文档 · 🌐 官网 · 📦 功能模块
数字一览
| | | |
|---|
| 94 个业务模块SCRM+AI+CDP+自动化 | 10+ 触达渠道抖音/小红书/TikTok/WhatsApp… | 45 个智能体工具ReAct 自主编排 | 0 条数据出域本地推理,零外网可跑 |
界面一览
| 统一收件箱 | AI 智能体 |
|---|
| |
| 营销画布 | 客户 360° |
| |
| 知识库 RAG | 数据大屏 |
| |
这是什么
HiveMtk("Hive"+"Marketing Toolkit")是一套面向中文私域运营场景的开源 AI 营销系统,把四件事在同一个仓库里做透:
- 多端社媒触达 —— 抖音/快手/小红书/闲鱼/TikTok 经 Chrome 扩展桥接,企微/Telegram/WhatsApp/邮件/短信协议直连,统一收件箱
- ReAct 自主智能体 —— 感知 → 规划 → 调工具 → 反思,45 个原子工具自主组合,不是写死的 if-else 工作流
- 本地知识库 RAG —— pgvector 1024 维混合检索 + bge-m3 + bge-reranker-v2-m3 精排
- 数据零出域 —— llama.cpp(Qwen2.5)+ TEI 本地推理栈,对话/知识库/向量化全程在客户内网完成
覆盖获客 → 触达 → 转化 → 复购全链路。不是"给大模型套个壳",是直接能跑营销业务的完整系统;另附 GEO 模块打通 AI 搜索获客闭环。完整功能列表与已知限制如实披露,见 docs/marketing-features/README.md。
适合谁:5–50 人的成长型团队 · 合规敏感行业(金融/医疗/政企)· 不想被 SaaS 厂商锁定的运营团队。
数字背后的差异
诚实对比,敢暴露劣势。没有银弹,按需选择。
| 维度 | HiveMtk(本项目) | Dify / FastGPT | 商业 SCRM(微伴/尘锋) | 源雀 / MoChat |
|---|
| 核心定位 | 私域营销 AI 系统 | 通用 LLM 应用平台 | 商业 SaaS | 企微 SCRM |
| 触达端 | 多端(10+) | 无内置 | 1-3 端 | 1 端(企微) |
| AI 能力 | ReAct 智能体 + 45 工具 | 可视化 Workflow | 基础客服机器人 | 简单 RAG / 无 |
| 数据部署 | 100% 私域 + 本地推理栈 | 自托管 / SaaS | 云端 | SaaS / 私有 |
| 开源协议 | AGPL-3.0 | Apache-2.0 | 闭源 | 部分开源 |
| 适合谁 | 想自主可控、多端、强 AI 的团队 | 纯 AI 应用开发 | 无 IT 团队的中小商家 | 企微深度用户 |
核心能力
🌐 多端触达:一个工作台全管
| 渠道 | 触达 | 智能卡片 | 自动回复 | RAG 客服 | 备注 |
|---|
| 抖音 / 快手 / 小红书 / 闲鱼 / TikTok | ✅ | ✅ | ✅ | ✅ | Chrome 扩展桥接,你自己的登录态浏览器,无需无头浏览器 |
| 微信 / 企业微信 | ✅ | — | ✅ | ✅ | 含社群/朋友圈 |
| Telegram | ✅ | — | ✅ | ✅ | Bot 协议直连,群线索挖掘 + 主动 DM + 入群管控 |
| WhatsApp | ✅ | — | ✅ | ✅ | Cloud API + 模板消息 |
| 邮件 / 短信 | ✅ | — | ✅ | — | SMTP;阿里云/腾讯云/华为云 |
统一 CDP 客户视图,一份资料全渠道触达;统一收件箱,会话/工单/留言一处看完。渠道能力明细与 Telegram 五大获客能力,见 docs/marketing-features/README.md。
🤖 ReAct 自主智能体:不是写死的工作流
- ReAct 循环:感知 → 规划 → 调工具 → 反思,撞到预设之外的场景也能自己组合工具搞定
- 45 个原子工具:触达/项目管理/客户/知识库/业务五域,Permission→Retry→Timeout→RateLimit→Audit 五层装饰器逐层包裹
- 混合检索 RAG:pgvector HNSW + BM25 RRF 融合粗排,bge-reranker 精排,可选 HyDE/MultiQuery 改写
- 多智能体协作:被动应答智能体 + 主动触达智能体;四层记忆系统(短期/长期/SOP 状态/业务记忆)
- 可视化工作流:营销自动化编辑器,零代码搭建销冠 SOP
工具注册逻辑以源码为准:user-server/internal/aiagent/agent/tooluse/(代码即清单)。
🔒 数据安全:100% 私域,对话不出客户内网
- 本地推理栈:llama.cpp(Qwen2.5)+ TEI(bge-m3 + bge-reranker-v2-m3),LLM/Embedding/Rerank 三个 OpenAI 兼容服务跑在客户内网
- 零外网可跑:对话、知识库、向量化、检索增强全程域内完成
- FRP 私域穿透:访客从公网进,数据经隧道回本地,云端不落一条对话
- 合规友好:满足等保、数据出境管控、私有化部署基线
- 可选云端 LLM:把
LLM_BASE_URL 指向 DeepSeek/OpenAI 即可,Embedding/Rerank 仍强制本地
🎯 GEO 智能优化:AI 搜索获客闭环
SEO 争搜索结果排名,GEO(生成式引擎优化)争 AI 答案里的"席位"——让 ChatGPT Search、Perplexity、Google SGE 作答时提及你的品牌。
品牌配置 → 关键词蒸馏 → 内容创作 → 多模型验证 → 平台同步发布
↑ ↓
数据增强 ← 历史验证数据 ←──────────┘
关键词蒸馏 · E-E-A-T + Schema 注入 · 多厂商 LLM 模拟 AI 搜索作答量化"席位" · RAG 锚定品牌事实 · 高权重平台同步。完整指南见 user-server/docs/geo-module-guide.md。
适用场景
| 场景 | 关键能力 | 典型行业 |
|---|
| 私域获客 → AI 自动谈单 | 多端线索接入 + ReAct 智能体承接咨询 + 异议处理 + 逼单邀约 | 招商加盟 / 医美 / 教培 / B2B |
| 企微 SCRM 多账号聚合 | 多账号统一收件箱 + 客户资产沉淀 + 离职继承 | 连锁门店 / 品牌方 |
| AI 客服 / RAG 知识库 | 混合检索 + 7×24 自动回复 | 电商 / SaaS / 售后 |
| 营销自动化 SOP | 销冠 SOP 可视化编排 + RFM 分层 + 流失预警 + 沉睡激活 | 会员制零售 / 母婴 / 美业 |
| 跨境出海多渠道触达 | TikTok + WhatsApp + 邮件 + Telegram 统一管理 | 跨境电商 / 出海品牌 |
| 合规私有化部署 | 本地推理栈 + 零出域 + 行级权限 + 审计存档 | 金融 / 医疗 / 政企 |
🚀 5 分钟跑起来
唯一要求:Docker 24+ 与 Docker Compose v2。硬件最低 4 核/8GB/50GB(dev 档),推荐 8 核/16GB(prod 档含 14B 模型);GPU 可选,无 GPU 走 CPU 推理。
# 1. 克隆(国内走 Gitee,海外走 GitHub 镜像)
git clone https://gitee.com/xhpmayun/hivemtk.git && cd hivemtk
# 2. 一键安装:.env 模板 + 构建前后端 + 下载模型 + 拉起数据层与推理栈
make install
# 3. 改密钥
vim .env # 必改：POSTGRES_PASSWORD / REDIS_PASSWORD / JWT_SECRET
# 只有把平台端跑起来（PLATFORM_ENABLED=true）才用到：PLATFORM_ADMIN_PASSWORD / MERCHANT_API_SECRET
# 4. 启动
make dev # user-server 热更新 → http://localhost:8204
cd user-web && npm run dev # 前端工作台 → http://localhost:8211(另开终端)
dev/prod 模型档切换、常见命令、数据库备份恢复等运维细节,见 docs/DEPLOYMENT_GUIDE.md 与 docs/TROUBLESHOOTING.md。
FAQ
和 Dify / FastGPT 有什么区别?
HiveMtk 是私域营销系统,聚焦"多端触达 + 销冠 SOP + CDP + 零出域",内置 94 个业务模块开箱即用;Dify/FastGPT 是通用 LLM 应用开发平台,偏 Workflow 编排,不内置营销业务。
是真的开源吗?可以商用吗?
✅ AGPL-3.0 完全开源。可自由 fork、私有部署、二次开发、商用。唯一限制:修改后的版本若通过网络对外提供服务(SaaS/云端 API),必须同样按 AGPL-3.0 开源你的修改;仅内部私有部署无需公开。
数据真的不出域吗?
✅ 所有对话、知识库、向量化、检索增强全程在客户内网完成。本地推理栈跑在客户内网,FRP 穿透时云端不落一条对话。即使配置云端 LLM,也只传 prompt 文本,PII 本地脱敏后再调用。
支持哪些大模型?
✅ DeepSeek / 通义千问 / GPT-4o / 智谱 GLM / 本地 Qwen2.5。LLM 路由网关按场景动态路由:复杂异议用强模型,常规回复用轻模型。Embedding/Rerank 强制本地。
海外能用吗?
✅ TikTok + WhatsApp + Telegram + Email 适配跨境出海场景。
有 SaaS 版吗?
❌ 不提供。坚持私有化部署、数据自主可控。企业级技术支持/定制集成联系 [email protected]。
架构一图
访客浏览器(公网)
│ HTTPS / WSS(经 FRP / 公网 IP / 反代)
▼
┌─────────────────────────────────────────────────┐
│ 客户本地内网 │
│ │
│ user-server (Go + Gin) :8204 │
│ ├── PostgreSQL + pgvector :8202 (1024 维) │
│ └── Redis 7 :8203 │
│ │
│ 宿主机推理栈(llama.cpp,非容器化) │
│ ├── LLM :8207 (Qwen2.5) │
│ ├── Embedding :8208 (bge-m3) │
│ └── Rerank :8209 (bge-reranker-v2-m3) │
│ │
│ user-web (Vue 3) · embed-sdk(客服 Widget) │
└─────────────────────────────────────────────────┘
┆ HTTPS(低频心跳:install_id / 版本号 / 主机信息 / 运行指标 / 设备指纹)
┆ —— 这条边默认不存在:平台端是可选本地组件,
┆ 未设 PLATFORM_ENABLED=true 时一个请求都不发
┆
▼
平台端(独立仓库 hivemtk-platform,可选自建):仅元数据,
不接触、不存储、不访问任何业务数据;无任何商户授权/标识校验环节
后端严格遵循五层架构(Controller → Service → Repository → Model → DTO,禁止跨层调用,CI 强制检查)。完整规范见 docs/architecture/GO_FIVE_LAYER_ARCHITECTURE.md,与平台端的分工见 docs/architecture/部署方案_用户端.md。
技术栈:Go 1.26 + Gin + GORM · Vue 3 + Vite + Element Plus + Pinia · PostgreSQL 15 + pgvector · Redis 7 · llama.cpp + Qwen2.5 · TEI + bge-m3 / bge-reranker-v2-m3 · Docker Compose。
仓库结构
hivemtk/ # 用户端仓库
├── user-server/ # Go 后端(核心业务,五层架构)→ user-server/README.md
├── user-web/ # Vue 3 前端(B 端工作台)→ user-web/README.md
├── embed-sdk/ # 嵌入式客服 Web Widget(IIFE/ESM)
├── website/ # 官网源码(Vue 3 SPA)→ 由 .github/workflows/website-pages.yml 发到 GitHub Pages
├── migrations/ # 数据库迁移 SQL(幂等)
├── scripts/inference-host/ # 宿主机推理栈脚本(llama.cpp + TEI)
├── docs/ # 文档:INDEX.md / DEPLOYMENT_GUIDE.md / marketing-features/ …
├── docker-compose.yml # 数据层编排(PG + Redis)
├── Makefile # 一键安装/启动/停止/推理栈/开发热更新
└── .env-example # 环境变量模板
文档导航
合规与免责
主动触达(短信/邮件/社媒私信/Telegram/WhatsApp 等主动推送能力)属于核心敏感功能,本项目作为开源工具不对使用者的调用方式承担责任;每次主动触达发送,服务端日志都会打印不可关闭的 [COMPLIANCE] 合规提示。完整声明见 DISCLAIMER.md(English)。
License:本项目采用 AGPL-3.0 发布。私有部署、内部使用、二次开发完全自由、无需开源;修改代码并以 SaaS/云服务/托管 API 对外提供时,必须按 AGPL-3.0 开源修改部分。版权与联系方式见 NOTICE。
联系与社区
添加作者微信,入群同频交流
扫码或搜索微信号 xiao142000,备注来意通过,一起交流。
镜像仓库:Gitee 主仓库 gitee.com/xhpmayun/hivemtk(国内推荐,下载更快)· GitHub 镜像 github.com/xiaofang142/hivemtk(Actions 定时同步)
⭐ Star / Watch 一下,跟项目一起成长
多端打透 · AI 真自主 · 数据封死在域内
Made with ❤️ by HiveMtk Team
