Bot Crossing 操作全清单:14 个快捷键、Google Earth 式相机与点击交互一次学会

原创2026-10-25 16:46:001,328 阅读

Bot Crossing 操作全清单:14 个快捷键、Google Earth 式相机与点击交互一次学会

Bot Crossing(bot-crossing)把本机每一条 AI 编程会话(Claude Code、Codex、Cursor 等 harness)变成殖民地里的一个小机器人:它们走出飞船、认领仓库地块、盖楼干活。想看懂这场"机器人小镇",只需掌握本文这套 Bot Crossing 快捷键全清单与相机操作指南——鼠标、触摸板、键盘三种方式全覆盖,几分钟上手。

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 分钟,期间仍可自由拖、倾、缩

Bot Crossing 相机特写:机器人面罩中的天空与建筑反射

几个容易忽略的小技巧:

  • 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(点击机器人 = 顺带选中它脚下那块地):

  1. 点机器人 → 弹出一张跟随该 bot 移动的线程卡片:头像、标题、worktree、分支、模型、最近活动、建筑进度,卡片永远停在它身边(右侧优先,放不下自动翻到左侧)。
  2. 点地块甲板或头顶名牌 → 打开该仓库的侧栏。
  3. 点侧栏列表里的仓库 → 同样打开仓库面板,并高亮列表项。
  4. 点空地 → 取消选中、关闭仓库面板。

选中仓库后面板提供 New conversation(C)、Finder 打开文件夹、Copy path;选中线程后卡片上有 Open、Viewed(V)、Archive,仓库级还有 Hide——把整个仓库从地图上收起(线程原封不动,之后从侧栏底部的列表恢复,落回原地块)。

点击命中检测在 src/agents/picking.js 与 src/main.js;还有一个细节:名牌即使处于淡出状态也能点中——"指着一个安静项目的名字应该在的位置"正是让它浮现的方式。

🤖 先读懂 bot 的状态,再决定点什么

机器人头顶的徽章是唯一的"信息优先级",只有真正需要你(或值得注意)的状态才亮符号:

徽章 状态 bot 的动作
? 等你回复 停下原地举手
! 最近 3 天内报错 垂头、红眼、故障灯闪烁
⚒ 正在运行 抡锤建造、火星四溅
✓ PR 已合并 跳跃 + 彩带 + 爱心眼
z 3 天无动静 坐下睡觉

Bot Crossing 机器人提示表情:面罩上的惊讶表情

配合快捷键 N(飞到下一个等你处理的 bot)就是最高效的巡检路线:看到 ? → 按 N 逐个飞过去 → 点 ? 徽章或 bot → 卡片里按 Enter 打开 → 回来按 V 收手。一个都不漏。

Bot Crossing 机器人表情设计稿:16 种面罩表情一览

⚙️ 进阶:设置里的画质与视角开关

按 S 打开设置,五个预设档(Potato → Ultra)之下每个旋钮都可单独调,动过的项会有小圆点标记。除了渲染比例(最大性能杠杆)和自适应画质,还有几个与操作体验直接相关的:

  • View → Return to isometric:松手后自动归位到等轴测角度;
  • Look 分组:世界弯曲、积云、调色——"动物森友会式"的观感开关;
  • Hide dormant repos:默认折叠全部静默超过 3 天的仓库,地图更清爽。

Bot Crossing 建筑环境光遮蔽对比:关闭与 25% 强度

另外 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 殖民地就是你的了 🛸

登录后查看全文
bot-crossing