Bit

Brean In Terminal — Agent Tool Hub

简体中文 | [English](README_EN.md)

[](https://github.com/yxpil/bit/releases/latest) [](https://github.com/yxpil/bit/releases) [](https://github.com/yxpil/bit/blob/main/LICENSE) [](https://github.com/yxpil/bit/actions) [](https://osbt.space) [](https://osbt.space) [](https://qm.qq.com/q/qlFr8ct0ps)

[](https://github.com/yxpil/homebrew-bit) [](https://github.com/yxpil/scoop-bit) [](https://www.npmjs.com/package/bit-agent) [](https://github.com/microsoft/winget-pkgs/pull/428288) [](https://yxpil.github.io/apt-repo) [](https://yxpil.github.io/dnf-repo) [](https://yxpil.github.io/pacman-repo)

BIT 是一个基于 Tauri 2 + React 18 的桌面应用：一个可审计、可远程访问的 AI Agent 工具中枢。你可以配置任意 AI 提供方，与模型进行流式对话，并让 AI 调用本机工具、自写脚本、沉淀记忆与技能。

BIT 永久免费：完全开源（Apache-2.0），所有功能对个人与商业用户永久免费——无内购、无订阅、无功能锁、无遥测，可随时自行编译。

> 无边框自定义标题栏 · 深/浅色主题 · 黑白线性设计 · QQ 交流群

目录

[功能特性](#功能特性) · [技术栈](#技术栈) · [安装使用](#安装使用) · [远程访问与 API](#远程访问与-api) · [文档](#文档) · [安全与隐私](#安全与隐私) · [开发](#开发) · [项目结构](#项目结构) · [许可](#许可)

功能特性

对话与 AI

• 流式对话：前后端全链路流式（SSE + Tauri Event），回复逐字展示；思考过程独立显示；助手消息 Markdown 渲染（表格、代码块等）；缓存命中率实时统计。
• 多提供方：OpenAI / Gemini / Claude 三种协议，可配置多家、同一时刻激活一个（互斥）；先测试上游连通性再保存；「从 API 获取」一键拉取模型列表。
• 多模态：支持图片输入，随消息发给多模态模型。
• 终端模式：终端直接输入 bit 进入简约 TUI——无窗口、无单实例约束、不监听端口，适合 SSH / 无桌面环境。

Agent 能力

• 工具中枢：注册、启停、调用工具；自动探测并注册本机解释器（JS / Python 等），AI 只需写一段能通讯的脚本即可成为工具；工具热更新。
• AI 自建能力：AI 可通过内置工具自写插件 / 直接执行脚本 / 把脚本沉淀为常驻工具（Rhai 沙箱受限执行）。
• 记忆与技能：AI 通过 add_memory / skill 工具自行总结沉淀，跨会话复用，无需手动触发。

协议与集成

• MCP 客户端：接入任意标准 MCP 服务器，支持两种传输方式：
• Streamable HTTP — 扫描端口范围或手动填 URL，适合独立部署的 MCP 服务
• stdio（JSON-RPC 2.0） — 粘贴 { "mcpServers": { ... } } 格式配置（兼容 Cursor / Claude Desktop），支持 command + args + env，Windows 下自动 cmd /c 包裹 npx/uvx 等 npm 命令；示例：

``json { "mcpServers": { "filesystem": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "/home/user"] }, "brave-search": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-brave-search"], "env": { "BRAVE_API_KEY": "xxx" } } } } `` 每个子进程独立 spawn → initialize 握手 → tools 自动并入注册表 → 暂停/继续/移除 → kill 进程。

• MCP 服务器：BIT 自身也暴露标准 MCP 端点（POST /mcp），Claude Desktop 等任何 MCP 客户端可直接调用 BIT 的全部启用工具。
• OpenAI 兼容端点：/v1/chat/completions 支持流式，第三方应用可把 BIT 当本地 AI 网关使用。

可靠与治理

• 审计日志：所有工具调用与关键操作留痕，可在「审计」页查看。
• 自动更新：全平台自动检查、下载、换装（可关闭）。
• 数据本地化：会话、记忆、技能、配置全部保存在本机。

技术栈

| 层 | 技术 | |----|------| | 前端 | React 18、Vite 6、Tailwind CSS 4、react-markdown + remark-gfm | | 桌面 | Tauri 2（Rust） | | 后端 | reqwest（含 stream）、tokio、axum、rhai、futures-util |

安装使用

从 Releases 下载对应平台的安装包：

| 平台 | 安装包 | 说明 | |---|---|---| | Windows x64 | *-setup.exe（NSIS）或 *.msi | 双击安装；ARM64 笔记本（骁龙 X）选 aarch64 版 | | macOS Apple Silicon | *_aarch64.dmg | M 系列芯片 | | macOS Intel | *_x64.dmg | 拖入 Applications 安装 | | Linux x64 / ARM64 | *.deb / *.AppImage / *.rpm | 按发行版习惯选择 | | 龙芯 LoongArch64（3A5000/3A6000） | *_loongarch64.deb / *_loongarch64.tar.gz | deb 双击安装；其他发行版解压二进制 | | RISC-V 64（VisionFive 2 等） | *_riscv64.deb / *_riscv64.tar.gz | 同上 | | 飞腾 / 鲲鹏 / 麒麟 ARM | *_arm64.deb / *_arm64.AppImage / *_arm64.rpm | 与 Linux ARM64 通用 | | 兆芯 / 海光 | *_amd64.deb / *_amd64.AppImage / *_x86_64.rpm | 与 Linux x64 通用 |

> 全部支持的芯片架构与操作系统明细（含飞腾 / 鲲鹏 / 麒麟 / UOS / ChromeOS 矩阵）见 Wiki：芯片与操作系统支持。

ChromeOS（Crostini）安装

ChromeOS 内置 Linux 开发环境（Debian 12 容器），BIT 的 Linux 安装包可直接使用，无需专门版本：

1. 设置 → 关于 ChromeOS → 开发者 → Linux 开发环境 → 启用（Intel/AMD 与 ARM 机型均支持）
2. 在 Linux 终端安装（Intel/AMD 选 amd64，ARM 选 arm64）：

sudo apt install ./BIT_0.5.9_amd64.deb

依赖（libwebkit2gtk-4.1、libgtk-3、libayatana-appindicator3）会由 Debian 12 仓库自动补齐；安装后 BIT 出现在「Linux 应用」文件夹，窗口经 Wayland 显示，与原生 Linux 体验一致。

包管理器安装

macOS（Homebrew）：

brew tap yxpil/bit
brew install --cask bit

Windows（Scoop）：

scoop bucket add bit https://github.com/yxpil/scoop-bit
scoop install bit

npm（跨平台，自动下载对应平台应用）：

npm install -g bit-agent
bit-agent   # 启动 BIT

Windows（winget，审核中）：winget install yxpil.bit

Debian / Ubuntu / UOS / 麒麟（APT 源）：

echo "deb [trusted=yes] https://yxpil.github.io/apt-repo stable main" | sudo tee /etc/apt/sources.list.d/bit.list
sudo apt update && sudo apt install bit

Fedora / RHEL / openSUSE（dnf 源）：

sudo tee /etc/yum.repos.d/bit.repo  原理：`xattr -cr` 删除文件的 quarantine 隔离标记；签名本身完整可校验，去掉隔离后 macOS 不再拦截。

### Windows 首次运行提示 SmartScreen？

安装包未做代码签名（EV 证书同样需付费）。SmartScreen 弹窗时点 **"更多信息" → "仍要运行"** 即可。

### Linux 运行 AppImage

```bash
chmod +x BIT_0.5.9_amd64.AppImage
./BIT_0.5.9_amd64.AppImage

首次使用

进入「AI 设置」→ 添加一个提供方（协议 / Base URL / API Key / 模型，可点"从 API 获取"拉取模型列表）→ 点击播放按钮激活 → 回到「对话」开始使用。

终端场景：安装后在任意终端输入 bit 直接进入 TUI 对话。

远程访问与 API

「远程」页开启后，BIT 在本机监听 HTTP API（默认 127.0.0.1:8600，可改为 0.0.0.0 供局域网访问；默认关闭，开启时自动生成密钥与访问密码）。

认证

• Client Key（bit_ 前缀，自动生成）：Authorization: Bearer 或 ?key=——用于 /v1/* 与 /mcp 端点
• 访问密码：/api/* 管理端点额外要求 X-Access-Password 头（OpenAI / MCP 客户端无法携带自定义头，故豁免）

端点

| 端点 | 方法 | 说明 | |---|---|---| | /v1/chat/completions | POST | OpenAI 兼容对话（支持 SSE 流式） | | /v1/models | GET | 模型列表 | | /mcp | POST / DELETE | 标准 MCP 服务器（Streamable HTTP / JSON-RPC 2.0） | | /api/* | — | 会话 / 配置 / 审计等管理接口（需访问密码） | | /api/health | GET | 健康检查（无需认证） |

curl http://127.0.0.1:8600/v1/chat/completions \
  -H "Authorization: Bearer $BIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_MODEL","messages":[{"role":"user","content":"列出当前目录"}]}'

详见 Wiki：远程访问与 API · MCP-集成

文档

完整文档在 Wiki（中英双语，每页顶部可切换语言）：

• 使用：安装指南 · 芯片与操作系统支持 · 快速上手 · 对话功能 · TUI-终端模式 · FAQ
• 进阶：工具系统 · MCP-集成 · 记忆与技能 · 远程访问与 API · 自动更新 · 审计日志
• 参与：开发与构建

English wiki: Home-EN — every page has a language switcher at the top.

在线站点：osbt.space · 文档

安全与隐私

• 数据本地化：会话、记忆、技能、配置全部保存在本机应用数据目录，不上传遥测。
• 双重认证：Client Key（常数时间比较防时序侧信道）+ 访问密码；远程访问默认关闭。
• 沙箱与限额：AI 自建脚本经 Rhai 沙箱受限执行（深度 / 操作数 / 墙钟预算）；子进程工具带超时杀灭、输出上限与资源回收。
• MCP 会话治理：会话 30 分钟空闲过期、数量上限、显式 DELETE 终止。
• 签名透明：macOS ad-hoc 签名 / Windows 无 EV 证书（均为无付费证书的取舍，见上方安装说明），源码与 CI 构建流程全部公开可查。

开发

前置：Node.js、Rust 工具链、Tauri 系统依赖。

npm install          # 安装前端依赖
npm run tauri dev    # 开发模式（热更新）
npm run tauri build  # 构建 release（NSIS / MSI / dmg / AppImage / deb）

项目结构

src/               React 前端
  pages/           对话 / AI 设置 / 工具 / 技能 / 记忆 / 审计 / 远程
  components/      Markdown、工具卡片、图标等
src-tauri/         Tauri (Rust) 后端
  src/             ai、agent、mcp、registry、runtime、script_runtime、
                   http_api、update、audit、session、goal、memory …
installer/bit.iss  Inno Setup 打包脚本

许可

[Apache License 2.0](LICENSE) — BIT 永久免费：所有功能无内购、无订阅、无功能锁，个人与商业使用均免费。

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: yxpil
• Source: yxpil/bit
• License: Apache-2.0
• Homepage: https://yxpil.github.io/bit/

Install and usage instructions live in the source repository linked above.