Oh My Coder - AI 多 Agent 协作编程助手

核心特性

31 个专业 Agent + 5 大创新系统，覆盖完整开发流程

🚀

构建通道（9 Agent）

Explore → Analyst → Planner → Architect → Executor → Verifier → Debugger → Tracer → Performance

🔍

审查通道（2 Agent）

CodeReviewer + SecurityReviewer 双重审查，质量+安全双重保障

🎯

领域通道（16 Agent）

测试、设计、视觉、Git、数据库、API、DevOps、UML、迁移、数据处理等专业 Agent

🧙

协调通道（4 Agent）

Prompt 优化、自我改进、Skill 沉淀、批判分析，系统越用越聪明

📖

主动学习模块

任务执行中自动提取可复用经验，沉淀为 Skill，系统越用越聪明

🔄

Scale 自进化系统

根据任务复杂度动态调整 Agent 数量和策略，简单任务单 Agent 快速完成，复杂任务多 Agent 协同

🧩

分层记忆系统

原始日志 → 精炼知识 → 索引检索三层架构，支持跨会话记忆持久化和智能召回

🎯

工作目录上下文感知

自动分析项目结构、技术栈、代码风格，生成精准的系统提示词，减少幻觉

⚡

上下文自动压缩

智能压缩对话历史，保留关键信息，节省 60% Token 消耗，响应速度提升 3 倍

💰

零成本起步

GLM-4.7-Flash 完全免费，DeepSeek 新用户赠送余额，无需信用卡

快速开始

3 分钟上手，选择适合你的方式

📋 第 0 步：检查 Python（必做！）

🖥️ 怎么打开终端（就是一个输入命令的小黑窗）：

Mac	按 Command ⌘ + 空格键，输入「终端」或「Terminal」，按回车
Windows	按 Win 键 + R，输入 `cmd`，按回车

打开终端后，复制下面这行粘贴进去按回车：

python3 --version

✅ 看到 Python 3.9.x 或更高 → 没问题，继续！
❌ 如果提示找不到 → 去 python.org 下载安装 Python 3.9+，安装完重新打开终端再试

👉 跟着做：复制每行，粘贴到终端按回车

                    # 第 1 步：安装 oh-my-coder

                    pip3 install oh-my-coder

                    # 第 2 步：验证安装成功

                    omc --version

                    # 第 3 步：配置 API Key（推荐用免费 GLM-4-Flash）

                    # 获取 Key：https://open.bigmodel.cn → 注册 → 创建 API Key

                    omc config set -m glm -k api_key -v "你的API Key"

                    omc config set -k DEFAULT_MODEL -v glm-4-flash

                    # 第 4 步：开始使用！

                    # 简单任务（如创建文件），加 --simple 或 -s 秒出结果

                    omc run --simple "帮我在桌面创建一个 hello.txt"

                    # 复杂任务（如分析代码），去掉 --simple 走完整工作流

                    omc run "帮我分析这个项目"

⚠️ 遇到问题？

• omc 说找不到命令 → 粘贴这行：export PATH="$HOME/Library/Python/3.9/bin:$PATH" 再试
• 简单任务卡住 → 加 --simple 跳过工作流直接执行：omc run --simple "你的任务"
• 更多问题 → 见下方「常见问题」

📋 第 0 步：打开「终端」+ 检查 Python（必做！）

🖥️ 怎么打开终端（就是一个输入命令的小黑窗）：

Mac	按 Command ⌘ + 空格键，输入「终端」或「Terminal」，按回车
Windows	按 Win 键 + R，输入 `cmd`，按回车

打开终端后，复制下面这行粘贴进去按回车：

python3 --version

✅ 看到 Python 3.9.x 或更高 → 没问题，继续！
❌ 如果提示找不到 → 去 python.org 下载安装 Python 3.9+，安装完重新打开终端再试

👉 跟着做：复制每行，粘贴到终端按回车

                    # 第 1 步：把项目下载到电脑

                    git clone https://github.com/vobc/oh-my-coder.git

                    cd oh-my-coder

                    # 第 2 步：安装依赖（大概 30 秒）

                    pip3 install -e ".[web]"

                    # 第 3 步：注册到系统（让 omc 命令全局可用）

                    pip3 install -e .

                    # （如果提示 omc 找不到，运行下面这行再试）

                    # export PATH="$HOME/Library/Python/3.9/bin:$PATH"

                    # 第 4 步：启动 Web 服务（浏览器会自动打开）

                    omc server start

                    # 如果浏览器没自动打开，手动访问 http://localhost:8080

                    # 第 4 步：在网页中配置 API Key（点击右上角 ⚙️ 设置）

                    #    - 选择模型（推荐免费：GLM-4-Flash）

                    #    - 获取 Key：https://open.bigmodel.cn → 注册 → API Keys

                    #    - 粘贴 API Key → 点击"测试连接"验证 → 开始使用

⚠️ 遇到问题？

• 浏览器没自动打开 → 手动复制 http://localhost:8080 到浏览器地址栏
• omc 说找不到命令 → 粘贴：export PATH="$HOME/Library/Python/3.9/bin:$PATH" 再试
• 更多问题 → 见下方「常见问题」

📋 第 0 步：检查 Node.js（必做！）

🖥️ 怎么打开终端（就是一个输入命令的小黑窗）：

Mac	按 Command ⌘ + 空格键，输入「终端」或「Terminal」，按回车
Windows	按 Win 键 + R，输入 `cmd`，按回车

打开小黑窗后，复制下面两行，每行粘贴进去按回车：

node --version
git --version

✅ 看到类似 v18.x.x 的版本号 → 没问题，继续往下做！
❌ 看到「找不到命令」或「不是内部命令」→ 需要先安装 Node.js：
👉 点这里下载 Node.js（选 LTS 那个绿色按钮）→ 下载完双击安装 → 安装完重新打开终端再试一次

👉 跟着做：复制每行，粘贴到终端按回车

                    # 第 1 步：把项目下载到电脑（大概 10 秒）

                    # ⚠️ 如果提示「目录已存在」，说明你之前下过，跳过这行，直接做下一行 cd

                    git clone https://github.com/VOBC/oh-my-coder.git || true

                    cd oh-my-coder/desktop

                    # 第 2 步：设置国内下载加速（国内用户必须做，否则会卡住）

                    export ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/

                    # 第 3 步：安装运行所需文件（大概 1-3 分钟，耐心等）

                    # 看到「added XXX packages」字样就说明成功啦 ✅

                    npm install

                    # ✅ 看到「added」字样就是安装成功！直接启动：

                    # 第 4 步：一键启动（一条命令搞定）

                    node start.js

                    # 看到「🎉 Desktop 已启动」字样，桌面窗口会自动弹出来 🎉

✅ 启动成功后，配置一下就能用了

① 桌面窗口右上角找到 ⚙️ 设置图标，点进去
② 选择模型（推荐用免费的 GLM-4-Flash，不用花钱）
③ 去这里注册拿 Key：open.bigmodel.cn → 注册 → 创建 API Key
④ 把 Key 粘贴进去 → 点「测试连接」→ 显示 ✅ Connected → 开始聊天！

💬 小技巧：点输入框旁边的 🎤 按钮可以语音输入，自动识别中文

⚠️ 遇到问题？先看这里：

1. 粘贴命令后没有任何反应 / 报错
  → 先确认第 0 步的 Node.js 安装成功了（看到版本号）
  → 再试一次：rm -rf node_modules package-lock.json && npm install

2. 跑 node start.js 后卡住 / 没有反应
  → 按一下回车，可能只是光标停在等待状态
  → 确认能看到「⚡ 启动 Vite」和「✅ Vite 已就绪」字样
  → 确认端口 1420 没被占用：lsof -ti:1420 | xargs kill -9

3. 提示「port 1420 被占用」
  → 粘贴这行命令：lsof -ti:1420 | xargs kill -9，然后再启动

4. 窗口是白的 / 没内容
  → 看终端里有没有显示「ready in xxx ms」，没有的话重做第 3 步

5. 不能用语音输入
  → Mac：系统设置 → 隐私与安全性 → 麦克风 → 勾选 Terminal 或 Electron

💡 新手推荐：想最快体验 → 选 CLI；想要图形界面 → 选 Web 或 Desktop。Web 和 Desktop 可在界面内直接配置 API Key；CLI 用 omc config set 命令配置。三种方式修改的是同一个配置文件，任选其一即可。

国产首个
多 Agent 协作编程框架

🔒 企业级安全合规

完全本地运行

密钥本地存储

国产模型直连

自动安全审查

Diff 预览确认

开源可审计

核心特性

构建通道（9 Agent）

审查通道（2 Agent）

领域通道（16 Agent）

协调通道（4 Agent）

主动学习模块

Scale 自进化系统

分层记忆系统

工作目录上下文感知

上下文自动压缩

零成本起步

Agent 工作流

Planner

Coder

Reviewer

Executor

界面预览

快速开始

常见问题

安装配置

使用教程

模型选择

故障排查

国产首个 多 Agent 协作编程框架

🔒 企业级安全合规

完全本地运行

密钥本地存储

国产模型直连

自动安全审查

Diff 预览确认

开源可审计

核心特性

构建通道（9 Agent）

审查通道（2 Agent）

领域通道（16 Agent）

协调通道（4 Agent）

主动学习模块

Scale 自进化系统

分层记忆系统

工作目录上下文感知

上下文自动压缩

零成本起步

Agent 工作流

Planner

Coder

Reviewer

Executor

界面预览

快速开始

常见问题

安装配置

使用教程

模型选择

故障排查

国产首个
多 Agent 协作编程框架