每个 BIT
都不相同。

安装（图形安装包）

• macOS：打开 dmg，把 BIT 拖入 Applications，从启动台打开。
• Windows：双击 setup.exe 或 MSI 按向导安装；便携版解压即用。
• Linux：deb / rpm 双击安装，或运行 AppImage（chmod +x BIT_*.AppImage 后执行）。
• ChromeOS：设置 → 关于 ChromeOS → 开发者 → Linux 开发环境（Debian 12），启用后在 Linux 终端执行 sudo apt install ./BIT_*.deb，Intel/AMD 选 amd64、ARM 选 arm64，应用出现在 Linux 应用文件夹。

macOS 提示「已损坏，无法打开」

BIT 当前为 ad-hoc 签名（无付费开发者证书），浏览器下载会带上隔离标记，macOS 会误报"已损坏"。应用本身签名完整，去掉隔离标记即可：

或者在 系统设置 → 隐私与安全性 中点击「仍要打开」。

Windows SmartScreen 提示

安装包未做代码签名，首次运行点击「更多信息 → 仍要运行」即可。便携版同理。

首次配置

打开 BIT → AI 设置：填入任意 OpenAI 兼容服务的 Base URL 与 API Key（内置 Claude / Gemini 协议切换）， 点击「从 API 获取」可在线拉取该服务的全部模型列表。左侧输入区实时显示提示词缓存命中率。

工具页可暂停/启用内置工具（shell、文件读写、计划、技能），或从 MCP 服务器一键导入远程工具； 技能页用 Rhai 脚本自定义 AI 能力；记忆页管理计划目标与待办。

远程访问 API

设置 → 远程访问 开启后（默认 0.0.0.0:8600），BIT 暴露完整 HTTP API，认证方式：请求头 Authorization: Bearer <Client Key>，或 X-Access-Password: <访问密码>。

OpenAI 兼容端点：GET /v1/models、POST /v1/chat/completions（支持 stream， 流式末尾返回 usage 含 cached_tokens）。第三方 OpenAI 格式客户端把 Base URL 指向 http://主机:8600/v1、API Key 填 Client Key 即可。

MCP 端点

BIT 既是 MCP 客户端（自动发现并导入外部 MCP 服务器工具），也自带 MCP 服务端（Streamable HTTP / JSON-RPC 2.0）： 端点 POST /mcp，方法 initialize / tools/list / tools/call。 Claude Desktop 等任意 MCP 客户端可接入 BIT 的全部启用工具。

升级与卸载

包管理器安装：升级走 brew upgrade / scoop update / apt upgrade / dnf upgrade / pacman -Syu / npm update -g。 图形安装包：新版本直接覆盖安装。数据目录：macOS ~/Library/Application Support/com.bit.hub。

关于 osbt.space

osbt.space 是 BIT 的官方站点：os = Open Source，bt = BIT。BIT 是 Apache-2.0 开源软件， 源码与发布均在 GitHub。

同一作者的站点：yxpil.com（个人主页）· yxp.hk（短链接服务）· cidaiji.com（磁带姬）。