我以为 npm 装完就结束了，直到 Oh My OpenCode 真正生效

前面我们安装了 OpenCode，使用过程中感受到了它的强大和复杂。而 Oh My OpenCode，可以把它理解成 OpenCode 世界里的「精装修方案」。

很多人第一次用 OpenCode，会有一种既兴奋又别扭的感觉：能力很强，但各种配置、Agent、模型、插件散落在不同地方，需要自己一点点拼起来。直到你真正用过 Oh My OpenCode，才会意识到，它解决的并不是“功能不够”，而是“上手成本太高”。

安全警告：ohmyopencode.com 与本项目无关。 我们不运营或认可该网站。

https://github.com/code-yeongyu/oh-my-opencode/blob/dev/README.zh-cn.md

# 一、快捷键和基本交互

OpenCode 的 TUI（终端界面）有一套非常克制，却高效的交互设计：

•@：引用文件、代码、Agent，这是与 AI 协作的核心能力•TAB：切换模式•!：直接执行 Bash 命令•/：系统命令入口
/init 初始化项目
/compact 压缩上下文
/new、/sessions 管理会话•exit：退出

这些设计本质上是在终端里构建一个“可组合的 AI 工作环境”，而不是简单的聊天窗口。

# 二、为什么要有 Oh My Zsh？

先用一个熟悉的例子来导入。

Zsh 本身非常强，但配置复杂：补全、主题、插件、快捷键，全得靠自己折腾。

Oh My Zsh 出现后，把这些繁琐的事情全部社区化、模板化，一条命令就能获得“看起来像高手”的终端环境。

一句话总结：

•zsh：能力强，但上手难。•oh-my-zsh：隐藏复杂度，让你直接进入工作状态。

# 三、OpenCode 与 Oh My OpenCode 的类比

这个逻辑，在 OpenCode 上几乎完全的复刻。

OpenCode（像 Zsh） 是“骨架”和“引擎”，提供底层能力：模型调用、上下文管理、容器化执行和Agent 框架。

Oh My OpenCode（像 Oh My Zsh） 是“灵魂”和“管家”，在 OpenCode 之上：

•预装常用 Agent。•集成插件体系。•提供合理的默认模型配置。•把最佳实践直接变成开箱即用的体验。

它的理念很简单： 你不需要一开始就懂一切，但你用的“已经是调校过的正确姿势”。

# 四、我踩过的坑：npm 装了，却好像没效果？

一开始我走的“自信流”：

npm install -g oh-my-opencode

安装过程没报错，但重新进入 OpenCode 之后：

•@ 看不到新增的 agent。•opencode agent list 查看也没有 oracle、 librarian。

当时的第一反应是： “是不是我哪里漏配了？” 

但翻文档，也看不出什么端倪。那就从零开始，然后对比配置的差异。

# 五、最省心的重装方式（强烈推荐）

在 Windows 下，我直接做了这一件事：

删除目录：

然后，完全按照官方 README 的方式重新安装，让 AI 帮我生成配置。官方文档： 

https://github.com/code-yeongyu/oh-my-opencode/blob/dev/README.zh-cn.md#面向人类用户

按照以下说明安装和配置 oh-my-opencode：

重新进入 OpenCode 后，一切都对了：

•@ 能看到官网提到的所有 Agent。•oracle、librarian、explore 的 Agent 全部就位。•插件和模型配置好一次性生效。

它做了些什么呢？

查看 OpenCode 的配置。主要做了两件事情：配置添加插件 oh-my-opencode，为不同的 Agent 配置了合理的大模型。

那一刻的感觉就是： 不是工具不行，是你之前没用上它“完全态”。

# 六、Oh My OpenCode 到底帮你做了什么？

它主要干了三件非常关键的事：

1.Agent 体系预置 不再是一个“通用 AI”，而是一组各司其职的智能体。2.插件化扩展 像 Zsh 插件一样，可以按需增强能力，而不是侵入源码核心。3.模型与工作流的默认方案 不用纠结“该用哪个模型”，先用对的，再慢慢替换成你自己最优的。

把 Agent 的模型替换为自己使用的模型。

字节方舟也搞 Coding Plan 了，首月 8.9，可以试试。

方舟 Coding Plan 支持 Doubao、GLM、DeepSeek、Kimi 等模型，工具不限，现在订阅折上9折，低至8.9元，订阅越多越划算！立即订阅：https://volcengine.com/L/FRWng3MO4k0/ 邀请码：VMFFD5G5

# 七、核心 Agent 一次说明白

这些 Agent 的命名，其实非常讲究（features.md）：

•Sisyphus（西西弗斯） 在永远推着巨石上山的那个人。LLM智能体也每天不断地推动它们的“石头”：思考、分析、执行。我们也是：写代码、改需求、修补BUG。它是功能强大的 OpenCode AI 编排智能体，专注于调度资源、拆解任务和持续推进，是技术负责人。•oracle 逻辑推理和深度分析能力。架构、代码审查、策略判断。•librarian 文档查找、多仓库分析，提供基于证据的答案。•explore 快速代码库探索和模式匹配，带上下文的高级grep。

如果给智能体足够好的工具，以及可靠的“队友”，它们能像一个成熟的开发团队一样的工作。

LLM智能体和我们没有区别。如果你给它们（其他智能体）优秀的工具和可靠的队友，它们可以写出和我们一样出色的代码，工作的同样的优秀。

https://github.com/code-yeongyu/oh-my-opencode/blob/dev/README.zh-cn.md

# 八、工作模式：ultrawork 与 ultrathinking

Oh My OpenCode 提供了一个快速使用、极其简单却强大的魔法入口：

•ultrawork / ulw 全力干活模式。所有提供的功能都会像魔法一样开始运行：并行智能体、后台任务、深度探索，以及不懈执行直到完成。智能体会自动理解处理其他的。•ultrathinking 深度思考模式，彻底想清楚。慢一点，但想的更深，更严谨。

这和你写代码时“先想清楚”还是“先跑起来”，是同一种取舍。

# 九、总结一句话

OpenCode 是能力底座， Oh My OpenCode 是经验的结晶。

如果你把它当成“又一个 AI 工具”，会低估它； 如果你把它当成“一个已经帮你配好环境、分好角色的虚拟开发团队”，你会突然意识到：

原来很多复杂，并不是必要的。

将来，你是AI团队的负责人，智能体负责推石头，它们不会停下，直到事情真正的完成。