Baige

Baige 使用教程

从安装到高级用法，全面了解 Baige 本地智能体的各项能力。让 AI 在你的环境中持续存在、记忆并行动。

安装指南

Baige 是一个纯本地运行的智能体系统，所有数据均存储在您的设备上，无需联网即可使用。

01 系统要求

  • 操作系统：Windows 10/11（64 位）或 macOS 12+
  • Python 3.10 及以上版本
  • 内存：建议 8GB 以上
  • 磁盘空间：至少 2GB 可用空间

02 获取凭证

联系作者获取 Pro 授权码（微信：QingPu_Z）。凭证用于激活本地运行时环境，确保软件安全运行。

提示

每个授权码绑定一台设备，换机需重新申请。请妥善保管您的凭证信息。

03 下载与安装

在首页输入凭证码，点击「验证并下载」获取安装包。下载完成后：

  1. 解压安装包到您选择的目录
  2. 运行 setup.bat（Windows）或 setup.sh（macOS）完成环境初始化
  3. 安装完成后运行 start.bat 或 start.sh 启动服务
  4. 浏览器访问 http://localhost:7860 即可进入交互界面

语音使用

Baige 支持实时语音识别，让您动动嘴就能下达指令。语音指令会经过本地 STT 引擎转写后送入智能体运行流。

01 启用语音

在 Baige 界面右上角点击麦克风图标，系统将请求麦克风权限。首次使用需在浏览器弹窗中点击「允许」。

02 语音指令示例

  • 信息查询："帮我查一下今天的天气"、"最近的新闻有哪些"
  • 文件操作："打开昨天的项目文档"、"帮我把桌面整理一下"
  • 任务管理："提醒我下午三点开会"、"帮我总结本周工作"
  • 工具调用："搜索一下机器学习的最新论文"、"把这份 PDF 转成 Word"

03 语音反馈

语音识别结果会实时显示在对话区域。如果识别有误，您可以手动编辑修正后再发送，系统会从修正后的文本中提取意图。

提示

在嘈杂环境中使用时，建议靠近麦克风讲话或使用耳机麦克风以获得更好的识别效果。语音识别完全在本地进行，不上传任何音频数据。

心跳机制

心跳是 Baige 的核心特性之一。即使没有新消息，心跳也会按节奏唤醒智能体，让它检查环境、回看未完成的任务。

01 心跳工作原理

心跳机制按固定间隔（默认为每 30 秒）自动触发一次「清醒周期」。在清醒周期中，Baige 会：

  1. 检查是否有未完成的任务需要推进
  2. 扫描环境变化（新文件、系统通知等）
  3. 回顾短期记忆中待处理的事项
  4. 决定是否需要主动通知用户或继续行动

02 配置心跳间隔

在 Baige 的配置文件中修改心跳参数：

# config.yaml
heartbeat:
  enabled: true
  interval: 30          # 心跳间隔（秒），默认 30
  max_idle_cycles: 10   # 最大空闲周期数，超过后进入休眠
  wake_on_event: true   # 是否在系统事件时唤醒

03 心跳状态查看

在界面顶部的状态栏中，绿色圆点表示心跳正常运行。点击状态栏可以展开详细信息，包括上次心跳时间、下一个心跳倒计时和最近执行的操作。

提示

如果希望节省系统资源，可以将心跳间隔调整为 60 秒或更长。但请注意，间隔过长可能导致对突发事件的响应变慢。

系统配置

通过配置文件可以精细调整 Baige 的行为，包括模型参数、工具权限、记忆策略等。

配置文件位置

配置文件位于安装目录下的 config.yaml，首次运行时会自动生成默认配置。

关键配置项

  • model.provider：AI 模型提供商（支持 OpenAI / Anthropic / 本地模型）
  • model.api_key：API 密钥（如使用云端模型）
  • memory.max_tokens：记忆上下文的最大 token 数
  • tools.allowed_paths：允许文件操作工具访问的目录白名单
  • voice.language：语音识别语言（默认 zh-CN）
安全提示

修改配置文件后需要重启 Baige 服务才能生效。建议在修改前备份原始配置文件。

常见问题

启动后无法访问界面？

请检查：① 防火墙是否阻止了 7860 端口；② 是否有其他程序占用了 7860 端口；③ Python 环境是否正确安装。

语音识别不准确？

尝试：① 调整麦克风输入音量；② 在安静环境中使用；③ 在配置中切换语音识别引擎。

如何更新版本？

在首页使用凭证码重新下载最新版本。更新前请备份 config.yaml 和 memory/ 目录以保留个人数据。