lazycodex-ai 5.0.0 → 5.1.0

package/README.zh-cn.md

@@ -10,444 +10,123 @@
 > | [<img alt="OpenGateway" src="./.github/assets/opengateway-logo.svg" width="156px" />](https://opengateway.ai/) | **[OpenGateway](https://opengateway.ai/)** 赞助了 OmO。它是一个兼容 OpenAI 的网关,通过一个 API 即可使用多家模型提供商。感谢对开源的支持。 |
 > | :-----| :----- |
 
-> [!NOTE]
-> **正在进行多 Harness 代理操作系统重构**
->
-> 我们正在重构代码库以支持多个代理 harness（OpenCode、Codex、Pi、Claude Code 等）。如果您有兴趣贡献，请先阅读 [ROADMAP](./ROADMAP.md)。与 ROADMAP 相关的 PR 请使用 `ROADMAP` 标签。
-
 
 > [!NOTE]
 >
 > [![Sisyphus Labs - Meet Dori. Not a demo. Subscribes to everything.](./.github/assets/sisyphuslabs.png?v=4)](https://sisyphuslabs.ai)
-> > **OmO 由上述的 Jobdori 进行维护。认识你专属的 Jobdori — Dori。<br />[在此处](https://sisyphuslabs.ai)加入等待名单。**
+> > **OmO 由上述的 Jobdori 进行维护。认识你专属的 Jobdori, Dori。<br />[在此处](https://sisyphuslabs.ai)加入等待名单。**
 
 > [!TIP]
 > 加入我们！
 >
-> | [<img alt="Discord link" src="https://img.shields.io/discord/1452487457085063218?color=5865F2&label=discord&labelColor=black&logo=discord&logoColor=white&style=flat-square" width="156px" />](https://discord.gg/PUwSMR9XNk) | 加入我们的 [Discord 社区](https://discord.gg/PUwSMR9XNk)，与贡献者及其他 `oh-my-openagent` 用户交流。 |
+> | [<img alt="Discord link" src="https://img.shields.io/discord/1452487457085063218?color=5865F2&label=discord&labelColor=black&logo=discord&logoColor=white&style=flat-square" width="156px" />](https://discord.gg/PUwSMR9XNk) | 加入我们的 [Discord 社区](https://discord.gg/PUwSMR9XNk)，与贡献者及其他 OmO 用户交流。 |
 > | :-----| :----- |
-> | [<img alt="X link" src="https://img.shields.io/badge/Follow-%40justsisyphus-00CED1?style=flat-square&logo=x&labelColor=black" width="156px" />](https://x.com/justsisyphus) | 关于 `oh-my-openagent` 的更新过去发布在我的 X 账号上。<br /> 因为账号被意外停用，现在由 [@justsisyphus](https://x.com/justsisyphus) 代为发布更新。 |
+> | [<img alt="X link" src="https://img.shields.io/badge/Follow-%40justsisyphus-00CED1?style=flat-square&logo=x&labelColor=black" width="156px" />](https://x.com/justsisyphus) | 关于 OmO 的更新过去发布在我的 X 账号上。<br /> 因为账号被意外停用，现在由 [@justsisyphus](https://x.com/justsisyphus) 代为发布更新。 |
 > | [<img alt="GitHub Follow" src="https://img.shields.io/github/followers/code-yeongyu?style=flat-square&logo=github&labelColor=black&color=24292f" width="156px" />](https://github.com/code-yeongyu) | 在 GitHub 上关注 [@code-yeongyu](https://github.com/code-yeongyu) 获取更多项目信息。 |
 
 <!-- <CENTERED SECTION FOR GITHUB DISPLAY> -->
 
 <div align="center">
 
-<a href="https://github.com/code-yeongyu/oh-my-openagent#oh-my-openagent"><img src="./.github/assets/omo-icon-light.svg" alt="OmO" width="200" /></a>
-
-[![Oh My OpenAgent](./.github/assets/hero.jpg)](https://github.com/code-yeongyu/oh-my-openagent#oh-my-openagent)
+<a href="https://omo.dev"><img src="./.github/assets/omo-icon-light.svg" alt="OmO" width="200" /></a>
 
-[![Preview](./.github/assets/omo.png)](https://github.com/code-yeongyu/oh-my-openagent#oh-my-openagent)
+# OmO
 
-</div>
-
-> 这是 oh-my-openagent 运行 Team Mode 的画面。搭配 Kimi K3 和 GPT-5.6 Sol。
-
-> Anthropic [**因为我们屏蔽了 OpenCode。**](https://x.com/thdxr/status/2010149530486911014) **这是真的。**
-> 他们想把你锁住。Claude Code 是个漂亮的牢笼，但仍然是牢笼。
->
-> 你不需要为 2 小时的工作付 200 美元。
-> 未来不是选一个赢家，而是把所有赢家编排到一起。模型每个月都在变便宜、变聪明。没有任何一个供应商能够独占。我们是在为那个开放的市场而构建，不是为他们的围墙花园。
-
-<div align="center">
+**Your tool for real work. But it's an agent.**
 
 [![GitHub Release](https://img.shields.io/github/v/release/code-yeongyu/oh-my-openagent?color=369eff&labelColor=black&logo=github&style=flat-square)](https://github.com/code-yeongyu/oh-my-openagent/releases)
-[![npm downloads](https://img.shields.io/endpoint?url=https%3A%2F%2Fomo.dev%2Fapi%2Fnpm-downloads&style=flat-square)](https://www.npmjs.com/package/oh-my-opencode)
+[![downloads](https://img.shields.io/endpoint?url=https%3A%2F%2Fomo.dev%2Fapi%2Fdownloads&style=flat-square)](https://omo.dev)
 [![GitHub Contributors](https://img.shields.io/github/contributors/code-yeongyu/oh-my-openagent?color=c4f042&labelColor=black&style=flat-square)](https://github.com/code-yeongyu/oh-my-openagent/graphs/contributors)
-[![GitHub Forks](https://img.shields.io/github/forks/code-yeongyu/oh-my-openagent?color=8ae8ff&labelColor=black&style=flat-square)](https://github.com/code-yeongyu/oh-my-openagent/network/members)
 [![GitHub Stars](https://img.shields.io/github/stars/code-yeongyu/oh-my-openagent?color=ffcb47&labelColor=black&style=flat-square)](https://github.com/code-yeongyu/oh-my-openagent/stargazers)
-[![GitHub Issues](https://img.shields.io/github/issues/code-yeongyu/oh-my-openagent?color=ff80eb&labelColor=black&style=flat-square)](https://github.com/code-yeongyu/oh-my-openagent/issues)
 [![License](https://img.shields.io/badge/license-SUL--1.0-white?labelColor=black&style=flat-square)](https://github.com/code-yeongyu/oh-my-openagent/blob/dev/LICENSE.md)
-[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/code-yeongyu/oh-my-openagent)
 [![Docs](https://img.shields.io/badge/docs-omo.dev-369eff?labelColor=black&logo=readthedocs&logoColor=white&style=flat-square)](https://omo.dev/docs)
 
-[English](README.md) | [한국어](README.ko.md) | [日本語](README.ja.md) | [简体中文](README.zh-cn.md)
+[English](README.md) | [한국어](README.ko.md) | [日本語](README.ja.md) | [简体中文](README.zh-cn.md) | [Русский](README.ru.md)
 
 </div>
 
 <!-- </CENTERED SECTION FOR GITHUB DISPLAY> -->
 
-## 评价
-
-> "因为它，我取消了 Cursor 的订阅。令人震撼的事在开源社区发生了。" - [Arthur Guiot](https://x.com/arthur_guiot/status/2008736347092382053?s=20)
-
-> "如果人类需要 3 个月完成的事情 Claude Code 需要 7 天，那么 Sisyphus 只需要 1 小时。它会一直工作直到任务完成。它是一个极度自律的智能体。" <br/>- B, 量化研究员
-
-> "用 Oh My Opencode 一天之内解决了 8000 个 eslint 警告。" <br/>- [Jacob Ferrari](https://x.com/jacobferrari_/status/2003258761952289061)
-
-> "我用 Ohmyopencode 和 ralph loop 花了一晚上的时间，把一个 45k 行代码的 tauri 应用转换成了 SaaS Web 应用。从面试模式开始，让它对我提供的提示词进行提问和提出建议。看着它工作很有趣，今早醒来看到网站基本已经跑起来了，太震撼了！" - [James Hargis](https://x.com/hargabyte/status/2007299688261882202)
-
-> "用 oh-my-opencode 吧，你绝对回不去了。" <br/>- [d0t3ch](https://x.com/d0t3ch/status/2001685618200580503)
-
-> "我很难准确描述它到底哪里牛逼，但开发体验已经达到完全不同的维度了。" - [苔硯:こけすずり](https://x.com/kokesuzuri/status/2008532913961529372?s=20)
-
-> "这周末我用 open code、oh my opencode 和 supermemory 瞎折腾一个像我的世界/魂系一样的怪物游戏。吃完午饭去散步前，我让它把下蹲动画加进去。[视频]" - [MagiMetal](https://x.com/MagiMetal/status/2005374704178373023)
-
-> "你们真该把这个合并到核心代码里，然后把他招安了。说真的，这东西实在太牛了。" <br/>- Henning Kilset
-
-> "如果你们能说服 @yeon_gyu_kim，赶紧招募他。这个人彻底改变了 opencode。" <br/>- [mysticaltech](https://x.com/mysticaltech/status/2001858758608376079)
-
-> "Oh My OpenCode 简直疯了。" - [YouTube - Darren Builds AI](https://www.youtube.com/watch?v=G_Snfh2M41M)
-
----
-
-# Oh My OpenAgent
-
-你同时折腾着 Claude Code、Codex、各种奇奇怪怪的开源模型。配工作流。给 Agent 调 Bug。
-
-这些事我们替你做完了。全部测试过。只留下真正跑得起来的代码。
-
-装上 oh-my-openagent。敲 `ultrawork`。就完事了。
-
+OmO 就是一个 `omo` 命令，把你的 token 变成真正完成的工作：上万个来源的研究、一看就懂的演示、后端、前端、编程。它运行在 senpi 上，这是我们基于 [pi](https://github.com/badlogic/pi-mono) 的分支，下面的一切都已内置。
 
 ## 安装
 
-### 给人类看的
-
-复制并粘贴以下提示词到你的 LLM Agent (Claude Code, AmpCode, Cursor 等):
-
-```
-Install and configure oh-my-openagent by following the instructions here:
-https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md
-```
-
-或者你也可以直接去读 [安装指南](docs/guide/installation.md)，但说真的，让 Agent 去干吧。人类在配置环境的时候，总是容易敲错字母。
-
-### 给 LLM Agent 看的
-
-获取安装指南并照做：
-
 ```bash
-curl -fsSL https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md
-```
-
-**注意**：已发布的 npm 包名和 CLI 二进制名仍然是 `oh-my-opencode`（过渡期间同时以 `oh-my-openagent` 的名字双重发布）。在 `opencode.json` 中，兼容性层现在优先使用插件入口 `oh-my-openagent`，而旧的 `oh-my-opencode` 条目仍会以警告的形式加载。运行时配置是 `~/.omo/omo.jsonc`，加上向上逐级查找的项目 `.omo/omo.jsonc`。旧版 `oh-my-openagent.json[c]` / `oh-my-opencode.json[c]` 文件只会被迁移引擎导入一次，之后不再被读取。
-
-推荐的 `bunx`/`npx` 调用方式是 `oh-my-openagent install`（或原来的 `oh-my-opencode install`）。安装完成后，短命令是 `omo-agent-toolkit`。这些包在本次大版本中移除了 `omo` bin，这个名字现在归 OmO Native 所有，通过 `bun add -g omo-ai` 安装。**不要**使用 `bunx omo` 或 `npx omo`：npm 上的 `omo` 是另一位作者的无关包，这两条命令会解析到它。OmO Native 的包名是 `omo-ai`。`lazycodex-ai` 是一个单一用途的 Node/npm 安装器包：`npx lazycodex-ai install` 会直接进入 Codex Light 安装器。它不是 Codex marketplace 的名字（marketplace 仓库是 `code-yeongyu/lazycodex`）。Codex 看到的是 marketplace `sisyphuslabs` 和插件 `omo`，以 `omo@sisyphuslabs` 启用。
-
-匿名遥测默认开启，用于统计活跃安装数(DAU/WAU/MAU)。每台机器每个 UTC 日最多发送一次事件,使用哈希化的安装标识符,绝不会使用原始主机名,且不会创建 PostHog person profile。可通过 `OMO_SEND_ANONYMOUS_TELEMETRY=0` 或 `OMO_DISABLE_POSTHOG=1` 禁用。详见 [隐私政策](docs/legal/privacy-policy.md) 和 [服务条款](docs/legal/terms-of-service.md)。
-
-**Ultimate、Light 与 OmO Native:** oh-my-openagent 以同一产品的三个版本发布：两个插件加载到你已经在用的宿主里，另有一个独立版本。**Ultimate 版本**（`bunx oh-my-openagent install` 或 `--platform=opencode`，默认值）在 OpenCode 上提供完整功能 —— 11 个智能体、54+ 个生命周期钩子、Team Mode、4 个内置 MCP（websearch、context7、grep_app、lsp）、所有斜杠命令、IntentGate 模式。**Light 版本**（`npx lazycodex-ai install`）提供能够干净地移植到 OpenAI Codex CLI 插件系统的 核心组件（`rules`、`comment-checker`、`git-bash`、`lsp`、`ultrawork`、`ulw-loop`、`ulw-execute-continuation`、`telemetry`），外加 `teammode` 和配套组件（`bootstrap`、`lcx` 等），并会把 Codex 智能体 TOML 安装到 `~/.codex/agents/`。要同时安装这两个插件版本，使用 `--platform=both`。**OmO Native（独立）** 是内建 OMO 扩展的 `omo` 命令：`bun add -g omo-ai`，然后运行 `omo`。它从 `omo-ai` 安装，不加载进 OpenCode 或 Codex。从 OpenCode 版本迁移请参阅 [Migrating from OpenCode](docs/guide/migrating-from-opencode.md)。Codex 专用遥测可通过 `OMO_CODEX_DISABLE_POSTHOG=1` 或 `OMO_CODEX_SEND_ANONYMOUS_TELEMETRY=0` 禁用。
-
----
-
-## 跳过这个 README 吧
-
-读文档的时代已经过去了。直接把下面这段发给你的 Agent：
-
-```
-Read this and tell me why it's not just another boilerplate: https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/README.md
-```
-
-## 路线图
-
-我们正在重构代码库以支持多个代理 harness（OpenCode、Codex、Pi、Claude Code 等）。当前最紧迫的任务是包分层重构：将纯 TypeScript 核心逻辑、MCP 服务器、技能和适配器 shim 分离到不同的层，以便跨 harness 复用而不产生重复。
-
-如果你有兴趣贡献，请先阅读 [ROADMAP](./ROADMAP.md)。与此重构相关的 PR 请使用 `ROADMAP` 标签，以便我们追踪。
-
-
-## 核心亮点
-
-### 🪄 `ultrawork`
-
-你竟然还在往下读？真有耐心。
-
-安装。输入 `ultrawork`（或者 `ulw`）。搞定。
-
-下面的内容、所有特性、所有优化，你全都不需要知道。它就是能跑。
-
-即使只订阅了下面这几个，`ultrawork` 也能跑得很好（本项目与它们没有任何关联，纯属个人推荐）：
-- [ChatGPT 订阅 ($20)](https://chatgpt.com/)
-- [Kimi Code 订阅 ($19)](https://www.kimi.com/code)
-- [GLM Coding 套餐 ($10)](https://z.ai/subscribe)
-- 如果你能使用按 token 计费的方式，用 Kimi 和 GLM 模型花不了多少钱。
-
-|       | 特性                                                            | Editions | 功能说明                                                                                                                                                                        |
-| :---: | :-------------------------------------------------------------- | :------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-|   🤖   | **自律军团 (Discipline Agents)**                                | Ultimate | 主 Agent 负责调度架构师咨询、Librarian、Explore 和类别工作者。一支完整的 AI 开发团队并行工作。                                                                                   |
-|   🧩   | **Codex CLI Light Edition**                                      | Light    | 在 OpenAI Codex CLI 中运行的 omo 的可移植组件 (rules, comment-checker, git-bash, LSP, ultrawork, ulw-loop, ulw-execute continuation, telemetry, teammode 等)。安装: `npx lazycodex-ai install`。                    |
-|   👥   | **Team Mode** (选择性启用)                                       | Ultimate | 领导 Agent + 最多 8 个并行成员，实时 tmux 可视化，专用 `team_*` 工具家族。驱动 `hyperplan`(5 个敌对评论者) 和 `security-research`(3 个猎手 + 2 个 PoC 工程师)。[文档 →](docs/guide/team-mode.md) |
-|   ⚡   | **`ultrawork` / `ulw`**                                         | Both     | 一键触发，所有智能体(Ultimate)或 Codex `ultrawork` 组件(Light)出动。任务完成前绝不罢休。                                                                                          |
-|   🚪   | **[IntentGate 意图门](https://factory.ai/news/terminal-bench)** | Ultimate | 检测 `ultrawork`/`ulw`、`team`、`hyperplan` 关键词(不做语义层面的意图分类)。(Light 仅识别 `ulw` / `ultrawork` 关键词。)                                                       |
-|   🔗   | **基于哈希的编辑工具**                                          | Ultimate | Hashline (`LINE#ID`) 编辑/读取标记。需手动启用：在 `~/.omo/omo.jsonc` 中设置 `hashline_edit: true`、0% 错误修改。灵感来自 [oh-my-pi](https://github.com/can1357/oh-my-pi)。[The Harness Problem →](https://blog.can.ac/2026/02/12/the-harness-problem/) (Codex 使用其原生 `apply_patch`。) |
-|   🛠️   | **LSP + AST-Grep**                                              | Both     | 工作区级别的重命名、构建前诊断、基于 AST 的重写。LSP 通过 MCP 提供，AST-Grep 通过共享 `ast-grep` skill 和 `sg` 提供。                                   |
-|   🧠   | **后台智能体**                                                  | Ultimate | 同时发射 5+ 个专家并行工作。保持上下文干净，随时获取成果。                                                                                                                      |
-|   📚   | **内置 MCP**                                                    | Both     | Ultimate 运行时注入 websearch（Exa）、context7（官方文档）、grep_app（GitHub 源码搜索）、lsp。Light 通过 plugin-scoped MCP 提供 `grep_app`、`context7`、`git_bash`、`lsp`。                                                                              |
-|   🔁   | **Goal / `/goal`**                                              | Ultimate | `/goal` 为会话设定持久目标。idle continuation 仅在 `goal.enabled` 为 true 时运行（默认 false）。                                                                                          |
-|   ✅   | **Todo 强制执行** (Boulder)                                     | Ultimate | Agent 想要摸鱼？系统直接揪着领子拽回来。你的任务，必须完成。                                                                                                                    |
-|   💬   | **注释审查员**                                                  | Both     | 剔除带有浓烈 AI 味的冗余注释。同一个 `@code-yeongyu/comment-checker` 二进制在两个版本中运行。                                                                                    |
-|   📜   | **Rules Injection**                                             | Both     | `AGENTS.md` / `CLAUDE.md` / `.omo/rules/**` 的分层上下文注入。Ultimate 中为 hook，Light 中为 `rules` 组件。                                                                       |
-|   🧬   | **Ulw Loop**                                                   | Light    | 面向持久化多目标编排（含证据审计）的 Codex 组件 + CLI。在 OpenCode 上请改用 **Goal / `/goal`**。                                                                              |
-|   🖥️   | **Tmux 集成**                                                   | Ultimate | 完整的交互式终端支持。跑 REPL、用调试器、用 TUI 工具，全都在实时会话中完成。                                                                                                    |
-|   🔌   | **Claude Code 兼容**                                            | Ultimate | 你现有的 Hooks、命令、技能、MCP 和插件？全都能无缝迁移过来。(Codex 拥有其自己的原生插件系统。)                                                                                   |
-|   🎯   | **技能内嵌 MCP**                                                | Ultimate | 技能自带其所需的 MCP 服务器。按需开启，不会撑爆你的上下文窗口。                                                                                                                 |
-|   📋   | **Ultrawork Planner 规划师**                                    | Ultimate | 动手写代码前，先通过访谈模式做好战略规划。                                                                                                                                      |
-|   🔍   | **`/init-deep`**                                                | Ultimate | 在整个项目目录层级中自动生成 `AGENTS.md`。不仅省 Token，还能大幅提升 Agent 理解力。                                                                                             |
-
-> **Editions 图例。** **Ultimate** = 仅 OpenCode (`bunx oh-my-openagent install`)。**Light** = 仅 Codex CLI (`npx lazycodex-ai install`)。**Both** = 两个版本均提供 (内部实现可能略有不同)。
-
-### 自律军团 (Discipline Agents)
-
-**主 Agent** 运行在你的会话模型上，是你的主指挥官。他负责制定计划、分配任务给专家团队，并以极其激进的并行策略推动任务直至完成。他从不半途而废。你只需要给他目标，不要给他具体做法。他会自动探索代码库模式，从头到尾独立执行任务，绝不会中途要你当保姆。*名副其实的正牌工匠。*
-
-**Ultrawork Planner** (`/ulw-plan`) 是你的战略规划师。他通过访谈模式，在动一行代码之前，先通过提问确定范围并构建详尽的执行计划。随后 `/ulw-execute` 在同一会话中执行该计划。
-
-每一个提示词预设都针对其底层模型的特点进行了专门调优。你无需手动来回切换模型。[阅读背景设定了解更多 →](docs/guide/overview.md)
-
-> Anthropic [因为我们屏蔽了 OpenCode](https://x.com/thdxr/status/2010149530486911014)。这就是为什么我们将主 Agent 称为"正牌工匠 (The Legitimate Craftsman)"。这是一个故意的讽刺。
->
-> 我们在 Opus 或 Kimi K3 上运行得最好，但仅仅使用 Kimi K3 + GPT-5.6 Sol 就足以碾压原版的 Claude Code。完全不需要配置。
-
-### Team Mode
-
-一个 Agent 已经够快。一支协调的团队是 *毁灭性* 的。
-
-**Team Mode** 把 oh-my-openagent 从「带子 Agent 的单个 Agent」升级为真正的多 Agent 系统。一个领导 Agent 协调一队按类别专业化的成员，全部 **并行** 运行，通过专用工具(`team_create`、`team_send_message`、`team_task_create`、`team_status`、…)进行通信。在 tmux 布局的 focus + grid 窗口中同时观察每个成员的工作。
-
-```jsonc
-// ~/.omo/omo.jsonc  （或项目的 .omo/omo.jsonc）
-{
-  "team_mode": {
-    "enabled": true,
-    "max_parallel_members": 4,
-    "tmux_visualization": true
-  }
-}
-```
-
-重启 opencode，`team_*` 工具家族就会解锁。已经有两个技能站在它之上:
-
-- **`hyperplan`** — 5 个敌对 Agent 在写下第一行代码之前，从正交角度撕碎你的计划。
-- **`security-research`** — 3 个漏洞猎手 + 2 个 PoC 工程师并行审计你的代码库。严重性按 *实际可利用性* 校准。
-
-> **默认关闭。需要时再开。** [Team Mode 完整指南 →](docs/guide/team-mode.md)
-
-### 智能体调度机制
-
-当主 Agent 把任务分配给子智能体时，他选择的不是具体的模型，而是 **类别 (Category)**。系统会自动将类别映射到最合适的模型：
-
-| 类别                 | 作用领域               |
-| :------------------- | :--------------------- |
-| `visual-engineering` | 前端、UI/UX、设计      |
-| `deep`               | 深度自主调研与执行     |
-| `quick`              | 单文件修改、修错字     |
-| `ultrabrain`         | 复杂硬核逻辑、架构决策 |
-
-智能体只需要说明要做什么类型的工作，框架就会挑选出最合适的模型去干。`ultrabrain` 路由到 GPT-6 Astra max，`deep` 路由到 GPT-6 Astra high（OpenAI / OpenAI Codex，其次 GitHub Copilot，再其次 OpenCode），不可用时回退到 GPT-5.6 Sol。你完全不需要操心。
-
-### 完全兼容 Claude Code
-
-你已经花了大力气调教好了 Claude Code 的配置？太好了。
-
-这里完美兼容所有的 Hook、命令、技能、MCP 以及插件。所有配置直接生效，包括插件系统。
-
-### 赋予 Agent 世界级的开发工具
-
-LSP、AST-Grep、Tmux、MCP 并不是用胶水勉强糊在一起的，而是真正深度的集成。
-
-- **LSP**: 支持 `lsp_rename`、`lsp_goto_definition`、`lsp_find_references` 和 `lsp_diagnostics`。给 Agent 提供 IDE 般的精准操作。
-- **AST-Grep**: 支持 25 种编程语言，能够理解语法树的模式匹配和代码重写。
-- **Tmux**: 真实的交互式终端环境，支持 REPL、调试器以及 TUI 工具。Agent 的进程持久运行。
-- **MCP**: 内置 Web 搜索、官方文档直连以及 GitHub 级代码搜索。
-
-### 技能专属的按需 MCP 服务器
-
-一堆全局 MCP 服务器极其消耗 Context 额度，我们修好了这个问题。
-
-现在每个技能 (Skill) 都带着自己的专属 MCP。只在执行该任务时启动，任务完成即刻销毁。Context 窗口始终清爽。
-
-### 拒绝瞎改：基于内容哈希的编辑工具 (Hash-Anchored Edits)
-
-Harness 问题是真的。绝大多数所谓的 Agent 故障，其实并不是大模型变笨了，而是他们用的文件编辑工具太烂了。
-
-> *"目前所有工具都无法为模型提供一种稳定、可验证的行定位标识……它们全都依赖于模型去强行复写一遍自己刚才看到的原文。当模型一旦写错——而且这很常见——用户就会怪罪于大模型太蠢了。"*
->
-> <br/>- [Can Bölük, The Harness Problem](https://blog.can.ac/2026/02/12/the-harness-problem/)
-
-受 [oh-my-pi](https://github.com/can1357/oh-my-pi) 的启发，我们做出了 **Hashline**。启用 `hashline_edit` 后，Agent 读到的每一行代码，末尾都会打上一个强绑定的内容哈希值：
-
+bun add -g omo-ai
+omo
 ```
-11#VK| function hello() {
-22#XJ|   return "world";
-33#MB| }
-```
-
-Agent 发起修改时，必须通过这些标签引用目标行。如果在此期间文件发生过变化，哈希验证就会失败，从而在代码被污染前直接驳回。不再有缩进空格错乱，彻底告别改错行的惨剧。
-
-### 深度上下文初始化：`/init-deep`
-
-执行一次 `/init-deep`。它会为你生成一套树状的 `AGENTS.md`：
-
-```
-project/
-├── AGENTS.md              ← 全局级架构与约定
-├── src/
-│   ├── AGENTS.md          ← src 级规范
-│   └── components/
-│       └── AGENTS.md      ← 组件级详细说明
-```
-
-Agent 会自动顺藤摸瓜加载对应的 Context，免去了你所有的手动喂喂喂的麻烦。
-
-### 让 Agent 动手前先过脑子：Ultrawork Planner
-
-碰到了硬骨头？千万不要扔个 Prompt 就双手合十祈祷。
-
-Ultrawork Planner (`/ulw-plan`) **会像一个真实的主管那样去采访你**，主动深挖需求、指出模糊地带，并在改动哪怕一行代码之前把经过严密论证的计划写入 `.omo/plans/`。随后 `/ulw-execute` 让主 Agent 在同一会话中执行该计划。你的 Agent 终于知道了自己在干嘛。
 
-### 技能系统 (Skills)
+没有 bun？用 `npm i -g omo-ai` 也可以。包名是 `omo-ai`；npm 上那个无关的 `omo` 包属于别人。
 
-这里的 Skills 绝不只是一段无脑的 Prompt 模板。它们包含了：
+打开项目，运行 `omo`，说出要做的事。设置就这么多。
 
-- 面向特定领域的极度调优系统指令。
-- 按需加载的独立 MCP 服务器。
-- 对 Agent 能力边界的强制约束。
+从 OpenCode 版或 LazyCodex 迁移过来？运行一次 `omo setup`。它会把你的提供商密钥、自定义提供商、MCP 服务器、技能和模型选择一并带过来。
 
-默认内置：`playwright`（极其稳健的浏览器自动化）、`git-master`（全自动的原子级提交及 rebase 手术）、`frontend`（设计感拉满的 UI 实现）。
+之后运行 `omo doctor`，可以看到你的提供商能跑哪些任务类别，以及旧安装留下了什么。完整步骤见 [从 OpenCode 迁移](docs/guide/migrating-from-opencode.md)。
 
-想加你自己的？放进 `.opencode/skills/*/SKILL.md` 或者 `~/.config/opencode/skills/*/SKILL.md` 就行。
+`omo update` 原地更新。`bun remove -g omo-ai`（或 `npm uninstall -g omo-ai`）即可卸载。
 
-**想看所有的硬核功能说明吗？** 点击查看 **[详细特性文档 (Features)](docs/reference/features.md)**，深入了解 Agent 架构、Hook 流水线、核心工具链和所有的内置 MCP 等等。
+## 为什么选 OmO
 
----
+**ultrawork。** 不必学习。觉得任务很难，就在提示词里加上 `ultrawork`（或 `ulw`）。
 
-> **第一次用 oh-my-openagent？** 阅读 **[Overview](docs/guide/overview.md)** 了解你拥有哪些功能，或查看 **[Orchestration Guide](docs/guide/orchestration.md)** 了解 Agent 如何协作。
+代理会先读代码库再动手，制定计划，每一步验证后再继续，在真实环境中检查结果，完成后停下。
 
-## 如何卸载
+**让数百个代理为你工作。只需一个关键词。** 输入 `mass ulw`，整件工作就变成一张代理图：横跨数千来源的深度研究、一整套机器学习流水线、没人想做的迁移。
 
-要移除 oh-my-openagent：
+每个部分由最合适的模型并行完成，说完成之前先经过检查。
 
-1. **从你的 OpenCode 配置文件中去掉插件**
+**Kibitzer。你的代理不会忘记你，也不会忘记你的工作。** 记忆保存在一个由 markdown 文件组成的 git 仓库里。
 
-   编辑 `~/.config/opencode/opencode.json`（或 `opencode.jsonc`），并从 `plugin` 数组中删掉 `"oh-my-openagent"` 或旧的 `"oh-my-opencode"` 条目：
+一个小而便宜的模型坐在昂贵的主代理旁边，查看你做过的事，在主代理重蹈覆辙之前轻轻提醒。你不必反复解释自己。
 
-   ```bash
-   # 如果你有 jq 的话
-   jq '.plugin = [.plugin[] | select(. != "oh-my-openagent" and . != "oh-my-opencode")]' \
-       ~/.config/opencode/opencode.json > /tmp/oc.json && \
-       mv /tmp/oc.json ~/.config/opencode/opencode.json
-   ```
+**不用纠结的多模型。** 把你喜爱的前沿模型和便宜的模型混着用。登录即可：`/login` 支持 Claude、ChatGPT、Kimi 和 GLM 订阅。
 
-2. **清除配置文件（可选）**
+每个模型都自带为它调好的系统提示词，你永远不会选错。
 
-   ```bash
-   # 移除运行时配置文件
-   rm -f ~/.omo/omo.jsonc ~/.omo/omo.json
+**高质量技能，只给你需要的那一点。** 你的模型很聪明，但解决现实问题时仍有很多不知道的事。
 
-   # 移除当前项目的配置（如果存在）
-   rm -f .omo/omo.jsonc .omo/omo.json
+OmO 把缺失的知识做成技能，包括浏览器操作，只加载当前任务需要的部分。
 
-   # 移除残留的旧版迁移备份（如有）
-   rm -f ~/.config/opencode/oh-my-openagent.jsonc ~/.config/opencode/oh-my-openagent.json \
-         ~/.config/opencode/oh-my-opencode.jsonc ~/.config/opencode/oh-my-opencode.json \
-         .opencode/oh-my-openagent.jsonc .opencode/oh-my-openagent.json \
-         .opencode/oh-my-opencode.jsonc .opencode/oh-my-opencode.json
-   ```
+**其余的一切都经过精心打造。** 彼此独立的工具调用放进一个小程序里一起执行，二十次读取只需一次往返。格式错误的工具参数在执行前被修好。
 
-3. **确认卸载成功**
-
-   ```bash
-   opencode --version
-   # 这个时候就应该没有任何关于插件的输出信息了
-   ```
-
-4. **移除 omo-codex（Codex CLI Light 版本）**
-
-   ```bash
-   npx lazycodex-ai uninstall
-   # backward-compatible alias:
-   npx lazycodex-ai cleanup
-   ```
-
-   卸载命令会移除由它管理的 `sisyphuslabs` Codex 缓存和 marketplace 状态，在写入备份后从 `~/.codex/config.toml` 中剥离 `omo@sisyphuslabs` 插件和 hook-state 区块，并删除安装清单中列出的智能体 TOML 链接。如果某个项目里还残留着旧的项目级 Codex 插件状态，请在该项目下运行此命令，或传入 `--project <path>`；它会修复已知的项目级 `.codex/config.toml` 冲突，并报告项目级 `.codex` 产物，但不会删除项目自有文件。
-
-## Features
-
-那种"这个功能本来就该一直存在"的感觉。一用就回不去。
-
-完整内容请见 [Features Documentation](docs/reference/features.md)。
-
-**简要概览：**
-- **Agents**: 主 Agent（调度器）、Ultrawork Planner（`/ulw-plan`）、架构师咨询（架构/调试）、Librarian（文档/代码检索）、Explore（快速 grep）、Multimodal Looker
-- **后台 Agents**: 像真正的开发团队那样并行跑多个 Agent
-- **LSP & AST 工具**: 重构、重命名、诊断、AST 感知的代码检索
-- **基于哈希的编辑工具**（通过 `hashline_edit: true` 手动启用）: `LINE#ID` 引用在应用每次修改前都会验证内容。外科手术级编辑，零陈旧行错误
-- **上下文注入**: 自动注入 AGENTS.md、README.md、条件规则
-- **Claude Code 兼容**: 完整的 Hook 系统、命令、技能、Agents、MCP
-- **内置 MCP**: websearch（Exa）、context7（文档）、grep_app（GitHub 检索）、lsp ——由插件在运行时注入，不会显示在 `opencode mcp list`  中(参见文档 [MCP docs](docs/reference/features.md#native-vs-plugin-injected-mcps))
-- **会话工具**: 列出、读取、搜索、分析会话历史
-- **效率功能**: Goal、Todo Enforcer、Comment Checker、Think Mode 等
-- **Doctor 命令**: 内置诊断（`bunx oh-my-opencode doctor`），验证插件注册、配置、模型和环境
-- **模型回退**: `fallback_models` 可以在同一数组中混合使用普通模型字符串和 per-fallback 对象配置
-- **文件提示词**: 通过 `file://` 在 Agent 配置中从文件加载提示词
-- **会话恢复**: 从会话错误、上下文窗口上限、API 失败中自动恢复
-- **模型设置**: Agent 与模型的匹配已内置在 [安装指南](docs/guide/installation.md#step-5-understand-your-model-setup) 中
+等待构建或部署是一种订阅，而不是轮询。长任务会记录检查过的内容，会话重启后从停下的地方继续。配置、技能、提示词实时重新加载。
 
 ## 配置
 
-我们有自己主见的默认值。如果你真要改，也可以调。
-
-详细内容见 [Configuration Documentation](docs/reference/configuration.md)。
-
-**简要概览：**
-- **配置文件位置**: 用户 `~/.omo/omo.jsonc`，同时会从当前目录向上查找项目 `.omo/omo.jsonc`（查到 `$HOME` 为止），离当前目录越近的优先级越高。旧版 `oh-my-*` 文件只会被迁移一次到 `omo.jsonc`。
-- **JSONC 支持**: 支持注释和尾逗号
-- **Agents**: 可对任意 Agent 覆盖模型、temperature、prompts 和权限
-- **内置技能**: `playwright`（浏览器自动化）、`git-master`（原子提交）
-- **主 Agent**: 调度器，搭配 Ultrawork Planner（`/ulw-plan`）和 Plan Consultant
-- **后台任务**: 按 provider/model 配置并发上限
-- **类别**: `visual-engineering`、`ultrabrain`、`deep`、`artistry`、`quick`、`unspecified-low`、`unspecified-high`、`writing`，外加自定义名称
-- **Hooks**: 54+ 内置生命周期 Hook（启用 Team Mode 时为 61 个），都可以通过 `disabled_hooks` 控制
-- **MCPs**: 内置 websearch（Exa）、context7（文档）、grep_app（GitHub 检索）、lsp——由插件在运行时注入，不会显示在 `opencode mcp list`  中
-- **LSP**: 包括重构工具的完整 LSP 支持
-- **Experimental**: 激进截断、抢占式上下文压缩等
-
+默认值自有主张，你坚持的话也可以调整。你的设置在 `~/.omo/omo.jsonc`，项目也可以添加自己的 `.omo/omo.jsonc`；离得最近的文件优先。
 
-## 闲聊环节 (Author's Note)
+所有配置项见 [配置参考](docs/reference/configuration.md)。
 
-**想知道做这个插件的哲学理念吗？** 阅读 [Ultrawork Manifesto](docs/manifesto.md)。
+## 文档
 
----
+- [omo.dev/docs](https://omo.dev/docs)
+- [从 OpenCode 迁移](docs/guide/migrating-from-opencode.md)
+- [配置参考](docs/reference/configuration.md)
+- [功能](docs/reference/features.md)
+- [电脑操作](docs/guide/computer-use.md)（实验性功能）
+- [Ultrawork 宣言](docs/manifesto.md)
 
-我为了做个人项目，烧掉了整整 $24,000 的 LLM API Token 费用。我把市面上每个宣称好用的代码 Agent 全试了一遍，配置选项被我翻得底朝天。最后我得出了结论，OpenCode 赢了。
-
-我踩过的坑、撞过的南墙，它们的终极解法现在全都被硬编码到了这个插件里。你只需要安装，然后直接用。
-
-如果把 OpenCode 喻为底层的 Debian/Arch，那么 oh-my-openagent 毫无疑问就是开箱即用的 Ubuntu/[Omarchy](https://omarchy.org/)。
+## 评价
 
-本项目受到 [AmpCode](https://ampcode.com) 和 [Claude Code](https://code.claude.com/docs/overview) 的深刻启发。我把他们好用的特性全都搬了过来，且在很多地方做了底层强化。它仍在活跃开发中，因为毕竟，这是 **Open**Code。
+> "It made me cancel my Cursor subscription. Unbelievable things are happening in the open source community." - [Arthur Guiot](https://x.com/arthur_guiot/status/2008736347092382053?s=20)
 
-其他调度框架只会给你画饼画一张很酷的 Multi-Agent 大饼。我们把饼烙出来了。不仅能用，而且极其稳定。所有的功能都不是为了炫技，而是真的能把任务干完。
+> "If Claude Code does in 7 days what a human does in 3 months, OmO does it in 1 hour." <br/>- B, Quant Researcher
 
-因为我自己就是这个项目最偏执、最神经质的极端用户：
-- 哪个模型在处理变态业务逻辑时最不容易晕？
-- 谁是修 Bug 的神？
-- 谁文笔最好、最不 AI 味？
-- 谁能在前端交互上碾压一切？
-- 后端性能谁来扛？
-- 谁又快又便宜适合打杂？
-- 竞争对手们今天又发了啥牛逼的功能，能抄吗？
+> "You guys should pull this into core and recruit him. Seriously. It's really, really, really good." <br/>- Henning Kilset
 
-这个插件是以上一切的结晶 (Distillation)。直接拿走去用。如果有更好的点子，PR 大门永远敞开。
+## 作者的话
 
-**别再浪费时间去到处对比选哪个框架好了。**
-**我会去市面上调研，把最强的特性全偷过来，然后在这更新。**
+如果我不得不从代理手里把方向盘拿回来，那不是团队协作，而是系统失败了。OmO 就建立在这个理念之上。
 
-听起来很自大吗？如果你有更牛逼的实现思路，那就交 PR，热烈欢迎。
+你说出想要什么；代理负责研究、规划，写出与资深工程师难以区分的代码，验证它，一直推进到完成。它在能换来真正速度时才花 token，把简单的部分交给便宜的模型。
 
-郑重声明：本项目与文档中提及的任何框架或大模型供应商**均无利益相关**，这完完全全就是一次走火入魔的个人硬核实验成果。
+我是这个项目最着迷的用户。哪个模型逻辑最敏锐？谁的文字写得最好？这周别人都发布了什么？这些答案最终都落在 OmO 里。有更好的办法？欢迎 PR。
 
-本项目 99% 的代码都是直接由 OpenCode 生成的。我本人其实并不懂 TypeScript。**但我以人格担保，这个 README 是我亲自审核并且大幅度重写过的。**
+目标是一个你不再察觉到的代理。按下开关，灯就亮了。完整版本见 [Ultrawork 宣言](docs/manifesto.md)。
 
-## 以下公司的专业开发人员都在用
+与文中提到的任何项目或模型均无关联。Ultragoal 和 UltraQA 的思路来自 [oh-my-codex](https://github.com/Yeachan-Heo/oh-my-codex)，并按其概念为 OmO 重新实现。
 
-- [Indent](https://indentcorp.com)
-  - 开发了 Spray（意见领袖营销系统）、vovushop（跨境电商独立站）、vreview（AI 赋能的电商买家秀营销解决方案）。
-- [Google](https://google.com)
-- [Microsoft](https://microsoft.com)
-- [Vercel](https://vercel.com)
-- [ELESTYLE](https://elestyle.jp)
-  - 开发了 elepay（全渠道移动支付网关）、OneQR（专为无现金社会打造的移动 SaaS 生态系统）。
-- [Deepgram](https://deepgram.com)
+## 这些公司的专业人士在用
 
-*特别感谢 [@junhoyeo](https://github.com/junhoyeo) 为我们设计的令人惊艳的首图（Hero Image）。*
+[Indent](https://indentcorp.com), makers of Spray (influencer marketing solution), vovushop (cross-border commerce platform) and vreview (AI commerce review marketing solution). [Google](https://google.com). [Microsoft](https://microsoft.com). [Vercel](https://vercel.com). [ELESTYLE](https://elestyle.jp), makers of elepay (multi-mobile payment gateway) and OneQR (mobile application SaaS for cashless solutions). [Deepgram](https://deepgram.com).