Easy Coding Agents

ECA — Easy Coding Agent

ECA Desktop 1.0.0（Windows x64）：桌面工程位于 desktop/，支持多项目与多会话并发、主对话与侧聊附件、网页预览、PowerShell 交互终端，以及按需打开的修改审查。与 CLI 共用 Python 核心和项目数据。下载桌面版 · 安装、开发与验收说明。npm 启动器同时提供 eca 和兼容命令 ecs。

新 Agent 接手请先读 完整接力文档：包含本机路径、未提交代码状态、依赖、G 盘缓存、打包更新、测试与陶土界面约定。

主 Agent 默认不限响应轮数和输出截断恢复次数，可用 Ctrl+C 中断。旧配置中的显式上限仍有效，可运行 ecs --max-turns 0 --output-recovery-limit 0 取消这两项限制。模型单次输出上限、子 Agent 限额和共享预算的区别见 输出与持续执行配置。

你的项目，你的模型。
通过终端或桌面理解代码、执行修改，并检查每一步留下的结果。

  快速开始 ·
  使用手册 ·
  更新记录 ·
  贡献指南 ·
  验证记录

CLI + Windows Desktop · v1.0.0 · 首个公开版本

ECA（Easy Coding Agent）是一个可自行配置模型的编程助手，提供 CLI 和 Windows 桌面入口，共用 Python 核心。它可以读取与搜索项目、编辑文件、运行命令，并把完整会话和文件修改记录保存在项目本地。桌面安装包自带运行时；CLI 运行需要 Python 3.11+。

它重视三件事：改动可检查、工作可继续、记忆有来源。 你可以先看差异再允许写入，中断后恢复会话，也可以检查或撤销文件工具产生的修改。
当前适合个人试用、开发与研究。基础机制已有自动化测试，但真实复杂任务的稳定性仍在验证中；尚未达到成熟编码 CLI 的功能覆盖与可靠性。

大仓库定位：/related SYMBOL 查看定义与 Python 调用/导入候选；模型的 code_search、repo_map、code_relations 支持目录筛选与增量读取统计。用法与验证边界。

下载桌面版

最新版本 提供 Windows x64 安装包（ECA-Desktop--x64-Setup.exe，约 160 MB，自带 Python 运行时，无需另外装环境）：

1. 下载并运行安装包，按向导完成安装（默认装在 G:\Apps\ECA Desktop，可在向导里改）
2. 打开应用，在「模型与设置」里添加一个你自己的模型连接——DeepSeek / OpenAI / Anthropic，或任何兼容 OpenAI 协议的端点——并填入 API 密钥
3. 选择项目文件夹，开始对话；之后每次启动会直接回到你上次打开的项目

安装包未购买代码签名证书：Windows SmartScreen 会提示「未知发布者」，需要点「更多信息 → 仍要运行」。每个版本都在说明里给出 SHA256，可以先核对再安装，详见 未签名分发说明。

桌面版目前只支持 Windows x64。macOS / Linux 可用 CLI，见下方快速开始。

用着有问题或有建议，欢迎开 Issue；请附上版本号、你用的模型，以及复现步骤。

可选多模型协作

默认只需一个 API，原有用法不变。需要时额外配置云端或本地 Worker，并通过 worker_profiles 显式开启，主 Agent 才能按子任务选择模型。不会自动下载本地模型；具体小模型需要支持工具调用并经过任务验证。配置示例

还可以显式启用 Worker → 检查 → 主模型修复链路：--worker-first 指定先执行的模型，只有检查失败且配置修复预算时才调用主模型接手。

能做什么

快速开始

需要 Python 3.11+ 和支持工具调用的模型 API。

1. 安装终端命令

已有本地 npm 安装包时（需要 Node.js 20+ 和 Python 3.11+）：

首次启动自动建立独立 Python 环境并安装依赖，之后直接输入 ecs 即可。当前包尚未发布到 npm 官网；使用本地安装包无需 npm 账号。G…