---
title: "安装与首次运行"
description: "下载、解压与模型配置。"
lang: zh
---

Bi 以压缩包或安装盘形式提供，不需要安装依赖，也不需要单独的运行时。

## 下载

前往[下载页](/download)，按系统选择对应产物。每个平台提供 x64 与 ARM64 两种架构：

- **Windows**：解压后运行 `bi-windows-*.exe`。请先解压，不要在压缩包内直接双击，否则 `ocr/` 无法随程序加载。
- **macOS**：推荐 `.dmg` 安装盘，双击挂载后把 Bi 拖入「应用程序」；也可以使用绿色版 `.zip`。
- **Linux**：解压后运行对应架构的可执行文件。

`ocr/` 是文档识别组件，需要与可执行文件保持同级。删除它只会失去扫描件的文字识别能力，其他功能不受影响。

## 首次运行

启动后 Bi 在本机运行，并自动在浏览器中打开工作台。三个平台的操作方式略有不同：

- **Windows** 以 GUI 模式启动，并常驻系统托盘。
- **macOS** 提供菜单栏图标，可打开工作台、工作区、配置目录与日志。
- **Linux** 以服务模式运行，界面在浏览器中访问。

数据保存在程序目录旁的 `.bi` 目录内：设置与模型密钥、会话记录、本地数据库和运行日志都在这里。Bi 没有自己的服务器。

## 配置一个模型

Bi 不包含模型。首次使用前，在「设置」中添加至少一个模型服务——云端 API，或本机运行的 Ollama / LM Studio。具体步骤见[添加模型](/docs/configuration/providers)。

## 校验下载（可选）

下载页给出了每个文件的 SHA-256。按系统执行：

```bash
# macOS / Linux
shasum -a 256 bi-linux-amd64.zip

# Windows PowerShell
Get-FileHash .\bi-windows-amd64.zip -Algorithm SHA256
```

把输出与下载页显示的值比对即可。