feihong-code 0.2.2 → 0.5.1

package/CODE_OF_CONDUCT.md

@@ -1,56 +1,56 @@
-# 行为准则
-
-## 我们的承诺
-
-为了营造一个开放和友好的环境，我们作为贡献者和维护者承诺：
-
-- 不受性别、种族、民族、性取向、性别认同、残疾、外貌、体型、年龄、宗教或国籍的影响
-- 以尊重和包容的态度对待每一位参与者
-- 致力于创造一个无骚扰的环境
-
-## 我们的标准
-
-**促进积极互动的行为：**
-- 使用友好和包容的语言
-- 尊重不同的观点和经历
-- 虚心接受建设性反馈
-- 关注社区的整体利益
-- 对同类表现出同理心
-
-**不可接受的行为：**
-- 使用性化的语言或图像，以及任何形式的性关注或挑逗
-- 恶意的评论、侮辱性的贬低攻击或个人/政治攻击
-- 公开或私下的骚扰
-- 未经明确许可发布他人的私人信息，如物理或电子邮件地址
-- 其他在专业场所被认为不恰当的行为
-
-## 执行责任
-
-社区领导者负责澄清和执行我们接受的行为标准，并将根据以下原则采取适当和公平的纠正措施：
-
-1. 以建设性的方式提供纠正性反馈
-2. 移除、编辑或不接受违反本行为准则的评论、提交、代码、问题和其他贡献
-3. 暂时或永久禁止任何被视为不合适、威胁、冒犯或有害的行为
-
-## 范围
-
-本行为准则适用于：
-- 项目空间和公共空间，当个人正式代表项目或其社区时
-- 代表项目的官方电子邮件、社交媒体账户或在线活动中
-
-## 报告
-
-如目睹或遭受不法行为，请通过以下方式联系项目负责人：
-
-- **GitHub Issues**: https://github.com/wch887292/feihong-code/issues
-- **邮件**: wch887292@gmail.com
-
-所有投诉将被认真、及时地审查和调查。
-
-##  attribution
-
-本行为准则改编自 [Contributor Covenant](https://www.contributor-covenant.org)，版本 2.1。
-
----
-
-**晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹**
+# 行为准则
+
+## 我们的承诺
+
+为了营造一个开放和友好的环境，我们作为贡献者和维护者承诺：
+
+- 不受性别、种族、民族、性取向、性别认同、残疾、外貌、体型、年龄、宗教或国籍的影响
+- 以尊重和包容的态度对待每一位参与者
+- 致力于创造一个无骚扰的环境
+
+## 我们的标准
+
+**促进积极互动的行为：**
+- 使用友好和包容的语言
+- 尊重不同的观点和经历
+- 虚心接受建设性反馈
+- 关注社区的整体利益
+- 对同类表现出同理心
+
+**不可接受的行为：**
+- 使用性化的语言或图像，以及任何形式的性关注或挑逗
+- 恶意的评论、侮辱性的贬低攻击或个人/政治攻击
+- 公开或私下的骚扰
+- 未经明确许可发布他人的私人信息，如物理或电子邮件地址
+- 其他在专业场所被认为不恰当的行为
+
+## 执行责任
+
+社区领导者负责澄清和执行我们接受的行为标准，并将根据以下原则采取适当和公平的纠正措施：
+
+1. 以建设性的方式提供纠正性反馈
+2. 移除、编辑或不接受违反本行为准则的评论、提交、代码、问题和其他贡献
+3. 暂时或永久禁止任何被视为不合适、威胁、冒犯或有害的行为
+
+## 范围
+
+本行为准则适用于：
+- 项目空间和公共空间，当个人正式代表项目或其社区时
+- 代表项目的官方电子邮件、社交媒体账户或在线活动中
+
+## 报告
+
+如目睹或遭受不法行为，请通过以下方式联系项目负责人：
+
+- **GitHub Issues**: https://github.com/wch887292/feihong-code/issues
+- **邮件**: wch887292@gmail.com
+
+所有投诉将被认真、及时地审查和调查。
+
+##  attribution
+
+本行为准则改编自 [Contributor Covenant](https://www.contributor-covenant.org)，版本 2.1。
+
+---
+
+**晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹**

package/CONTRIBUTING.md

@@ -1,68 +1,68 @@
-# 贡献指南（CONTRIBUTING）
-
-感谢关注 **飞虹 Code（Muse Code 参照复刻）**。本文件约定开发协作规范，请提交前阅读。
-
-## 一、项目署名（强制）
-
-所有开发产出（源码注释头部、README、LICENSE、文档、页脚、about）必须标注：
-
-- 公司：**晋江市飞虹智科技企业管理有限公司**
-- 中心：**飞扬企源研发中心**
-- 负责人：**吴赐虹**
-
-源码文件头部统一使用：
-
-```ts
-/**
- * 飞虹 Code (Muse Code 参照复刻)
- * 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹
- */
-```
-
-## 二、架构约定（feature-first 分层）
-
-```
-src/
-  cli/        入口、参数解析、REPL、运行时装配
-  shared/     配置、错误、日志、共享类型（基础设施）
-  agent/      Orchestrator / Planner / Prompts
-  tools/      工具实现（file / shell / search / verify）+ registry
-  models/     模型路由 + providers（openai-compatible / ollama / mock）
-  runtime/    事件日志、会话状态（单一可信源）
-  skills/     高级技能（/plan /grill /goal）
-```
-
-铁律：
-
-1. **边界必须校验**：所有外部输入（CLI 参数、模型响应、工具入参）用 zod 校验。
-2. **集中配置**：配置只在 `shared/config.ts` 读取，启动即校验（fail-fast），懒加载不影响 `--version`。
-3. **类型化错误**：抛出 `AppError` 子类（`ConfigError`/`ModelError`/`ToolError`/`ApprovalRequiredError`/`SecurityError`），禁止裸 `throw`。
-4. **结构化日志**：通过 `shared/logger` 输出 JSON 日志，密钥自动脱敏；每次运行带 `runId`。
-5. **单一可信源**：Agent 行为以 `runtime/event-log` 的 append-only JSONL 为准，支持审计与恢复。
-
-## 三、安全底线
-
-- 文件工具限制在项目根沙箱内（防 `../` 穿越）。
-- shell 工具走白名单 + 危险命令拦截 + 审批（`ApprovalRequiredError`）。
-- 日志/响应中任何密钥字段自动转 `[REDACTED]`。
-- 禁止在代码、日志、提交信息中泄露真实凭证。
-
-## 四、提交规范
-
-- 提交信息用中文，句式「动词 + 内容」，如：`feat: 新增 ollama provider`、`fix: 修复 zod v4 record 校验`。
-- 不提交 `node_modules/`、`dist/`、`.env`、日志与本地 demo 产物（见 `.gitignore`）。
-- 大改动先建分支，描述清楚动机与验证方式。
-
-## 五、本地开发
-
-```bash
-npm install
-npm run build      # tsc 编译到 dist/
-npm run dev        # tsx 直接跑源码
-node dist/cli/index.js --version
-node dist/cli/index.js "<需求>"   # 未配 FH_PROVIDERS 自动离线 Mock 闭环
-```
-
----
-
-© 2026 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹
+# 贡献指南（CONTRIBUTING）
+
+感谢关注 **飞虹 Code（Muse Code 参照复刻）**。本文件约定开发协作规范，请提交前阅读。
+
+## 一、项目署名（强制）
+
+所有开发产出（源码注释头部、README、LICENSE、文档、页脚、about）必须标注：
+
+- 公司：**晋江市飞虹智科技企业管理有限公司**
+- 中心：**飞扬企源研发中心**
+- 负责人：**吴赐虹**
+
+源码文件头部统一使用：
+
+```ts
+/**
+ * 飞虹 Code (Muse Code 参照复刻)
+ * 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹
+ */
+```
+
+## 二、架构约定（feature-first 分层）
+
+```
+src/
+  cli/        入口、参数解析、REPL、运行时装配
+  shared/     配置、错误、日志、共享类型（基础设施）
+  agent/      Orchestrator / Planner / Prompts
+  tools/      工具实现（file / shell / search / verify）+ registry
+  models/     模型路由 + providers（openai-compatible / ollama / mock）
+  runtime/    事件日志、会话状态（单一可信源）
+  skills/     高级技能（/plan /grill /goal）
+```
+
+铁律：
+
+1. **边界必须校验**：所有外部输入（CLI 参数、模型响应、工具入参）用 zod 校验。
+2. **集中配置**：配置只在 `shared/config.ts` 读取，启动即校验（fail-fast），懒加载不影响 `--version`。
+3. **类型化错误**：抛出 `AppError` 子类（`ConfigError`/`ModelError`/`ToolError`/`ApprovalRequiredError`/`SecurityError`），禁止裸 `throw`。
+4. **结构化日志**：通过 `shared/logger` 输出 JSON 日志，密钥自动脱敏；每次运行带 `runId`。
+5. **单一可信源**：Agent 行为以 `runtime/event-log` 的 append-only JSONL 为准，支持审计与恢复。
+
+## 三、安全底线
+
+- 文件工具限制在项目根沙箱内（防 `../` 穿越）。
+- shell 工具走白名单 + 危险命令拦截 + 审批（`ApprovalRequiredError`）。
+- 日志/响应中任何密钥字段自动转 `[REDACTED]`。
+- 禁止在代码、日志、提交信息中泄露真实凭证。
+
+## 四、提交规范
+
+- 提交信息用中文，句式「动词 + 内容」，如：`feat: 新增 ollama provider`、`fix: 修复 zod v4 record 校验`。
+- 不提交 `node_modules/`、`dist/`、`.env`、日志与本地 demo 产物（见 `.gitignore`）。
+- 大改动先建分支，描述清楚动机与验证方式。
+
+## 五、本地开发
+
+```bash
+npm install
+npm run build      # tsc 编译到 dist/
+npm run dev        # tsx 直接跑源码
+node dist/cli/index.js --version
+node dist/cli/index.js "<需求>"   # 未配 FH_PROVIDERS 自动离线 Mock 闭环
+```
+
+---
+
+© 2026 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹

package/LICENSE

@@ -1,22 +1,22 @@
-MIT License
-
-Copyright (c) 2026 晋江市飞虹智科技企业管理有限公司
-飞扬企源研发中心 · 负责人：吴赐虹
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 晋江市飞虹智科技企业管理有限公司
+飞扬企源研发中心 · 负责人：吴赐虹
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,5 @@
+> **English / 英文文档**：[README_EN.md](README_EN.md) · [FAQ (English)](FAQ_EN.md)
+
 # 飞虹 Code（fhcode）
 
 > **终端 AI 编程智能体** · 对标 Meta Muse Code · 全功能 M0→M9.1 完成 · 企业级 RBAC/审计/SWE Agent
@@ -8,16 +10,18 @@
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue.svg)](https://typescriptlang.org)
 [![GitHub stars](https://img.shields.io/github/stars/wch887292/feihong-code?style=social)](https://github.com/wch887292/feihong-code/stargazers)
 [![GitHub issues](https://img.shields.io/github/issues/wch887292/feihong-code)](https://github.com/wch887292/feihong-code/issues)
-[![npm version](https://img.shields.io/npm/v/feihong-code.svg)](https://www.npmjs.com/package/feihong-code)
-[![npm downloads (monthly)](https://img.shields.io/npm/dm/feihong-code.svg)](https://www.npmjs.com/package/feihong-code)
-[![npm downloads (total)](https://img.shields.io/npm/dt/feihong-code.svg)](https://www.npmjs.com/package/feihong-code)
+[![npm version](https://img.shields.io/npm/v/feihong-code.svg)](https://www.npmjs.com/package/feihong-code)
+[![npm downloads (monthly)](https://img.shields.io/npm/dm/feihong-code.svg)](https://www.npmjs.com/package/feihong-code)
+[![npm downloads (total)](https://img.shields.io/npm/dt/feihong-code.svg)](https://www.npmjs.com/package/feihong-code)
 [![CI Status](https://github.com/wch887292/feihong-code/actions/workflows/ci.yml/badge.svg)](https://github.com/wch887292/feihong-code/actions)
 
-**🔍 关键词**：AI Agent · 代码生成 · SWE Agent · CLI · 多模型路由 · 企业级权限 · 离线可用
-
-**📦 一键安装**：`npm install -g feihong-code` · 国内镜像：`npm install -g feihong-code --registry=https://registry.npmmirror.com`
+**🔍 关键词**：AI Agent · 代码生成 · SWE Agent · CLI · 多模型路由 · 企业级权限 · 离线可用
+
+**📦 一键安装**：`npm install -g feihong-code` · 国内镜像：`npm install -g feihong-code --registry=https://registry.npmmirror.com`
 **🚀 5 分钟上手**：`fhcode --version` → `fhcode chat`（离线模式免 API Key 即可对话）
 
+**🌐 中英文双语界面**：`fhcode --lang zh|en` 切换 CLI 语言，或设置环境变量 `FHCODE_LANG=zh|en`（默认按系统 locale 自动检测）。Web 控制台（`fhcode serve`）同样支持中英文一键切换。
+
 
 ---
 
@@ -74,21 +78,21 @@ export FH_ROLE=developer
 
 ---
 
-### 🆚 与其他工具对比
-
-| 能力 | **fhcode（飞虹 Code）** | Claude Code | Cursor CLI | Aider | OpenCode |
-|---|---|---|---|---|---|
-| 终端原生 CLI | ✅ | ✅ | ⚠️（编辑器内） | ✅ | ✅ |
-| 多模型路由（DeepSeek/通义/Ollama/OpenAI） | ✅ | ❌（仅 Anthropic） | ⚠️ | ⚠️ | ✅ |
-| 离线 / 私有化（数据不出内网） | ✅（Ollama 本地） | ❌ | ❌ | ⚠️ | ✅ |
-| 企业级 RBAC / 审计链 | ✅ | ❌ | ❌ | ❌ | ❌ |
-| 全自动 SWE Agent（M0→M9.1） | ✅ | ✅ | ⚠️ | ✅ | ⚠️ |
-| 多子代理并行（M2） | ✅ | ✅ | ❌ | ❌ | ❌ |
-| 自我进化（M6） | ✅ | ❌ | ❌ | ❌ | ❌ |
-| 开源可自托管（MIT） | ✅ | ❌ | ❌ | ✅ Apache-2.0 | ✅ MIT |
-
-> 最适合：**数据不出内网**、需要**企业权限审计**、希望**混合调度多家大模型**的团队与个人开发者。
-
+### 🆚 与其他工具对比
+
+| 能力 | **fhcode（飞虹 Code）** | Claude Code | Cursor CLI | Aider | OpenCode |
+|---|---|---|---|---|---|
+| 终端原生 CLI | ✅ | ✅ | ⚠️（编辑器内） | ✅ | ✅ |
+| 多模型路由（DeepSeek/通义/Ollama/OpenAI） | ✅ | ❌（仅 Anthropic） | ⚠️ | ⚠️ | ✅ |
+| 离线 / 私有化（数据不出内网） | ✅（Ollama 本地） | ❌ | ❌ | ⚠️ | ✅ |
+| 企业级 RBAC / 审计链 | ✅ | ❌ | ❌ | ❌ | ❌ |
+| 全自动 SWE Agent（M0→M9.1） | ✅ | ✅ | ⚠️ | ✅ | ⚠️ |
+| 多子代理并行（M2） | ✅ | ✅ | ❌ | ❌ | ❌ |
+| 自我进化（M6） | ✅ | ❌ | ❌ | ❌ | ❌ |
+| 开源可自托管（MIT） | ✅ | ❌ | ❌ | ✅ Apache-2.0 | ✅ MIT |
+
+> 最适合：**数据不出内网**、需要**企业权限审计**、希望**混合调度多家大模型**的团队与个人开发者。
+
 ## 二、核心特性
 
 ### 🔥 主要亮点
@@ -115,7 +119,7 @@ export FH_ROLE=developer
 ### 🌟 技术亮点
 - **零依赖侵入**：仅依赖 `express` + `zod`，无框架包袱
 - **TypeScript 全量类型安全**：tsc --noEmit 零错误
-- **完整测试覆盖**：27+ 单元测试，41+ 断言的 M4 企业能力专项验证
+- **完整测试覆盖**：42 单元测试 + 145 集成验证断言（M4/M6/M7/M8/M9/M9-real 全离线）
 - **CI/CD 就绪**：GitHub Actions 三流水线（build/enterprise/security），零 Secrets 可跑
 - **Docker 多阶段构建**：支持容器化部署
 
@@ -147,10 +151,11 @@ npm install -g feihong-code
 # 国内镜像（加速）
 npm install -g feihong-code --registry=https://registry.npmmirror.com
 fhcode --version           # 直接调用 bin（Windows 下为 fhcode.cmd）
+> 也支持别名包：`npm install -g feihong-cli`（与 feihong-code 同源，bin 同为 `fhcode`）。
 ```
 
 > 要求 Node.js >= 18。入口 `dist/cli/index.js` 已带 `#!/usr/bin/env node` shebang。
-> 源码与问题反馈已迁移至 GitCode 镜像仓库：<https://gitcode.com/gcw_YuRlTP0G/feihong-code>
+> 源码与问题反馈请前往 GitHub 仓库：<https://github.com/wch887292/feihong-code>
 ### 方式三：Docker
 
 ```bash
@@ -499,9 +504,10 @@ node dist/cli/index.js --version
 
 关注飞虹智 klAI 动态，获取最新开源项目更新与技术教程：
 
-![社区支持二维码](https://github.com/wch887292/feihong-code/releases/download/v1.0.0-community/qrcode-community.png)
+- 🏠 官网与开源矩阵：[https://www.klai.top/opensource.html](https://www.klai.top/opensource.html)
+- 🤖 AI Agent 入口：[https://www.klai.top/openclaw.html](https://www.klai.top/openclaw.html)
 
-扫码加入 **飞虹智企微小助手**，获取：
+加入 **飞虹智企微小助手**，获取：
 - 技术答疑与部署指导
 - 开源项目更新通知
 - 本地化服务预约（泉州地区）

package/README.self-evolve.md

@@ -0,0 +1,274 @@
+# 飞虹 Code - 自我迭代升级系统
+
+> 让 AI 编程助手能够自我学习、持续进化
+
+## 🎯 系统概述
+
+Self-Evolve 是飞虹 Code 的**元技能系统**，让它能够：
+
+1. **自动记录失败** - 每次任务失败都会被记录并分析
+2. **提取错误模式** - 识别重复出现的错误类型
+3. **创建解决技能** - 当遇到无解问题时，自动生成新技能
+4. **定期复盘优化** - 每日/每周回顾，持续改进
+
+## 📦 包含内容
+
+### 核心系统
+- `skills/self-evolve/SKILL.md` - Self-Evolve 技能定义
+- `src/self-evolve/manager.js` - 核心管理器
+- `src/self-evolve/hook.ts` - 集成钩子
+- `src/cli/self-evolve-cli.js` - 命令行接口
+
+### 文档
+- `docs/self-evolve.md` - 用户文档
+- `docs/self-evolve-implementation.md` - 实现指南
+
+### 测试
+- `tests/unit/self-evolve.test.js` - 单元测试
+- `tests/demo/self-evolve-demo.js` - 演示脚本
+
+### 脚本
+- `scripts/self-evolve-setup.sh` - 初始化脚本
+- `scripts/quick-start.js` - 快速开始脚本
+
+## 🚀 快速开始
+
+### 1. 初始化系统
+
+```bash
+# 运行安装脚本
+bash scripts/self-evolve-setup.sh
+
+# 或使用 Node.js 快速开始
+node scripts/quick-start.js
+```
+
+### 2. 查看系统状态
+
+```bash
+# 设置别名（可选）
+alias fe='fhcode self-evolve'
+
+# 查看统计
+fe status
+```
+
+### 3. 开始使用
+
+```bash
+# 列出失败记录
+fe failures list
+
+# 查看技能库
+fe skills list
+
+# 每日复盘
+fe review --daily
+
+# 分析错误模式
+fe analyze
+```
+
+## 📊 核心功能
+
+### 失败记录
+自动记录所有失败的执行，包括：
+- 错误类型（编译、运行时、路径、权限、API等）
+- 完整的错误信息
+- 尝试的解决方案
+- 根本原因分析
+
+### 错误模式识别
+- 按类型统计失败频率
+- 识别重复出现的错误
+- 建议创建针对性技能
+
+### 技能自动生成
+当遇到无法解决的新问题时：
+```bash
+# 系统会提示创建技能
+fe create-skill \
+  --name my-error-handler \
+  --description "处理我的特定错误" \
+  --pattern error-type \
+  --solution "具体解决步骤" \
+  --triggers "触发关键词"
+```
+
+### 定期复盘
+```bash
+# 每日复盘
+fe review --daily
+
+# 查看周统计
+fe status --week
+```
+
+## 🔄 工作流程
+
+```
+任务执行
+    ↓
+成功？ → 记录成功
+    ↓ 失败
+自动记录失败
+    ↓
+搜索已知解决方案
+    ↓ 找到 → 应用方案
+    ↓ 未找到
+分析根因
+    ↓
+创建新技能？ → 是 → 保存到 ~/.feihong-code/skills/
+    ↓ 否
+标记待人工处理
+    ↓
+每日复盘 → 优化系统
+```
+
+## 📁 数据结构
+
+所有数据存储在 `~/.feihong-code/self-evolve/`：
+
+```
+~/.feihong-code/
+├── self-evolve/
+│   ├── config.json          # 配置
+│   ├── failures.json        # 失败记录
+│   ├── skills-index.json    # 技能索引
+│   ├── history.json         # 操作历史
+│   └── report-YYYY-MM-DD.json  # 每日报告
+├── skills/
+│   └── <skill-name>/
+│       └── SKILL.md
+└── ...
+```
+
+## 🔧 集成开发
+
+### 在工具中记录失败
+
+```typescript
+import { selfEvolveHook } from './self-evolve/hook.ts';
+
+try {
+  await someToolCall(input);
+} catch (error) {
+  selfEvolveHook.onToolFailure({
+    tool: 'tool-name',
+    input: input,
+    error: error.message,
+    attemptedSolutions: []
+  });
+  throw error;
+}
+```
+
+### 定期复盘
+
+```javascript
+// 每天运行
+const report = await selfEvolveHook.dailyReview();
+console.log(`今日失败: ${report.total_failures}`);
+```
+
+## 📚 与现有系统集成
+
+Self-Evolve 可以与以下技能配合：
+
+| 技能 | 集成点 | 作用 |
+|------|--------|------|
+| `/self-heal` | 自动创建修复技能 | 解决技术错误 |
+| `/plan` | 计划时参考历史 | 避免重复失败 |
+| `/goal` | 目标设定参考 | 追踪迭代进度 |
+
+## 🎯 使用示例
+
+### 示例1：处理编译错误
+
+```bash
+# 分析最近7天的编译错误
+fe analyze --days 7 --type compile-error
+
+# 创建通用编译错误处理技能
+fe create-skill \
+  --name compile-error-handler \
+  --description "处理TypeScript编译错误" \
+  --pattern compile-error \
+  --solution "1. 检查导入路径\n2. 验证类型定义\n3. 安装缺失依赖" \
+  --triggers "error TS, syntax error, cannot find module"
+```
+
+### 示例2：处理路径穿越
+
+```bash
+# 创建路径安全技能
+fe create-skill \
+  --name path-security-handler \
+  --description "处理路径穿越安全问题" \
+  --pattern path-error \
+  --solution "1. 验证路径在workspace内\n2. 使用相对路径\n3. 规范化路径" \
+  --triggers "path traversal, outside workspace, EACCES"
+```
+
+### 示例3：查看每日复盘
+
+```bash
+fe review --daily
+```
+
+输出：
+```
+📅 每日复盘报告
+========================================
+日期: 2026-08-16
+失败任务: 5
+已解决: 3
+待处理: 2
+新技能: 1
+
+今日失败详情:
+  ✅ [a1b2c3d4] compile-error: error TS2307...
+  ⏳ [e5f6g7h8] path-error: Path traversal...
+```
+
+## 🛡️ 纪律与原则
+
+1. **诚实记录** - 失败就是失败，不伪造成功
+2. **及时复盘** - 每日至少一次复盘分析
+3. **渐进改进** - 每次迭代只优化一个方面
+4. **验证优先** - 新技能必须经过测试验证
+5. **可追溯** - 所有变更记录保存历史版本
+
+## 📈 版本历史
+
+- **v1.0.0** (2026-08-16) - 初始版本
+  - 基础失败记录功能
+  - 技能自动生成
+  - 每日复盘
+  - CLI 接口
+
+## 🔮 未来规划
+
+- [ ] 自动检测技能冲突
+- [ ] 技能效果追踪
+- [ ] 团队共享技能库
+- [ ] AI 辅助技能创建
+- [ ] 失败预测模型
+
+## 🤝 贡献指南
+
+欢迎贡献！请遵循以下步骤：
+
+1. Fork 本仓库
+2. 创建特性分支 (`git checkout -b feature/amazing-feature`)
+3. 提交更改 (`git commit -m 'Add amazing feature'`)
+4. 推送到分支 (`git push origin feature/amazing-feature`)
+5. 创建 Pull Request
+
+## 📄 许可证
+
+MIT License
+
+---
+
+**让飞虹 Code 越来越聪明！** 🚀

package/dist/agent/code-review.js

@@ -57,6 +57,8 @@ function reviewCode(filePath, content, rules = DEFAULT_RULES) {
     for (let i = 0; i < lines.length; i++) {
         const line = lines[i];
         for (const rule of rules) {
+            // 关键：规则正则带 g 标志时 RegExp.test 会残留 lastIndex，必须每次重置，否则跨行误判
+            rule.pattern.lastIndex = 0;
             if (rule.pattern.test(line)) {
                 issues.push({
                     ruleId: rule.id,