CountBot 发行版

# CountBot v0.5.0 安装使用指南

##  0.5.0 主要更新:

- 实现真正的AI团队协作：支持多角色分工、上下文衔接、条件流转与团队级编排,可以在企业微信、飞 - 书等群聊添加多个机器人实现多团队协作
 
 - 会话级配置升级为角色级与团队级配置：一个工作区即可管理多个角色、多个模型、多个机器人

- 渠道系统全面增强：支持自定义渠道扩展，并新增微博、企业微信、小智 AI 等接入能力
 
 - 多机器人运行能力进一步完善：不同渠道、不同角色、不同配置可独立服务不同场景
 
 - 前端全面重构与优化：聊天、配置、技能、团队、工具面板和国际化体验整体升级
 
 - 工具调用、消息流、媒体发送与渠道管理链路全面增强，复杂任务更稳定

## 重要提示
- 桌面版处于测试阶段，若遇兼容性问题，优先使用Python源码运行方案。
- Skills调用依赖python（python3）命令，务必将python加入到系统环境变量。

## 方案一：Python源码运行（推荐，提供更好的交互体验）
### 1. 安装Python 3.10.11环境
- Windows（64位）：下载 https://www.python.org/ftp/python/3.10.11/python-3.10.11-amd64.exe ，安装时勾选 「Add Python 3.10 to PATH」，未勾选则手动将Python安装目录及Scripts目录加入系统PATH。
- macOS：下载 https://www.python.org/ftp/python/3.10.11/python-3.10.11-macos11.pkg ，按向导安装，默认已加入环境变量。
- Linux（Ubuntu/Debian）：执行 `sudo apt update && sudo apt install -y python3.10 python3.10-pip`。

### 2. 下载项目源码
- 手动下载：访问 https://github.com/countbot-ai/CountBot ，下载ZIP包并解压。
- Git克隆：`git clone https://github.com/countbot-ai/CountBot.git` 。

### 3. 进入项目目录
```bash
# 手动下载解压后
cd CountBot-main
# Git克隆后
cd CountBot
```

### 4. 安装依赖
```bash
# Windows
C:\Users\Administrator\AppData\Local\Programs\Python\Python31\python.exe -m pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/

# 环境变量配置正常时简化为
python -m pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/
或pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/

# macOS/Linux
python3 -m pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/
```

### 5. 启动系统
```bash
# Windows
python start_app.py
# macOS/Linux
python3 start_app.py
```

### 6. 访问系统
打开浏览器，输入 http://127.0.0.1:8000

## 方案二：桌面版快速运行（测试版）
### Windows
1. 解压下载的zip压缩包；
2. 双击运行CountBot.exe；
3. 常见问题：缺少Edge WebView2需下载 https://go.microsoft.com/fwlink/p/?LinkId=2124703 安装；端口8000被占用则修改配置文件端口；防火墙拦截需允许CountBot访问网络。

### macOS
```bash
# 解压
tar -xzf CountBot-macOS-x64.tar.gz
# 添加执行权限
chmod +x CountBot/CountBot
# 运行
./CountBot/CountBot
```
常见问题：提示「无法验证开发者」执行 `xattr -cr CountBot/CountBot`；需macOS 10.13及以上版本。

### Linux（Ubuntu/Debian）
```bash
# 解压
tar -xzf CountBot-Linux-x64.tar.gz
# 添加执行权限
chmod +x CountBot/CountBot
# 安装依赖
echo 'deb http://gb.archive.ubuntu.com/ubuntu jammy main' | sudo tee -a /etc/apt/sources.list >/dev/null && sudo apt update && sudo apt install -y libwebkit2gtk-4.0-37
# 运行
./CountBot/CountBot
```
补充：依赖缺失可尝试 `sudo apt update && sudo apt install -y webkit2gtk-4.0`（Ubuntu/Debian）或 `sudo dnf install -y webkit2gtk3`（Fedora）。

## 问题排查
1. 查看日志：源码运行版日志路径为data/logs/CountBot_*.log；
2. 优先方案：桌面版报错切换为Python源码运行；
3. 反馈问题：访问 https://github.com/countbot-ai/CountBot/issues ，附日志、系统版本、Python版本。

## 推荐源码运行的原因
1. 兼容性更好，避免打包程序适配问题；
2. 错误信息完整，便于调试；
3. 可通过git pull随时更新版本；
4. 支持自定义Python环境和依赖。

## 感谢支持
- 点Star：https://github.com/countbot-ai/CountBot
- 提Issue：https://github.com/countbot-ai/CountBot/issues
- 做贡献：查看 https://github.com/countbot-ai/CountBot/blob/main/CONTRIBUTING.md

countbot-ai/CountBot .gitee-modal { width: 500px !important; }

搜索帮助

countbot-ai/CountBot