docs(readme): update zh-cn README for team-mode

This commit is contained in:
YeonGyu-Kim
2026-04-28 10:48:36 +09:00
parent c142f6de52
commit 22056bd9c7
+107 -67
View File
@@ -1,13 +1,7 @@
> [!WARNING]
> **临时通知(本周):维护者响应延迟说明**
>
> 核心维护者 Q 因受伤,本周 issue/PR 回复和发布可能会延迟。
> 感谢你的耐心与支持。
> [!TIP]
> **Building in Public**
>
> 维护者正在使用 Jobdori 实时开发和维护 oh-my-opencode。Jobdori 是基于 OpenClaw 深度定制的 AI 助手。
> 维护者正在使用 Jobdori 实时开发和维护 oh-my-openagent。Jobdori 是基于 OpenClaw 深度定制的 AI 助手。
> 每个功能开发、每次修复、每次 Issue 分类,都在 Discord 上实时进行。
>
> [![Building in Public](./.github/assets/building-in-public.png)](https://discord.gg/PUwSMR9XNk)
@@ -23,29 +17,33 @@
> [!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-opencode` 用户交流。 |
> | [<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="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-opencode` 的新闻和更新过去发布在我的 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) | 关于 `oh-my-openagent` 的更新过去发布在我的 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">
[![Oh My OpenCode](./.github/assets/hero.jpg)](https://github.com/code-yeongyu/oh-my-openagent#oh-my-opencode)
[![Oh My OpenAgent](./.github/assets/hero.jpg)](https://github.com/code-yeongyu/oh-my-openagent#oh-my-openagent)
[![Preview](./.github/assets/omo.png)](https://github.com/code-yeongyu/oh-my-openagent#oh-my-opencode)
[![Preview](./.github/assets/omo.png)](https://github.com/code-yeongyu/oh-my-openagent#oh-my-openagent)
</div>
> 这是类固醇式编程。不是一个模型的类固醇——而是整个药库
> 这是 oh-my-openagent 运行 Team Mode 的画面。搭配 Kimi K2.6 和 GPT-5.5
> Anthropic [**因为我们屏蔽了 OpenCode。**](https://x.com/thdxr/status/2010149530486911014) **这是真的。**
> 他们想把你锁住。Claude Code 是个漂亮的牢笼,但仍然是牢笼。
>
> 用 Claude 做编排,用 GPT 做推理,用 Kimi 提速度,用 Gemini 处理视觉。模型正在变得越来越便宜,越来越聪明。没有一个提供商能够垄断。我们正在为那个开放的市场而构建。Anthropic 的牢笼很漂亮。但我们不住那
> 你不需要为 2 小时的工作付 200 美元
> 未来不是选一个赢家,而是把所有赢家编排到一起。模型每个月都在变便宜、变聪明。没有任何一个供应商能够独占。我们是在为那个开放的市场而构建,不是为他们的围墙花园。
<div align="center">
[![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/npm/dt/oh-my-opencode?color=ff6b35&labelColor=black&style=flat-square)](https://www.npmjs.com/package/oh-my-opencode)
[![npm downloads](https://img.shields.io/endpoint?url=https%3A%2F%2Fohmyopenagent.com%2Fapi%2Fnpm-downloads&style=flat-square)](https://www.npmjs.com/package/oh-my-opencode)
[![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)
@@ -61,38 +59,35 @@
## 评价
> 因为它,我取消了 Cursor 的订阅。开源社区正在发生令人难以置信的事情。 - [Arthur Guiot](https://x.com/arthur_guiot/status/2008736347092382053?s=20)
> "因为它,我取消了 Cursor 的订阅。开源社区正在发生令人难以置信的事情。" - [Arthur Guiot](https://x.com/arthur_guiot/status/2008736347092382053?s=20)
> 如果人类需要 3 个月完成的事情 Claude Code 需要 7 天,那么 Sisyphus 只需要 1 小时。它会一直工作直到任务完成。它是一个极度自律的智能体。 <br/>- B, 量化研究员
> "如果人类需要 3 个月完成的事情 Claude Code 需要 7 天,那么 Sisyphus 只需要 1 小时。它会一直工作直到任务完成。它是一个极度自律的智能体。" <br/>- B, 量化研究员
> 用 Oh My Opencode 一天之内解决了 8000 个 eslint 警告。 <br/>- [Jacob Ferrari](https://x.com/jacobferrari_/status/2003258761952289061)
> "用 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)
> "我用 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)
> "用 oh-my-opencode 吧,你绝对回不去了。" <br/>- [d0t3ch](https://x.com/d0t3ch/status/2001685618200580503)
> 我很难准确描述它到底哪里牛逼,但开发体验已经达到完全不同的维度了。 - [苔硯:こけすずり](https://x.com/kokesuzuri/status/2008532913961529372?s=20)
> "我很难准确描述它到底哪里牛逼,但开发体验已经达到完全不同的维度了。" - [苔硯:こけすずり](https://x.com/kokesuzuri/status/2008532913961529372?s=20)
> 这周末我用 open code、oh my opencode 和 supermemory 瞎折腾一个像我的世界/魂系一样的怪物游戏。吃完午饭去散步前,我让它把下蹲动画加进去。[视频] - [MagiMetal](https://x.com/MagiMetal/status/2005374704178373023)
> "这周末我用 open code、oh my opencode 和 supermemory 瞎折腾一个像我的世界/魂系一样的怪物游戏。吃完午饭去散步前,我让它把下蹲动画加进去。[视频]" - [MagiMetal](https://x.com/MagiMetal/status/2005374704178373023)
> 你们真该把这个合并到核心代码里,然后把他招安了。说真的,这东西实在太牛了。 <br/>- Henning Kilset
> "你们真该把这个合并到核心代码里,然后把他招安了。说真的,这东西实在太牛了。" <br/>- Henning Kilset
> 如果你们能说服 @yeon_gyu_kim,赶紧招募他。这个人彻底改变了 opencode。 <br/>- [mysticaltech](https://x.com/mysticaltech/status/2001858758608376079)
> "如果你们能说服 @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 OpenCode 简直疯了。" - [YouTube - Darren Builds AI](https://www.youtube.com/watch?v=G_Snfh2M41M)
---
# Oh My OpenCode
# Oh My OpenAgent
我们最初把这叫做“给 Claude Code 打类固醇”。那是低估了它
你同时折腾着 Claude Code、Codex、各种奇奇怪怪的开源模型。配工作流。给 Agent 调 Bug
不是只给一个模型打药。我们在运营一个联合体。Claude、GPT、Kimi、Gemini——各司其职,并行运转,永不停歇。模型每个月都在变便宜,没有任何提供商能够垄断。我们已经活在那个世界里了
脏活累活我们替你干了。我们测试了一切,只留下了真正有用的。
安装 OmO。敲下 `ultrawork`。疯狂地写代码吧。
这些事我们替你做完了。全部测试过。只留下真正跑得起来的
装上 oh-my-openagent。敲 `ultrawork`。就完事了。
## 安装
@@ -102,11 +97,11 @@
复制并粘贴以下提示词到你的 LLM Agent (Claude Code, AmpCode, Cursor 等):
```
Install and configure oh-my-opencode by following the instructions here:
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 去干吧。人类配环境总是容易敲错字母。
或者你可以直接去读 [安装指南](docs/guide/installation.md),但说真的,让 Agent 去干吧。人类配环境总是容易敲错字母。
### 给 LLM Agent 看的
@@ -116,7 +111,7 @@ https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/do
curl -s https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md
```
**注意**请使用已发布的包名和二进制名 `oh-my-opencode`。在 `opencode.json` 中,兼容性层现在优先使用插件入口 `oh-my-openagent`,而旧的 `oh-my-opencode` 条目仍会加载并显示警告。插件配置文件通常仍使用 `oh-my-opencode.json``oh-my-opencode.jsonc`,在过渡期间新旧两种文件名都会被识别。
**注意**:已发布的 npm 包名和 CLI 二进制名仍然是 `oh-my-opencode`(过渡期间同时以 `oh-my-openagent` 的名字双重发布)。在 `opencode.json` 中,兼容性层现在优先使用插件入口 `oh-my-openagent`,而旧的 `oh-my-opencode` 条目仍会以警告的形式加载。插件配置文件通常仍使用 `oh-my-opencode.json``oh-my-opencode.jsonc`,在过渡期间新旧两种文件名都会被识别。
匿名遥测默认开启,用于统计活跃安装数(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)。
@@ -124,37 +119,38 @@ curl -s https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/head
## 跳过这个 README 吧
读文档的时代已经过去了。直接把下面这发给你的 Agent
读文档的时代已经过去了。直接把下面这发给你的 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
```
## 核心亮点
### 🪄 `ultrawork`
你竟然还在往下读?真有耐心。
安装。输入 `ultrawork` (或者 `ulw`)。搞定。
安装。输入 `ultrawork`或者 `ulw`。搞定。
下面的内容,包括所有特性、所有优化,你全都不需要知道,它自己就能完美运行
下面的内容所有特性、所有优化,你全都不需要知道。它就是能跑
只需以下订阅之一,ultrawork 就能顺畅工作(本项目与它们没有任何关联,纯属个人推荐):
即使只订阅了下面这几个,`ultrawork` 也能跑得很好(本项目与它们没有任何关联,纯属个人推荐):
- [ChatGPT 订阅 ($20)](https://chatgpt.com/)
- [Kimi Code 订阅 ($19)](https://www.kimi.com/code)
- [GLM Coding 套餐 ($10)](https://z.ai/subscribe)
- 如果你能使用按 token 计费的方式,用 kimi 和 gemini 模型花不了多少钱。
- 如果你能使用按 token 计费的方式,用 Kimi 和 Gemini 模型花不了多少钱。
| | 特性 | 功能说明 |
| :---: | :-------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 🤖 | **自律军团 (Discipline Agents)** | Sisyphus 负责调度 Hephaestus、Oracle、Librarian 和 Explore。一支完整的 AI 开发团队并行工作。 |
| ⚡ | **`ultrawork` / `ulw`** | 一键触发,所有智能体出动。任务完成前绝不罢休。 |
| 🚪 | **[IntentGate 意图门](https://factory.ai/news/terminal-bench)** | 真正行动前,先分析用户的真实意图。彻底告别被字面意思误导的 AI 废话。 |
| 🔗 | **基于哈希的编辑工具** | 每次修改都通过 `LINE#ID` 内容哈希验证、0% 错误修改。灵感来自 [oh-my-pi](https://github.com/can1357/oh-my-pi)。[马具问题](https://blog.can.ac/2026/02/12/the-harness-problem/) |
| 🔗 | **基于哈希的编辑工具** | 每次修改都通过 `LINE#ID` 内容哈希验证、0% 错误修改。灵感来自 [oh-my-pi](https://github.com/can1357/oh-my-pi)。[The Harness Problem](https://blog.can.ac/2026/02/12/the-harness-problem/) |
| 🛠️ | **LSP + AST-Grep** | 工作区级别的重命名、构建前诊断、基于 AST 的重写。为 Agent 提供 IDE 级别的精度。 |
| 🧠 | **后台智能体** | 同时发射 5+ 个专家并行工作。保持上下文干净,随时获取成果。 |
| 📚 | **内置 MCP** | Exa (网络搜索)、Context7 (官方文档)、Grep.app (GitHub 源码搜索)。默认开启。 |
| 📚 | **内置 MCP** | Exa网络搜索、Context7官方文档、Grep.appGitHub 源码搜索。默认开启。 |
| 🔁 | **Ralph Loop / `/ulw-loop`** | 自我引用闭环。达不到 100% 完成度绝不停止。 |
| ✅ | **Todo 强制执行** | Agent 想要摸鱼?系统直接揪着领子拽回来。你的任务,必须完成。 |
| 💬 | **注释审查员** | 剔除带有浓烈 AI 味的冗余注释。写出的代码就像老练的高级工程师写的。 |
@@ -179,7 +175,7 @@ Read this and tell me why it's not just another boilerplate: https://raw.githubu
每一个 Agent 都针对其底层模型的特点进行了专门调优。你无需手动来回切换模型。[阅读背景设定了解更多 →](docs/guide/overview.md)
> Anthropic [因为我们屏蔽了 OpenCode](https://x.com/thdxr/status/2010149530486911014)。这就是为什么我们将 Hephaestus 命名为正牌工匠 (The Legitimate Craftsman)。这是一个故意的讽刺。
> Anthropic [因为我们屏蔽了 OpenCode](https://x.com/thdxr/status/2010149530486911014)。这就是为什么我们将 Hephaestus 命名为"正牌工匠 (The Legitimate Craftsman)"。这是一个故意的讽刺。
>
> 我们在 Opus 上运行得最好,但仅仅使用 Kimi K2.5 + GPT-5.4 就足以碾压原版的 Claude Code。完全不需要配置。
@@ -194,7 +190,7 @@ Read this and tell me why it's not just another boilerplate: https://raw.githubu
| `quick` | 单文件修改、修错字 |
| `ultrabrain` | 复杂硬核逻辑、架构决策 |
智能体只需要说明要做什么类型的工作,框架就会挑选出最合适的模型去干。你完全不需要操心。
智能体只需要说明要做什么类型的工作,框架就会挑选出最合适的模型去干。`ultrabrain` 现在默认路由到 GPT-5.4 xhigh。你完全不需要操心。
### 完全兼容 Claude Code
@@ -221,11 +217,11 @@ LSP、AST-Grep、Tmux、MCP 并不是用胶水勉强糊在一起的,而是真
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** 技术。Agent 读到的每一行代码,末尾都会打上一个强绑定的内容哈希值:
受 [oh-my-pi](https://github.com/can1357/oh-my-pi) 的启发,我们做出**Hashline**。Agent 读到的每一行代码,末尾都会打上一个强绑定的内容哈希值:
```
11#VK| function hello() {
@@ -235,11 +231,11 @@ Harness 问题是真的。绝大多数所谓的 Agent 故障,其实并不是
Agent 发起修改时,必须通过这些标签引用目标行。如果在此期间文件发生过变化,哈希验证就会失败,从而在代码被污染前直接驳回。不再有缩进空格错乱,彻底告别改错行的惨剧。
在 Grok Code Fast 1 上,仅仅因为更换了这套编辑工具,修改成功率直接**6.7% 飙升至 68.3%**
在 Grok Code Fast 1 上,仅仅因为更换了这套编辑工具,修改成功率**6.7% 飙升至 68.3%**
### 深度上下文初始化:`/init-deep`
执行一次 `/init-deep`。它会为你生成一树状的 `AGENTS.md` 文件系统
执行一次 `/init-deep`。它会为你生成一树状的 `AGENTS.md`
```
project/
@@ -262,43 +258,45 @@ Agent 会自动顺藤摸瓜加载对应的 Context,免去了你所有的手动
这里的 Skills 绝不只是一段无脑的 Prompt 模板。它们包含了:
- 面向特定领域的极度调优系统指令
- 按需加载的独立 MCP 服务器
- 对 Agent 能力边界的强制约束
- 面向特定领域的极度调优系统指令
- 按需加载的独立 MCP 服务器
- 对 Agent 能力边界的强制约束
默认内置:`playwright`(极其稳健的浏览器自动化)、`git-master`(全自动的原子级提交及 rebase 手术)、`frontend-ui-ux`(设计感拉满的 UI 实现)。
想加你自己的?放进 `.opencode/skills/*/SKILL.md` 或者 `~/.config/opencode/skills/*/SKILL.md` 就行。
**想看所有的硬核功能说明吗?** 点击查看 **[详细特性文档 (Features)](docs/reference/features.md)** ,深入了解 Agent 架构、Hook 流水线、核心工具链和所有的内置 MCP 等等。
**想看所有的硬核功能说明吗?** 点击查看 **[详细特性文档 (Features)](docs/reference/features.md)**,深入了解 Agent 架构、Hook 流水线、核心工具链和所有的内置 MCP 等等。
---
> **第一次用 oh-my-opencode** 阅读 **[概述](docs/guide/overview.md)** 了解你拥有哪些功能,或查看 **[编排指南](docs/guide/orchestration.md)** 了解 Agent 如何协作。
> **第一次用 oh-my-openagent** 阅读 **[Overview](docs/guide/overview.md)** 了解你拥有哪些功能,或查看 **[Orchestration Guide](docs/guide/orchestration.md)** 了解 Agent 如何协作。
## 如何卸载 (Uninstallation)
## 如何卸载
要移除 oh-my-opencode:
要移除 oh-my-openagent
1. **从你的 OpenCode 配置文件中去掉插件**
编辑 `~/.config/opencode/opencode.json` (`opencode.jsonc`) ,并把 `"oh-my-opencode"``plugin` 数组中删掉
编辑 `~/.config/opencode/opencode.json``opencode.jsonc`),并从 `plugin` 数组中删掉 `"oh-my-openagent"` 或旧的 `"oh-my-opencode"` 条目
```bash
# 如果你有 jq 的话
jq '.plugin = [.plugin[] | select(. != "oh-my-opencode")]' \
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
```
2. **清除配置文件 (可选)**
2. **清除配置文件可选**
```bash
# 移除全局用户配置
rm -f ~/.config/opencode/oh-my-opencode.json ~/.config/opencode/oh-my-opencode.jsonc
# 移除兼容期间被识别的插件配置文件
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
# 移除当前项目的配置
rm -f .opencode/oh-my-opencode.json .opencode/oh-my-opencode.jsonc
# 移除当前项目的配置(如果存在)
rm -f .opencode/oh-my-openagent.jsonc .opencode/oh-my-openagent.json \
.opencode/oh-my-opencode.jsonc .opencode/oh-my-opencode.json
```
3. **确认卸载成功**
@@ -308,9 +306,51 @@ Agent 会自动顺藤摸瓜加载对应的 Context,免去了你所有的手动
# 这个时候就应该没有任何关于插件的输出信息了
```
## Features
那种"这个功能本来就该一直存在"的感觉。一用就回不去。
完整内容请见 [Features Documentation](docs/reference/features.md)。
**简要概览:**
- **Agents**: Sisyphus(主 Agent)、Prometheus(规划师)、Oracle(架构/调试)、Librarian(文档/代码检索)、Explore(快速 grep)、Multimodal Looker
- **后台 Agents**: 像真正的开发团队那样并行跑多个 Agent
- **LSP & AST 工具**: 重构、重命名、诊断、AST 感知的代码检索
- **基于哈希的编辑工具**: `LINE#ID` 引用在应用每次修改前都会验证内容。外科手术级编辑,零陈旧行错误
- **上下文注入**: 自动注入 AGENTS.md、README.md、条件规则
- **Claude Code 兼容**: 完整的 Hook 系统、命令、技能、Agents、MCP
- **内置 MCP**: websearchExa)、context7(文档)、grep_appGitHub 检索)
- **会话工具**: 列出、读取、搜索、分析会话历史
- **效率功能**: Ralph Loop、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)。
**简要概览:**
- **配置文件位置**: 兼容性层同时识别 `oh-my-openagent.json[c]` 和旧的 `oh-my-opencode.json[c]` 插件配置文件。现有安装仍大多使用旧文件名。
- **JSONC 支持**: 支持注释和尾逗号
- **Agents**: 可对任意 Agent 覆盖模型、temperature、prompts 和权限
- **内置技能**: `playwright`(浏览器自动化)、`git-master`(原子提交)
- **Sisyphus Agent**: 主调度器,搭配 Prometheus(规划师)和 Metis(计划顾问)
- **后台任务**: 按 provider/model 配置并发上限
- **类别**: 按领域的任务委托(`visual`、`business-logic`、自定义)
- **Hooks**: 25+ 内置 Hook,都可以通过 `disabled_hooks` 控制
- **MCPs**: 内置 websearchExa)、context7(文档)、grep_appGitHub 检索)
- **LSP**: 包括重构工具的完整 LSP 支持
- **Experimental**: 激进截断、自动 resume 等
## 闲聊环节 (Author's Note)
**想知道做这个插件的哲学理念吗?** 阅读 [Ultrawork 宣言](docs/manifesto.md)。
**想知道做这个插件的哲学理念吗?** 阅读 [Ultrawork Manifesto](docs/manifesto.md)。
---
@@ -318,7 +358,7 @@ Agent 会自动顺藤摸瓜加载对应的 Context,免去了你所有的手动
我踩过的坑、撞过的南墙,它们的终极解法现在全都被硬编码到了这个插件里。你只需要安装,然后直接用。
如果把 OpenCode 喻为底层的 Debian/Arch,那么 OmO 毫无疑问就是开箱即用的 Ubuntu/[Omarchy](https://omarchy.org/)。
如果把 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。
@@ -329,7 +369,7 @@ Agent 会自动顺藤摸瓜加载对应的 Context,免去了你所有的手动
- 谁是修 Bug 的神?
- 谁文笔最好、最不 AI 味?
- 谁能在前端交互上碾压一切?
- 后端性能谁来
- 后端性能谁来
- 谁又快又便宜适合打杂?
- 竞争对手们今天又发了啥牛逼的功能,能抄吗?
@@ -340,17 +380,17 @@ Agent 会自动顺藤摸瓜加载对应的 Context,免去了你所有的手动
听起来很自大吗?如果你有更牛逼的实现思路,那就交 PR,热烈欢迎。
郑重声明:本项目与文档中提及的任何框架/大模型供应商**均无利益相关**,这完完全全就是一次走火入魔的个人硬核实验成果。
郑重声明:本项目与文档中提及的任何框架大模型供应商**均无利益相关**,这完完全全就是一次走火入魔的个人硬核实验成果。
本项目 99% 的代码都是直接由 OpenCode 生成的。我本人其实并不懂 TypeScript。**但我以人格担保,这个 README 是我亲自审核并且大幅度重写过的。**
## 以下公司的专业开发人员都在用
- [Indent](https://indentcorp.com)
- 开发了 Spray - 意见领袖营销系统, vovushop - 跨境电商独立站, vreview - AI 赋能的电商买家秀营销解决方案
- 开发了 Spray意见领袖营销系统)、vovushop跨境电商独立站)、vreviewAI 赋能的电商买家秀营销解决方案)。
- [Google](https://google.com)
- [Microsoft](https://microsoft.com)
- [ELESTYLE](https://elestyle.jp)
- 开发了 elepay - 全渠道移动支付网关, OneQR - 专为无现金社会打造的移动 SaaS 生态系统
- 开发了 elepay全渠道移动支付网关)、OneQR专为无现金社会打造的移动 SaaS 生态系统)。
*特别感谢 [@junhoyeo](https://github.com/junhoyeo) 为我们设计的令人惊艳的首图(Hero Image)。*