🛡️ 国产替代方案 · 本地运行 · 数据不出境

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

31 个专业 Agent · 12 家国产大模型 · 完全本地运行
代码不上传云端，数据不出境，中小企业合规首选

⚡ 3 分钟上手 ⭐ GitHub Star
31
专业 Agent
12+
国产模型
0
元起步
100%
本地运行
omc run "实现用户登录功能"
$ omc run "实现用户登录功能"
📋 Planner 分析需求：需要 JWT 认证 + 密码哈希 + 数据库模型
💻 Coder 生成代码：auth.py, models.py, routes.py (156 行)
👀 Reviewer 代码审查：发现 2 处安全问题，已修复
⚡ Executor 运行测试：✅ 12/12 通过
✅ 任务完成！代码已保存到 src/auth/

## 🔒 企业级安全合规

🏠

### 完全本地运行

代码在本地处理，不上传任何云端服务器，源代码不会离开你的机器

🔐

### 密钥本地存储

API Key 仅保存在本地环境变量，不存储在第三方服务器，企业数据自主可控

✅

### 国产模型直连

支持 DeepSeek、智谱 GLM、Kimi 等 12 家国产大模型，无需翻墙，合规使用

🛡️

### 自动安全审查

内置 SecurityReviewerAgent，自动扫描漏洞：SQL 注入、XSS、硬编码密钥等

📋

### Diff 预览确认

修改文件前预览变更内容，GitMasterAgent 管理版本，避免误操作

🔓

### 开源可审计

MIT 开源协议，代码完全透明，支持私有化部署、二次开发、安全审计

## 核心特性

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 新用户赠送余额，无需信用卡

## Agent 工作流

像团队一样协作，比一个人更高效

📋

#### Planner

分析需求
制定计划

→
💻

#### Coder

编写代码
生成测试

→
👀

#### Reviewer

代码审查
安全检查

→
⚡

#### Executor

运行测试
部署执行

## 界面预览

CLI 命令行、Web 界面、Desktop 桌面端三种使用方式

终端运行 `omc agents` 查看 31 个智能体

Web 界面 — 多个模型可选，5 步工作流自动执行

Electron 桌面应用，支持多 Agent 状态指示器和实时日志面板

## 快速开始

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` 命令配置。三种方式修改的是同一个配置文件，任选其一即可。

## 常见问题

快速找到答案，开始使用

📦

### 安装配置

如何安装、配置 API Key、验证安装

🚀

### 使用教程

第一次使用、CLI vs Web、工作流选择

🤖

### 模型选择

选哪个模型、多 Key 配置、Key 泄露处理

🔧

### 故障排查

Key 未配置、超时、代码错误修复

查看全部 15+ 个问题 →
💬
✉️
yangchenyu2050@sina.com