TeamBot - 团队协作型AI助手

本地桌面端执行型 AI 助手，支持 Windows / macOS / Linux。

安装

一键安装（推荐）

macOS / Linux

curl -fsSL https://teambot.samai.cc/install.sh | bash

指定版本：

curl -fsSL https://teambot.samai.cc/install.sh | bash -s -- --version 1.52.0

Windows（PowerShell）

irm https://teambot.samai.cc/install.ps1 | iex

指定版本：

irm https://teambot.samai.cc/install.ps1 | iex -Version 1.52.0

首次运行若提示执行策略限制，先执行：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

系统要求

一键安装脚本会自动下载独立可执行文件，无需 Python 或 Node.js。

启动命令

teambot              # 默认启动（Web 管理后台）
teambot update       # 更新到最新版
teambot web          # Web 管理后台
teambot cli          # CLI 交互模式
teambot tray         # 系统托盘后台运行
teambot server       # API 服务模式
teambot install      # 安装/更新依赖
teambot uninstall    # 卸载

配置 LLM

环境变量方式（推荐）

export TEAMBOT_LLM_API_KEY="sk-your-key"
export TEAMBOT_LLM_MODEL="gpt-4"

配置文件方式

首次运行自动创建 ~/.teambot/config.json，编辑即可：

{
  "llm": {
    "provider": "openai",
    "api_key": "sk-...",
    "model": "gpt-4"
  }
}

Ollama 本地模型（免费）

curl -fsSL https://ollama.ai/install.sh | sh
ollama pull llama3
export TEAMBOT_LLM_PROVIDER="ollama"
export TEAMBOT_OLLAMA_MODEL="llama3"

发布客户端

⚠️ TeamBot 使用 Cython 编译发布，源码以 .so 二进制形式分发，不提供 sdist。

1. CI/CD 自动构建（推荐）

推送到 main 分支后，CI 自动执行 wf1 → wf2 → wf3 链式流程：

• wf1: Cython 编译 + 发布到 PyPI
• wf2: PyInstaller 打包 exe + 创建 runner 脚本（无 pip/npm）
• wf3: 上传二进制和安装脚本到 teambot.samai.cc/downloads/

2. 本地构建（当前平台）

python3 build_cython.py

构建产物在 dist/ 目录，为当前平台的 .whl 文件。

2. CI/CD 自动构建

推送到 main 分支后，CI 自动执行：

• wf1: Cython 编译 + 发布编译后 wheel 到 PyPI
• wf2: 构建多平台二进制（PyInstaller exe + runner 脚本，无 pip/npm）
• wf3: 上传到 teambot.samai.cc/downloads/ 并部署 install.sh / install.ps1

3. 跨平台构建（GitHub Actions）

推送版本标签即可自动构建所有平台的 wheel 并发布到 PyPI：

# 1. 更新版本号
#    编辑 package.json 和 pyproject.toml 中的 version 字段

# 2. 提交并打标签
git add .
git commit -m "release v1.52.0"
git tag v1.52.0
git push origin main --tags

4. 配置 PyPI Token

在 GitHub 仓库 Settings → Secrets and variables → Actions 中添加：

• Name: PYPI_API_TOKEN
• Value: 你的 PyPI API Token（pypi- 开头）

5. 构建说明

• 不发布 sdist：仅发布预编译 .whl 文件，避免 .py 源码泄露
• Cython 编译：大部分 .py 编译为 .so，仅入口文件和必要模块保留 .py
• 保留 .py 的模块：main.py, config.py, tray_manager.py, monitor_timer.py, core/version.py, web/api_server.py 等大型或关键模块

更新代码

用户端更新

teambot update

或重新运行安装脚本：

# macOS / Linux
curl -fsSL https://teambot.samai.cc/install.sh | bash

# Windows
irm https://teambot.samai.cc/install.ps1 | iex

开发者更新流程

1. 修改代码：在本地仓库开发并测试

2. 本地测试：

   pip install -e .        # 开发模式安装
   teambot                 # 运行验证
   

3. 构建测试：

   python3 build_cython.py --test    # 编译 + 导入测试
   

4. 发布新版本：

   # 更新版本号 → 提交 → 打标签 → 推送
   git tag v1.53.0
   git push origin main --tags
   

清理构建产物

python3 build_cython.py --clean

链接

• 官网: https://teambot.samai.cc
• 下载: https://teambot.samai.cc/downloads/
• GitHub: https://github.com/ctz168/teambot
• PyPI: https://pypi.org/project/teambot-ai

License

MIT