omp²

工具不是壳,
是调过的作业面。

31 个内置工具,各自按真实会话反复校准。下面按“改代码—懂代码—跑代码—协作—记忆—联网—收尾”的顺序拆开。

默认开启核心集小众工具走 xd:// 设备可用 --tools 精确裁剪

01编辑:按锚点改,不重抄

edit 使用内容哈希锚点(hashline):模型只指向要改的行,补丁不再依赖逐字复述上下文。锚点与磁盘不一致时,补丁在写盘前被拒绝,不会悄悄改错位置。

  • 结构化改写交给 ast_edit,基于 ast-grep,先返回替换计数与预览,再由 xd://resolve 触发原子应用
  • ast_grep 用 50+ 种 tree-sitter 语法做结构查询,而不是正则碰运气
  • 官方基准称:同一任务下 Grok 4 Fast 输出 token 减少 61%,Gemini 3 Flash 较 str_replace 提升约 5 个百分点
hashline patchstale-safe
@@ src/auth/session.ts
# 锚点 = 内容哈希,不是行号
-  if (token == expected) {
+  if (timingSafeEqual(token, expected)) {
     return true;
   }

文件已被他人改动 → 锚点漂移 → 拒绝应用,并要求重新读取。多文件改动失败时整体不落盘。

02代码智能:LSP 与真实调试器

写操作与语言服务器联动。重命名走 workspace/willRenameFiles,barrel 文件、再导出、别名导入会在文件移动前同步更新;诊断、符号、代码操作、原始请求都可直接调用。

  • 14 类 LSP 操作:诊断、定义、引用、实现、悬停、符号、重命名、代码操作等
  • 28 类 DAP 操作:断点、单步、线程、调用栈、作用域、变量、求值
  • 调试适配器覆盖 lldb-dap、dlv、debugpy、vscode-js-debug 等;C 段错误、Go 卡死、Python 挂起都能现场下断
rename 是语义操作LSP 14 ops
# 不是全文替换
lsp rename
  file: src/auth/session.ts
  position: compareToken
  newName: timingSafeEqual

# 结果
✓ 3 files changed
✓ 2 barrel re-exports updated
✓ tsc diagnostics clean

这些能力随会话工具暴露,无需在编辑器里另开窗口。

03读取与搜索:一个路径走天下

read 是统一入口:文件、目录、压缩包、SQLite、PDF、笔记本、网页、ssh:// 远端路径,以及 pr://、issue://、agent://、skill:// 等内部 scheme 都返回同一种结构。

  • read pr://1428 与 read src/foo.ts 形状一致;grep 可以像遍历目录一样遍历 diff
  • agent://<id>/findings.0.path 按路径取出子代理输出中的字段
  • 读取默认返回摘要式片段,而不是整文件倾倒;grep/glob 由进程内 Rust 实现
统一寻址one path
read  src/router.ts
read  ./fixtures.tar.gz:raw:2-4
read  data/app.sqlite#users
read  https://arxiv.org/pdf/2604.10739v1
read  pr://1428
read  conflict://3

GitHub 被当作文件系统,而不是一堆需要模型学习参数的专用工具。

04运行时:进程内的原生执行

别的 harness 把工作外包给 rg、grep、find、bash;omp 把这些实现链进进程。搜索、glob、PTY、AST、截图、图片解码、BPE 计数都在 libuv 线程池上跑,热路径没有 fork/exec。

  • 自带 bash 5.3 引擎,会话跨调用保留;58+ 个命令行工具(coreutils、findutils、sed、jq、diff……)编译进 shell
  • eval 提供持久 Python 与 Bun 内核,两个内核都能通过 loopback 回调 agent 的 read、grep、task
  • 支持 PTY 交互(sudo、ssh),长任务可转入后台并用 proc:// 管理
6 个 Rust crate~80k LoC
pi-shell     bash 5.3 引擎 · 持久会话
pi-walker    并行遍历 · glob · 内容搜索
pi-natives   grep · PTY · 桌面 · 截图
pi-ast       tree-sitter · ast-grep
pi-iso       APFS/btrfs/ZFS/overlay 隔离
pi-voice      音频采集 · Opus · WebRTC

平台:linux-x64/arm64、darwin-x64/arm64、win32-x64/arm64;x64 同时提供 AVX2 与 baseline。

05协作:子代理、第二双眼睛

task 把工作拆给并行 worker。需要时每个 worker 在隔离工作树里运行,拥有自己的工具面,最后以 schema 校验过的对象 yield 给父会话——没有要解析的长篇散文,也没有兄弟代理之间的写冲突。

  • Alt+A 打开 Agent Hub:查看每个子代理的实时转录、成本与耗时,发消息纠偏、唤醒或终止
  • wait 阻塞到下一个后台结果、同伴消息或中断;agent:// 负责点对点通信
  • --advisor 用独立上下文与模型逐轮旁听,注入提醒或阻断意见
fan-out → typed yieldisolated
task [
  { name: "Tests",  isolation: worktree },
  { name: "Types",  isolation: worktree },
  { name: "Review", isolation: worktree }
]
→ { findings: [...], verdict: "ship" }
  schema validated · no merge conflicts

父会话直接读字段,例如 agent://tests/findings.0.path。

06记忆:项目级的长期上下文

代理在会话中主动整理记忆,而不是把整段历史硬塞进下一次提示。retain 记录事实,learn 沉淀可复用经验,recall 检索原始记忆,reflect 在记忆库上综合答案。

  • 后端可选 local、Hindsight 或 Mnemopi(本地 SQLite),由 memory.backend 决定
  • 默认按项目隔离:在这个仓库学到的东西留在这个仓库
  • 会话结束时压缩成心理模型,下一次首轮加载;也可把经验提升为受管技能
memory toolsproject scoped
retain  "部署走 pnpm dlx wrangler"
learn   "这个仓库的测试必须串行"
recall  "鉴权中间件"
reflect "为什么 v2 迁移被回滚?"
memory_edit  id=mem_42 action=forget

记忆工具按后端开关启用,默认不是全部常驻在提示里。

07浏览器、桌面与网络

eval 里的 browser 返回真实标签页句柄:导航、检查、交互、执行自定义 JS。默认启动隔离 Chromium,也可通过 relay 接管你已打开的 Chrome 标签而不抢焦点。

  • computer 操作宿主机:枚举窗口/显示器、截图、原生输入、无障碍树、剪贴板
  • web_search 内置 25 个后端,auto 按链回退;GitHub、npm、arXiv、Stack Overflow、文档站转为结构化 Markdown
  • generate_image 接 Gemini / GPT / Grok 图像模型,tts 接 Grok Voice
eval preludereal tabs
const tab = await browser.open("https://omp.sh");
await tab.click("text=Install");
const text = await tab.text("main");
await tab.screenshot("./omp.png");

const win = computer.window("Terminal");
await win.screenshot();

浏览器与桌面能力走 Eval 设备,不占用常驻工具位。

08会话、审查与收尾

会话是持久对象:继续、恢复、派生、导出 HTML、加密分享,或将整场直播通过 relay 交给队友(/collab,Web 端 my.omp.sh)。崩溃后用 --restore 连中断的子代理一起接着跑。

  • /review 派出多个审查子代理,按 P0–P3 分级并给置信度,最后给明确结论
  • omp commit 依据 git_overview / git_hunk 拆分原子提交,拒绝依赖环,锁文件不参与分析
  • conflict://N 把合并冲突变成一个 URL,写 @ours / @theirs / @base 即解决
session opspersistent
omp --continue
omp --resume <id-prefix>
omp --restore <session.jsonl>
omp --fork <session>
omp --export <session>   # → HTML
/share                   # 加密链接
/collab view             # 只读直播

护栏同样在会话层:审批模式、--max-cost、--max-time、--warn-cost。

Tool map

按场景找工具。

核心工具与 read、bash 同处一个命名空间;不常用的能力藏在 xd:// 设备后,按需发现。

场景工具要点
文件与搜索read write edit ast_edit ast_grep grep glob统一寻址;哈希锚点补丁;结构查询
运行时bash eval持久内核;前台/后台任务;PTY
代码智能lsp debug security_scan语义导航与重命名;真实断点调试
协作task wait todo ask并行 fan-out;阶段化清单;中途表单确认
桌面与网络browser computer web_search github generate_image ttsEval 驱动;25 个搜索后端;GitHub CLI
记忆与技能retain recall reflect memory_edit learn manage_skill项目级记忆;经验提升为技能
上下文管理checkpoint rewind标记状态;折叠探索过程只留报告

部分工具(github、security_scan、generate_image、tts、checkpoint、rewind 及记忆类)默认关闭,需在设置中启用。