BiliGo V3 全平台消息自动回复+AI智能检索/AI客服-心云阁

BiliGo V3 Ultra：全平台消息自动回复神器，AI智能

BiliGoV3Ultra是一款开源的多平台消息自动回复系统，将B站私信、B站评论、抖音、小红书、微博、闲鱼六类消息入口整合到同一个Web管理界面中统一管理，并支持为各平台接入AI自动回复。

回复方式有两种，可按平台自由选择：•关键词规则：默认回复+关键词触发，可区分已关注/未关注用户、限制单用户回复次数、自定义发送间隔以降低风控风险；B站私信支持图片回复。•AI客服：支持OpenAI、Anthropic及自定义兼容接口，多知识库按平台分配，会话上下文自动压缩，内置违禁词拦截；AI无法可靠处理的会话会进入人工待回队列。一些实用设计：只处理启动后的新消息，不会批量回复历史会话；各平台的配置、登录状态、统计与日志相互隔离；内置仪表盘查看全平台回复量与成功率；支持登录失效、运行异常邮件告警；规则支持跨平台导入导出，导出内容不包含Cookie等敏感信息。

部署方面提供源码运行、Docker镜像（含内置Chromium的完整版）和Windows单文件EXE三种方式，仓库默认配置不含任何凭据，开箱即用。

适合自媒体运营者、店铺客服与多账号管理人员使用。仅供学习研究和个人效率用途，自动化操作请控制频率，注意账号安全，遵守各平台规则。

BiliGo V3 Ultra · 开发者部署流程指南

源码运行 → 测试 → Docker 生产部署 → EXE 打包的完整工程手册（面向开发者）

二、分步操作详解

准备环境

组件	要求	用途
Python	3.11（推荐）	运行主程序
Git	任意近期版本	拉取源码
Chrome	系统已装，或 Playwright Chromium	浏览器自动化平台
Docker	20+（仅生产部署需要）	服务器部署

获取源码

git clone https://github.com/Chiyang001/BiliGo.git cd BiliGo

核心代码结构：单 Flask 应用 app.py（B 站私信 + 评论 + 统一 API），四个平台模块通过 register_*_routes(app) 挂载，浏览器自动化在 *_playwright.py，AI 服务层在 ai_*.py。

创建虚拟环境并安装依赖

python -m venv .venv # Windows 激活 .venv\Scripts\activate # Linux/macOS 激活 source .venv/bin/activate # 国内建议走镜像 pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple pip install playwright -i https://pypi.tuna.tsinghua.edu.cn/simple # 浏览器内核（国内走 npmmirror，否则官方源极慢） PLAYWRIGHT_DOWNLOAD_HOST=https://cdn.npmmirror.com/binaries/playwright playwright install chromium

注意：requirements.txt 只声明了 Flask 和 requests，playwright 是延迟导入的可选依赖，不装也能启动 Web，但浏览器平台功能不可用。

本地启动与数据隔离

# 强烈建议：运行数据与源码分离 # Windows PowerShell $env:BILIGO_DATA_DIR=”$PWD\.biligo-data” # Linux/macOS export BILIGO_DATA_DIR=”$PWD/.biligo-data” export PORT=4999 python app.py

访问 http://localhost:4999 确认首页渲染、/api/status 返回 JSON 即启动成功。数据目录会自动生成默认无凭据配置 + 3 个 SQLite 库（会话 / 人工待回 / 仪表盘指标）。

💡 路径解析逻辑在 app_paths.py：优先级 BILIGO_DATA_DIR → PyInstaller 冻结目录 → 源码根目录，三态共存。

跑冒烟测试验证

python scripts/smoke_test_regressions.py python scripts/smoke_test_platform_login_guards.py python scripts/smoke_test_xianyu.py python scripts/smoke_test_comment_ui.py

四个脚本会各自拉起临时实例（随机端口 + 临时数据目录），不污染本地数据。
除 regressions 外都需要 Playwright Chromium 已安装。
看到 ... passed 即通过；提交代码前必须全绿。

生产部署 · 分支 A：Docker（服务器首选）

两个镜像按需选择：

# 基础镜像：仅 B 站 API 模式 + Web 界面，体积小 docker build -t biligo:latest . # Playwright 完整镜像：内置 Chromium，五平台全功能 docker build -f Dockerfile.playwright -t biligo:playwright . docker run -d –name biligo \ -p 4999:4999 \ -v biligo-data:/data \ –restart unless-stopped \ biligo:playwright # 或者一行 Compose（docker-compose.yml 已就绪） docker compose up -d –build

配置、登录会话、数据库全部持久化在 biligo-data 卷（容器内 /data）。
entrypoint 会把 docker/defaults/ 下的无凭据模板复制进新卷 —— 仓库里永远不应出现真实 Cookie。

⚠️ 删除容器不会删命名卷，但删除卷 = 删除所有登录态和数据，删除前务必先备份。

生产部署 · 分支 B：Windows 单文件 EXE

build_exe.bat # 产物：dist\BiliGo.exe

打包配置在 BiliGo.spec（PyInstaller 单文件，HTML/JS/CSS 全部内嵌）。
EXE 首次运行在数据目录生成无凭据默认配置。
浏览器平台仍依赖系统 Chrome 或 Playwright Chromium 运行时，EXE 内不含浏览器。

开发迭代与提交规范

改动后跑全部 4 个冒烟测试 → 全绿再提交。
确认 .gitignore / .dockerignore 生效：绝不上传 config.json、*_storage.json、浏览器资料目录、SQLite 库、日志、dist/ 产物。
平台页面结构变化会导致浏览器自动化选择器失效，需同步更新 *_playwright.py 中的 DOM 定位。
B 站相关改动注意保留 HTTP 412 区分逻辑与 im_dev_id 账号隔离，这是历史风控事故的修复成果。

三、常见部署问题排查

现象	原因	处理
pip 装 playwright 极慢/超时	PyPI 直连慢	加 `-i https://pypi.tuna.tsinghua.edu.cn/simple`
chromium 下载卡住	官方 CDN 慢	`PLAYWRIGHT_DOWNLOAD_HOST=https://cdn.npmmirror.com/binaries/playwright`
Docker 里浏览器平台起不来	用了基础镜像	换 `biligo:playwright` 镜像，并确认 /data 可写
Flask 与新版 Werkzeug 冲突	未锁版本	Flask 2.3.3 配 `werkzeug<3`
EXE 启动后配置找不到	数据目录解析到了只读位置	显式设置 `BILIGO_DATA_DIR`

文章版权声明 1、本网站名称：心云阁
2、官网网址：https://www.bllo.cn
3、本网站的文章部分内容可能来源于网络，仅供大家学习与参考，如有侵权，请联系站长fgh2014869500@163.com进行删除处理。
4、本站一切资源不代表本站立场，并不代表本站赞同其观点和对其真实性负责。
5、本站一律禁止以任何方式发布或转载任何违法的相关信息，访客发现请向站长举报
6、本站资源大多存储在云盘，如发现链接失效，请联系我们我们会第一时间更新。

THE END