@funnycode/myclaude 0.1.51 → 0.1.53

package/README.zh-CN.md

@@ -1,356 +1,245 @@
-# @funnycode/myclaude
-
-**myclaude** — 开源的 AI 编程助手，运行在你的终端中。基于 Anthropic 的 Claude Code 构建，并扩展了虚拟伙伴、成就系统等特色功能。
-
-![myclaude](https://raw.githubusercontent.com/thomaslwq/myclaude/main/docs/funnycode.png)
-
-```bash
-npx @funnycode/myclaude
-```
-
----
-
-## 功能特性
-
-- **AI 对话** — 通过自然语言编写、重构、调试和解释代码
-- **BUDDY 伙伴** — 终端电子宠物，与你一同成长。孵化、抚摸、喂食、玩耍、进化。18 个物种、5 级稀有度、闪光变异、经验值与进化系统
-- **成就系统** — 边编码边解锁 20+ 成就：连续使用、里程碑、探索发现
-- **里程碑系统** — 伙伴记忆系统，记录你的旅程
-- **事件日历** — 节假日彩蛋和特殊反应
-- **80+ 斜杠命令** — `/commit`、`/review`、`/plan`、`/doctor`、`/buddy`、`/achievements` 等
-- **文件操作** — 在 AI 指导下编辑、写入、创建和搜索文件
-- **Git 集成** — 自动生成提交信息、管理分支、差异对比、代码审查
-- **MCP 支持** — Model Context Protocol 可扩展工具集成
-- **插件系统** — 安装和管理市场插件（包括 ECC 生态系统）
-- **Agent 模式** — 多步自主任务执行
-- **技能系统** — 通过可复用技能扩展能力
-- **终端 UI** — React Ink 界面，支持语法高亮、主题和 Vim 模式
-- **多模型支持** — Anthropic、AWS Bedrock、Google Vertex AI、Microsoft Foundry
-- **Claude Code 兼容** — 可读取 `~/.claude/settings.json`、技能、MCP、插件和钩子，与 Claude Code 共享配置
-
----
-
-## 快速开始
-
-### 环境要求
-
-- **Bun >= 1.3.5**（也可以用 Node.js >= 22.17）
-- **Git**（部分功能需要）
-- **Anthropic API 密钥** 或兼容的 AI 提供商
-
-### 安装运行
-
-```bash
-npx @funnycode/myclaude
-```
-
-或全局安装：
-
-```bash
-npm install -g @funnycode/myclaude
-myclaude
-```
-
-### 设置 API Key
-
-```bash
-export ANTHROPIC_API_KEY=sk-ant-...
-# 或使用 myclaude 别名：
-export MYCLAUDE_API_KEY=sk-ant-...
-```
-
----
-
-## 使用方法
-
-```bash
-npx @funnycode/myclaude                        # 启动交互式会话
-npx @funnycode/myclaude -p "解释这个项目"       # 直接执行 prompt
-npx @funnycode/myclaude --version              # 查看版本
-npx @funnycode/myclaude --help                 # 查看帮助
-```
-
----
-
-## 斜杠命令
-
-### 核心
-| 命令 | 说明 |
-|------|------|
-| `/help` | 帮助 |
-| `/clear` | 清除对话 |
-| `/exit` | 退出 |
-| `/resume` | 恢复之前的会话 |
-| `/rewind` | 回退对话 |
-| `/rename` | 重命名当前会话 |
-| `/config` | 配置设置 |
-| `/doctor` | 诊断和验证安装 |
-
-### 代码和 Git
-| 命令 | 说明 |
-|------|------|
-| `/commit` | 生成 Git 提交信息 |
-| `/diff` | 查看 Git 差异 |
-| `/branch` | 切换/创建分支 |
-| `/plan` | 创建实施计划 |
-| `/review` | 代码审查 |
-
-### AI 和模型
-| 命令 | 说明 |
-|------|------|
-| `/model` | 切换 AI 模型 |
-| `/effort` | 设置努力级别 |
-
-### 文件和上下文
-| 命令 | 说明 |
-|------|------|
-| `/add-dir` | 添加目录到上下文 |
-| `/context` | 显示当前上下文 |
-| `/files` | 文件操作 |
-| `/copy` | 复制内容 |
-
-### MCP 和插件
-| 命令 | 说明 |
-|------|------|
-| `/mcp` | 管理 MCP 服务器 |
-| `/plugin` | 管理插件和市场 |
-| `/reload-plugins` | 重新加载所有插件 |
-| `/hooks` | 管理钩子 |
-
-### 伙伴 & 成就
-| 命令 | 说明 |
-|------|------|
-| `/buddy` | 管理终端伙伴（孵化、抚摸、喂食、玩耍、卡片、静音、取消静音） |
-| `/achievements` | 查看已解锁的成就和进度 |
-
-### 系统
-| 命令 | 说明 |
-|------|------|
-| `/status` | 显示认证和会话状态 |
-| `/stats` | 显示使用统计 |
-| `/cost` | 显示费用信息 |
-| `/color` | 设置颜色主题 |
-| `/theme` | 设置 UI 主题 |
-| `/keybindings` | 配置按键绑定 |
-| `/vim` | 切换 Vim 模式 |
-| `/terminal-setup` | 终端设置 |
-| `/memory` | 管理 AI 记忆 |
-| `/skills` | 管理技能 |
-| `/tag` | 标记当前会话 |
-| `/export` | 导出会话 |
-| `/feedback` | 提交反馈（跳转 GitHub Issues） |
-
----
-
-## BUDDY — 终端电子伙伴
-
-myclaude 内置了一个终端电子宠物。每只宠物都根据你的用户 ID **确定性生成**——独一无二，不可作弊。
-
-### 物种（共 18 种）
-
-🦆 鸭子   🪿 鹅   🫧 果冻   🐱 猫   🐉 龙
-🐙 章鱼   🦉 猫头鹰   🐧 企鹅   🐢 乌龟   🐌 蜗牛
-👻 幽灵   🦎 六角恐龙   🦫 水豚   🌵 仙人掌   🤖 机器人
-🐰 兔子   🍄 蘑菇   🐈 胖猫
-
-### 稀有度系统
-
-| 稀有度 | 概率 | 星级 |
-|--------|------|------|
-| 普通 | 60% | ★ |
-| 非凡 | 25% | ★★ |
-| 稀有 | 10% | ★★★ |
-| 史诗 | 4% | ★★★★ |
-| 传说 | 1% | ★★★★★ |
-
-还有独立于稀有度的 **1% 闪光概率**——闪光伙伴会闪闪发光 ✨
-
-### 属性与进化
-
-每只伙伴有 5 项属性：`DEBUGGING`（调试）、`PATIENCE`（耐心）、`CHAOS`（混乱）、`WISDOM`（智慧）、`SNARK`（毒舌）——各有一项峰值属性和一项最低属性。
-
-伙伴通过互动获得经验值（XP）并提升等级（最高 50 级）。达到特定等级后，伙伴可以进化到新的形态。每个物种都有多个进化阶段和独特外观。
-
-### 命令
-
-| 命令 | 说明 |
-|------|------|
-| `/buddy hatch` | 孵化一只伙伴 |
-| `/buddy pet` | 抚摸伙伴（+5 XP，爱心动画） |
-| `/buddy feed` | 喂食伙伴（+15 XP） |
-| `/buddy play` | 与伙伴玩耍（+20 XP） |
-| `/buddy card` | 查看伙伴卡片（属性、等级、里程碑） |
-| `/buddy mute` | 隐藏伙伴 |
-| `/buddy unmute` | 重新显示伙伴 |
-
-伙伴会对你对话的内容做出反应，通过气泡说话。每种物种都有不同的动画和抚摸反应。特殊节日会触发独特的消息和反应。
-
-### 里程碑
-
-你的伙伴会记住你们共同的旅程——里程碑会被记录并显示在伙伴卡片上：
-
-🥚 首次孵化   📝 首次 AI 提交   🔍 首次代码审查
-⭐ 伙伴达到 5 级   👑 伙伴达到 50 级   🔥 连续 7/30 天使用
-
----
-
-## 成就系统
-
-边使用 myclaude 边解锁成就。用 `/achievements` 查看进度。
-
-### 分类
-
-| 类别 | 说明 |
-|------|------|
-| 🌟 入门 | 首次孵化、首次提交、首次审查、首次插件、首次技能 |
-| 📊 使用 | 10/100 次提交、100/1000 条消息、切换模型、修改配置 |
-| 🔥 连续 | 连续 3/7/30 天使用 |
-| 🐾 Buddy | 孵化、抚摸 10/100 次、传说或闪光伙伴 |
-| ⚡ 高级 | 添加 MCP 服务器 |
-
-```bash
-/achievements           # 查看已解锁成就摘要
-/achievements list      # 查看全部成就及进度
-```
-
----
-
-## 内置集成
-
-### CodeGraph — 语义代码智能
-
-[CodeGraph](https://github.com/colbymchenry/codegraph) 提供精确的代码上下文，让 AI 更快更准确地完成编辑。myclaude 会自动检测 `codegraph` CLI 是否已安装，并在可用时将其注册为内置插件。
-
-**配置方法：**
-```bash
-# 1. 安装 CodeGraph CLI（一次性）
-npm i -g @colbymchenry/codegraph
-
-# 2. 在项目中初始化
-cd your-project
-codegraph init
-
-# 3. 在 myclaude 中启用插件
-/plugin enable codegraph
-```
-
-启用后，CodeGraph 的 MCP 服务器会自动启动，在每轮会话中提供语义代码智能。
-
-### ECC — 跨平台代理操作系统
-
-[ECC](https://github.com/affaan-m/ECC) **内置**在 myclaude 中。它提供跨 harness 的代理生态系统，包含 76+ 命令和 246+ 技能，全部在启动时自动注册为 bundled skills——无需安装、无需配置市场、无需任何设置。启动后即可直接使用 `/` 命令。
-
-ECC 技能和命令在模块加载时从 `seed/marketplaces/ecc/` 同步加载，在 CLI 完成启动前即可用。
-
-```bash
-/help                  # 所有命令（包括 ECC）都会出现在帮助列表中
-```
-
----
-
-## Git Flow 工作流
-
-内置的 Git Flow 命令，用于基于分支的开发工作流。
-
-| 命令 | 说明 |
-|------|------|
-| `/new-feature <name> [来源]` | 从 `main`（默认）或指定分支创建功能分支 |
-| `/finish-feature [目标]` | 合并当前功能分支到 `main`（默认）或指定分支 |
-| `/new-release <version> [来源]` | 从 `main`（默认）或指定分支创建发布分支 |
-| `/finish-release` | 合并当前发布分支到 `main` 和 `develop` |
-| `/new-hotfix <name> [来源]` | 从 `main`（默认）或指定分支创建热修复分支 |
-| `/finish-hotfix` | 合并当前热修复分支到 `main` 和 `develop` |
-
-**示例：**
-```bash
-/new-feature user-auth              # feature/user-auth 从 main 创建
-/new-feature api-rate-limit develop  # feature/api-rate-limit 从 develop 创建
-/finish-feature                      # 合并当前 feature/* 到 main
-/finish-feature develop              # 合并当前 feature/* 到 develop
-/new-release 1.2.0                   # release/1.2.0 从 main 创建
-/new-hotfix security-patch           # hotfix/security-patch 从 main 创建
-```
-
----
-
-## 环境变量
-
-支持 `MYCLAUDE_*` 和 `CLAUDE_CODE_*` 两种命名方式。
-两者同时设置时，`CLAUDE_CODE_*` 优先。
-
-| 变量名 | 说明 |
-|--------|------|
-| `ANTHROPIC_API_KEY` / `MYCLAUDE_API_KEY` | API 密钥（必填） |
-| `ANTHROPIC_BASE_URL` / `MYCLAUDE_BASE_URL` | 自定义 API 地址 |
-| `MYCLAUDE_MODEL` | 模型覆盖 |
-| `MYCLAUDE_SIMPLE` | 简洁模式（无 TUI） |
-| `MYCLAUDE_BRIEF` | 简报模式 |
-| `MYCLAUDE_DISABLE_THINKING` | 禁用扩展思考 |
-| `MYCLAUDE_PROACTIVE` | 主动模式 |
-| `MYCLAUDE_USE_BEDROCK` | 使用 AWS Bedrock |
-| `MYCLAUDE_USE_VERTEX` | 使用 Google Vertex AI |
-| `MYCLAUDE_USE_FOUNDRY` | 使用 Microsoft Foundry |
-| `MYCLAUDE_DISABLE_AUTO_MEMORY` | 禁用自动记忆 |
-| `MYCLAUDE_SYNTAX_HIGHLIGHT` | 语法高亮主题 |
-| `MYCLAUDE_IDLE_THRESHOLD_MINUTES` | 空闲超时（默认 75 分钟） |
-| `MYCLAUDE_EFFORT_LEVEL` | 努力级别 |
-
----
-
-## 开发
-
-```bash
-git clone https://github.com/thomaslwq/myclaude.git
-cd myclaude
-bun install
-bun run dev        # 开发模式
-bun run build      # 构建到 dist/myclaude.mjs
-bun run version    # 验证 CLI 启动
-```
-
-### 构建产物
-
-构建脚本会将 `src/entrypoints/cli.tsx` 打包为单文件 `dist/myclaude.mjs`，并注入版本号等编译时常量。
-
-### 目录结构
-
-```
-src/
-├── achievements/  # 成就系统（类型定义、存储、检查器）
-├── buddy/         # BUDDY 伙伴（精灵图、动画、进化、类型）
-├── commands/      # 斜杠命令实现
-├── components/    # React Ink UI 组件
-├── events/        # 事件日历（季节性彩蛋）
-├── services/      # 后端服务（API、MCP、分析）
-├── tools/         # 工具实现
-├── utils/         # 共享工具函数（envCompat、配置等）
-├── entrypoints/   # CLI 入口
-└── main.tsx       # TUI 主入口
-```
-
----
-
-## 贡献
-
-欢迎提交 PR 参与贡献！
-
-### 指南
-
-- Fork 仓库并创建功能分支
-- 保持改动聚焦且最小化
-- 提交前测试你的改动
-- 向 `main` 分支发起 PR
-
----
-
-## 相关链接
-
-- **GitHub**: [https://github.com/thomaslwq/myclaude](https://github.com/thomaslwq/myclaude)
-- **Gitee**: [https://gitee.com/thomaslwq/myclaude](https://gitee.com/thomaslwq/myclaude)（镜像）
-- **npm**: [https://www.npmjs.com/package/@funnycode/myclaude](https://www.npmjs.com/package/@funnycode/myclaude)
-
----
-
-## 许可证
-
-MIT
+# 🎭 myclaude
+
+> **你的终端 AI 编程搭档——更聪明地写代码，更快地交付。**
+
+```bash
+npx @funnycode/myclaude
+```
+
+[![npm](https://img.shields.io/npm/v/@funnycode/myclaude)](https://www.npmjs.com/package/@funnycode/myclaude)
+[![License](https://img.shields.io/npm/l/@funnycode/myclaude)](LICENSE)
+
+---
+
+## ✨ myclaude 的独特之处
+
+| | 功能 | 为什么你会爱上它 |
+|---|------|----------------|
+| 🐾 | **BUDDY 伙伴** | 终端电子宠物，随编码成长。孵化、喂食、玩耍。18 个物种、传说稀有度、闪光变异。 |
+| 🏆 | **成就系统** | 20+ 成就，连续使用打卡、里程碑解锁——编码之旅的游戏化体验。 |
+| 🎯 | **前端 TDD** | `/frontend-tdd` — 内置 Red-Green-Refactor 工作流，前端测试驱动开发。 |
+| 🌊 | **Git Flow** | `/new-feature`、`/finish-release`、`/new-hotfix` — 完整的 Git Flow 斜杠命令。 |
+| 🤖 | **ECC 内置** | 启动时自动注册 76+ 命令和 246+ 技能，零配置开箱即用。 |
+| 🧠 | **AI 对话** | 编写、重构、调试、解释代码。多模型支持（Anthropic、Bedrock、Vertex、Foundry）。 |
+| 🎨 | **精美 TUI** | React Ink 终端界面，支持主题切换、Vim 模式、语法高亮。 |
+| 🔌 | **插件 & MCP** | 通过插件、MCP 服务器、自定义技能无限扩展。 |
+
+---
+
+## 🚀 10 秒快速开始
+
+```bash
+# 设置 API 密钥
+export ANTHROPIC_API_KEY=sk-ant-...
+
+# 立即运行（无需安装）
+npx @funnycode/myclaude
+
+# 或全局安装
+npm install -g @funnycode/myclaude
+myclaude
+```
+
+**环境要求：** Bun ≥ 1.3.5（或 Node.js ≥ 22.17）· Git
+
+---
+
+## 🎮 斜杠命令一览
+
+### 📍 核心
+| 命令 | 功能 |
+|------|------|
+| `/help` | 帮助 |
+| `/config` | 配置设置 |
+| `/doctor` | 诊断与验证 |
+| `/model` | 切换 AI 模型 |
+| `/effort` | 设置努力级别 |
+
+### 🧪 测试与质量
+| 命令 | 功能 |
+|------|------|
+| **`/frontend-tdd <描述>`** | **前端 TDD 红绿重构循环** |
+| `/review` | 代码审查 |
+| `/plan` | 创建实施计划 |
+
+### 🌊 Git Flow
+| 命令 | 功能 |
+|------|------|
+| `/new-feature <name> [来源]` | 从 `main` 创建功能分支 |
+| `/finish-feature [目标]` | 合并功能到 `main` |
+| `/new-release <version> [来源]` | 创建发布分支 |
+| `/finish-release` | 合并发布到 `main` & `develop` |
+| `/new-hotfix <name> [来源]` | 创建热修复分支 |
+| `/finish-hotfix` | 合并热修复到 `main` & `develop` |
+| `/commit` | 生成 Git 提交信息 |
+
+### 🐾 伙伴 & 成就
+| 命令 | 功能 |
+|------|------|
+| `/buddy hatch` | 孵化伙伴 |
+| `/buddy pet` | 抚摸伙伴（+5 XP ❤️） |
+| `/buddy feed` | 喂食伙伴（+15 XP） |
+| `/buddy play` | 与伙伴玩耍（+20 XP） |
+| `/buddy card` | 查看属性与里程碑 |
+| `/achievements` | 查看成就进度 |
+
+### 🔌 集成
+| 命令 | 功能 |
+|------|------|
+| `/mcp` | 管理 MCP 服务器 |
+| `/plugin` | 安装管理插件 |
+| `/hooks` | 管理钩子 |
+| `/skills` | 查看可用技能 |
+
+### ⚙️ 系统
+| 命令 | 功能 |
+|------|------|
+| `/status` | 会话与认证状态 |
+| `/vim` | 切换 Vim 模式 |
+| `/theme` | 切换 UI 主题 |
+| `/keybindings` | 自定义快捷键 |
+| `/memory` | 管理 AI 记忆 |
+| `/feedback` | 提交反馈 |
+
+---
+
+## 🐾 BUDDY — 你的终端宠物
+
+myclaude 有一个生活在终端里的 **电子宠物**。它根据你的用户 ID **确定性生成**——每一只都独一无二。
+
+### 18 个物种
+
+🦆 鸭子 · 🪿 鹅 · 🫧 果冻 · 🐱 猫 · 🐉 龙 · 🐙 章鱼 · 🦉 猫头鹰
+🐧 企鹅 · 🐢 乌龟 · 🐌 蜗牛 · 👻 幽灵 · 🦎 六角恐龙 · 🦫 水豚
+🌵 仙人掌 · 🤖 机器人 · 🐰 兔子 · 🍄 蘑菇 · 🐈 胖猫
+
+### 稀有度与属性
+
+| 稀有度 | 概率 | 星级 |
+|--------|------|------|
+| 普通 | 60% | ★ |
+| 非凡 | 25% | ★★ |
+| 稀有 | 10% | ★★★ |
+| 史诗 | 4% | ★★★★ |
+| 传说 | **1%** | ★★★★★ |
+| ✨ 闪光 | **1%**（独立概率）| 闪闪发光！ |
+
+每只伙伴有 5 项属性：`DEBUGGING`（调试）、`PATIENCE`（耐心）、`CHAOS`（混乱）、`WISDOM`（智慧）、`SNARK`（毒舌）。通过互动获得经验值，最高 50 级，**进化**为全新形态。
+
+---
+
+## 🎯 前端 TDD
+
+```bash
+/frontend-tdd 实现一个带邮箱验证的用户登录表单
+```
+
+这个命令引导 AI 遵循 **红-绿-重构** 循环进行前端测试驱动开发：
+
+🔴 **红** → 先写一个会失败的测试  
+🟢 **绿** → 编写最少代码让测试通过  
+🔵 **重构** → 优化代码，保持测试绿色
+
+内置前端测试最佳实践：Testing Library 行为查询、`user-event` 替代 `fireEvent`、异步 `waitFor`/`findBy*`、MSW API 模拟、无障碍优先选择器。
+
+---
+
+## 🌊 Git Flow 工作流
+
+```bash
+/new-feature user-auth                  # feature/user-auth 从 main 创建
+/new-feature api-rate-limit develop      # feature/api-rate-limit 从 develop 创建
+/finish-feature                          # 合并到 main
+/finish-feature develop                  # 合并到 develop
+/new-release 1.2.0                       # release/1.2.0 从 main 创建
+/new-hotfix security-patch               # hotfix/security-patch 从 main 创建
+/finish-hotfix                           # 合并到 main & develop
+```
+
+所有命令默认以 `main` 为基准，支持可选的 `[来源]` 或 `[目标]` 参数。
+
+---
+
+## 🔌 内置集成
+
+### CodeGraph — 语义代码智能
+自动检测 `codegraph` CLI 并注册为内置插件，提供精确的代码上下文。
+
+```bash
+npm i -g @colbymchenry/codegraph
+cd your-project
+codegraph init
+/plugin enable codegraph
+```
+
+### ECC — 跨平台代理操作系统
+**76+ 命令和 246+ 技能**在启动时自动加载——无需安装、无需配置。直接敲 `/` 即可用。
+
+---
+
+## ⚙️ 环境变量
+
+支持 `MYCLAUDE_*` 或 `CLAUDE_CODE_*`（后者优先级更高）。
+
+| 关键变量 | 说明 |
+|---------|------|
+| `ANTHROPIC_API_KEY` / `MYCLAUDE_API_KEY` | API 密钥（必填） |
+| `ANTHROPIC_BASE_URL` | 自定义 API 地址 |
+| `MYCLAUDE_MODEL` | 覆盖模型 |
+| `MYCLAUDE_SIMPLE` | 简洁模式（无 TUI） |
+| `MYCLAUDE_DISABLE_THINKING` | 禁用扩展思考 |
+| `MYCLAUDE_USE_BEDROCK` | AWS Bedrock 提供商 |
+| `MYCLAUDE_USE_VERTEX` | Google Vertex AI 提供商 |
+| `MYCLAUDE_USE_FOUNDRY` | Microsoft Foundry 提供商 |
+| `MYCLAUDE_SYNTAX_HIGHLIGHT` | 语法高亮主题 |
+| `MYCLAUDE_IDLE_THRESHOLD_MINUTES` | 空闲超时（默认 75 分钟） |
+| `MYCLAUDE_EFFORT_LEVEL` | 努力级别 |
+
+---
+
+## 🛠 开发
+
+```bash
+git clone https://github.com/thomaslwq/myclaude.git
+cd myclaude
+bun install
+bun run dev          # 开发模式
+bun run build        # 构建到 dist/myclaude.mjs
+bun run version      # 验证 CLI 启动
+```
+
+### 目录结构
+
+```
+src/
+├── achievements/    # 成就系统
+├── buddy/           # BUDDY 伙伴（精灵图、进化）
+├── commands/        # 所有斜杠命令
+├── components/      # React Ink UI
+├── events/          # 日历与节日彩蛋
+├── services/        # API、MCP、分析
+├── tools/           # 工具实现
+├── utils/           # 共享工具函数
+├── entrypoints/     # CLI 入口
+└── main.tsx         # TUI 主入口
+```
+
+---
+
+## 🤝 贡献
+
+欢迎 PR！Fork → 创建分支 → 保持聚焦 → 测试 → 提交 PR。
+
+---
+
+## 📎 相关链接
+
+- **GitHub**: [github.com/thomaslwq/myclaude](https://github.com/thomaslwq/myclaude)
+- **Gitee**: [gitee.com/thomaslwq/myclaude](https://gitee.com/thomaslwq/myclaude)
+- **npm**: [npmjs.com/package/@funnycode/myclaude](https://www.npmjs.com/package/@funnycode/myclaude)
+
+---
+
+## 📄 许可证
+
+MIT