Easy Code (formerly DeepV Code) — A highly customizable AI coding assistant compatible with all major AI models. The perfect alternative to Claude Code and Codex, offering deep code analysis, intelligent suggestions, version rollback, multi-device sync, and automated testing…
$git clone https://github.com/orionstarai/easycodeInstalls into the current project.
Install easycode by running `git clone https://github.com/orionstarai/easycode`, then use it for the current task and follow its documentation at https://github.com/orionstarai/easycode.
| 1 | <div align="center"> |
| 2 | |
| 3 | # 🚀 Easy Code |
| 4 | |
| 5 | ### **AI 驱动的智能编程助手** |
| 6 | |
| 7 | *赋能开发者,加速创新* |
| 8 | |
| 9 | > ℹ️ **品牌升级提示**:本项目原名 **Easy Code**,现已统一更名为 **Easy Code**。 |
| 10 | > 包名、命令名、配置目录在过渡期内保留旧名(`easycode-ai` / `easycode` / `.easycode/` 等)以保证向后兼容;后续新文档与界面均使用新品牌名。 |
| 11 | |
| 12 | <br> |
| 13 | |
| 14 | [](LICENSE) |
| 15 | [](https://nodejs.org/) |
| 16 | [](https://www.typescriptlang.org/) |
| 17 | [](https://www.npmjs.com/package/easycode-ai) |
| 18 | [](https://code.visualstudio.com/) |
| 19 | |
| 20 | <br> |
| 21 | |
| 22 | [English](./README_EN.md) | **简体中文** |
| 23 | |
| 24 | <br> |
| 25 | |
| 26 | <!-- 如果有演示 GIF,取消下面这行注释 --> |
| 27 | <!-- <img src="docs/assets/demo.gif" alt="Easy Code Demo" width="800"> --> |
| 28 | |
| 29 | </div> |
| 30 | |
| 31 | --- |
| 32 | |
| 33 | ## 📖 目录 |
| 34 | |
| 35 | - [项目简介](#-项目简介) |
| 36 | - [为什么选择 Easy Code](#-为什么选择-easycode-ai) |
| 37 | - [核心特性](#-核心特性) |
| 38 | - [快速安装](#-快速安装) |
| 39 | - [快速开始](#-快速开始) |
| 40 | - [CLI 命令参考](#-cli-命令参考) |
| 41 | - [交互式斜杠命令](#-交互式斜杠命令) |
| 42 | - [项目架构](#️-项目架构) |
| 43 | - [VS Code 扩展](#-vs-code-扩展) |
| 44 | - [内置工具系统](#️-内置工具系统) |
| 45 | - [MCP 协议支持](#-mcp-协议支持) |
| 46 | - [Hooks 钩子机制](#-hooks-钩子机制) |
| 47 | - [配置文件](#️-配置文件) |
| 48 | - [开发指南](#-开发指南) |
| 49 | - [常见问题](#-常见问题) |
| 50 | - [贡献指南](#-贡献指南) |
| 51 | - [路线图](#️-路线图) |
| 52 | - [许可证](#-许可证) |
| 53 | - [相关链接](#-相关链接) |
| 54 | |
| 55 | --- |
| 56 | |
| 57 | ## ✨ 项目简介 |
| 58 | |
| 59 | **Easy Code** 是一款革命性的 AI 驱动智能编程助手,通过深度整合人工智能技术,全面提升软件开发的效率、质量和创新能力。 |
| 60 | |
| 61 | 不同于传统的代码补全工具,Easy Code 是一个能够**理解整个项目上下文**、**自主编排工具完成复杂任务**的智能代理(Agent)。它将开发者从繁琐重复的工作中解放出来,让你专注于更高层次的创新和问题解决。 |
| 62 | |
| 63 | ### 💡 Easy Code 能做什么? |
| 64 | |
| 65 | ``` |
| 66 | 👤 你:帮我分析这个项目的架构,找出性能瓶颈,并给出优化方案 |
| 67 | |
| 68 | 🤖 Easy Code: |
| 69 | ├── 📂 扫描项目结构,理解模块依赖 |
| 70 | ├── 🔍 分析代码热点和复杂度 |
| 71 | ├── 📊 识别潜在的性能问题 |
| 72 | ├── 💡 生成优化建议和重构方案 |
| 73 | └── ✏️ 自动应用修改(经你确认后) |
| 74 | ``` |
| 75 | |
| 76 | --- |
| 77 | |
| 78 | ## 🌟 为什么选择 Easy Code |
| 79 | |
| 80 | <table> |
| 81 | <tr> |
| 82 | <td width="50%"> |
| 83 | |
| 84 | ### 🎯 与传统 AI 编码助手的区别 |
| 85 | |
| 86 | | 特性 | 传统工具 | Easy Code | |
| 87 | |:---:|:---:|:---:| |
| 88 | | 上下文范围 | 单文件 | **整个项目** | |
| 89 | | 交互方式 | 被动补全 | **主动代理** | |
| 90 | | 任务复杂度 | 简单补全 | **复杂工作流** | |
| 91 | | 工具调用 | 无 | **Shell/文件/Web** | |
| 92 | | 会话管理 | 无 | **持久化会话** | |
| 93 | | 可扩展性 | 受限 | **MCP/Hooks/Skills** | |
| 94 | |
| 95 | </td> |
| 96 | <td width="50%"> |
| 97 | |
| 98 | ### 🚀 核心优势 |
| 99 | |
| 100 | - **🧠 深度理解** - 通过 MCP 协议构建完整项目认知 |
| 101 | - **🛠️ 自主执行** - AI 可调用工具完成实际操作 |
| 102 | - **🔄 持续对话** - 会话保存/恢复,上下文不丢失 |
| 103 | - **🎨 多端支持** - CLI + VS Code 插件 |
| 104 | - **🔌 高度可扩展** - Hooks、Skills、MCP 服务器 |
| 105 | - **🔒 安全可控** - 敏感操作需用户确认 |
| 106 | |
| 107 | </td> |
| 108 | </tr> |
| 109 | </table> |
| 110 | |
| 111 | --- |
| 112 | |
| 113 | ## 🎯 核心特性 |
| 114 | |
| 115 | ### 🧠 AI 驱动的代码生成与重构 |
| 116 | |
| 117 | - **智能代码生成** - 根据自然语言描述生成完整的函数、类、模块甚至整个应用 |
| 118 | - **代码重构建议** - 识别代码异味,提供优化方案,自动统一代码风格 |
| 119 | - **Bug 智能修复** - 分析错误堆栈,定位问题根源,生成修复代码 |
| 120 | - **多语言支持** - TypeScript、JavaScript、Python、Go、Rust、Java 等主流语言 |
| 121 | |
| 122 | ### 🔍 智能调试与问题解决 |
| 123 | |
| 124 | - **错误日志分析** - 深入解析错误信息,快速定位问题 |
| 125 | - **堆栈追踪诊断** - 理解调用链路,找出异常根因 |
| 126 | - **自动修复执行** - 生成修复方案,一键应用(需确认) |
| 127 | - **增强调试控制台** - `Ctrl+O` 三状态循环:全部日志 → 仅错误 → 关闭,智能过滤错误信息 |
| 128 | |
| 129 | ### 📦 高级上下文管理 (MCP) |
| 130 | |
| 131 | Model Context Protocol (MCP) 是 Easy Code 的核心创新: |
| 132 | |
| 133 | - **全局项目视图** - 理解文件结构、模块依赖、代码语义 |
| 134 | - **跨文件分析** - 追踪函数调用链、类型引用、导入导出 |
| 135 | - **智能上下文选择** - 自动识别与任务相关的文件和代码段 |
| 136 | - **第三方 MCP 服务器** - 接入外部数据源和工具 |
| 137 | |
| 138 | ### 🛠️ 可扩展工具系统 |
| 139 | |
| 140 | AI 通过工具与外部环境交互,内置丰富工具集: |
| 141 | |
| 142 | ``` |
| 143 | 📁 文件操作 → read_file, write_file, replace, delete_file, glob |
| 144 | 🔍 代码搜索 → grep (ripgrep), read_many_files |
| 145 | 💻 命令执行 → shell (bash/powershell) |
| 146 | 🌐 网络访问 → web_fetch, web_search (Google) |
| 147 | 🧩 MCP 工具 → 调用任意 MCP 服务器提供的工具 |
| 148 | 📊 代码分析 → task (启动分析子 Agent) |
| 149 | 📝 任务管理 → todo_write |
| 150 | 💾 记忆系统 → memory (长期记忆) |
| 151 | ``` |
| 152 | |
| 153 | ### 🪝 Hooks 钩子机制 |
| 154 | |
| 155 | 在关键工作流节点注入自定义逻辑: |
| 156 | |
| 157 | - **PreToolExecution** - 工具执行前触发 |
| 158 | - **PostToolExecution** - 工具执行后触发 |
| 159 | - **OnSessionStart** - 会话开始时触发 |
| 160 | - **OnSessionEnd** - 会话结束时触发 |
| 161 | |
| 162 | 支持自动化代码检查、格式化、提交前验证等场景。 |
| 163 | |
| 164 | ### 🔄 会话管理 |
| 165 | |
| 166 | - **会话持久化** - 自动保存对话历史和上下文 |
| 167 | - **会话恢复** - 随时继续之前的工作 |
| 168 | - **历史压缩** - 智能压缩对话历史,节省 Token |
| 169 | - **检查点恢复** - 文件修改可回滚到之前状态 |
| 170 | |
| 171 | --- |
| 172 | |
| 173 | ## 📦 快速安装 |
| 174 | |
| 175 | ### 系统要求 |
| 176 | |
| 177 | - **Node.js** 20.0.0 或更高版本 |
| 178 | - **操作系统** Windows / macOS / Linux |
| 179 | - **终端** 支持 ANSI 颜色的终端模拟器 |
| 180 | |
| 181 | ### 方式一:npm 全局安装(推荐) |
| 182 | |
| 183 | ```bash |
| 184 | # 使用 npm |
| 185 | npm install -g easycode-ai |
| 186 | |
| 187 | # 使用 yarn |
| 188 | yarn global add easycode-ai |
| 189 | |
| 190 | # 使用 pnpm |
| 191 | pnpm add -g easycode-ai |
| 192 | ``` |
| 193 | |
| 194 | 安装完成后,验证安装: |
| 195 | |
| 196 | ```bash |
| 197 | easycode --version |
| 198 | ``` |
| 199 | |
| 200 | ### 方式二:从源码构建 |
| 201 | |
| 202 | ```bash |
| 203 | # 1. 克隆仓库 |
| 204 | git clone https://github.com/OrionStarAI/EasyCodeCode.git |
| 205 | cd |