把 Herdr 的 agent
装进口袋。
Bellterm 是 Herdr 的原生 Android 客户端。通过 SSH 访问工作区、标签页和窗格,agent 需要你时回应一下,然后放下手机。所有程序都在主机上继续运行。
手机只是一扇窗,会话由 Herdr 掌管。
Bellterm 不运行你的终端。它像桌面客户端一样连接到你机器上的 Herdr 守护进程,把 Herdr 发来的画面画出来。信号断了、锁屏了、关掉 App 都没关系:窗格和 agent 照常运行,回来时接着看就行。
Bellterm
用 libghostty-vt 绘制 Herdr 的窗格,发送你的按键和触摸,并把守护进程的 agent 提醒转成 Android 通知。
SSH,需要时经过跳板机
herdr remote-client-bridge
你的机器
运行 Herdr 守护进程,保存你的工作区、标签页、窗格和 agent。Bellterm 不会在上面安装、启动或升级任何东西。
在手机上做你在 Herdr 里做的事。
按 Herdr 的布局原样显示,再配上手机需要的操作。
Agent
- 侧边栏里显示每个 agent 的状态:工作中、需要输入、已完成、空闲。
- App 在后台时,agent 需要你或任务完成会弹出通知。
- 点一下 agent,直接跳到它的窗格。
- 工作区显示分支、领先和落后的提交数,以及 worktree。
终端
- libghostty-vt 负责字形簇、宽字符和颜色。
- 扩展按键行:Esc、Tab、可锁定的 Ctrl 和 Alt,以及按住连发的方向键。
- 中文输入直接在光标处组字,也支持实体键盘。
- Nerd Font 图标、十套配色、双指缩放、长按复制。
SSH
- 跳板机可以像
ssh -J一样串联,每一跳的主机密钥都会核对。 - 密钥与证书:在手机上生成 Ed25519 密钥,或导入 RSA、ECDSA、Ed25519 密钥。
- 导入 ~/.ssh/config:每个 Host 成为一个节点,ProxyJump 也会导入。
- 密钥和密码用 Android Keystore 中的密钥加密保存。
开始使用
你需要一台能通过 SSH 访问、装有 Herdr 0.9.0 或更新版本的机器。
-
安装 Bellterm
在手机上下载 APK 并打开安装。首次启动时,Bellterm 会为这台设备生成一把 Ed25519 密钥。
-
授权手机的密钥
在“密钥与证书”中复制公钥,添加到主机上。也可以改用你的 SSH CA 为它签发证书。
echo 'ssh-ed25519 AAAA… bellterm@Pixel7' >> ~/.ssh/authorized_keys
-
添加节点并连接
把主机添加为节点,或导入你的 SSH 配置。第一次连接时请核对主机密钥指纹。如果这个会话还没有运行 Herdr 服务,在主机上运行
herdr启动一个。
系统要求
- 手机
- Android 10(API 29)或更新版本,arm64 或 x86_64。
- 主机
- Herdr 0.9.0 或更新版本,以及
/bin/sh。不支持只提供 PowerShell 的 Windows 主机。 - 跳板机
- 允许 TCP 转发的 SSH 即可,不需要别的。