Limbo 最早是 Python 写的,后来整体用 Rust 重写,现在仓库里只有 Rust 版。重写的另一个目的是学 Rust。所以代码里有不少面向学习者的注释,会解释所有权、async、trait 对象这类概念在这里为什么这样用。
cargo run --release # 打开 TUI
cargo run --release -- -c # 继续当前目录最近的会话
cargo run --release -- -r <id> # 恢复指定会话(id 可以只写前缀)
cargo run --release -- -p "解释一下 src/agent.rs" # 只跑一轮,把回答打印出来
cargo run --release -- --headless # 纯文本 REPL(加 --json 输出事件流)
cargo run --release -- daily # daily 模式(非编码助手,在 [daily] workdir 里),等同 --daily
cargo run --release -- models [词] # 列出可用模型(可按名字过滤)
cargo run --release -- auth login [提供商] # 保存 API key 到 ~/.limbo/auth.json(auth list / auth logout)
cargo run --release -- sessions # 列出当前目录的会话(--all 列出全部)
cargo test # 跑测试需要 Rust 1.88 以上(edition 2024)。grep 工具依赖系统里装好的 rg(ripgrep)。
第一次运行时如果找不到任何 API key,会直接在终端里提示粘贴一个(输入不回显,先联网验证再保存)。
| 按键 | 作用 |
|---|---|
| Enter / Shift+Enter(或 Ctrl+J) | 发送 / 换行 |
| Alt+Enter | 排进队列,当前任务完成后再发(follow-up) |
| Ctrl+V / Ctrl+Y | 从剪贴板粘贴(图片、文件路径或文本)/ 复制最后一条回复 |
| 鼠标拖动 | 选中文字,松开即复制到剪贴板(终端原生选择:按住 Shift 拖动,或 /mouse 关闭鼠标捕获) |
| Ctrl+G | 子代理面板(任务板 + 选中任务的记录) |
| Esc、Ctrl+C | 打断当前回合;空闲时连按两次 Ctrl+C 退出(有选中文字时 Ctrl+C 改为复制) |
| Super+C / Ctrl+Shift+C | 复制鼠标选中的文字(Super+V / Ctrl+Shift+V 粘贴);Super 组合键不会再被当成 Ctrl |
| agent 忙时按 Enter | 把消息排进队列,作为“插话”发给 agent |
| ↑ / ↓ | 翻输入历史 |
| PageUp / PageDown、Ctrl+↑/↓ | 滚动对话 |
| Shift+Tab | 切换思考强度 |
| Ctrl+O / Ctrl+T | 展开或折叠工具输出 / 显示或隐藏思考过程 |
| Ctrl+R | 会话列表 |
/ |
命令面板:/model /thinking /plan /goal /queue /code-mode /daily-mode /memory /learn /btw /agents /task /tracing-viewer /copy /2048 /compact /fork /handoff /sessions /export /theme /mouse /new … |
在 /model 里选一个还没有 key 的模型,会弹出登录框,粘贴 key 后验证、保存、再切换。最近用过的模型排在最前面;Shift+Tab 调的思考强度会写回配置。
主题有 neon、aurora、ember、dawn(daily 模式默认)和 omarchy(跟随 Omarchy 桌面主题),用 /theme 切换,或者在配置里写 [ui] theme = "aurora"。动效可以用 [ui] motion = "full" | "reduced" | "off" 调整(通过 SSH 连接时默认是 reduced)。
| 文件 | 内容 | 能学到的 Rust 知识 |
|---|---|---|
src/models.rs |
消息、工具调用这些数据类型 | serde 派生、enum、Option |
src/config.rs、auth.rs |
读取 ~/.limbo/config.toml |
错误处理、toml_edit 保留注释改写 |
src/llm/ |
三种 LLM 协议,以及共用的 SSE 解析 | trait 对象 Box<dyn Decoder>、mpsc 通道、流 |
src/tools/ |
bash/read/write/edit/ls/find/grep | #[async_trait]、Arc<dyn Tool>、tokio::select!、进程组 |
src/session.rs、history.rs |
JSONL 日志、崩溃恢复 | #[serde(flatten)] 保留未知字段、原子写文件 |
src/agent.rs |
agent 主循环 | 把 Agent move 进任务再通过 JoinHandle 取回所有权 |
src/pump.rs、goal.rs |
一次任务的外层循环:/goal 验收闭环、follow-up 队列 |
用 &mut Agent 串起多轮,async 函数里的早退出 |
src/subagents/ |
子代理任务板:计划、依赖、优先级、worktree、通知 | Arc::new_cyclic + Weak 自引用、Mutex 里的共享状态、宏生成工具 |
src/learn.rs、memory.rs、skills.rs |
daily 模式的记忆和自动复盘 | 正则 + OnceLock 懒初始化 |
src/trace_viewer.rs |
/tracing-viewer:本机 HTTP 服务 + 浏览器页面 |
只用 std::net 和线程写一个小 HTTP 服务 |
src/integrations.rs |
Herdr、OSC 7501 状态上报 | unsafe 调 libc、信号处理 |
src/tui/ |
ratatui 界面和 tachyonfx 动效 | 即时模式 UI、按条目缓存渲染、CJK 宽字符换行 |
- 配置、
auth.json和 JSONL 会话格式都和原来的 Python 版一致,~/.limbo里的旧数据可以直接用,旧会话也能--resume。 - 有一处有意的不同:
/goal第一轮验收失败后,Python 版提示“第 2 轮验收未通过”,Rust 版改成了正确的“第 1 轮”。