Oh My Pi(omp)命令速查
一、交互终端（TUI）：斜杠命令、快捷键、配置文件
1. 关键文件与目录地址
- 可执行程序：
/opt/homebrew/bin/omp（Homebrew 安装路径） - 全局配置目录：
~/.omp/agent/├── config.yml：全局核心配置文件（包含皮肤主题theme.dark/theme.light、思考级别、输入模式等）├── models.yml：自定义模型及 Provider 配置文件├── keybindings.yml：自定义快捷键映射文件（如覆盖默认热键）├── themes/：自定义皮肤主题目录（放置*.json皮肤文件，修改即时热重载）├── sessions/：持久化会话记录（所有对话历史的jsonl及 artifacts）├── commands/：用户级自定义斜杠命令（编写*.md模板文件即自动注册为/命令）├── history.db：输入历史与搜索 SQLite 数据库└── agent.db / models.db：状态机缓存与模型元数据数据库
- 项目级配置目录：
<当前项目根目录>/.omp/（优先于全局配置，可放置项目级config.yml和commands/） - 日志目录：
~/.omp/logs/
2. 常用交互斜杠命令（按功能分类）
2.1 皮肤与界面外观
| 命令 | 说明 |
|---|---|
/settings |
打开交互式设置面板，进入 Appearance 可即时预览并切换明暗皮肤主题（Dark Theme / Light Theme）。 |
/hotkeys |
在终端展示当前版本所有生效的键盘快捷键映射清单。 |
- 皮肤文件位于
~/.omp/agent/themes/<theme-name>.json - 配置文件对应项为
~/.omp/agent/config.yml中的theme.dark与theme.light
2.2 上下文压缩与清理 (Context & Compaction)
| 命令 | 说明 |
|---|---|
/compact [说明] |
手动触发上下文压缩，将早期对话压缩为关键总结并附带文件操作痕迹。 |
/compact soft |
强制使用当前对话模型在本地进行总结压缩。 |
/compact remote |
使用服务商原生服务端压缩接口（如 OpenAI Responses compact、Anthropic compaction beta）。 |
/compact snapcompact |
将旧历史无损渲染为稠密位图图片送入视觉模型，免 LLM 摘要调用且保留最大回忆度。 |
/shake |
快速剔除上下文中沉重的工具执行长输出和代码块，替换为可恢复的引用。 |
/handoff |
生成上下文交接文档并就地压缩，适合大型任务交接。 |
/context |
查看当前上下文窗口的 Token 占用分解与各部分比例。 |
/clear |
清空当前活跃模型的上下文（插入重置边界），但保留当前会话记录和文件标识。 |
/fresh |
仅重置服务商的传输与流式状态，不更改本地历史。 |
2.3 会话与历史记录管理 (History & Sessions)
| 命令 | 说明 |
|---|---|
/resume [id] |
查看并选择历史会话（不带参数直接弹出近期会话选择列表，支持模糊搜索）。 |
/tree |
分支树导航，可视化浏览当前会话的消息树分支，并可在不同分叉间回溯跳转。 |
/branch |
回溯到之前的某条消息，并基于该节点开辟新分支。 |
/fork |
分叉克隆当前会话为一个独立的全新会话。 |
/new |
新建并切换到一个全新的空白会话。 |
/delete |
删除当前保存的会话记录及工件，并自动创建新会话。 |
/dump [raw] |
将当前会话记录完整复制到系统剪贴板（同时在临时目录生成请求 JSON）。 |
/export [路径] |
将当前完整对话渲染导出为单文件 HTML 网页。 |
/rename [标题] |
重命名当前会话名称（留空则自动根据内容生成）。 |
/move <路径> |
将当前会话工作目录切换并迁移到指定目录。 |
/wt |
将当前会话及当前改动迁移到全新的 Git worktree 中。 |
2.4 模型与推理通道
| 命令 | 说明 |
|---|---|
/model |
打开模型选择器，快速切换当前会话所用的主模型。 |
/fast |
切换优先高吞吐服务通道（如 OpenAI priority / Anthropic fast）。 |
/slow |
切换慢速深度思考通道（或在到达限额后以低优先级继续）。 |
/plan |
开启/关闭架构规划模式（Agent 在写代码前必须先生成并确认执行计划）。 |
/plan-review |
重新打开最新计划的审查面板。 |
2.5 辅助与扩展协作
| 命令 | 说明 |
|---|---|
/btw <问题> |
上下文侧向提问。利用当前会话上下文发起一次性独立查询，不污染主会话历史。 |
/todo |
打开并管理 Agent 的任务执行清单（支持 /todo edit 用编辑器打开、/todo done 等）。 |
/collab |
开启局域网或 Relay 实时多人会话协同共享，生成终端与浏览器链接/二维码。 |
/marketplace |
打开插件市场浏览与安装扩展插件。 |
/skills |
检索、安装和更新 skills.omp.sh 技能（如 /skills search <query>）。 |
/mcp |
管理 MCP (Model Context Protocol) 外部服务连接。 |
/pause |
全局暂停当前所有主任务、子 Agent 及审查器的运行（按 Esc 或 Enter 恢复）。 |
3. 核心高频快捷键
| 快捷键 | 功能 |
|---|---|
Ctrl + R |
反向搜索提示词历史（在输入框中实时检索之前发过的指令） |
Up / Down |
向上/向下翻阅上一条输入记录（支持找回刚按 Ctrl+C 取消的草稿） |
Ctrl + P / Shift+Ctrl+P |
快速顺时针/逆时针轮换候选模型 |
Alt + M |
呼出模型选择浮层 |
Alt + Shift + P |
一键开关 Plan（规划）模式 |
Ctrl + O |
折叠 / 展开工具执行结果细节卡片 |
Ctrl + T |
隐藏 / 显示模型的思考过程（Thinking 模块） |
Shift + Tab |
循环切换思考深度（off → low → medium → high → max） |
Ctrl + G |
在外部系统编辑器（$EDITOR / $VISUAL）中编写当前提示词 |
Ctrl + Q 或 Ctrl + Enter |
在 Agent 执行期间排队追加后续指令（Follow-up） |
Alt + A |
打开 Agent Hub（多子代理 live 监控仪表盘） |
Ctrl + C |
第一次按清空输入框草稿；连续两次按退出程序 |
二、当前环境可调用工具与设备
1. 核心文件与代码操作
| 命令 | 功能说明 | 核心参数 / 用法注意 |
|---|---|---|
read |
读取文件与数据源；支持本地文件、目录列表、URL、压缩包内部、SQLite 表/行、多媒体元数据及内部 URI（agent://, history://, artifact://）。 |
path：路径支持语法切片（如 :50-100 行号范围、:raw 原始文本、archive.zip:sub/file）。默认展示代码声明，支持精准行号读取。 |
edit |
精准局部代码编辑；基于哈希锚点（Hashline 块标签 [FILE#TAG]）对现有文件进行微创级改动。 |
input：操作指令包含 PUT N.=M:（单/多行替换）、PUT <N: / PUT >N:（行前/后插入）、CUT N.=M（删除/剪切）、MV（重命名）、REM（删除）。禁止盲写行号，必须依赖最新 read 提供的快照哈希与行号。 |
write |
新建文件、全量覆盖或写入控制设备；创建新文件、完全重写现有文件，或向内部虚拟设备发送 JSON 指令。 | path：目标文件路径或 xd://<tool> 虚拟 URI。content：写入的文本内容或设备 JSON 参数。 |
2. 执行与运行时
| 命令 | 功能说明 | 核心参数 / 用法注意 |
|---|---|---|
bash |
执行 Shell 管道与系统命令；在持久化 shell 中运行真实二进制文件或简单命令管道。 | command：待执行命令（禁止用 sed/awk/python 单行替代编辑）。cwd：工作目录。timeout：超时时间（秒）。async：异步执行。ready / name：启动长驻服务监听指定端口或日志正则。 |
eval |
交互式代码运行内核；执行 Python (IPython) 或 JavaScript (Bun) 代码，内核状态跨调用持久化。 | language："py" 或 "js"。code：代码片段（顶层支持 await）。内置全局环境：文件读写 ( read/write)、浏览器自动化 (browser)、模型批处理 (judge/completion)。 |
3. 搜索与探索
| 命令 | 功能说明 | 核心参数 / 用法注意 |
|---|---|---|
glob |
匹配查找路径与文件名；基于通配符遍历工程目录树结构，代替 find/ls。 |
path：通配符路径（如 src/**/*.ts）。hidden：是否包含隐藏文件。gitignore：是否遵循忽略规则。 |
grep |
正则代码检索；基于 Rust/PCRE2 引擎在指定文件或全局目录中匹配文本。 | pattern：正则表达式（支持跨行匹配 \n）。path：检索范围（支持指定特定行段如 src/app.py:10-50）。case：是否大小写敏感。 |
4. 流程控制与多 Agent 协作
| 命令 | 功能说明 | 核心参数 / 用法注意 |
|---|---|---|
task |
并发分发子 Agent 任务；将复杂任务拆解，并行分发给专业子 Agent 处理。 | context：共享契约与目标。tasks[]：子任务列表。agent：子 Agent 类型，常用：- scout：只读代码库高速探测。- reviewer：代码审查与质量分析。- security-reviewer：安全审计与漏洞挖掘。- task：通用全功能 Agent。 |
wait |
挂起等待任务完成；当前无可执行任务时阻塞，等待后台 Job 产出或 Agent 消息返回。 | 无必填参数；等待首个结果到达即解除阻塞。 |
todo |
任务清单状态机管理；维护多步骤开发进度与依赖状态。 | op："init"（初始化）、"start"（开始）、"done"（完成）、"block"（阻塞）、"unblock"（解除）、"append"（追加）、"view"（查看）。 |
5. 交互与外部信息
| 命令 | 功能说明 | 核心参数 / 用法注意 |
|---|---|---|
ask |
向用户发起结构化提问；在出现重大技术分歧或需要确认不可逆决策时弹出选项。 | questions[]：问题列表，包含 question、options（标签及风险描述）、recommended（推荐项索引）、multi（多选支持）。 |
web_search |
网络实时检索；通过搜索引擎获取最新的外部文档、库规范或实时信息。 | query：检索关键词（支持 site:、filetype: 等高级语法）。recency：限制时间范围（day/week/month/year）。 |
6. xd:// 虚拟扩展设备（通过 write 调用）
| 设备 URI | 功能说明 |
|---|---|
xd://lsp |
语言服务器（LSP）调用：代码智能诊断、跳转定义 (definition)、查找引用 (references)、类型提示 (hover) 及重构修复 (codeAction)。 |
xd://ast_edit |
AST 语法树重构：执行结构感知的高阶代码重构与语法节点级编辑。 |
xd://debug |
调试协议（DAP）：与正在运行的程序交互，设置断点、单步执行、检查调用栈及变量。 |
xd://report_issue |
工具异常上报：工具返回行为与预期不符时记录异常报告。 |