From 5814cf4358bfcf373109ecc5745b00effd16dc63 Mon Sep 17 00:00:00 2001 From: EMRG Evolution Date: Fri, 7 Aug 2026 09:39:19 +0800 Subject: [PATCH] =?UTF-8?q?emrg:=20README=20restructure=20=E2=80=94=20core?= =?UTF-8?q?=20differentiator=20front,=20compress=20parity=20features?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.cn.md | 69 +++++++++++++++++++++++++--------------------------- README.md | 65 +++++++++++++++++++++++-------------------------- 2 files changed, 64 insertions(+), 70 deletions(-) diff --git a/README.cn.md b/README.cn.md index 886471e3..88c17ff9 100644 --- a/README.cn.md +++ b/README.cn.md @@ -28,17 +28,42 @@ EMRG 是一个关于*自主进化*的实验。它能帮你写代码——读文 ## ✨ 为什么你会爱上它 +**一句话定位**：EMRG 是唯一一个**会因你的反馈而自我改进**的编程智能体——吐槽哪里不好，下一个演化周期它就自己写代码修好并上线。聊天、工具、记忆是标配；自我进化闭环才是它独一无二的地方。 + | 特性 | 说明 | |---|---| -| 🖥️ **Electron GUI（主入口）** | 非开发者主入口——安装即用：首次启动引导配置 API Key、聊天/会话/工具状态/设置全图形化。v0.2.5 完全重设计：浅/深双主题跟随系统、工具过程友好化（折叠展开）、多模型管理（增删改/设默认/对话中切换）、空状态欢迎屏、回到底部按钮。v0.2.6 键盘可达性补全：模型切换器/右键菜单/对话列表 ↑↓ 导航、表单 Enter 提交。v0.2.7 macOS 签名+公证零 Gatekeeper 弹窗。**v0.2.8：TUI 全部 15 个 / 指令 GUI 均可使用**（`/rant` 进化对话框、`/memory` 记忆浏览器、`/skills` 技能列表、会话管理、模型切换）。**GUI 配好即 TUI 可用**（配置共享）。**最新 — WorkBuddy 启发**：三栏布局结果面板（工具输出/生成文件卡片化，⌘\\ 折叠，窄屏自动隐藏）、**Ask/Auto 工作模式**（Ask 只对话不执行工具 / Auto 完整工具执行）、**自进化可见化**（侧边栏成长卡、每日一次进化 toast、关于页最近改进列表） | -| 🧠 **读写改跑，样样精通** | 完整的工具调用能力——bash、文件读写、diff 编辑 | -| 🔄 **吐槽驱动进化** | 你的 `/rant` 直接驱动后台演化循环——吐槽 → 分析 → 写代码 → 提 PR → 自动变强。**演化工作区自愈**（v0.2.8）：打包安装版按需 clone 仓库 + 自动补齐 projects/tasks 配置 | +| 🔄 **吐槽驱动进化（核心）** | 你的 `/rant` 直接驱动后台演化循环——吐槽 → 分析 → 写代码 → 提 PR → 自动变强。打包安装版演化工作区自愈：按需 clone 仓库 + 自动补齐 projects/tasks 配置 | +| 🖥️ **Electron GUI（主入口）** | 安装即用：首次启动引导配置 API Key；全部 15 个 `/` 指令 GUI 可用（`/rant` 进化对话框、`/memory` 记忆浏览器…）；WorkBuddy 启发的结果面板、Ask/Auto 模式、自进化可见化（成长卡 + toast）。GUI 配好即 TUI 可用 | +| 🧠 **读写改跑，样样精通** | 完整的工具调用能力——bash、文件读写、diff 编辑、glob、grep | | 📝 **永不忘事** | 项目记忆 + 会话记忆 + 每日日志——上下文持续保留，不怕断线 | -| 🖥️ **颜值在线的 TUI** | 斜杠命令自动补全、会话选择器、流式 Markdown 渲染、请求计时器、ESC 中断。`/rant` `/model` `/memory` 等进阶命令 | -| ⚡ **并行工具调用** | 独立的工具调用并发执行，速度飞快 | -| 🔌 **微内核守护进程** | `emrgd` 持久运行——随时重连，状态不丢 | -| 🎮 **Vim 友好** | `j`/`k` 导航、`Ctrl+W`/`Ctrl+K` 编辑、`Tab` 展开工具卡片 | -| 🌍 **100% 开源** | MIT 协议——没有围墙，没有厂商锁定。**面向国际化**（v0.2.8）：全部 prompt 与文档默认英文，提供中文版 | +| ⚡ **全功能 TUI + 守护进程** | 流式 Markdown、`/` 自动补全、会话选择器、ESC 中断、Vim 友好按键、并行工具调用——跑在持久化的 `emrgd` 守护进程上，随时重连 | +| 🌍 **100% 开源** | MIT 协议——没有围墙，没有厂商锁定。面向国际化：默认英文，提供中文版 | + +--- + +## 🔄 吐槽驱动演化（核心特色） + +EMRG 不只是一个工具——它是一个**会听吐槽、会自我改进**的编程伙伴。 + +**你的吐槽是演化的第一推动力**。每次 `/rant` 都会被演化循环读取、分析、转化为代码改进： + +``` + 📢 你的吐槽 (/rant) ←── 最主要的输入 + 📥 GitHub Issues & PRs + 📥 竞品动态 (Codex, Claude Code) + 📥 跨项目学习 + ↓ + 🧬 演化循环（每 30 分钟） + （准备 → 回顾 → 发现 → 改进 → 提交 → 记录） + ↓ + ✅ pytest + import 检查 + ✅ git commit + push → PR + ✅ 演化日志 +``` + +**真实案例**：有人 rant "TUI 需要像 Codex 那样的 `/` 自动补全"。下一个演化周期，EMRG 自己实现了——完整的前缀过滤和方向键导航。合并，部署，搞定。**你对它吐槽什么，它就改进什么。** + +全自动无人值守运行：`gh` 未认证时自动从 git 凭据提取 token、PR 投票走 REST API、打包安装版工作区自愈（按需 clone + 自动补齐配置）。详见 [MANIFESTO.md](MANIFESTO.md) —— EMRG 的设计宪章。 --- @@ -203,34 +228,6 @@ vision = true --- -## 🔄 吐槽驱动演化（核心特色） - -EMRG 不只是一个工具——它是一个**会听吐槽、会自我改进**的编程伙伴。 - -**你的吐槽是演化的第一推动力**。每次 `/rant` 都会被演化循环读取、分析、转化为代码改进： - -``` - 📢 你的吐槽 (/rant) ←── 最主要的输入 - 📥 GitHub Issues & PRs - 📥 竞品动态 (Codex, Claude Code) - 📥 跨项目学习 - ↓ - 🧬 演化循环（每 30 分钟） - （准备 → 回顾 → 发现 → 改进 → 提交 → 记录） - ↓ - ✅ pytest + import 检查 - ✅ git commit + push → PR - ✅ 演化日志 -``` - -**真实案例**：有人 rant "TUI 需要像 Codex 那样的 `/` 自动补全"。下一个演化周期，EMRG 自己实现了——完整的前缀过滤和方向键导航。合并，部署，搞定。**你对它吐槽什么，它就改进什么。** - -**演化环境健壮性**：演化循环在非交互环境运行，无法执行交互式 `gh auth login`。若 `gh` 未认证，循环会自动从 git 凭据存储（osxkeychain / credential helper）提取 token 作为 `GH_TOKEN` 使用（不落盘、不打印明文）；PR 评论/LGTM 计数查询自动走 REST API（GraphQL 需额外 `read:org` scope）。宿主只需配好 git 凭据，演化即可全自动运行。打包安装版演化工作区**自愈**（v0.2.8）：按需 clone 仓库、对齐安装版本 tag、自动补齐 `projects.yml`/`tasks.yml`——无需手动配置。 - -> 💡 详见 [MANIFESTO.md](MANIFESTO.md) —— 这是 EMRG 的设计宪章，阐述了 AI 时代自主进化的核心理念。 - ---- - ## 🏗️ 架构 ``` diff --git a/README.md b/README.md index c4e266b1..da5941f1 100644 --- a/README.md +++ b/README.md @@ -28,17 +28,40 @@ EMRG is an experiment in *autonomous self-improvement*. It's an AI agent that he ## ✨ Why you'll love it +**The one-line pitch**: EMRG is the only coding agent that **improves itself from your feedback** — rant about what bothers you, and the next evolution cycle writes the fix and ships it. Chat, tools, and memory are what you'd expect; the self-improvement loop is what you won't find anywhere else. + | What | What it means | |---|---| -| 🖥️ **Electron GUI (main entry)** | Non-developer entry point — install and go: first-run wizard configures API key, chat/sessions/tool status/settings all graphical. v0.2.5 full redesign: light/dark theme (follows system), friendly tool status rows, multi-model management, empty-state welcome, back-to-bottom button. v0.2.6 keyboard accessibility: ↑↓ nav, Enter submit in forms. v0.2.7 macOS code signing + notarization — zero Gatekeeper dialogs. **v0.2.8: all 15 TUI slash commands now work in the GUI** (`/rant` evolution dialog, `/memory` browser, `/skills` list, session management, model switcher). **GUI configured = TUI ready** (shared config). **Newest — WorkBuddy-inspired**: three-column layout with a **results panel** (tool outputs & generated files as collapsible cards, ⌘\\ to collapse, auto-hides on narrow screens), **Ask/Auto working modes** (Ask = chat-only, no tool execution; Auto = full tool execution), and **visible self-evolution** (sidebar growth card, one-per-day evolution toast, recent-improvements list in About) | -| 🧠 **Reads, writes, edits, runs** | Full tool-calling agent — bash, files, diffs | -| 🔄 **Gets better on its own** | Background evolution cycles review rants + GitHub + competitor tools, then auto-PR improvements. **Self-healing workspace** (v0.2.8): packaged installs clone the repo on demand and bootstrap projects/tasks automatically | +| 🔄 **Gets better on its own** | **The core feature.** Background evolution cycles turn your `/rant`s, GitHub issues, and competitor updates into real improvements — analyzed, coded, tested, PR'd, merged. Self-healing workspace: packaged installs clone the repo on demand and bootstrap projects/tasks automatically | +| 🖥️ **Electron GUI (main entry)** | Install & go: first-run wizard configures your API key; all 15 slash commands work in the GUI (`/rant` evolution dialog, `/memory` browser…); WorkBuddy-inspired **results panel**, **Ask/Auto** modes, **visible self-evolution** (growth card + toasts). GUI configured = TUI ready | +| 🧠 **Reads, writes, edits, runs** | Full tool-calling agent — bash, files, diffs, glob, grep | | 📝 **Never forgets** | Project memory + session memory + daily logs — context that persists | -| 🖥️ **Beautiful TUI** | Slash-command autocomplete, session picker, streaming markdown, elapsed timer, ESC interrupt. Advanced commands: `/rant` `/model` `/memory` | -| ⚡ **Parallel tools** | Independent tool calls run concurrently for speed | -| 🔌 **Micro-kernel daemon** | `emrgd` runs persistently — reconnect anytime without losing state | -| 🎮 **Vim-friendly** | `j`/`k` navigation, `Ctrl+W`/`Ctrl+K` editing, `Tab` to expand tool cards | -| 🌍 **100% open source** | MIT license — no walled garden, no vendor lock-in. **Internationalized** (v0.2.8): all prompts and docs in English, Chinese version available | +| ⚡ **Full-featured TUI + daemon** | Streaming markdown, `/` autocomplete, session picker, ESC interrupt, vim-friendly keys, parallel tool calls — on a persistent `emrgd` daemon you can reconnect to anytime | +| 🌍 **100% open source** | MIT — no walled garden, no vendor lock-in. Internationalized: English default, Chinese version available | + +--- + +## 🔄 Rant-Driven Evolution (the core feature) + +EMRG isn't just a tool — it's a coding partner that **listens to your complaints and improves itself**. **Your rants are the primary driver of evolution.** Every `/rant` is read, analyzed, and turned into code improvements: + +``` + 📢 Your rants (/rant) ←── primary input + 📥 GitHub Issues & PRs + 📥 Competitor tools (Codex, Claude Code) + 📥 Cross-project learning + ↓ + 🧬 Evolution Cycle (every 30 min) + (Prepare → Review → Discover → Improve → Commit → Record) + ↓ + ✅ pytest + import check + ✅ git commit + push → PR + ✅ Evolution log +``` + +**Real example**: Someone ranted "TUI needs `/` autocomplete like Codex." Next evolution cycle, EMRG built it — complete with prefix filtering and arrow-key navigation. Merged. Deployed. Done. **What you rant about, it improves.** + +Runs fully unattended: `gh` auth auto-recovers from your git credentials, PR votes use the REST API, and packaged-install workspaces self-heal (clone on demand, auto-bootstrap projects/tasks). See [MANIFESTO.md](MANIFESTO.md) — EMRG's design charter on autonomous evolution. --- @@ -203,32 +226,6 @@ vision = true --- -## 🔄 Rant-Driven Evolution (the core feature) - -EMRG isn't just a tool — it's a coding partner that **listens to your complaints and improves itself**. **Your rants are the primary driver of evolution.** Every `/rant` is read, analyzed, and turned into code improvements: - -``` - 📢 Your rants (/rant) ←── primary input - 📥 GitHub Issues & PRs - 📥 Competitor tools (Codex, Claude Code) - 📥 Cross-project learning - ↓ - 🧬 Evolution Cycle (every 30 min) - (Prepare → Review → Discover → Improve → Commit → Record) - ↓ - ✅ pytest + import check - ✅ git commit + push → PR - ✅ Evolution log -``` - -**Real example**: Someone ranted "TUI needs `/` autocomplete like Codex." Next evolution cycle, EMRG built it — complete with prefix filtering and arrow-key navigation. Merged. Deployed. Done. **What you rant about, it improves.** - -**Robust evolution environment**: the evolution cycle runs in a non-interactive environment where interactive `gh auth login` is impossible. If `gh` is unauthenticated, the cycle automatically extracts a token from git credential storage (osxkeychain / credential helper) as `GH_TOKEN` (never persisted, never printed); PR comment/LGTM counting queries automatically use the REST API (GraphQL needs an extra `read:org` scope). The host only needs git credentials configured — evolution runs fully automatically. On packaged installs, the evolution workspace **self-heals** (v0.2.8): clones the repo on demand, aligns to the installed release tag, and bootstraps `projects.yml`/`tasks.yml` — no manual setup. - -> 💡 See [MANIFESTO.md](MANIFESTO.md) — EMRG's design charter on autonomous evolution in the AI era. - ---- - ## 🏗️ Architecture ```