中文 | English

---

简介

在AI时代，真正的人机协作不仅仅是一个聊天框，而是一位理解你、与你并肩作战、不断进化，并能随时随地完成任务的伙伴。这正是BitFun的起点。

BitFun是一款新一代AI助手，内置代码智能体和协同办公智能体。它拥有记忆、个性，并能随着时间推移不断进化。你可以通过手机二维码配对或Telegram/飞书机器人远程控制桌面，发送指令，并实时查看每一步执行过程，同时智能体在后台持续工作。

采用Rust + TypeScript构建，提供超轻量、流畅的跨平台体验。

---

双重模式

BitFun提供两种模式，以适应不同类型的工作：

• 助理模式：更温暖、了解偏好，并具备长期记忆。最适合持续协作，例如维护项目或保持你的写作与设计风格。
• 专业模式：高效利用token、以执行为先、上下文干净。最适合短时间内的专注任务，如修复一个bug或更新一个小功能。

---

远程控制

借助二维码配对，你的手机瞬间成为桌面智能体的远程指挥中心。只需发送一条消息，桌面AI便会立即开始工作。

桌面会生成一个二维码，手机浏览器扫描后即可打开远程界面，无需安装任何应用。

除了手机二维码配对外，BitFun还支持Telegram/飞书机器人，用于远程指令及实时进度跟踪。

功能	描述
二维码配对	扫描桌面生成的二维码，完成密钥交换，并建立持久连接
全面控制	查看会话、切换模式、发送指令，并远程控制桌面工作流
实时流媒体	智能体的每一步操作及工具调用均可在手机上实时查看

智能体系统

智能体	角色	核心能力
个人助理（测试版）	你的专属AI伙伴	长期记忆与个性设置；可按需编排代码/协同办公/自定义智能体，并持续进化
代码智能体	编码助手	四种模式：自主式（自主读取/编辑/运行/验证）、计划式（先规划再执行）、调试式（追踪至根本原因）、评审式（仓库感知的代码评审）
协同办公智能体	知识工作助手	内置PDF/DOCX/XLSX/PPTX处理能力，并可从技能市场获取和扩展合适的功能包
自定义智能体	领域专家	使用Markdown快速定义特定领域的智能体

---

生态系统

它仍在不断成长。

对话中会涌现出迷你应用，社区中的技能也在不断发展，智能体则通过协作不断进步。

层级	描述
迷你应用	从提示词生成可运行的界面，并一键打包成桌面应用
技能市场	安装社区提供的功能包，使智能体能够快速学习新技能
MCP协议	连接外部工具和资源，将智能体的能力扩展到本地系统之外
自定义智能体	使用Markdown定义角色、记忆和能力边界
ACP协议（开发中）	一种结构化的多智能体通信标准，用于与主流AI工具实现互操作

---

平台支持

该项目采用Rust + TypeScript构建，实现跨平台复用，确保你的智能体无论在哪里工作都能随时可用。

形态	支持的平台	状态
桌面	Windows、macOS、Linux	✅ 已支持（Tauri）
远程控制	移动浏览器、Telegram、飞书	✅ 已支持

---

快速入门

下载与使用

从Releases下载最新的桌面安装程序。安装完成后，配置好模型即可开始使用BitFun。

CLI、服务器以及原生移动应用仍在规划或开发中。目前桌面和远程控制已支持。

从源码构建

请确保已安装以下依赖：

• Node.js（推荐使用LTS版本）
• pnpm
• Rust工具链（可通过rustup安装）
• Tauri前置条件用于桌面开发

仅限Windows：桌面构建会链接一个预编译的OpenSSL（无需自行编译OpenSSL源码）。你无需手动下载ZIP文件：首次需要OpenSSL时，工具会自动从FireDaemon OpenSSL 3.5.5下载到**.bitfun/cache/目录下，并在后续使用中重复利用该缓存。pnpm run desktop:dev以及所有pnpm run desktop:build*脚本都会运行ensure-openssl-windows.mjs（构建时使用desktop-tauri-build.mjs）。如果你直接使用cargo进行编译（不经过上述pnpm入口点），请先从仓库根目录运行一次node scripts/ensure-openssl-windows.mjs——它会执行相同的下载操作，并输出适用于PowerShell的OPENSSL_*环境变量。你可以通过设置OPENSSL_DIR指向ZIP包中的x64**文件夹，或者设置BITFUN_SKIP_OPENSSL_BOOTSTRAP=1并自行指定OPENSSL_*变量来覆盖默认值。

# 安装依赖
pnpm install

# 以开发模式运行桌面应用
pnpm run desktop:dev

# 构建桌面应用
pnpm run desktop:build

更多详情请参阅中文贡献指南。

Linux构建

前置条件

安装系统依赖：

# Debian/Ubuntu
sudo apt install libwebkit2gtk-4.1-dev build-essential libgtk-3-dev \
  libayatana-appindicator3-dev librsvg2-dev patchelf

其他发行版（Arch、Fedora等）请参阅docs/linux-setup.md。

构建

pnpm install
pnpm run desktop:build:linux

输出将在src/apps/desktop/target/release/bundle/目录下（包含.deb、.rpm、.AppImage）。

---

贡献

我们欢迎优秀的想法和代码贡献。对于AI生成的代码，我们持最大程度的开放态度。请先将PR提交到dev分支；我们会定期审查并同步到主分支。

我们重点关注的贡献领域包括：

1. 通过Issue提出关于功能、交互和视觉设计的好点子与创意
2. 优化Agent系统及整体质量
3. 提升系统稳定性与基础能力
4. 扩展生态体系，包括技能、MCP、LSP插件以及对垂直开发场景的支持

---

免责声明

1. 本项目是在业余时间构建的，用于探索和研究下一代人机协作，而非商业盈利。
2. 本项目的97%以上由Vibe Coding完成。我们也欢迎对代码问题的反馈，并鼓励通过AI进行重构或优化。
3. 本项目依赖并参考了许多开源项目。感谢所有开源作者。如您的权益受到影响，请联系我们进行修正。

---

BitFun 快速上手指南

BitFun 是一款具备个性与记忆的下一代 AI 助手，专为编码和知识工作打造。它支持桌面端运行，并可通过手机扫码、Telegram 或飞书机器人进行远程操控。

环境准备

在开始之前，请确保您的系统满足以下要求：

系统要求

• 操作系统：Windows、macOS 或 Linux
• 架构：主流 x64 架构（Linux 需额外依赖）

前置依赖

若您需要从源码构建，请安装以下工具：

• Node.js：建议安装 LTS 版本
• pnpm：包管理工具
• Rust 工具链：通过 rustup 安装
• Tauri 依赖：参考 Tauri 官方文档

Linux 用户额外依赖 (Debian/Ubuntu):

sudo apt install libwebkit2gtk-4.1-dev build-essential libgtk-3-dev \
  libayatana-appindicator3-dev librsvg2-dev patchelf

注：其他发行版（如 Arch, Fedora）请参考项目文档 docs/linux-setup.md。

安装步骤

方式一：直接使用安装包（推荐）

大多数用户无需编译，直接下载预构建版本即可：

1. 访问 GitHub Releases 页面。
2. 根据您的操作系统下载最新的安装包（.exe, .dmg, .deb, .rpm 等）。
3. 安装完成后启动应用，配置大模型即可使用。

方式二：从源码构建

如果您希望贡献代码或体验最新开发版，请按以下步骤操作：

1. 克隆项目并安装依赖

   pnpm install
   

2. Windows 用户特别注意 桌面构建需要预编译的 OpenSSL。首次运行时，脚本会自动下载并缓存到 .bitfun/cache/。

   • 若使用 pnpm 脚本（推荐），无需手动干预。
   • 若直接使用 cargo 编译，请先运行：

     node scripts/ensure-openssl-windows.mjs
     

     并根据输出设置 OPENSSL_DIR 环境变量。

3. 启动开发模式

   pnpm run desktop:dev
   

4. 构建生产版本

   # 通用构建
   pnpm run desktop:build
   
   # Linux 专属构建
   pnpm run desktop:build:linux
   

   Linux 构建产物位于 src/apps/desktop/target/release/bundle/。

基本使用

1. 初始化配置

启动 BitFun 后，进入设置页面配置您偏好的大模型（支持本地部署或云端 API）。

2. 选择工作模式

BitFun 提供两种核心模式，可根据任务类型切换：

• 助理模式 (Assistant Mode)：适合长期协作。具备长期记忆和个性化设置，适用于维护项目、保持写作/设计风格一致性。
• 专业模式 (Professional Mode)：适合短时任务。Token 效率高，上下文干净，适用于修复 Bug、更新小功能等一次性任务。

3. 远程操控（特色功能）

无需在手机安装 App，即可将手机变为远程控制台：

1. 在桌面端 BitFun 界面找到 二维码配对 选项。
2. 使用手机浏览器扫描二维码。
3. 绑定成功后，您可在手机端：
   • 发送指令触发桌面 Agent 工作。
   • 实时查看 Agent 的执行步骤和工具调用流。
   • 切换模式或管理工作会话。

此外，也支持通过配置 Telegram 或飞书 (Feishu) 机器人进行远程指令下发。

4. 开始协作

在对话框中输入自然语言指令，例如：“帮我重构这个模块的代码”或“总结这份 PDF 文档的核心观点”。Agent 将根据所选模式，自主调用代码编辑、文件读取或联网搜索等能力完成任务。