Bot Crossing 操作全清单:14 个快捷键、Google Earth 式相机与点击交互一次学会
Bot Crossing 操作全清单:14 个快捷键、Google Earth 式相机与点击交互一次学会
Bot Crossing(bot-crossing)把本机每一条 AI 编程会话(Claude Code、Codex、Cursor 等 harness)变成殖民地里的一个小机器人:它们走出飞船、认领仓库地块、盖楼干活。想看懂这场"机器人小镇",只需掌握本文这套 Bot Crossing 快捷键全清单与相机操作指南——鼠标、触摸板、键盘三种方式全覆盖,几分钟上手。
🚀 一分钟跑起来
先 clone 再启动(需要 Node 22.13 及以上):
git clone https://gitcode.com/gh_mirrors/bo/bot-crossing
cd bot-crossing
npm install && npm run dev
npm run dev 就是全部:API 内嵌在 Vite 开发服务器里,浏览器打开后殖民地就会扫描你本机各 harness 的会话,每个线程变成一个 bot。它只读 harness 的本地文件、唯一写入的是 data/colony.json,从不上传任何东西。
🖱️ Google Earth 式相机:拖地面、右键倾斜、光标处缩放
Bot Crossing 的导航直接复刻了 Google Earth 的手感,连"地球感"的两个关键细节都在:抓地和缩放都以光标下的地面点为锚,拖 200px 抓取点误差不超过 0.00 个世界单位。
| 操作 | 效果 |
|---|---|
| 左键拖拽 | 抓取地面平移,光标下的点全程钉在原地 |
| 右键拖拽(或 ⌃ / ⇧ / 中键拖拽) | 倾斜与旋转视角,向上拖朝向地平线 |
| 滚轮 | 以光标位置(而非屏幕中心)缩放 |
| 双指捏合(触控板/手机) | 双指间锚定缩放,拖拽平移 |
方向键 / + − |
键盘平移与缩放 |
轨道模式(O 键或侧栏按钮) |
围绕中心缓慢环绕一圈约 2 分钟,期间仍可自由拖、倾、缩 |
几个容易忽略的小技巧:
0键一键复位视角——迷路了直接按0,相机回到初始机位并退出轨道模式。- 在 View → Return to isometric 里可开启"松手后自动回到最近的等轴测角度",位置与缩放绝不会被改动。
- 手机上侧栏变成底部抽屉:单指拖地、双指缩放,交互逻辑与桌面一致。
相机逻辑集中在 src/core/camera.js,想要"有分量的相机"感觉都出自这里。
⌨️ Bot Crossing 快捷键全清单:14 个键一次记牢
所有快捷键在 src/main.js 里处理,输入框聚焦时自动失效。按用途分三组:
🧭 查看与导航(8 个)
| 按键 | 功能 |
|---|---|
H 或 ⌘\ / Ctrl\ |
隐藏所有面板,只留纯殖民地画面(状态还在 bot 头顶) |
S |
打开/关闭设置 |
O |
轨道环绕模式 |
Tab |
切换下一个星球(共 12 个世界:月球、火星、雨林、雪原、火山……) |
L |
切换一天中的时间(昼夜循环可手动拨) |
M |
静音/取消静音 |
P |
截图 |
0 |
复位视角 |
🧵 线程操作(4 个,需先选中一个 bot)
| 按键 | 功能 |
|---|---|
Enter |
Open:把线程交还给所属 harness,应用自动切到前台 |
V |
Viewed:标记已查看,头顶的 ? 消失,它不再招手 |
A |
Archive:归档该线程,bot 走回坡道登上飞船(不写 harness 任何数据) |
C |
在选中的仓库目录下新开一个会话 |
🚪 退出与求助(2 个)
| 按键 | 功能 |
|---|---|
Esc |
逐级向外退出:先取消 bot 选中,再关闭仓库侧栏,一步一个层级 |
? |
呼出帮助面板(即快捷键速查表) |
👆 点击交互:四种点法都通往同一个仓库
界面只有一个右侧面板,其余信息都在场景里。以下四种点击方式都下钻到同一个 repo(点击机器人 = 顺带选中它脚下那块地):
- 点机器人 → 弹出一张跟随该 bot 移动的线程卡片:头像、标题、worktree、分支、模型、最近活动、建筑进度,卡片永远停在它身边(右侧优先,放不下自动翻到左侧)。
- 点地块甲板或头顶名牌 → 打开该仓库的侧栏。
- 点侧栏列表里的仓库 → 同样打开仓库面板,并高亮列表项。
- 点空地 → 取消选中、关闭仓库面板。
选中仓库后面板提供 New conversation(C)、Finder 打开文件夹、Copy path;选中线程后卡片上有 Open、Viewed(V)、Archive,仓库级还有 Hide——把整个仓库从地图上收起(线程原封不动,之后从侧栏底部的列表恢复,落回原地块)。
点击命中检测在 src/agents/picking.js 与 src/main.js;还有一个细节:名牌即使处于淡出状态也能点中——"指着一个安静项目的名字应该在的位置"正是让它浮现的方式。
🤖 先读懂 bot 的状态,再决定点什么
机器人头顶的徽章是唯一的"信息优先级",只有真正需要你(或值得注意)的状态才亮符号:
| 徽章 | 状态 | bot 的动作 |
|---|---|---|
? |
等你回复 | 停下原地举手 |
! |
最近 3 天内报错 | 垂头、红眼、故障灯闪烁 |
⚒ |
正在运行 | 抡锤建造、火星四溅 |
✓ |
PR 已合并 | 跳跃 + 彩带 + 爱心眼 |
z |
3 天无动静 | 坐下睡觉 |
配合快捷键 N(飞到下一个等你处理的 bot)就是最高效的巡检路线:看到 ? → 按 N 逐个飞过去 → 点 ? 徽章或 bot → 卡片里按 Enter 打开 → 回来按 V 收手。一个都不漏。
⚙️ 进阶:设置里的画质与视角开关
按 S 打开设置,五个预设档(Potato → Ultra)之下每个旋钮都可单独调,动过的项会有小圆点标记。除了渲染比例(最大性能杠杆)和自适应画质,还有几个与操作体验直接相关的:
- View → Return to isometric:松手后自动归位到等轴测角度;
- Look 分组:世界弯曲、积云、调色——"动物森友会式"的观感开关;
- Hide dormant repos:默认折叠全部静默超过 3 天的仓库,地图更清爽。
另外 data/colony.json 会记住你手动搬过的地块布局——地图是"粘性"的,学到的位置重载后依旧在原地。删掉它只会丢布局与归档列表,线程本身不受影响。
📚 相关源码索引
| 想了解 | 看这里 |
|---|---|
| 14 个快捷键的完整处理逻辑 | src/main.js |
| Google Earth 相机(锚点、捏合、轨道) | src/core/camera.js |
| 帮助面板与徽章图例 | src/ui/hud.js |
| 点击拾取 | src/agents/picking.js |
| 新增 harness 适配器的契约文档 | server/harnesses/README.md |
| 项目说明与完整设计细节 | README.md |
按 ? 随时呼出速查表,配合上面的鼠标操作习惯,一两次操作下来,这片 bot 殖民地就是你的了 🛸




