feihong-code 7.2.0 → 7.6.0

package/docs/SWE_BENCH_REPORT.md

@@ -0,0 +1,73 @@
+# 飞虹 Code · SWE-bench Verified 跑分状态与说明
+
+> 更新时间：2026-08-28 · 版本：7.6.0
+> 本文档为 **SWE-bench 硬指标对外文案的事实依据**。所有数字均来自真实运行，不编造。
+
+## 1. 官方 harness 能力（已集成）
+
+飞虹 Code 内置 SWE-bench 官方评测 harness（`src/harness/`），对接 HuggingFace 官方数据集 `princeton-nlp/SWE-bench`（split 支持 `lite` / `verified`）：
+
+| 模块 | 作用 |
+|---|---|
+| `SwebenchLoader` | 从 HuggingFace datasets-server 分页拉取官方实例（含 instance_id / problem_statement / FAIL_TO_PASS / PASS_TO_PASS / patch 等） |
+| `MockOrchestratorExecutor` | mock 模式：脚本化 orchestrator 回归，验证 harness 链路（不依赖模型） |
+| `RealModelExecutor` | real 模式：真实模型推理，跑官方问题 |
+| `FileExistsVerifier` | 通过标准=生成指定文件（链路自检用） |
+| `TestVerifier`（P7-1） | **通过标准=官方测试通过**：有 FAIL_TO_PASS 用例时优先跑这些失败用例（`npm test -- <用例>`），退出码 0 判通过 |
+| `MarkdownReporter` / `JsonReporter` | 报告输出 |
+
+## 2. 实测结果（诚实记录）
+
+### 2.1 自建任务集 · 真实模型跑分（2026-08-27 复测，v7.6.0）
+
+| 运行 | 数据集 | 实例数 | 通过率 | 模型 | 验证器 | 说明 |
+|---|---|---|---|---|---|---|
+| 2026-08-27 | 自建 JS 任务集（5 例） | 5 | **100%（5/5）** | agnes-2.5-flash | real-test（node --test 真实断言） | 真实模型驱动 Orchestrator 修复，预定义测试不交给模型；平均迭代 2.2 次/例 |
+| 2026-08-26 | 自建 JS 任务集（5 例） | 5 | 80%（4/5） | agnes-2.5-flash | real-test | v7.2.0 首测，1 例因模型调用中断失败 |
+| 2026-08-26 | SWE-bench lite（官方） | 1 | 100% | mock（脚本化） | FileExistsVerifier | `harness lite --limit 2 --mode mock`，django__django-11099，验证 harness 链路真实可用 |
+
+> ⚠️ 自建任务集 100% 为 **5 个简单 JS 函数题**（max/fib/palindrome/findMissing/countWords）的实测，**不代表模型在真实复杂仓库上的解题能力**。真实硬指标必须以官方 SWE-bench Verified `--mode real --verifier test` 跑出。
+
+**复现命令**：
+```bash
+node scripts/_swe-bench-real.mjs   # 自建任务集真实跑分（5 例）
+node scripts/_swe-smoke.mjs         # harness 闭环冒烟（mock，2 例）
+node scripts/_swe-fetch.mjs         # 拉取官方 SWE-bench Lite 数据集（验证网络可达）
+```
+
+### 2.2 官方 SWE-bench Verified 数据集可达性（2026-08-27 验证）
+
+- `node scripts/_swe-fetch.mjs` 成功从 HuggingFace datasets-server 拉取官方实例（django/django-11099，problem_statement="Fix ORM bug."，FAIL_TO_PASS=test_orm）。
+- 结论：**官方数据集网络可达**，官方 harness 已就绪，可执行真实跑分。
+- 限制：官方 Verified 为 Python 大仓库（django/sympy/astropy 等），每例需 clone 仓库 + Docker 内跑 pytest，单例耗时数分钟至数十分钟，全量 500 例建议在 CI 中分批执行。
+
+## 3. 真实跑分命令（需模型 + Docker 环境）
+
+```bash
+# 官方 SWE-bench Verified，真实模型推理 + 官方测试验证
+fhcode harness verified --limit 20 --mode real --verifier test --report docs/swe-bench-verified-run.md
+
+# 全量（500 例，耗时长，建议 CI 分批）
+fhcode harness verified --mode real --verifier test --report docs/swe-bench-verified-full.md
+
+# 输出 JSON 供后续对标
+fhcode harness verified --mode real --verifier test --json
+```
+
+**环境前置**：
+- 已配置模型供应商（`fhcode config set` 或 `~/.feihong-code/config.json` 的 `models.providers`）
+- Docker 可用（验证器在容器内跑 FAIL_TO_PASS 测试，隔离不信任代码）
+- 每实例需 clone 对应 repo（django / sympy / astropy 等），网络可达 GitHub
+
+## 4. 对外文案口径（有据可依）
+
+- ✅ **可对外宣称（自建任务集）**：**「自建 SWE-bench 格式任务集真实跑分：5/5 = 100% 通过率（agnes-2.5-flash 真实模型 + node --test 预定义测试断言，2026-08-27 复测）」**——必须同时注明"自建 JS 任务集，非官方 SWE-bench Verified"。
+- ✅ **可对外宣称（官方 harness）**：**「已接入 SWE-bench Verified 官方评测（HuggingFace 官方数据集 + FAIL_TO_PASS 测试验证器），官方数据集已验证可达，支持一键跑分」**。
+- ⚠️ **禁止宣称**：在官方 Verified `--mode real --verifier test` 全量跑分未完成前，**禁止**对外发布任何「SWE-bench Verified 通过率 X%」数字，也不得将自建任务集 100% 等同于官方 Verified 成绩。
+- 当前公开口径：**「自建任务集 100%（5/5）；官方 SWE-bench Verified harness 已就绪且数据集可达，全量真实跑分待 CI 分批执行」**。
+
+## 5. 与对标产品的差距定位（供内部参考）
+
+- OpenAI Codex / Cursor / Claude Code 均已公开 SWE-bench Verified 通过率（如 60-75% 量级）
+- 飞虹 Code 尚未完成真实跑分 → 差距仍在，但**从"无 harness"升级为"官方 harness 就绪，待真实跑分"**
+- 真实跑分完成后的对标文案更新入口：`docs/BENCHMARK_REPORT_zh.md`

package/docs/TECHNICAL_SPEC_en.md

@@ -1,6 +1,6 @@
 # Feihong Code v7.0.0 Technical Specification
 
-**Version**: 7.0.0
+**Version**: 7.6.0
 **Date**: August 24, 2026
 **R&D Team**: Feihongzhi Technology Enterprise Management Co., Ltd. · Feiyang Qiyuan R&D Center
 

package/docs/TECHNICAL_SPEC_zh.md

@@ -1,6 +1,6 @@
 # 飞虹 Code v7.0.0 技术说明书
 
-**版本**：7.0.0
+**版本**：7.6.0
 **日期**：2026年8月24日
 **研发团队**：晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心
 

package/docs/Technical_Manual_EN.md

@@ -1,6 +1,6 @@
 # Feihong Code (fhcode) — Technical Manual
 
-**Version**: v0.5.0-b
+**Version**: v7.6.0
 **Date**: 2026-08-16
 **Product**: Feihong Code (feihong-code) — a terminal AI coding agent (a Muse Code reimplementation)
 **Attribution**: Jinjiang Feihongzhi Tech Enterprise Management Co., Ltd. · Feiyang Qiyuan R&D Center · Lead: Wu Cihong

package/docs/UPDATE_NOTES_en.md

@@ -1,7 +1,7 @@
 # Feihong Code v7.0.0 Release Notes
 
 **Release Date**: August 24, 2026
-**Version**: 7.0.0
+**Version**: 7.6.0
 **Product Name**: Feihong Code (feihong-code)
 **R&D Team**: Feihongzhi Technology Enterprise Management Co., Ltd. · Feiyang Qiyuan R&D Center
 

package/docs/UPDATE_NOTES_zh.md

@@ -1,7 +1,7 @@
 # 飞虹 Code v7.0.0 更新说明书
 
 **发布日期**：2026年8月24日
-**版本号**：7.0.0
+**版本号**：7.6.0
 **产品名称**：飞虹 Code（feihong-code）
 **研发团队**：晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心
 

package/docs/UPGRADE_7.2.0.md

@@ -0,0 +1,309 @@
+# 飞虹 Code v7.2.0 升级说明书
+
+> **产品名称**：飞虹 Code（feihong-code）
+> **版本号**：v7.2.0（自 v7.0.0 升级）
+> **发布日期**：2026-08-26
+> **发布方**：晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心
+> **产品定位**：终端 AI 编程智能体，对标 Muse Code / Cursor / Trae / WorkBuddy
+
+---
+
+## 1. 升级概述
+
+### 1.1 为什么升级到 v7.2.0
+
+v7.2.0 是飞虹 Code 从"基础可用"迈向"全面成熟"的关键版本。在 v7.0.0（Electron 桌面版 + 对话流重构）的基础上，本次升级围绕 **Agent 能力、生态集成、差异化创新、跨端交付** 四大方向完成 20+ 项新能力落地，并首次发布安卓版。
+
+### 1.2 版本演进
+
+| 版本 | 日期 | 里程碑 |
+|---|---|---|
+| v0.6.1 | 2026-08-19 | 对话流输出体验优化 |
+| v7.0.0 | 2026-08-24 | Electron 桌面版、对话流全面重构 |
+| **v7.2.0** | **2026-08-26** | **全链路升级：Agent能力 + 生态集成 + 差异化创新 + 安卓版** |
+
+### 1.3 交付形态
+
+| 形态 | 说明 | 获取方式 |
+|---|---|---|
+| **npm 包** | `feihong-code@7.2.0` | `npm i -g feihong-code` |
+| **Windows 桌面版** | Electron 绿色版 | `H:\feihong-app\飞虹 Code.exe` |
+| **安卓版** | Capacitor APK | `release/飞虹Code-v7.0.0-android.apk`（10.47MB，Android 6.0+） |
+| **Web 版** | 内置服务器 | `fhcode serve` → `http://localhost:8081` |
+
+---
+
+## 2. 新增功能详解
+
+### 2.1 阶段一：补全质量突破（对标 Cursor 补全）
+
+#### 2.1.1 跨文件深度上下文
+- **原理**：补全时自动构建代码图谱，通过 import 分析 → 依赖文件导出符号 → 使用分析三层检索，将相关符号定义注入补全模型提示词
+- **效果**：跨文件场景下补全准确率大幅提升，避免"知道引用但不知道定义"的问题
+- **配置**：自动启用，代码图谱最多扫描 500 个文件
+
+#### 2.1.2 补全 Pro 连续推荐
+- **原理**：记录用户接受补全的行为（`POST /api/completion/accept`），智能预测下一步操作
+- **三种推荐策略**：
+  - 函数定义后 → 推荐导出或调用
+  - import 后 → 推荐使用方式
+  - 连续编辑模式 → 推荐继续编辑
+- **接口**：`POST /api/completion/suggest-next`
+
+#### 2.1.3 FIM 训练数据准备
+- **脚本**：`scripts/prepare-fim-data.mjs`
+- **功能**：一键生成 Fill-in-the-Middle 训练数据（train.jsonl / val.jsonl / meta.json），支持自定义源目录、语言、样本数
+- **用途**：为后续专用补全模型微调提供数据基础
+
+### 2.2 阶段二：Agent 能力升级（对标 Cursor Background Agents）
+
+#### 2.2.1 多智能体协同（multi-agent）
+- **4 种角色**：架构师 / 开发者 / 测试工程师 / 评审员
+- **协作流程**：架构师设计方案 → 开发者实现 → 测试验证 → 评审员审查，最多 3 轮反馈循环
+- **质量评分**：0-100 分 + 结构化审查意见
+- **接口**：`POST /api/multi-agent/run`、`GET /api/multi-agent/roles`
+
+#### 2.2.2 事件驱动 Agent（event-driven）
+- **三种事件源**：
+  - **cron 定时任务**：5 段表达式，自动执行
+  - **文件变更**：递归监听目录，create/modify/delete，防抖触发
+  - **Webhook**：GitHub/GitLab 等来源，事件过滤 + 密钥验证
+- **特性**：事件历史持久化（100 条）、手动触发测试、配置启停
+- **配置**：`~/.feihong-code/event-driven/config.json`
+
+#### 2.2.3 自定义 Agent 框架（custom-agent）
+- **5 个内置模板**：代码审查员 / 测试工程师 / 文档生成器 / 重构专家 / Bug 猎手
+- **自定义能力**：Prompt + 工具集定义、分类管理、JSON 导入导出、使用次数统计
+- **智能推荐**：输入关键词自动匹配推荐 Agent
+- **配置**：`~/.feihong-code/custom-agents/*.json`
+
+### 2.3 阶段三：生态与体验
+
+#### 2.3.1 Electron 桌面端增强
+- **全局快捷键**：`Ctrl+Shift+Space`（显示/隐藏）、`Ctrl+Shift+K`（新建任务）、`Ctrl+Shift+L`（快速补全）
+- **深度链接**：`fhcode://` 协议，可从外部唤起
+- **开机自启**：托盘菜单一键设置
+- **增强托盘**：新建任务、快速补全、关于、检查更新
+
+#### 2.3.2 协作工具集成
+- **飞书**：交互卡片消息推送、任务完成/失败通知、令牌自动刷新
+- **GitHub**：PR 自动审查（批准/请求修改/评论）、Issue 管理、Conventional Commits 提交信息生成
+
+#### 2.3.3 Figma 设计稿转代码
+- **能力**：Figma API 拉取 → 组件识别（按钮/输入框/卡片/导航等）→ 设计令牌提取（颜色/字体/间距/阴影）→ 多框架代码生成
+- **支持框架**：Tailwind CSS / React / Vue / HTML
+- **接口**：`src/integrations/figma.ts`
+
+#### 2.3.4 SSO 单点登录
+- **支持协议**：SAML 2.0 / OIDC / OAuth 2.0 / LDAP
+- **支持平台**：飞书 / 企业微信 / 钉钉扫码登录
+- **特性**：登录 URL 生成、回调处理、24 小时会话、token 验证、用户管理
+
+### 2.4 阶段四：差异化创新
+
+#### 2.4.1 语音编程
+- **28 种语音指令**：文件操作 / 代码操作 / 编辑操作 / 视图操作 / AI 操作
+- **语音转代码**：函数模板、类模板，多语言支持
+- **语音上下文**：会话历史、当前文件跟踪、过期清理
+- **示例**："运行" → 执行代码；"跳到第100行" → 跳转；"生成一个排序函数" → AI 生成
+
+#### 2.4.2 AI 原生资料库
+- **文档管理**：7 种类型、分类标签、版本管理
+- **智能检索**：多维评分（标题/摘要/关键词/标签/内容）、高亮片段
+- **自动摘要**：自动提取关键句子
+- **关键词提取**：中英文分词 + 停用词过滤
+
+#### 2.4.3 插件市场
+- **插件生命周期**：安装 / 卸载 / 启用 / 禁用
+- **市场浏览**：搜索、分类、下载量、评分
+- **插件 API**：命令注册、视图注册、补全提供者、通知等
+- **权限系统**：workspace / git / terminal / ui 权限声明
+
+#### 2.4.4 PWA 移动端适配
+- **manifest.json**：可安装、独立显示、3 个快捷方式
+- **Service Worker**：离线缓存、API 网络优先、推送通知、通知点击跳转
+
+### 2.5 新增：安卓版
+
+- **技术方案**：Capacitor 8 打包 Web 前端
+- **包信息**：`com.feihong.code`，versionCode 1，Android 6.0+（API 23），targetSdk 35
+- **双模式**：
+  - **离线演示模式**（默认）：内置 mock-api.js 拦截层，完整展示 UI
+  - **远程连接模式**：设置中填写服务器地址，连接完整后端
+- **图标**：紫蓝渐变 + F 字母自适应图标（5 档密度 + adaptive icon）
+- **应用名**：飞虹 Code（深色主题 #1a1a2e）
+
+### 2.6 SWE 成绩对外文案（P3-2）
+
+**背景**：早期对外文档中的对标多为无依据定性表述（如"与 Cursor 处于同一梯队"），缺少量化跑分。v7.2.0 更新为"真实跑分 + 来源标注 + 诚实口径"三要素文案。
+
+- **飞虹 Code 真实成绩**（对外唯一声称口径）：自建 SWE-bench 格式任务集（problem_statement + FAIL_TO_PASS）5 个自包含 JS 任务，真实模型驱动 Orchestrator 修复，预定义测试 `node --test` 真实断言验证，**测试通过率 80%（4/5）**；harness 闭环 mock 2/2、真实模型生成率 3/3。复现：`node scripts/_swe-bench-real.mjs`
+- **行业公开对标**（SWE-bench Verified，2026）：Claude Opus 4.8=88.6%、Opus 4.7=87.6%、GPT-5.2=80.0%、Gemini 3.1 Pro=80.6%、豆包 Doubao-Seed-Code+TRAE=78.80%、TRAE=75.2%（字节官方）、Cursor≈51.7%（默认配置，MarkTechPost）
+- **诚实声明**：
+  1. 自建任务集 ≠ 官方 Verified 500 任务，**不可直接横向对比**，仅展示相对量级
+  2. Verified 已被确认数据污染（SWE-ABS：强化测试后平均下降 14.56pp，榜首 78.80%→62.20%），高分须谨慎解读
+  3. 官方 Verified 需 Docker+pytest，本机未复测，**不对官方榜单声明成绩**
+- **更新文件**：`docs/BENCHMARK_REPORT_zh.md` / `docs/BENCHMARK_REPORT_en.md`（新增第十三章量化对标章节）、`docs/geo-feihong-code.html`（FAQ 新增 SWE 成绩问答）、本说明书
+
+---
+
+## 3. 升级操作步骤
+
+### 3.1 升级 npm 包
+
+```bash
+# 全局升级
+npm i -g feihong-code@7.2.0
+
+# 项目内升级
+npm i feihong-code@7.2.0
+
+# 验证版本
+fhcode --version
+```
+
+### 3.2 从源码构建升级
+
+```bash
+# 拉取最新代码
+git pull origin master
+
+# 安装依赖（若新增依赖）
+npm install
+
+# 构建
+npm run build
+
+# 类型检查
+npm run typecheck
+
+# 运行
+npm start
+```
+
+### 3.3 Windows 桌面版升级
+
+1. 关闭正在运行的飞虹 Code
+2. 替换 `H:\feihong-app` 目录为最新版
+3. 启动 `飞虹 Code.exe`
+4. 验证：托盘图标 → 关于飞虹 Code → 版本应为 v7.2.0
+
+### 3.4 安卓版安装
+
+1. 将 `飞虹Code-v7.0.0-android.apk` 传输到手机
+2. 允许"未知来源"后安装
+3. 首次打开进入离线演示模式
+4. 需要完整功能时：设置 → 填写服务器地址 `http://服务器IP:端口`
+
+### 3.5 配置远程服务器（安卓完整功能）
+
+```bash
+# 服务器端启动飞虹 Code Web 服务
+fhcode serve --port 8081 --host 0.0.0.0
+
+# 安卓端设置
+# 设置界面填写: http://服务器IP:8081
+```
+
+---
+
+## 4. 接口变更说明
+
+### 4.1 新增 API（40+）
+
+| 模块 | 接口 | 说明 |
+|---|---|---|
+| 补全 | `POST /api/completion/accept` | 记录补全接受 |
+| 补全 | `POST /api/completion/suggest-next` | 连续推荐 |
+| 多智能体 | `POST /api/multi-agent/run` | 执行多角色协同 |
+| 多智能体 | `GET /api/multi-agent/roles` | 角色列表 |
+| 事件驱动 | `GET/POST /api/event-driven/config` | 配置管理 |
+| 事件驱动 | `POST /api/event-driven/trigger` | 手动触发 |
+| 事件驱动 | `POST /api/event-driven/webhook/:path` | Webhook 接收 |
+| 自定义Agent | `POST /api/custom-agents/match` | 关键词匹配 |
+| 自定义Agent | `POST /api/custom-agents/:id/execute` | 执行 Agent |
+| 协作 | 飞书/GitHub 集成 | `src/integrations/collaboration.ts` |
+| Figma | 设计稿转代码 | `src/integrations/figma.ts` |
+| SSO | 单点登录 | `src/integrations/sso.ts` |
+| 语音 | 语音编程 | `src/voice/voice-programming.ts` |
+| 知识库 | AI 资料库 | `src/knowledge/library.ts` |
+| 插件 | 插件市场 | `src/plugins/manager.ts` |
+
+### 4.2 兼容性
+
+- **完全向后兼容** v7.0.0 全部配置与 API
+- 既有 CLI 命令不变（`fhcode chat/serve/swe` 等）
+- 配置文件路径不变（`~/.feihong-code/`）
+
+---
+
+## 5. 配置说明
+
+### 5.1 新增配置目录
+
+```
+~/.feihong-code/
+├── event-driven/
+│   ├── config.json     # 事件驱动配置
+│   └── events.json     # 事件历史
+├── custom-agents/      # 自定义 Agent（每个 Agent 一个 JSON）
+├── knowledge/          # AI 资料库（index.json + documents/）
+└── plugins/            # 插件目录 + plugin-registry.json
+```
+
+### 5.2 环境变量
+
+| 变量 | 说明 |
+|---|---|
+| `FH_WEB_PORT` | Web 服务端口（默认 8081） |
+| `FH_WEB_HOST` | 监听地址（远程需设 0.0.0.0） |
+
+---
+
+## 6. 升级验证清单
+
+按顺序执行以下验证：
+
+| # | 验证项 | 命令/操作 | 预期结果 |
+|---|---|---|---|
+| 1 | 版本号 | `fhcode --version` | 显示 7.2.0 |
+| 2 | 构建 | `npm run typecheck` | 退出码 0 |
+| 3 | 服务启动 | `fhcode serve` | 健康检查 200 |
+| 4 | 多智能体 | `GET /api/multi-agent/roles` | 返回 4 角色 |
+| 5 | 自定义Agent | `GET /api/custom-agents` | 返回 5 内置 |
+| 6 | 事件驱动 | `GET /api/event-driven/config` | 返回配置 |
+| 7 | 补全 | `POST /api/completion` | 返回补全候选 |
+| 8 | 桌面版 | 启动 exe | 托盘图标出现 |
+| 9 | 安卓版 | 安装 APK | 打开进入演示模式 |
+
+---
+
+## 7. 已知问题与注意事项
+
+1. **GitHub workflow 文件**：`.github/workflows/release.yml` 因 PAT 缺少 `workflow` scope 未包含在 v7.2.0 PR 中，需在 GitHub 补权限后单独提交
+2. **安卓离线模式**：AI 生成能力需连接远程服务器，离线仅展示 UI 与演示数据
+3. **Android 构建路径**：因项目路径含中文，Android 构建需在纯 ASCII 路径（`H:\feihong-android`）执行
+4. **语音编程**：安卓端语音识别依赖系统 WebView 支持
+5. **Figma/飞书/GitHub 集成**：需在配置中填写对应 API Key 后方可使用
+
+---
+
+## 8. 回滚方案
+
+如需回滚到 v7.0.0：
+
+```bash
+# npm 回滚
+npm i -g feihong-code@7.0.0
+
+# 桌面版
+# 使用 v7.0.0 的 feihong-app 备份目录
+
+# 配置回滚
+# v7.2.0 新增配置目录删除即可，不影响 v7.0.0 既有配置
+```
+
+---
+
+*本说明书由晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心编制*
+*如需技术支持请联系：飞虹智（klai.top）*

package/docs/UPGRADE_GUIDE_7_5.md

@@ -0,0 +1,86 @@
+# 飞虹 Code · v7.5.0 升级说明书
+
+> 版本：v7.5.0 · 更新：2026-08-27
+> 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹
+> 适用：从 v7.2.0（或更早）升级到 v7.5.0 的所有用户
+
+## 1. 升级方式
+
+### npm 全局安装（CLI / 桌面后端）
+```bash
+npm install -g feihong-code@7.5.0
+# 校验版本
+fhcode --version   # 应输出 7.5.0
+# 环境自检
+fhcode doctor
+```
+
+### Docker（服务端/CI 场景）
+```bash
+docker pull <你的镜像仓库>/feihong-code:7.5.0
+```
+
+### Electron 桌面版
+从发布渠道下载 v7.5.0 安装包覆盖安装即可，数据（会话、配置、技能）自动保留在 `~/.feihong-code/`。
+
+## 2. v7.2.0 → v7.5.0 变更总览
+
+| 领域 | 变更 | 是否需要操作 |
+|---|---|---|
+| 补全 | 多候选 / temperature 分层 / 跨文件上下文 / accept 后 lint | 无（默认开启） |
+| 编辑器 | Monaco 语义诊断波浪线 + hover、多文件 diff 并排/折叠视图 | 无 |
+| 插件市场 | 本地种子源（断网可用 10 个官方 skill）+ install 自动注册 | 无 |
+| 沙箱 | container 档位隔离加固（默认断网） | 若使用 container 档位需确认镜像/网络配置 |
+| 安全 | `npm run security`（audit+SBOM） | 建议接入 CI |
+| SWE-bench | 官方 harness + `--verifier test` 跑分 | 需模型 + Docker 才可真实跑分 |
+| 合规 | 安全白皮书 + DPA | 政企售前可引用 |
+| 协作 | 团队面板协作总览 | 无 |
+
+## 3. 兼容性与行为变化（重要）
+
+1. **版本号**：7.2.0 → 7.5.0（跨 3 个 minor）
+2. **container 沙箱默认断网**：若此前使用 `sandboxMode: container` 且命令需要联网（如 `npm install`），现在默认 `--network none` 会失败。解决：
+   ```bash
+   # 容器内装依赖需要联网时，显式开启 host 网络（仍受网络 allow/deny 约束）
+   FH_SANDBOX_NETWORK=host fhcode run "npm install"
+   ```
+3. **补全体验变化**：full 模式补全多样性提升（temperature 0.3）、接受补全后可能有 lint 反馈波浪线（若代码确有语法问题）——这是预期行为
+4. **技能索引**：`skill-market install` 现在会输出"已自动注册到本地技能索引"，`fhcode skill-market list` 可直接看到新装技能
+5. **配置兼容**：v7.2.0 的 `~/.feihong-code/config.json` 完全兼容，无需迁移
+
+## 4. 升级后建议执行的验证
+
+```bash
+# 1. 版本与环境
+fhcode --version && fhcode doctor
+
+# 2. 综合冒烟（本地回归）
+node scripts/_smoke-full.mjs
+
+# 3. 安全 CI（SBOM 生成 + 漏洞扫描）
+npm run security
+
+# 4. 补全验证（若配置了模型）
+fhcode serve  # 打开 Web 编辑器，输入代码观察 ghost text 与诊断波浪线
+
+# 5. 插件市场（断网回退）
+fhcode skill-market list   # 应显示已装技能（含官方种子）
+```
+
+## 5. 回滚方案
+
+如需回退到 v7.2.0：
+```bash
+npm install -g feihong-code@7.2.0
+```
+配置与数据目录 `~/.feihong-code/` 不做破坏性改动，可直接回退。**注意**：v7.5.0 的 SBOM/白皮书等新增产物不回写旧版本。
+
+## 6. 常见问题（FAQ）
+
+- **Q: accept 补全后总出现红色波浪线？** A: 说明补全代码有括号/引号未配平等语法问题（/api/lint 检测），属真实反馈；可在扩展配置 `fhcode.enableAcceptLint=false` 关闭
+- **Q: container 模式下 npm install 失败？** A: 见上文第 3 节，设 `FH_SANDBOX_NETWORK=host`
+- **Q: SWE-bench 跑分怎么跑？** A: 见 `docs/SWE_BENCH_REPORT.md`，需模型配置 + Docker
+- **Q: 需要政企合规材料？** A: 见 `docs/SECURITY_WHITEPAPER.md` 与 `docs/DPA.md`
+
+---
+飞虹 Code v7.5.0 · 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹

package/docs/UPGRADE_GUIDE_7_6.md

@@ -0,0 +1,153 @@
+# 飞虹 Code · v7.6.0 版本升级说明书
+
+> 版本：v7.6.0 · 更新：2026-08-28
+> 适用：从 v7.5.0（或更早）升级到 v7.6.0 的所有用户
+> 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹
+
+---
+
+## 1. 升级前须知
+
+1. **数据安全**：升级不会破坏 `~/.feihong-code/` 下的会话、配置、技能与经验数据。建议升级前备份数据目录：
+   ```bash
+   # Windows PowerShell
+   Copy-Item -Recurse "$env:USERPROFILE\.feihong-code" "$env:USERPROFILE\.feihong-code-backup-7.5.0"
+   ```
+2. **版本检查**：升级前确认当前版本
+   ```bash
+   fhcode --version   # 若为 7.5.0 或更早，均可直接升级
+   ```
+3. **git 仓库状态**：若从源码升级，先提交或暂存本地改动，避免构建产物冲突。
+
+---
+
+## 2. 升级路径
+
+| 当前版本 | 升级路径 |
+|---------|---------|
+| v7.5.0 | **直接升级到 v7.6.0**（本次主路径） |
+| v7.2.0 及更早 | 先按 `docs/UPGRADE_7.2.0.md` / `docs/UPGRADE_GUIDE_7_5.md` 升级到 v7.5.0，再升级到 v7.6.0 |
+
+---
+
+## 3. v7.6.0 变更总览
+
+### 3.1 重大更新
+
+| 变更 | 说明 | 影响 |
+|------|------|------|
+| **SWE harness 差分语义** | `TestVerifier` 三段式校验：修复前 FAIL_TO_PASS 原本失败 → 修复后 FTP 全过 → PASS_TO_PASS 回归不破坏既有功能 | 跑分更严格、更可信；杜绝假阳性与回归破坏 |
+| **双系统收敛为单一经验库** | 旧式 `self-evolve` 的失败/解决/技能沉淀统一回流 `experiences.jsonl`，与 `self-improve` 同库同 upsert 语义 | 学习闭环统一；`self-evolve status` 新增共享经验库计数 |
+| **voice-programming 加固** | 补齐 5 个死类型命令规则、修复「创建一个叫 X 的文件」识别与面板命令抢占、新增 7 项单元测试 | 语音指令识别更准确 |
+
+### 3.2 工程与运维
+
+- **仓库卫生**：清理 163 个 android 构建产物 + 29 个根目录调试截图 + `.idsig` 的 git 跟踪；`.gitignore` 补全
+- **BOM 兼容**：`self-evolve` 读取 JSON 自动去 BOM（PowerShell 写入的配置可正常读取）
+- **版本号**：`7.5.0 → 7.6.0`；Android `versionCode 7 → 8`
+
+### 3.3 文档
+
+- 新增/重写：技术设计说明书、使用说明书（v7.6.0 权威版）
+- 新增：本升级说明书
+- 全库现行态文档版本头统一对齐 v7.6.0
+
+### 3.4 行为变化（需关注）
+
+1. `fhcode harness` 现在默认执行三段式校验：若测试集缺少 PASS_TO_PASS 或修复前未确认失败，判定会变严格。历史 mock 报告口径不变（诚实标注）。
+2. `fhcode self-evolve status` 输出新增一行「共享经验库」。
+3. 统一经验库启用后，首次运行会创建 `~/.feihong-code/experiences/` 目录并回流历史失败/技能记录。
+
+---
+
+## 4. 升级步骤
+
+### 4.1 npm 全局安装升级
+
+```bash
+npm install -g feihong-code@7.6.0
+fhcode --version   # 应输出 7.6.0
+fhcode doctor      # 环境自检
+```
+
+### 4.2 源码升级
+
+```bash
+git pull                 # 拉取 v7.6.0 代码
+npm install              # 更新依赖（如有变更）
+npm run build            # 重新构建 dist/
+node dist/cli/index.js --version   # 7.6.0
+npm test                 # 全量测试应 243/243 通过
+```
+
+### 4.3 Docker / 私有化升级
+
+```bash
+docker pull <你的镜像仓库>/feihong-code:7.6.0
+docker stop <旧容器>
+docker run -d -v ~/.feihong-code:/data/feihong-code \
+  <你的镜像仓库>/feihong-code:7.6.0
+```
+
+### 4.4 Android APK 升级
+
+从发布渠道下载 v7.6.0（versionCode 8）覆盖安装即可。数据（会话、配置、技能、经验）自动保留在 `~/.feihong-code/`（需与桌面端同步）。
+
+---
+
+## 5. 数据兼容性
+
+| 数据 | 兼容性 | 说明 |
+|------|--------|------|
+| `~/.feihong-code/sessions/` | ✅ 完全兼容 | 会话可 resume / diff / rollback |
+| `~/.feihong-code/config/` | ✅ 完全兼容 | 配置结构未变 |
+| `~/.feihong-code/self-evolve/` | ✅ 完全兼容 | 新增回流写入共享经验库，原有文件保留作审计 |
+| `~/.feihong-code/experiences/` | ✅ 新增 | 首次运行时自动创建；与 self-improve 共用 |
+| `~/.feihong-code/skills/` | ✅ 完全兼容 | 技能索引自动去 BOM 读取 |
+| 环境变量 `.env` | ✅ 完全兼容 | 所有 `FH_*` 变量含义不变 |
+
+---
+
+## 6. 升级后验证清单
+
+```bash
+fhcode --version                    # ✅ 7.6.0
+fhcode doctor                       # ✅ 环境自检通过
+fhcode self-improve                 # ✅ 经验库正常加载（含历史回流）
+fhcode self-evolve status           # ✅ 显示「共享经验库」行
+fhcode experiences                  # ✅ 可浏览经验
+fhcode harness --split lite --limit 1 --mode mock --verifier file   # ✅ 管道可复现
+fhcode swe "写一个 hello world"     # ✅ 端到端任务可用
+```
+
+---
+
+## 7. 回滚方案
+
+配置与数据目录 `~/.feihong-code/` 不做破坏性改动，可直接回退。
+
+```bash
+# npm 回退
+npm install -g feihong-code@7.5.0
+
+# 源码回退
+git checkout <v7.5.0 提交> && npm run build
+
+# 数据回退（如需）
+# 还原第 1 节备份的数据目录即可
+```
+
+**注意**：v7.6.0 新增的共享经验库条目（回流记录）不回写旧版本；回退后 `self-evolve status` 不再显示「共享经验库」行，原 `self-evolve/` 数据文件不受影响。
+
+---
+
+## 8. 已知限制
+
+1. **官方 SWE-bench（Python/pytest）跑分**：受 HF 网络可达性与 Docker 环境限制，v7.6.0 仍未产出官方分数；当前以「自建任务集真实模型跑分 5/5 + mock 管道复现」对外，口径诚实标注。详见 `docs/SWE_BENCH_REPORT.md`。
+2. **受管命令白名单**：`fhcode harness` 的测试命令仅放行 `npm/pnpm/yarn/bun`；`node -e` 直跑会被拦截，测试须封装为 npm script。
+3. **语音识别依赖**：语音编程的本地识别依赖 faster-whisper 部署，未部署时仅支持文本指令回退。
+
+---
+
+*飞虹 Code v7.6.0 · 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹*
+*2026-08-28 · 版本升级说明书*

package/docs/User_Manual_EN.md

@@ -1,6 +1,6 @@
 # Feihong Code (fhcode) — User Manual
 
-**Version**: v0.5.0-b
+**Version**: v7.6.0
 **Date**: 2026-08-16
 **Product**: Feihong Code (feihong-code) — a terminal AI coding agent (a Muse Code reimplementation)
 **Attribution**: Jinjiang Feihongzhi Tech Enterprise Management Co., Ltd. · Feiyang Qiyuan R&D Center · Lead: Wu Cihong