BitFun-OHOS:基于 OpenHarmony 的桌面级智能体运行时与应用套件项目

BitFun 是一个桌面级 Agent 运行时（Local Agent Runtime），同时也是一套开箱即用的桌面 Agent 应用，基于OpenBitFun（https://github.com/GCWing/BitFun）进行构建

文件	最后提交记录	最后更新时间
.github	feat(update): download daily app updates in background	1 个月前
BitFun-Installer	feat(update): download daily app updates in background	1 个月前
MiniApp	refactor(core): move miniapp-dev skill to builtin_skills directory	1 个月前
docs	refactor(core): centralize tool context runtime bindings Move ToolUseContext runtime/service helpers out of the tool framework into a core-owned runtime binding module. Centralize pipeline, manifest description, and write preflight context materialization there as well, while preserving existing custom_data, cancellation, path policy, runtime URI, remote containment, and Deep Review hook behavior behind focused regressions and boundary checks.	1 个月前
png	docs(readme): document flashgrep + ripgrep search gains - Add What's New / 最新特性 with Chromium benchmark figures - Add png/feat_flashgrep.png - zh-CN: fix wording, image alt, and markdown table formatting	2 个月前
resources	chore(search): isolate flashgrep logs and bump bundle v0.2.7	1 个月前
scripts	refactor(core): centralize tool context runtime bindings Move ToolUseContext runtime/service helpers out of the tool framework into a core-owned runtime binding module. Centralize pipeline, manifest description, and write preflight context materialization there as well, while preserving existing custom_data, cancellation, path policy, runtime URI, remote containment, and Deep Review hook behavior behind focused regressions and boundary checks.	1 个月前
src	chore(ohos): bump version to 1.0.1	1 个月前
tests	chore(core, desktop, web-ui): remove Mermaid interactive editor - Remove agent mermaid_interactive tool, desktop APIs, and announcements - Remove standalone editor scene, flow chat tool card, and mermaid-editor tooling UI - Trim FlexiblePanel and ide-control types; keep Markdown MermaidBlock rendering - Fix MermaidBlock SVG cache key regression; drop mermaid export E2E spec	1 个月前
.gitignore	feat(auto-update): add auto-update	1 个月前
.npmrc	fix: Clean up redundant and unreasonable dependencies between the front-end and back-end.	3 个月前
.release-please-manifest.json	chore(release): prepare v0.1.1 and increase build memory	4 个月前
AGENTS-CN.md	refactor(product-domains): add runtime facade guardrails Move MiniApp runtime state persistence behind product-domain facade contracts and add function-agent runtime facade/adapter boundaries without rewiring product execution paths. Update decomposition guardrails and module AGENTS docs to keep runtime migration constraints explicit.	1 个月前
AGENTS.md	refactor(tools): complete H1 provider boundary Move product tool provider group planning into bitfun-tool-packs while keeping concrete tool materialization, ToolUseContext, GetToolSpec execution, and runtime service handles core-owned. Update boundary guards and docs, and fix remote-connect subagent link routing exposed by full workspace verification.	1 个月前
CONTRIBUTING.md	docs(deep-review): localize contributor guidance	1 个月前
CONTRIBUTING_CN.md	refactor(core): establish P1 decomposition guardrails Move the core decomposition plan into docs/plans and add the architecture guardrail doc for future bitfun-core split work. Introduce the product-full safety net without reducing the default core capability set, and make current product crates opt into the full runtime explicitly. Add bitfun-core-types for shared AI error DTOs while preserving the existing bitfun-events re-export path. Move the existing terminal-core and tool-runtime packages to workspace-level crate paths without changing their package or lib names. Update AGENTS, README, and CONTRIBUTING guidance so future core decomposition work follows the guardrails and uses the new support crate locations.	1 个月前
Cargo.toml	Merge remote-tracking branch 'upstream/main' into bugfix_o	1 个月前
LICENSE	Initial commit	5 个月前
README.md	docs: complete Quick Start section with DevEco Studio and HarmonyOS build steps	1 个月前
README.zh-CN.md	docs: complete Quick Start section with DevEco Studio and HarmonyOS build steps	1 个月前
package-lock.json	bump version to 0.2.7	1 个月前
package.json	bump version to 0.2.7	1 个月前
pnpm-lock.yaml	feat: enhance browser control, screenshot, and tool system (#632) * feat: enhance browser control, screenshot, and tool system - Add configurable preferred browser selection with caching - Migrate screenshot to modern-screenshot with timeout/fallback - Unify withTimeout into shared timing module - Bash tool: add working_directory parameter - Tool results serialize full structured data - AI adapters: read local config with logging - Fix Codex credential header casing - Announcement respects startup tips config * fix(web-ui): simplify browser control copy in session settings locales Shorten browserControl.sectionDescription in en-US, zh-CN, and zh-TW session-config strings.	1 个月前
pnpm-workspace.yaml	fix: Clean up redundant and unreasonable dependencies between the front-end and back-end.	3 个月前
release-please-config.json	ci: add Release Please, CI checks, nightly builds and unify version management - Unify version across all 11 crates using Cargo workspace.package.version as the single source of truth (all crates now use version.workspace = true) - Remove version field from tauri.conf.json (Tauri 2 falls back to Cargo.toml) - Normalize package.json version to standard semver "0.1.0" - Add CI workflow (ci.yml): rust-lint, rust-test, rust-build-check, frontend-build with concurrency control and cancel-in-progress - Add Release Please workflow + config for automated versioning and changelog generation based on Conventional Commits - Refactor desktop-package.yml to trigger on release:published event instead of manually detecting version changes in tauri.conf.json - Add nightly build workflow: scheduled weekday builds with pre-release publishing Co-authored-by: Cursor <cursoragent@cursor.com>	4 个月前

中文 English

BitFun

BitFun 是什么

BitFun 是一个桌面级 Agent 运行时（Local Agent Runtime），同时也是一套开箱即用的桌面 Agent 应用。

它是基座——Rust 内核 + Tauri 外壳，内置会话、工具、记忆、MCP、LSP、远程控制协议，为长期运行而生；
它是产品——下载安装就拥有 Code / Cowork / Computer Use / 个人助理四大官方 Agent，几乎覆盖了当前业界所有主流 Agent 能力形态。

一次安装，既能当 Agent 用，也能当 Runtime 做。

BitFun 的野心是把 Code Agent 的编码力、Cowork 的办公力、OpenClaw 的助理体验、Computer Use 的操控力等等 这些业界最受欢迎的 Agent 能力，装进同一个桌面端，并把底层协议栈（Agentic RunTime、工具、记忆、MCP、Skill、上下文压缩、远程控制）全部默认就绪——你拿来就能用，也可以基于它定义你自己的领域 Agent。

readme_hero_CN

为什么选 BitFun

一个应用，几乎覆盖全部业界主流 Agent 能力：Code / Cowork / Computer Use / 文档协作 / 生成式 UI / Mini App / MCP / 远程控制 …… 不用在多个工具之间切换，也不用各配一个订阅。
下载即用，不做拼装工：MCP / LSP / 文件系统 / 终端 / Git / 远程 SSH 全部内置，模型配好就能开跑，省掉自己从零搭建协议栈的时间。
数据在你自己机器上：会话、记忆、工作目录都存在 .bitfun/sessions/ 下，可迁移、可导出、可审计；没有强制上云，隐私与合规场景都能用。
极致可定制，从一个 Markdown 到整仓 fork 没有断点：90% 的领域化需求一个 .md 就能搞定；缺工具？缺界面？要改产品？在 BitFun 里直接让 Code Agent 动手——你定制它的方式，就是用它本身。
手机也能指挥桌面：扫码、Telegram、飞书 Bot、微信 Bot 都是远控入口。Agent 在桌面上干活，你在路上看进度。
真正能装机长用的桌面应用：Rust 内核 + Tauri 外壳，冷启动快、常驻资源低，长时间后台运行也不心疼电脑。
会自我迭代：97%+ 代码由 BitFun 内置 Code Agent 通过 Vibe Coding 完成，天然亲和AI开发。

紧追前沿 · 开箱即用

Agent 领域几乎每周都有新范式出现。BitFun 的节奏是——看到好东西，就把它装进桌面，并让它和已有能力无缝协同。

first_screen_screenshot

以下是 BitFun 已装箱的官方 Agent 和能力清单和对业界最前沿 Agent 范式的复现进度。零配置，下载即用：

能力	说明
Code Agent	四种模式：Agentic（自主读改跑验证）/ Plan（先规划后执行）/ Debug（插桩取证 → 根因定位）/ Review（基于仓库规范审核）
深度审核	面向高风险代码变更的并行代码审核团队，内置专项审核员、质量把关和用户确认后的修复流程
会话用量报告	在聊天中输入 `/usage`，查看当前会话的记录耗时、Token 用量和模型/工具/文件摘要。
Cowork Agent	PDF / DOCX / XLSX / PPTX 原生处理能力，可从 Skill 市场按需扩展
文档协作	在文档里边写边问，AI 直接在段落上改写、续写、总结、排版
个人助理	长期记忆、个性设定，按需调度 Code / Cowork / Computer Use / 自定义 Agent
远程控制 / IM 接入	手机扫码、Telegram、飞书 Bot、微信 Bot 远程下达指令，实时查看进度
MCP / MCP App	任意外部工具一键接入，MCP 也能打包成可安装的 App
生成式 UI	对话过程中按需生成可交互 UI 组件，嵌在消息流里直接用
Mini App	一句话生成独立可运行的应用，即生即跑，一键打包成桌面端
Markdown 定义 Agent	写一个 `.md` 文件，立即在 Runtime 里跑起来，满足大多数领域化需求
长期记忆 + 项目上下文	跨会话积累，任意 Agent 可读
自我迭代	Code Agent 直接改 BitFun 自己的仓库
⋯⋯	下一个热点持续跟进中，欢迎 Issue 提需求

怎么定制自己的 BitFun

不同深度的定制需求，对应不同成本的扩展路径。按"从轻到重"依次选择即可：

层级	方式	适合做什么	改动成本
L1	Markdown 自定义 Agent	换提示词 + 挑选工具组合，即可定义一个新的 Agent 能力，满足大多数领域化需求	写一个 `.md` 文件
L2	Mini App	需要用界面交互的能力（面板、表单、可视化、业务流程）	一句话生成，即生即跑
L3	源码级添加工具	新工具、新模型适配、新协议接入——给自定义 Agent 补齐它需要但 BitFun 还没有的 `tool`	用 BitFun 的 Code Agent 改 BitFun 自己的源码
L4	自由改源码	换品牌、重做 UI、改会话模型、做完全不一样的产品	整仓 fork，天然亲和 Vibe Coding 开发模式

一个例子：Code Agent 和 Cowork Agent 的差别其实很小

在 BitFun 里，一个 Agent = 一段提示词（系统角色 + 行为约束）+ 一组它能调用的工具。官方的 Code Agent 和 Cowork Agent 区别就仅在于此：

	Code Agent	Cowork Agent
提示词	面向仓库工作的角色、规范、四种工作模式	面向知识工作的角色、文档处理流程
工具集	文件 / 终端 / Git / LSP / 构建与测试	PDF / DOCX / XLSX / PPTX / Skill 市场
共用底盘	同一套会话、记忆、MCP、远控、UI、模型适配	同一套会话、记忆、MCP、远控、UI、模型适配

所以，如果你想做一个"法律审阅 Agent"、"科研文献 Agent"或者"运维应急 Agent"——L1 就够了：

写一个 Markdown，定好它的角色 / 禁区 / 工作流程
从工具注册表里勾上它该用的工具（文件、浏览器、特定 MCP……）
如果缺了一个特定工具 —— 走 L3，打开 BitFun 让 Code Agent 帮你加进源码
如果这个 Agent 需要一个专属界面 —— 走 L2，一句话生成一个 Mini App
如果你要做一个完全不一样的产品 —— 走 L4，fork 整个仓库，让 Code Agent 陪你改

关键点：L3 和 L4 都不用你离开 BitFun——打开 BitFun，对 Code Agent 说你要改什么，它就改给你看。你定制它的方式，就是用它本身

从一个 Markdown 文件到完整 fork，中间没有断点。这正是"会自我迭代的基座"的含义。

平台支持

桌面端基于 Tauri，支持 Windows / macOS / Linux；远程控制支持手机浏览器、Telegram、飞书、微信。

快速开始

从源码构建

前置依赖：

Node.js（推荐 LTS 版本）
pnpm
Rust 工具链
Tauri 前置依赖（桌面端开发需要）
ohos-rs
DevEco Studio

运行指令：

# 在根目录安装依赖
pnpm install

# 在根目录编译前端
npm run build

# 在 desktop 目录编译后端（.so）
cd src/apps/desktop && cargo tauri ohos init && cargo tauri ohos build

# 编译 mini app 前端
cd src/mobile-web && npm run build

# 构建应用
## 1. 复制 mini-app 资源
cp src/mobile-web/dist src/apps/ohos/entry/src/main/resources/resfile

## 2. 复制应用可执行文件
cp target/aarch64-unknow-linux-ohos/release/libbitfun_desktop_lib.so src/apps/ohos/entry/libs/arm64-v8a/libbitfun_desktop_lib.so  

## 3. 使用 DevEco Studio 构建完整应用

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

项目结构一览

src/crates/core         # 兼容门面与完整产品 runtime 组装点
src/crates/{core-types,agent-stream,runtime-ports} # 已拆出的 core 支撑边界
src/crates/{terminal,tool-runtime} # workspace 顶层 terminal / tool 辅助 crate
src/crates/transport    # Tauri / WebSocket / CLI 传输适配
src/crates/api-layer    # 共享 handler 与 DTO
src/apps/desktop        # Tauri 桌面宿主
src/apps/server         # Web 服务端运行时
src/apps/cli            # CLI 运行时
src/web-ui              # 桌面 / Web 共用前端

架构原则：产品逻辑保持平台无关，通过适配器对外暴露。详见 AGENTS-CN.md。