BitFun v0.1.2 终于发布了。这个版本没有堆新功能,核心就是两件事:把 UI 从头到尾重构了一遍,把 Session 做成了可以远程接入和控制的东西。但恰恰是这两件事,让 BitFun 从一个“只能在开发机终端里跑的玩具”变成了一个“真正能随身带着用的 AI 开发助手”。我大概从三个多月前开始重度使用 BitFun 跑各种本地 AI agent 任务,从 v0.1.0 一路升级到现在,这次改动我愿称之为“补上了最后一块短板”。如果你也在用本地 AI 编程助手,或者正被 session 管理、远程控制这类问题折磨,这篇内容值得你花几分钟看一看。
先说清楚 BitFun 是干嘛的。它是一个本地优先的 AI 开发辅助工具,运行在你的终端或者浏览器里,可以理解成一个跑在你电脑上的 AI agent 工作台。你给它一个任务,它会自己规划步骤、调用工具、读写代码文件、执行命令,并且把整个过程以会话(Session)的形式记录下来。之前版本的问题在于:所有东西都绑死在一台机器上,一旦切换设备,工作状态就全断了;UI 层也做得比较糙,会话一多就卡。v0.1.2 的远程 Session 控制,说白了就是把“助手的工作现场”从一台机器上解放出来,让你在家里的电脑发起任务,到了公司用另一台电脑接上继续看、继续操作,整个过程不断线、不丢上下文。
1. 为什么这次更新值得关注
1.1 本地 AI 助手最尴尬的一个场景
我自己遇到最尴尬的情况是这样的:在工作室的台式机上让 BitFun 跑一个完整的代码重构任务,任务预期要 20 分钟。刚跑两分钟,临时有事要出门,我下意识想把任务停了——因为在我印象里,这种本地任务一旦离开机器,出任何问题都没法处理。出门之后心里一直悬着:跑完了吗?中途报错了怎么办?代码会不会被改了一半?
这就是本地运行 AI 助手的典型痛点。模型在你的机器上跑也好,API 在云端跑也好,但 agent 的执行过程、文件操作、工具调用都发生在本地。你人不在机器前,基本等于失联。BitFun v0.1.2 的远程 Session 控制,解决的就是这个“人机分离”的问题。它让会话变成一个可以随时挂载的实体,你从任何能联网的设备上都能 attach 进去,查看实时状态,甚至在远端继续给任务下达指令。
另一个跟它紧密相关的痛点是上下文割裂。以前我在两台电脑上分别用 BitFun,A 机器上积累的会话、决策记录、临时状态,B 机器完全不知道。想复用就得手动导出再导入,非常原始。Session 远程化之后,多台设备看到的是同一个“工作现场”,这种割裂感才算真正消失了。
1.2 UI 和 Session 才是决定体验的两根支柱
很多人一提到 AI 助手升级,第一反应就是“模型换没换”“能力涨没涨”。但作为每天实际在用的重度用户,我的体感是:模型能力只是下限,UI 和 Session 管理才决定你的使用频率和效率。
- UI 决定效率 :任务多、日志长的时候,一个信息层级混乱的界面会显著增加你的认知负担。工具调用过程、代码 diff、命令输出,如果全混在一起,你根本分不清当前到底跑到哪一步。
- Session 决定信任 :Session 是 AI 助手的工作记忆。一个可靠的 session 系统,意味着任务跑到一半崩溃了还能恢复,换个设备还能接着来。如果 session 管理脆弱,你对这个工具永远只敢拿来做一次性小任务,不敢让它独立跑复杂工作。
这次 v0.1.2 把两根支柱都补强了。UI 重构解决“看得清、点得动”的问题,远程 Session 控制解决“走得开、接得上”的问题。两者叠加,才是标题里那句“让 AI 开发助手真正随身可用”的底气。
2. UI 重构:从“能跑”变成“好用”
2.1 旧版 UI 的三个明显问题
说实话,v0.1.x 之前的界面不能说不可用,但离“好用”确实有距离。我总结下来主要是三个问题。
第一是会话和日志不分家。所有内容都沿着一个时间轴往下排,对话消息混着工具输出混着报错信息。任务简单还好,一旦跑一个十几步的 agent 流程,你想回看某一步的命令输出,得睁大眼睛在密密麻麻的文字里找半天。
第二是长任务没有直观的状态表达。agent 在执行过程中会多次调用工具,每调用一次可能要等几秒甚至几十秒。旧界面在等待期间几乎没有任何反馈,你只能盯着光标发呆,心里反复嘀咕“它是不是卡死了”。
第三是操作路径太绕。想切换 session,想查看上下文,想中断当前任务,这些高频操作都藏在二级菜单里,鼠标要点好几下才能到达。对一个每天要切换十几次任务的工具来说,这种交互损耗积累起来非常可观。
2.2 新版界面的信息架构
这次重构,核心思路是把“信息分层展示”做到极致。新 UI 采用三段式布局,每一块各司其职。
- 左侧 Session 列表 :展示所有本地和远程可用的会话,包括会话 ID、任务标题、运行状态(运行中/等待中/已完成/失败)、最后活动时间。远程会话会额外标注来源节点,方便区分。
- 中间主工作区 :按时间顺序展示对话消息和工具调用记录。每条工具调用单独一个卡片,包含工具名、输入参数摘要、输出状态和执行耗时。点击卡片可以展开完整详情。
- 右侧上下文面板 :展示当前 Session 的完整上下文信息,包括模型名称、关键参数、临时变量、当前工作目录、最近变更的文件列表。任务运行过程中,这个面板会实时刷新。
这种布局的好处是:你想看“现在跑到哪一步了”就看中间,想知道“它还记得什么”就看右边,想切换任务就看左边,各归其位,一个屏幕内完成所有操作。
底部的输入区也做了改动。命令输入框、常用工具快捷按钮、任务控制按钮(暂停/继续/中断)都放在同一行,位置固定,不需要滚动就能触达。实际上我后来发现在终端和浏览器两套界面里,这套交互模型保持一致,这应该是 v0.1.2 在架构层面做了统一设计,对我的使用体验提升非常明显。
2.3 一套界面逻辑同时覆盖终端和浏览器
这里延伸一下技术实现层面的思考。BitFun 本身是终端优先的工具,但 v0.1.2 开始同时提供浏览器界面。如果两套界面分别维护,工作量翻倍不说,交互细节还容易漂移。
这次重构采用的思路是:核心视图模型完全复用,渲染层分开。终端界面用类 TUI 的方式渲染,支持键盘快捷键操作;浏览器界面通过 WebSocket 接收同样的视图状态,用 Web 组件渲染。逻辑层只产生一份“界面状态描述”,渲染层拿到这份描述之后按自己的方式画出来。这意味着你在浏览器里能看到的操作按钮、状态标签、信息条目,终端版里同样全都有,只是呈现形式不同。
这种方案带来的额外好处是性能更好。旧版 UI 卡顿的一个重要原因是渲染层做了太多不必要的工作,每次状态变化都全量刷整个界面。新版的视图模型带上了细粒度的更新标记,哪个区域变了就只刷新哪个区域,跑长任务的时候输入框不再打顿,日志滚动也顺了很多。
3. 远程 Session 控制:核心机制拆解
3.1 Session 到底在“管”什么
Session 这个概念听起来抽象,但对 AI 开发助手来说,它就是“工作台账”。一个 Session 里至少包含了这样几类信息:
- 对话历史 :你和助手之间所有的消息往来,包括你给的任务描述、助手返回的文字。
- 工具调用记录 :助手每次调用工具的参数、结果、耗时。这是排查问题最重要的依据。
- 临时状态 :agent 运行过程中产生的中间变量、当前思考内容、执行计划等。
- 文件变更清单 :哪些文件被创建、修改、删除,改了什么内容。复杂任务往往涉及多个文件,没有这个清单基本没法做代码审查。
- 任务队列 :当前正在执行的任务和排队中的任务。
以前的版本里,这些数据散落在本地进程的内存和临时文件里,进程一退出,基本就没了。v0.1.2 把 Session 从“进程内的临时状态”升级成了“可持久化、可寻址、可远程接入的一等公民”。这个改动比单纯的界面优化重要得多,它决定了整个远程控制能力的根基。
3.2 几种远程控制方案的取舍
做远程 Session 控制,摆在面前的方案其实有好几条路,我参考公开的技术资料和个人使用经验,给你做个对比:
| 方案 | 优点 | 缺点 | 适用场景 |
|---|---|---|---|
| 直接 SSH 转发 | 零额外组件,成熟稳定 | 需要目标机器开放 SSH,配置复杂,移动端基本没法用 | 技术能力强、且只在自己机器间切换的用户 |
| 独立中控服务(自建) | 能力边界清晰,可扩展 | 部署运维成本高,需要一台常驻服务器 | 多人团队或对可用性要求极高的场景 |
| 内置 Session Broker | 开箱即用,与产品深度集成 | 需要信任工具的会话转发链路 | 个人使用、小团队协作 |
BitFun v0.1.2 选择的是第三种,内置一个轻量的 Session Broker。这个 Broker 可以跑在本地局域网内的任何一台机器上,也可以跑在一台有公网 IP 的云主机上,甚至跑在自己家里的 NAS 里也行。它的职责是转发 Session 数据,不做具体计算,因此资源开销非常低,我用一台配置很低的小主机实测过,内存占用稳定在几十 MB 这个量级。
3.3 Session Broker 的工作流程
有了 Broker,整个远程控制的链路就清晰了。
第一步,本地 Agent 启动后会主动连接配置好的 Broker 地址,并把本机可用的 Session 元信息注册上去。这一步相当于告诉 Broker:“我有一个这样的会话,欢迎来接”。
第二步,当你在另一台设备上打开 BitFun,并输入 attach 命令时,客户端向 Broker 请求目标 Session。Broker 校验权限之后,建立一条消息通道,把当前 Session 的快照数据一次性下发给客户端。
第三步,也是最关键的一步,是增量同步。从快照加载完成之后,双方不再同步整个 Session,而是同步事件流。比如 agent 调用了一次工具,本地就把一条“工具调用开始”事件推给 Broker,Broker 再转给所有已接入该 Session 的客户端。新的事件追加到客户端本地状态里,界面实时更新。
最后是断线恢复。如果网络抖动导致连接断开,Session 本身的数据一直在 Agent 侧保存,不会丢。客户端重连成功后,Broker 会把断开期间累积的事件补推过来,界面自动追平。
整个流程里我最欣赏的一点是,Session 的数据主权始终在运行 Agent 的那台机器手里,Broker 只做转发和缓存,不接管、不存储完整上下文。这就短期内避免了“助手的工作记录被第三方服务器留存”的疑虑,也把很多团队的合规顾虑降下来了不少。
4. 实操记录:从安装到远程接入的全流程
4.1 安装 v0.1.2
如果你已经装过旧版,升级很简单。通过包管理器直接拉新版本就行:
# 如果通过 homebrew 安装
brew upgrade bitfun
# 如果通过脚本安装
curl -fsSL https://bitfun.dev/install.sh | bash
装完之后确认一下版本号:
bitfun --version
# 输出类似 bitfun v0.1.2
如果是全新安装,跑一次
bitfun setup
,它会引导你配置模型接口、工作目录和 Session 存储位置。我个人建议 Session 存储路径不要用默认的临时目录,放到一个固定的数据盘,比如
~/bitfun-data/sessions
,这样就算重装系统,老会话也能找回来。
4.2 首次启动与本地 Session 托管
启动 BitFun 之后,在交互界面里输入:
/start 帮我分析当前仓库的测试覆盖率,并给出优化建议
这条指令会创建一个新的 Session。看到提示符变成了类似
[session: a3f8c2]
的样子,说明已经进入了一个可托管的会话上下文。
这时候你可以打开另一个终端窗口,输入:
bitfun session list
应该能看到类似这样的输出:
ID STATUS CREATED LAST ACTIVE TASK
a3f8c2 running 2025-06-15 10:23:11 2025-06-15 10:24:05 分析测试覆盖率
看到任务进入 running 状态,说明这个 Session 已经被 Agent 接管,你关闭交互界面也不会打断任务执行。这里有个细节要提醒:任务一旦被 Agent 接管,它会在后台继续运行,哪怕你 Ctrl+C 退出客户端,任务本身不会死。如果你确实想停掉一个任务,需要显式执行
/cancel
。我第一次用的时候不知道这一点,退出了客户端,回来发现任务早跑完了,倒是误打误撞体验了一把“本地异步任务”。
4.3 从另一台设备接入同一个 Session
现在到了重头戏。假设你人在外面,带了笔记本,想接上家里台式机上正在跑的任务。
首先保证两边连的是同一个 Broker。在 Agent 所在机器上配置 Broker:
bitfun broker config set --address tcp://broker.example.com:7391
bitfun broker start
然后在笔记本上也配置好同样的 Broker 地址,再列出远程可用的会话:
bitfun session list --remote
你会看到家里那台机器的会话出现在列表里。接着执行:
bitfun attach a3f8c2
几秒钟之内,笔记本地界面就会加载出完整的会话快照。任务当前执行到哪一步、已经调用了哪些工具、输出了什么内容,全部同步过来。如果 agent 正在运行,你能在界面上看到实时的工具调用日志滚动。
接入之后,不只能看,还能发指令。比如我中途发现任务方向偏了,直接输入:
/ask 当前分析到哪一步了?先不要继续,等我看下 diff 再做决定
这条消息通过 Broker 传到运行 Agent 的机器,agent 会暂停当前动作,等待你的进一步指令。这种“远端介入”能力是我日常使用频率最高的功能,相当于给远程控制增加了一个完整的双向交互入口。
4.4 多设备同时观察与权限控制
有一说一,多设备同时接入同一个 Session 的场景在新版本里也被考虑到了。官方设计支持多个客户端同时 attach 一个 Session,每个客户端看到的事件流是一样的。这意味着你可以让同事一起看同一个任务的状态,或者自己在手机、平板上同时开着监控页面。
但这里有个必须注意的点:权限控制。v0.1.2 默认只有 Session 创建者有权 attach,其他人的接入需要在目标 Session 里显式授权:
/allow @colleague
这条命令会生成一个一次性授权码,对方凭码接入。不授权的设备即使知道 Session ID 也无法访问。用的时候要清楚,远程控制是便利,权限收敛是底线,尤其是把 Broker 暴露到公网的时候,别偷懒省掉授权步骤。
5. 常见问题与排查技巧实录
5.1 attach 提示 session not found
这个是我测出来出现频率最高的问题。执行 attach 之后,客户端报 session not found。大部分情况下不是 Session 不存在,而是 Broker 没拿到这个 Session 的注册信息。
排查思路按顺序走:
-
确认 Agent 机器上的 Broker 是否真的在运行,
bitfun broker status看状态。 -
确认 Agent 所在机器的 BitFun 是否连上了 Broker,
bitfun session list --remote能不能列出本机会话。列不出来,说明注册环节出了问题,重点检查 Broker 地址配置。 -
如果地址配的是内网 IP,从外部设备访问的时候要确保网络路由可达。我用的时候踩过坑,本地配的是
127.0.0.1,导致远端永远找不到 Session。正确做法是配置成局域网或者公网可达的地址。
5.2 远程界面卡顿、日志刷新不及时
远程接入后界面卡顿,多半不是网络带宽问题,而是事件推得太密。agent 在快速执行多个短命令的时候,会在很短的时间内产生大量事件。BitFun 的 Broker 默认有一个限流机制,超过阈值的事件会合并批量推送,如果客户端跟不上就容易感觉“卡”。
实际处理办法有两个,二选一或者同时用:
# 调低事件推送频率上限,降低界面刷新压力
bitfun attach --max-events-per-second 20
# 或者只订阅核心事件,过滤掉命令输出这种高频噪音
bitfun attach --events task,message,core
我一般情况下会直接用
--events
过滤,只看任务状态和对话消息,命令输出的细节需要时再展开。这样既保住了界面流畅度,也不丢失关键信息。
5.3 断线重连之后状态不对
有个比较隐蔽的问题:客户端在断线期间,Agent 侧可能已经完成了大量工作,重连后界面上的“当前状态”和“最近变更文件清单”会出现一瞬间的不一致。这不一定是 bug,可能是全量快照和增量事件之间的时间差。
遇到这种情况,先不要急着操作。等界面顶部的状态指示变成“已同步”,再执行以下命令强制刷新一次上下文面板:
/refresh
这条命令会向 Agent 侧请求一次最新的上下文快照,把文件变更、任务状态、临时变量全部重新拉一遍。实测下来,90% 以上的不一致问题都能通过
/refresh
解决。如果刷新之后仍有异常,再检查 Agent 侧日志,重点看重连之后是否重新推了快照。
5.4 后台任务导致 CPU 占用偏高
远程 Session 带来的一个直接变化是,任务不再依赖某个终端窗口挂着。很多人把任务丢后台之后就不管了,结果发现电脑风扇一直在转。这里要区分一下:agent 在正常工作的时候 CPU 占用高是正常的,毕竟它要跑模型推理、工具调用、文件读写。
但如果任务已经结束、界面上显示 idle,CPU 却还是高,那多半是 Broker 或者 UI 渲染层在空转。这时候跑一下
bitfun doctor
自检,它会给出可疑进程和资源占用报告。就我的经验,v0.1.2 里如果是长时间不操作导致的“假死”,重启客户端进程就能恢复正常,不影响到任务数据本身。
5.5 排查问题时的实用技巧
-
日志是第一突破口
。BitFun 的日志目录通常在
~/bitfun-data/logs/,遇到任何疑难杂症,先看broker.log,再对照agent.log,两边的时序一对,问题基本能定位。 - 不要迷信 IP 直连 。跨网络环境下,Broker 地址用域名或者固定的 Node ID 比用动态 IP 稳得多,省去每次都改配置的麻烦。
- 养成“任务即会话”的习惯 。每个独立的开发任务都创建独立的 Session,不要所有事情堆在一个会话里,否则远程接入的时候根本分不清哪段内容是哪个任务的。我后来强制自己一个任务一个 session,排查问题的效率高了很多。
6. 版本使用感受与后续期待
从 v0.1.0 到 v0.1.2,我算是看着 BitFun 一点点变顺手的。v0.1.2 这版最大的进步在于,它把“本地 AI 助手”从开发机的附属品变成了一个可以独立运行、随时遥控的服务。我现在常用的一个工作流是这样的:早上在家把一天的代码改动计划写成任务丢给 BitFun,让它跑在台式机上;到了公司用笔记本
attach
进去看进度,有偏差就远程介入纠正;晚上回家再接管收尾。整个流程里没有任何一刻需要我守在某一台机器前,这种自由度在之前是想都不敢想的。
当然,这版也不是没有缺。远程 Session 控制的权限模型还比较基础,遇到团队场景需要更细粒度的角色划分;Broker 本身目前没有内置鉴权加密,公网部署的话需要自己套一层隧道或者防火墙,希望后面版本能补上内置加密。另外,移动端的阅读体验虽然做到了基本可用,但触屏操作还有优化空间,发指令、看 diff 在手机上始终不如电脑顺手。
最后分享一个小经验:如果你真的打算把 BitFun 当“随身助手”用,建议单独弄一台功耗低的小主机作为常驻执行端,笔记本和手机只做控制端。这样不管你在哪里,家里的执行端都能稳定跑任务,成本不高,体验却比任何软件层面的优化都管用。v0.1.2 的远程 Session 控制,就是让这套玩法成为可能的那块最后拼图。
480



被折叠的 条评论
为什么被折叠?



