源码系统概览
文章正文
云渠通（Yun Qu Tong / linkbot-ai）是一套面向直播与短视频获客场景的全域智能客服与线索运营平台源码。
整套代码 141 个文件、约 13 MB，按 backend（36 文件）+ frontend（64 文件）+ docs（30）+ script（5）四块组织，配套 docker-compose 一键部署与 PostgreSQL/Redis 种子脚本。
能直接拿来当演示底座，也能按行业规则做二次定制。
源码简介
云渠通在产品形态上属于「公域短视频账号接入 + 智能客服 + 线索运营」三段一体：把分散在抖音、快手、视频号、小红书等公域平台上的账号、会话与线索收拢到同一套管理台。
技术形态采用 React 管理台 + Express REST API + Go 渠道/WebSocket 网关的分层架构，后端 linkbot-ai-backend 1.0.0、TypeScript 编写（backend/package.json author「赵国第一科技官」、license MIT），默认监听 3001 端口（API_PORT）、前端 3000 端口（Create React App proxy）、Go 网关 8080 端口。
前端 React 19.2 + Ant Design 5.27 + react-router-dom 6 + recharts 3 + socket.io-client 4 + axios + dayjs，主题青绿主色 + 琥珀强调（antd zh_CN locale）。
后端 Express 5.1 + TypeScript + PostgreSQL（pg 8.23）+ Redis（ioredis 5.8），中间件 helmet + cors + compression + morgan + express-rate-limit 8.1 + joi 17 校验，鉴权 jsonwebtoken 9.0，密码 bcryptjs 3 哈希。
Go 网关 backend/proxy/main.go 暴露 live-im-proxy/channel + health + limiter + oauth + pipeline 五大模块，channels 配置默认包含 douyin、kuaishou、wechat、xiaohongshu 四类账号类型，可对接 Coze 大模型 API（COZE_API/COZE_TOKEN）、Redis 限流、抖音 OAuth 回调（DOYIN_APP_ID/SECRET + REDIRECT_URI）。
代码全部开源 MIT 协议，依赖 PostgreSQL 13+/Redis 6+、Node.js 18+/Go 1.21+，可通过 Docker Compose（backend + frontend + proxy + postgres + redis）一键拉起本地演示。
适用场景
电商直播团队：把抖音、快手、视频号、小红书直播间的弹幕/私信集中到同一后台，用 AI 规则与关键词回复承接价格、库存、发货类高频咨询，配合人工坐席转接把意向用户引导到留资表单。
教育培训矩阵号：多个短视频矩阵号同时引流，统一接入同一智能客服，用意图识别与 FAQ 知识库匹配课程咨询，并按渠道/评分规则把线索分配到不同课程顾问。
本地生活服务：餐饮、医美、健身等本地商家通过短视频引流到店，平台统一接管咨询、自动收集到店预约信息、留资表单一键到 CRM。
品牌矩阵号运营方：管理几十上百个品牌矩阵号的消息与线索，规模化承接咨询，避免账号消息遗漏导致意向用户流失，配合经营概览做渠道人效对比。
客服 SaaS 服务商：基于多租户（tenants 表 + 租户套餐 + 计费账单 + 服务监控）做行业版客服 SaaS，按渠道/规则/AI 模型灵活配置租户级功能。
个人开发者与外包交付：141 文件、13 MB 体积适中，前后端分离 + Docker Compose 一键拉起，能直接拿来当 SaaS 客服中台原型或外包项目的基础底座。
功能亮点
四公域平台账号接入：抖音/快手/视频号/小红书的 OAuth 接入与账号绑定，在统一控制台展示账号数、在线数与当前选中账号，每条账号独立更新时间和配置入口（frontend/src/pages/Channels/DouyinPage 等 4 个独立页面 + StatusPage 总览）。
AI 智能接待三层结构：关键词规则自动回复（高频问题快答）+ 意图识别与 FAQ 知识库（标准化答复）+ 大模型推理回答（开放式问题），所有场景下都能随时切到人工坐席（ActiveConversations + AutoReply + Handover 三页）。
线索运营闭环：线索筛选与分级、按规则分配销售、留资表单组件（LeadsList + RulesPage + ComponentsPage），配合获客流程可视化编排与灰度发布（Workflow/DesignerPage）、经营数据报表与坐席绩效（Analytics/AnalyticsDashboard）。
经营概览仪表盘：核心 KPI 卡（对话量、线索量、渠道在线、自动回复命中、转人工），对话/线索趋势柱状图与渠道分布饼图（douyin / kuaishou / wechat / xiaohongshu），近 7 日默认时间窗（frontend/src/pages/Dashboard.tsx + @ant-design/charts）。
AI 能力配置：意图管理（IntentsPage）、知识库问答（KnowledgePage）、模型选择（ModelsPage），可对接 Coze 智能体 API（backend/proxy/main.go COZE_API/COZE_TOKEN），按租户/渠道启用不同模型。
多租户 SaaS：tenants 租户表 + 租户套餐 + 计费账单（BillingPage）+ 服务监控（MonitoringPage），全栈 11 个业务路由（auth / channels / conversations / leads / ai / analytics / dashboard / workflows / security / system / simple）按租户隔离。
实时 WebSocket：socket.io-client 4 + Go 网关 Gorilla WebSocket（live-im-proxy/pipeline），支持进行中对话、留资通知、灰度发布事件的实时推送。安全审计：helmet + express-rate-limit + JWT 鉴权 + joi 校验 + 敏感词与审核记录（Security 路由与页面）。
技术架构与部署指南
技术栈与运行环境
前端：React 19.2.0 + TypeScript 4.9 + Ant Design 5.27.6 + @ant-design/charts 2.6.6 + react-router-dom 6.30 + recharts 3.3 + socket.io-client 4.8 + axios 1.12 + dayjs 1.11，Create React App 5.0.1 构建。
后端：Node.js 18+ / Express 5.1.0 + TypeScript + PostgreSQL 13+ + Redis 6+，中间件 helmet 8.1、cors 2.8、compression 1.8、morgan 1.10、express-rate-limit 8.1、joi 17 校验，鉴权 jsonwebtoken 9.0、密码 bcryptjs 3。
数据库：PostgreSQL 13+（主存 tenants/users/channels/conversations/leads/lead_rules/forms 等 10 余张业务表，bcrypt 哈希存口令，init.sql 含近 7 日约 10 条/域的演示种子），初始化自动建表 + 种子（script/init.sql + docker-entrypoint-initdb.d）。
缓存：Redis 6+ 用于 session、限流、Coze 调用计数（backend/.env.example REDIS_URL 形如 redis://localhost:6379），Go 网关也共享同一 Redis 实例。
其他依赖：Go 1.21+ 渠道/WebSocket 网关（live-im-proxy，模块 channel/health/limiter/oauth/pipeline），Nginx 1.25 反向代理（script/nginx.conf），Docker 24+ / Docker Compose 2.x（docker-compose.yml + docker-compose.prod.yml 区分本地演示与生产）。
安装与部署提示
克隆源码：git clone https://github.com/light618/linkbot-ai.git，或 git@www.gitcc.com:hoya012/yun-qu-tong-gitcc.git（gitcc 平台需会员账号）。
配置环境变量：复制 backend/.env.template 到 backend/.env，设置 DATABASE_URL（PostgreSQL 连接串）、REDIS_URL、COZE_API/COZE_TOKEN、DOYIN_APP_ID/SECRET/REDIRECT_URI、JWT_SECRET 等。
启动数据库与缓存：本地用 docker compose up -d postgres redis 拉起 PostgreSQL 13 与 Redis 6；也可使用已有云数据库，但需保证 script/init.sql 已在首次启动时执行（卷已存在则手动 psql -f 导入）。
启动后端：在 backend 目录执行 npm install 安装依赖，npm run build 编译 TypeScript，npm start 启动 Express；或在 backend 目录 docker compose up backend 走容器。默认端口 3001。
启动 Go 网关：在 backend/proxy 目录 go mod download 下载依赖，go run main.go 启动渠道代理；或 backend 容器同栈由 docker compose 拉起。默认端口 8080，需配置 COZE_TOKEN 与 DOYIN_APP_ID 等环境变量。
启动前端：在 frontend 目录 npm install 后 npm start（开发模式 3000 端口）或 npm run build 打包后由 Nginx 代理（参考 script/nginx.conf）。前端通过 proxy 字段（package.json proxy=http://localhost:3001）转发到后端。
访问系统：浏览器打开 http://localhost:3000 进入登录页，使用 SQL 初始化内置管理员账号 admin/admin123（script/init.sql 演示种子，bcrypt 哈希），进入实时仪表盘后即可查看四渠道账号状态与近 7 日 KPI 趋势。
启用 Coze 大模型：在 backend/.env 设置 COZE_API=https://api.coze.com/open/v1 与 COZE_TOKEN 后重启后端与 Go 网关，进入 AI 配置页（ModelsPage）启用相应模型；意图/知识库页（IntentsPage/KnowledgePage）配置 FAQ。
截图与演示说明
经营概览页：登录后进入实时仪表盘，5 张核心 KPI 卡（对话量 10、线索量 10、渠道在线 20、自动回复命中 550、转人工 3），下方分两栏展示对话/线索趋势柱状图（蓝色对话 + 橙色线索，X 轴为日期 08-10 至 08-15）与渠道分布环形图（douyin / kuaishou / wechat / xiaohongshu 四个分块）。
渠道中心 – 抖音接入页：左侧二级菜单「渠道中心/抖音接入」展开，顶部三张数据卡（账号数 10、在线 5、当前选中 ID ch-douyin-01），下方账号列表展示账号名称、账号 ID、状态（online/offline）、更新时间与操作列（查看/配置）。
对话管理 – 进行中对话页：左侧菜单「对话管理/进行中对话」展开，表格展示用户名（张小明/李小红/王强/赵丽/陈浩/刘轩）、渠道（ch-douyin-01 至 ch-douyin-06 蓝色标签）、状态（active 蓝色标签）、消息数、最近消息时间、操作列查看消息，支持实时刷新按钮。
其他页面：自动回复配置（AutoReplyPage）、人机切换（HandoverPage）、意图管理（IntentsPage）、知识库问答（KnowledgePage）、模型选择（ModelsPage）、线索列表（LeadsList）、分配规则（RulesPage）、留资组件（ComponentsPage）、流程设计器（Workflow/DesignerPage）、租户管理（System/TenantsPage）、计费账单（System/BillingPage）、服务监控（System/MonitoringPage）、内审安全（Security/敏感词）、系统设置（System/*）均已实现，可由 docker compose 一键演示。
常见问题
问：云渠通项目在 GitHub 还是 GitLab 平台？
云渠通原始仓库在 GitHub：https://github.com/light618/linkbot-ai（用户 light618，创建于 2025-10-28，描述「全域获客智能客服系统」，2 stars、1 fork、17.3 MB、TypeScript 主语言）；同步镜像在 gitcc.com 的 https://www.gitcc.com/hoya012/yun-qu-tong-gitcc（hoya012 账户，2026-08-17 创建，内部可见）。
问：云渠通与同类知名客服系统（如 yunqiic/contact-center 小白客服、jeepay 等）相比有什么差异？
相较于 yunqiic/contact-center（小白客服，基于 Spring Cloud + Kotlin + PostgreSQL + Elasticsearch + MinIO 的传统工单客服系统）与 jeepay（开源支付系统），云渠通专注于短视频公域获客场景：原生集成抖音/快手/视频号/小红书四公域账号、对接 Coze 大模型智能体、按渠道/评分规则做线索分配；技术栈更轻（Node.js 18+ Express 5 + React 19 + Go 1.21），141 文件、13 MB 体积适中，单机 docker compose 一键拉起。
| 对比维度 | 云渠通（Yun Qu Tong） | 小白客服 yunqiic/contact-center | jeepay |
|---|---|---|---|
| 技术栈 | React 19 + Express 5 + Go 1.21 + PostgreSQL/Redis | Spring Cloud + Kotlin + PostgreSQL + Elasticsearch + MinIO | Java + Spring Boot 支付网关 |
| 业务方向 | 短视频公域获客 + 智能客服 + 线索运营 | 传统工单客服 + 机器人问答 | 聚合支付 |
| 平台接入 | 抖音/快手/视频号/小红书四公域账号 + Coze 大模型 | Web 端 + 桌面客户端（Electron） | 微信/支付宝/云闪付三方支付 |
| 部署形态 | Docker Compose 一键拉起，141 文件 13 MB | Spring Cloud 多服务，依赖重 | Spring Boot 单体 |
问：项目是否完全免费商用？协议是什么？
基于 backend/package.json license 字段明示 MIT 协议，个人与企业可 100% 免费使用，无需保留作者版权信息；商用前请确认 Coze 大模型 API、抖音/快手/视频号/小红书开放平台各自的服务条款与计费规则，避免触达平台政策。
问：如何对接抖音/快手/视频号/小红书的账号？
在 backend/.env 设置各平台开放平台的 AppID/AppSecret/回调地址（DOYIN_APP_ID、DOYIN_APP_SECRET、REDIRECT_URI 等），重启 Go 网关（backend/proxy/main.go）后进入渠道中心页点击新增账号，按各平台 OAuth 流程授权即可；账号 token 由 Go 网关 + Redis 维护，API 转发由 live-im-proxy/channel 模块实现。
问：Coze 大模型怎么接入？没有 Coze 账号能用吗？
无 Coze 账号仍可使用关键词规则 + 意图识别 + FAQ 知识库三层基础接待能力，AI 大模型为可选高级能力。注册 Coze 智能体平台账号（https://www.coze.com/open）获取 API Token 后填入 backend/.env 的 COZE_TOKEN，重启后端与 Go 网关即可启用。
问：数据库一定要用 PostgreSQL 吗？能不能换成 MySQL？
当前 init.sql 语法（JSONB、ON CONFLICT、bcrypt 等）针对 PostgreSQL 13+ 编写，暂未提供 MySQL 版本；如需迁移，需重写 init.sql 为 MySQL 8 语法、调整 pg 模块到 mysql2/promise，并修改 backend/src/data 层数据库驱动。短期推荐直接使用 PostgreSQL 13+。
问：演示账号与默认密码是什么？
SQL 初始化内置管理员账号 admin/admin123（script/init.sql 演示种子，bcrypt 哈希存库，明文不入库）；前端登录页 http://localhost:3000 可直接登录，登录后进入实时仪表盘查看演示数据；部署公网前请务必修改默认账号密码并清理演示数据。
安全风险提示
本次审计通过 codebase-memory-mcp 在 787 个代码节点、1727 条引用边上执行高危函数扫描（eval、child_process、exec、shell、os/exec、base64_decode、deserialize 等关键字），raw_match_count=0，无真实命令执行、反序列化与 base64 注入风险。
路径：backend/.env.template；类型：敏感凭据模板占位；证据：数据库口令、Redis URL、Coze API Token、抖音/快手/视频号/小红书 AppID/Secret、JWT_SECRET 均以环境变量方式注入，但 .env.example 文件本身可能被误提交到仓库；建议：部署前通过环境变量或密钥管理服务（Vault/KMS）注入敏感字段，禁用公网对 /api/system 与 /api/security 路径的访问。
路径：script/init.sql；类型：演示种子口令；证据：管理员账号 admin 默认密码 admin123 以 bcrypt 哈希写入种子脚本，bcrypt 哈希强度足够但默认账号密码必须修改；建议：演示验收完成后立即修改管理员密码并清理演示数据，启用多租户（tenants）隔离。
特别提示：本源码未检测到恶意后门与混淆代码（search_code raw_match_count=0），但默认配置存在多处公网回调地址（http://localhost:8080/oauth/callback）与 Coze API 占位，生产部署前必须替换为 HTTPS 域名、配置强 JWT_SECRET、启用 helmet 全部安全头、调整 express-rate-limit 阈值，并按《数据安全法》完成隐私评估与租户隔离加固。
下载说明
本资源为云渠通（Yun Qu Tong / linkbot-ai）完整源码压缩包（含 141 个文件、约 13 MB），适用于短视频/直播团队的智能客服与线索运营平台搭建，以及多平台矩阵号运营方的统一管理后台部署。
本资源基于 MIT 协议开源，使用前请阅读项目根目录 README.md 的许可与免责声明；商用前请自行确认 Coze 大模型 API、抖音/快手/视频号/小红书开放平台各自的服务条款、计费规则与数据合规要求。
涉及用户私信、会话记录、留资数据采集的部分，请按《数据安全法》《个人信息保护法》与各公域平台开放平台的服务协议完成合规评估后再上线运行。
源码仅供学习研究、测试部署和二次开发参考，商用前请自行确认授权、版权和安全风险。
GitHub项目开源地址：https://github.com/light618/linkbot-ai
最后更新：2026-08-18（GitHub 镜像 light618/linkbot-ai 创建于 2025-10-28）。