HiveMtk 蜂巢营销

HiveMtk 蜂巢营销是什么

HiveMtk（Hive + Marketing Toolkit）是一套面向中文私域运营场景的开源 AI 营销系统，把多端社媒触达、ReAct 自主智能体、本地知识库 RAG 与 GEO 优化整合在同一个仓库里，覆盖获客 → 触达 → 转化 → 复购全链路。

它适合 5–50 人的成长型团队、合规敏感行业（金融/医疗/政企），以及不想被 SaaS 厂商锁定的运营团队。

核心能力

多端触达：一个工作台全管

• 抖音 / 快手 / 小红书 / 闲鱼 / TikTok：通过 Chrome 扩展桥接，使用自己的登录态浏览器
• 微信 / 企业微信：含社群与朋友圈
• Telegram：Bot 协议直连，支持群线索挖掘与主动 DM
• WhatsApp：Cloud API + 模板消息
• 邮件 / 短信：SMTP 及主流云厂商短信

统一 CDP 客户视图与统一收件箱，一份资料全渠道触达。

ReAct 自主智能体

智能体按「感知 → 规划 → 调工具 → 反思」循环运行，内置 42 个原子工具，覆盖触达、项目管理、客户、知识库、业务五大域，并通过 Permission、Retry、Timeout、RateLimit、Audit 五层装饰器逐层包裹。

• 混合检索 RAG：pgvector HNSW + BM25 RRF 融合粗排，bge-reranker 精排
• 多智能体协作：被动应答 + 主动触达
• 四层记忆系统：短期 / 长期 / SOP 状态 / 业务记忆
• 可视化工作流：零代码搭建销冠 SOP

数据安全：100% 私域

• 本地推理栈：llama.cpp（Qwen2.5）+ TEI（bge-m3 + bge-reranker-v2-m3）
• 零外网可跑：对话、知识库、向量化、检索增强全程域内完成
• FRP 私域穿透：访客从公网进，数据经隧道回本地
• 可选云端 LLM：将 LLM_BASE_URL 指向 DeepSeek/OpenAI 即可，Embedding/Rerank 仍强制本地

GEO 智能优化

GEO（生成式引擎优化）争的是 AI 答案里的「席位」，让 ChatGPT Search、Perplexity、Google SGE 作答时提及你的品牌。流程大致为：品牌配置 → 关键词蒸馏 → 内容创作 → 多模型验证 → 平台同步发布，并配合数据增强回流。

快速上手

唯一要求是 Docker 24+ 与 Docker Compose v2，硬件最低 4 核 / 8GB / 50GB，推荐 8 核 / 16GB。

# 1. 克隆仓库
git clone https://gitee.com/xhpmayun/hivemtk.git && cd hivemtk

# 2. 一键安装：生成 .env、构建前后端、下载模型、拉起数据层与推理栈
make install

# 3. 修改密钥
vim .env

# 4. 启动
make dev
cd user-web && npm run dev

技术栈与架构

• 后端：Go 1.26 + Gin + GORM，严格五层架构（Controller → Service → Repository → Model → DTO）
• 前端：Vue 3
• 数据层：PostgreSQL + pgvector、Redis 7
• 推理层：llama.cpp + TEI 本地推理栈

注意事项

• 项目采用 AGPL-3.0 协议，若将修改版通过网络对外提供服务，需同样以 AGPL-3.0 开源修改
• 不提供官方 SaaS 版本，坚持私有化部署
• 模块较多，完整落地需要一定运维与调优成本