monk-pi 0.10.0 → 0.11.0

package/README.md

@@ -16,18 +16,29 @@
 
 ## 🚀 快速开始
 
-### 1. 一键运行 (推荐)
-
-无需全局安装，直接通过 `npx` 启动：
+### 1. 快速安装与运行
 
+#### 方式 A：纯免安装直接运行 (推荐)
+无需全局安装任何环境，直接通过 `npx` 启动：
 ```bash
 npx monk-pi
 ```
 
-或者全局安装命令：
+#### 方式 B：使用 Homebrew 安装 (macOS / Linux 首选)
+Homebrew 会**自动帮你处理并安装 Node.js 依赖**（完全无需担心电脑缺少环境）：
+```bash
+brew install yaoleifly/tap/monk-pi
+```
 
+#### 方式 C：通过 npm / pnpm / bun 全局安装
 ```bash
 npm install -g monk-pi
+# 或者使用 bun (最快)
+bun add -g monk-pi
+```
+
+安装完成后，在任意项目目录下直接输入：
+```bash
 monk-pi
 ```
 
@@ -83,6 +94,7 @@ monk-pi --model monk "帮我设计一套分布式系统的架构方案"
 ### 终端 CLI 指令
 | 命令 | 说明 |
 | :--- | :--- |
+| `monk-pi run <命令>` | **监控运行命令**，报错时自动捕获日志并提示一键呼叫 AI 代码自愈 (Auto-Fix) |
 | `monk-pi resume` (或 `-r`) | 可视化交互式浏览历史会话列表，带相对时间和摘要快速恢复 (断点续写) |
 | `monk-pi login` (或 `auth`) | 交互式配置或更新 Monk API Key，并自动同步至 Pi |
 | `monk-pi status` (或 `check`) | 检测 API 网络延迟、认证有效性及推演通道 |
@@ -103,7 +115,31 @@ monk-pi --model monk "帮我设计一套分布式系统的架构方案"
 
 ---
 
-## ⚡ 智能首屏导航 (Smart Navigator) 与极客小贴士
+## 🛠️ 命令报错一键自愈 (Auto-Fix on Error)
+
+日常开发中最繁琐的痛点就是“编译挂了 / 跑测试挂了，得复制报错去问 AI”。Monk-Pi 提供了零摩擦的包装运行命令：
+
+```bash
+# 监控任何本地命令运行
+monk-pi run "npm run build"
+monk-pi run "npm test"
+monk-pi run "cargo check"
+monk-pi run "go test ./..."
+```
+
+- **命令成功 (exit 0)**：正常透传输出并退出，零额外打扰。
+- **命令报错 (exit != 0)**：自动捕获 stderr 与异常堆栈，在终端无缝弹出自愈向导：
+  ```text
+  ✖ 命令执行失败 (退出码: 1 · 耗时 2.4s)
+
+  ? 检测到命令报错，请选择 Monk 介入处理方式:
+  ❯ 1. 呼叫 Monk 分析报错并自动修复代码 (一键自愈 Auto-Fix · 推荐)
+    2. 进入交互式终端协助排查 (带入报错日志)
+    3. 忽略并直接退出终端
+  ```
+- **选第 1 项**：AI 自动读取报错涉及的源码文件、分析根因、自动精准编辑修复，并**重新在后台跑一遍命令验证**，整个过程无需复制粘贴一个字符！
+
+---
 
 告别面对空白输入框与闪烁光标“不知道该问什么”的迷茫感：
 - **项目画像智能感知**：首次启动或新会话打开时，自动识别当前技术栈（如 `Vue 3 技术栈`、`Next.js 全栈`、`Go 后端应用` 等）及 Git 状态。