feihong-code 7.2.0 → 7.6.0

package/docs//344/275/277/347/224/250/350/257/264/346/230/216/344/271/246.md

@@ -1,9 +1,10 @@
 # 飞虹 Code（fhcode）使用说明书
 
-**版本**：v0.5.0-b
-**日期**：2026-08-16
-**产品**：飞虹 Code（feihong-code）— 终端 AI 编程智能体（Muse Code 参照复刻）
+**版本**：v7.6.0
+**日期**：2026-08-28
+**产品**：飞虹 Code（feihong-code）— 终端 AI 编程智能体（对标 Muse Code，自研内核）
 **署名**：晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹
+**配套文档**：`docs/技术说明书.md`（技术设计）、`docs/UPGRADE_GUIDE_7_6.md`（升级）、`docs/常见问题与故障排查.md`（FAQ）
 
 ---
 
@@ -15,304 +16,212 @@
 - npm ≥ 9
 - git（diff/rollback/并行 worktree 需要）
 - Docker（仅 `FH_SANDBOX_MODE=container` 时需要）
+- 可选：Ollama（本地模型）、faster-whisper（本地语音）
 
 ### 1.2 安装
 
 ```bash
-# 方式一：源码构建（推荐）
+# 方式一：npm 全局安装（推荐）
+npm install -g feihong-code
+fhcode --version        # 应输出 7.6.0
+
+# 方式二：源码构建
 git clone https://github.com/wch887292/feihong-code.git
 cd feihong-code
 npm install
 npm run build
+node dist/cli/index.js --version   # 7.6.0
 
-# 方式二：npm 全局安装
-npm install -g feihong-code
-fhcode --version   # 验证
-```
-
-### 1.3 三秒上手
-
-```bash
-# 未配置模型时自动进入离线模式（Mock 驱动闭环），可直接体验
-fhcode "写一个 hello.ts"
+# 方式三：Electron 桌面版
+npm run electron:build             # 生成 Windows 安装包
 
-# 配置真实模型（DeepSeek 示例）后走真实模式
-export FH_PROVIDERS='[{"name":"deepseek","type":"openai-compatible","baseUrl":"https://api.deepseek.com/v1","apiKey":"sk-...","tags":["code-gen","reasoning"],"priority":1}]'
-fhcode "修复 src/auth.ts 中的 token 校验 bug"
+# 方式四：Android APK（versionCode 8 / 7.6.0）
+# 从发布渠道安装，配套桌面端使用
 ```
 
----
-
-## 二、命令速查
+### 1.3 首次配置
 
 ```bash
-# 基础
-fhcode                              进入交互式 REPL（TTY 下自动启用 TUI）
-fhcode "<需求>"                      单命令执行一条需求
-fhcode --stream "<需求>"             流式输出（任务过程实时可见）
-fhcode --yes "<需求>"                跳过审批（危险操作需谨慎）
-fhcode --lang zh|en                  设置界面语言
-
-# 只读技能
-fhcode /plan "<目标>"                生成实现计划
-fhcode /grill [路径]                 红队式代码审查（文本）
-fhcode review [路径] [--json]        结构化代码审查（--json 供 IDE/CI 消费）
-fhcode /goal "<目标>"                分解并保存高层目标
-
-# 会话管理（M3）
-fhcode sessions                      列出历史会话
-fhcode resume <id>                   从检查点续跑
-fhcode diff [id]                     查看会话/工作区变更
-fhcode rollback <id> --yes           回滚会话改动（破坏性）
-
-# 企业能力（M4）
-fhcode whoami                        当前租户/用户/角色/配额
-fhcode policy                        查看生效 RBAC 策略
-fhcode audit [verify]                审计记录 / 哈希链校验
-fhcode tenants                       租户用量汇总
-
-# 自我进化（M6/M8/M9）
-fhcode model-stats                   模型性能统计
-fhcode experiences [路径]            经验库
-fhcode code-write "<目标>"            自主编程
-fhcode quality-gate [路径]           质量门禁审查
-fhcode self-improve                  自我改进统计
-fhcode swe "<目标>"                  全自动软件工程 Agent
-fhcode team "<目标>"                 多 agent 协作（共享任务板+消息总线）
-
-# 生态
-fhcode skill-market search "<关键词>" 搜索技能市场（agentskills.io）
-fhcode skill-market install <技能名>  安装技能
-fhcode skill-market list             列出本地技能
-fhcode plugin install <目录|git URL> 安装插件
-fhcode plugin list                   列出插件
-fhcode doctor                        环境自检
-```
-
-**常用 flag**：`--parallel`（并行 worktree）/ `--repo`（swe 目标仓库/市场源）/ `--context-file <path>`（附加文件上下文）/ `--max-iterations N` / `--max-retries N` / `--plan-only` / `--verify-only` / `--json`。
-
----
-
-## 三、模型配置
+# 复制配置模板并填写模型 API Key
+cp .env.example .env
+# 编辑 .env：至少配置 FH_PROVIDERS 中一个 provider 的 apiKey
 
-### 3.1 配置优先级
-
-1. `FH_PROVIDERS`（JSON 数组，最高优先级）
-2. `fhcode.config.json`（项目配置文件 `models.providers`）
-3. 单环境变量 `FH_MODEL_*`
-
-### 3.2 Ollama 本地模型
-
-```bash
-export FH_MODEL_NAME=qwen3:8b
-export FH_MODEL_TYPE=ollama
-export FH_MODEL_BASE_URL=http://localhost:11434
-export FH_MODEL_TAGS=code-gen,reasoning,local
+# 环境自检（可选）
+fhcode doctor
 ```
 
-### 3.3 DeepSeek / 通义
+### 1.4 第一个任务
 
 ```bash
-# DeepSeek
-export FH_PROVIDERS='[{"name":"deepseek","type":"openai-compatible","baseUrl":"https://api.deepseek.com/v1","apiKey":"sk-...","tags":["code-gen","reasoning"],"costPer1k":0.0001}]'
-# 通义千问
-export FH_PROVIDERS='[{"name":"qwen","type":"openai-compatible","baseUrl":"https://dashscope.aliyuncs.com/compatible-mode/v1","apiKey":"...","tags":["code-gen","long-context"]}]'
-```
-
-### 3.4 路由策略
+# 直接下达自然语言任务
+fhcode "给我写一个 Node.js 的 hello world HTTP 服务，监听 3000 端口"
 
-```bash
-export FH_MODEL_STRATEGY=cost        # cost | capability | latency
-export FH_BUDGET_USD=0.5             # 单任务成本上限（超限熔断）
+# 查看会话与回滚
+fhcode sessions          # 列出历史会话
+fhcode diff <会话ID>     # 查看本次改动
+fhcode rollback <会话ID> # 回滚改动
 ```
-低成本标签 `cheap` 的 provider 会优先承担 `swe`/并行子任务（P1-1 模型分工）。
 
 ---
 
-## 四、典型工作流
+## 二、CLI 命令手册
+
+| 命令 | 说明 | 示例 |
+|------|------|------|
+| `fhcode <目标>` | 直接执行自然语言任务（默认入口） | `fhcode "修复登录接口的 bug"` |
+| `fhcode sessions` | 列出历史会话 | `fhcode sessions` |
+| `fhcode resume <id>` | 续跑指定会话 | `fhcode resume 3f9a…` |
+| `fhcode diff <id>` | 查看会话产生的代码改动 | `fhcode diff 3f9a…` |
+| `fhcode rollback <id>` | 回滚会话改动 | `fhcode rollback 3f9a…` |
+| `fhcode whoami` | 查看当前身份与角色 | `fhcode whoami` |
+| `fhcode policy` | 查看/管理权限策略 | `fhcode policy` |
+| `fhcode audit` | 审计日志；`--verify` 校验哈希链 | `fhcode audit --verify` |
+| `fhcode tenants` | 多租户管理 | `fhcode tenants` |
+| `fhcode doctor` | 环境自检（依赖/权限/网络） | `fhcode doctor` |
+| `fhcode tui` | 进入多面板终端 UI | `fhcode tui` |
+| `fhcode serve [port]` | 启动 Web 控制台 | `fhcode serve 8080` |
+| `fhcode plugin <action>` | 插件管理（install/list/remove） | `fhcode plugin install xxx` |
+| `fhcode skill-market <action>` | 技能市场（search/install） | `fhcode skill-market search lint` |
+| `fhcode skill-new <name>` | 新建技能（SKILL.md 模板） | `fhcode skill-new my-lint` |
+| `fhcode review <path>` | 代码审查 | `fhcode review src/` |
+| `fhcode team <目标>` | 多 agent 团队协作 | `fhcode team "完成这个模块"` |
+| `fhcode code-write <目标>` | 纯代码生成 | `fhcode code-write "写一个排序函数"` |
+| `fhcode quality-gate <path>` | 质量门禁检查 | `fhcode quality-gate src/` |
+| `fhcode self-improve` | 查看自我改进学习沉淀 | `fhcode self-improve` |
+| `fhcode self-evolve <action>` | 自我迭代运维（status/report） | `fhcode self-evolve status` |
+| `fhcode model-stats` | 模型用量与成本统计 | `fhcode model-stats` |
+| `fhcode experiences` | 浏览统一经验库 | `fhcode experiences` |
+| `fhcode harness …` | SWE-bench 评测 | `fhcode harness --split lite --limit 1 --mode mock` |
+| `fhcode swe <目标>` | 全自动软件工程任务 | `fhcode swe "实现排序功能"` |
+| 内置技能 | `/plan`（规划）`/grill`（拷问）`/self-heal`（自愈） | `fhcode /plan "实现登录"` |
 
-### 4.1 单任务
+---
 
-```bash
-# 基础
-fhcode "实现一个 HTTP 服务器，监听 3000 端口"
-# 流式 + 指定上下文文件
-fhcode --stream --context-file src/auth.ts "审查并修复此文件中的安全问题"
-```
+## 三、核心功能
 
-### 4.2 全自动软件工程（swe）
+### 3.1 对话编程
 
-```bash
-fhcode swe "修复 src/calc.ts 的 add 函数 bug，让 tests/calc.test.ts 通过" \
-  --repo /path/to/project \
-  --max-tasks 3 --max-iterations 5
-# --plan-only 仅规划 / --verify-only 仅验证 / --max-retries N 自愈重试
-```
+- 纯文本输出 + 实时思考过程展示
+- 支持上下文压缩、检查点续跑（会话中途断线可 resume）
+- 成本熔断：超预算自动止损（`FH_BUDGET_USD`）
 
-### 4.3 多 agent 协作（team）
+### 3.2 代码补全（Web / VS Code）
 
-```bash
-fhcode team "实现登录模块 并且 添加用户管理 并且 写集成测试"
-# 目标自动拆解 → 多 agent 并发认领 → 消息总线汇报 → 团队报告
-```
+- 多候选补全（按置信度 Top3）
+- temperature 分层（quick 0 / full 0.3）
+- 跨文件上下文（import 关联 + 工作区实时文档）
+- 接受补全后自动 lint（语法错误实时波浪线提示）
 
-### 4.4 技能市场与插件
+### 3.3 全自动软件工程（SWE）
 
 ```bash
-# 从 agentskills.io 搜索并安装技能（安装后任务中自动发现）
-fhcode skill-market search "code review"
-fhcode skill-market install code-review
-# 安装插件（打包 skills+hooks+MCP）
-fhcode plugin install ./my-plugin
+fhcode swe "给项目添加一个 markdown 转 HTML 的 CLI 工具"
 ```
 
-### 4.5 会话恢复与回滚
-
-```bash
-fhcode sessions                 # 找到会话 id
-fhcode resume <id>              # 中断后续跑
-fhcode diff <id>                # 查看改动
-fhcode rollback <id> --yes      # 回滚（破坏性）
-```
+流程：读取仓库结构 → 规划 → 实现 → 构建/测试验证 → 失败自动自愈重试 → 输出报告。验证支持测试（`--verifier test`）与文件级（`--verifier file`）两种模式。
 
-### 4.6 环境自检
+### 3.4 SWE 评测（harness）
 
 ```bash
-fhcode doctor
-# ✅ Node 版本 / git / 模型配置 / 网络连通 / 主目录可写 / 沙箱模式
+# 运行 mock 管道（无网络也可见证）
+fhcode harness --split lite --limit 1 --mode mock --verifier file --report bench/run-xxx.md
+
+# 使用官方测试验证器
+fhcode harness --split lite --limit 1 --verifier test --test-command "npm run test"
 ```
 
----
+差分语义：修复前确认用例原本失败 → 修复后 FAIL_TO_PASS 全过 → PASS_TO_PASS 回归不破坏既有功能。
 
-## 五、REPL / TUI 使用
+### 3.5 团队协作
 
 ```bash
-fhcode          # 进入交互模式（TTY 自动启用 TUI）
+fhcode team "让两个 agent 分别实现前端和后端"
 ```
-- TUI：顶部 sticky header 显示 模式/runId/迭代/成本/状态；内容区滚动；滚轮可回看
-- 输入需求回车执行；`exit`/`quit`/Ctrl+D 退出
-- 支持 `/plan` `/grill` `/goal` 斜杠技能
 
----
-
-## 六、VSCode 扩展
-
-在 `vscode-extension/` 目录打包（`npx @vscode/vsce package`）或 F5 调试加载：
-
-| 命令 | 说明 |
-|------|------|
-| `fhcode: 运行任务（附带选区上下文）` | 选中代码自动注入 `<selection>` 上下文 |
-| `fhcode: 内联评审当前文件` | `review --json` → 编辑器内联诊断（红/黄/蓝） |
-| `fhcode: 就地查看工作区 diff` | 原生 diff 编辑器 HEAD↔工作区 |
-| `fhcode: 查看最近任务输出` | 聚焦 Output Channel |
-
-配置：`fhcode.binaryPath` / `fhcode.offline` / `fhcode.reviewOnSave`（保存自动评审，默认开）。
-
----
+- 多 agent 消息总线协作
+- 协作总览面板：任务状态漏斗 + 成员负载分布
 
-## 七、Web 控制台（云执行）
+### 3.6 自我迭代（统一经验库）
 
 ```bash
-fhcode serve --port 8080
-# 浏览器打开 http://localhost:8080
+fhcode self-improve    # 查看学习沉淀（反思 + 经验库 + 成功率）
+fhcode self-evolve status   # 运维视图：失败记录/技能/共享经验库
+fhcode experiences     # 浏览经验库内容
 ```
 
-**任务面板**：输入 token（终端输出的 `FH_WEB_TOKEN`）→ 提交目标 → 轮询状态 → 展开结果详情。
+- 失败、解决、技能沉淀自动写入共享经验库 `~/.feihong-code/experiences/experiences.jsonl`
+- orchestrator 在后续任务自动检索注入经验，越用越强
 
-**API 调用**（Bearer 鉴权）：
+### 3.7 语音编程
 
-```bash
-TOKEN=$(echo $FH_WEB_TOKEN)
-# 提交任务
-curl -X POST http://localhost:8080/api/tasks \
-  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-  -d '{"goal":"写一个 hello.ts"}'
-# 查询
-curl http://localhost:8080/api/tasks -H "Authorization: Bearer $TOKEN"
-curl http://localhost:8080/api/tasks/<id> -H "Authorization: Bearer $TOKEN"
-# 注册 webhook（任务状态回调，可被 CI 调度）
-curl -X POST http://localhost:8080/api/webhook \
-  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-  -d '{"url":"https://your-ci.example.com/hook"}'
-```
+支持口头指令 → 编辑器/终端动作：新建/打开文件、复制/粘贴/剪切、替换、取消注释、切换终端/侧边栏/全屏、解释代码等。适合现场调试场景（如「打开终端」「上下反了」等口语化指令）。
 
 ---
 
-## 八、消息渠道
-
-```bash
-# Telegram 通知（任务状态变化推送）
-export FH_CHANNEL_TELEGRAM_BOT_TOKEN=bot:xxx
-export FH_CHANNEL_TELEGRAM_CHAT_ID=12345
-# 企业微信群机器人（可多个 key）
-export FH_CHANNEL_WECOM_KEY=key1,key2
-# 出站白名单（可选，配置后仅白名单渠道可发）
-export FH_CHANNEL_ALLOW=telegram,wecom
-```
+## 四、配置
+
+### 4.1 环境变量（.env）
+
+| 变量 | 说明 | 默认 |
+|------|------|------|
+| `FH_HOME` | 数据目录 | `~/.feihong-code` |
+| `FH_LOG_DIR` | 会话日志目录 | `~/.feihong-code/sessions` |
+| `FH_PROVIDERS` | 模型供应商 JSON 数组（baseURL/apiKey/tags/costPer1k） | 空 |
+| `FH_MODEL_STRATEGY` | 路由策略：cost / capability / latency | cost |
+| `FH_BUDGET_USD` | 单任务预算上限（美元） | 0.5 |
+| `FH_SANDBOX_MODE` | 沙箱模式：read-only / workspace-write / danger-full-access / container | workspace-write |
+| `FH_SHELL_ALLOW` | Shell 白名单（逗号分隔） | git,npm,pnpm,node,ls,cat |
+| `FH_REQUIRE_APPROVAL` | 危险操作是否需审批 | true |
+| `FH_NETWORK_DENY` / `FH_NETWORK_ALLOW` | 网络域名黑白名单 | 空 |
+| `FH_HOOKS` | hooks 配置（确定性控制） | 空 |
+| `FH_MCP_SERVERS` | MCP 服务器配置 | 空 |
+
+### 4.2 沙箱模式速查
+
+| 模式 | 适用场景 |
+|------|---------|
+| `read-only` | 只读勘察、审计场景 |
+| `workspace-write` | 默认；日常开发 |
+| `danger-full-access` | 需要全权限的自动化脚本 |
+| `container` | 执行不可信代码（Docker 断网隔离） |
 
 ---
 
-## 九、沙箱与安全使用
-
-```bash
-# 沙箱模式
-export FH_SANDBOX_MODE=workspace-write      # 默认
-export FH_SANDBOX_MODE=read-only            # 只读勘察（禁写禁执行）
-export FH_SANDBOX_MODE=danger-full-access   # 全权限（危险命令仍拦截）
-export FH_SANDBOX_MODE=container            # Docker 容器内执行 shell
-export FH_SANDBOX_IMAGE=node:22-alpine      # 容器镜像
-
-# 网络域名规则
-export FH_NETWORK_DENY=evil.example.com
-# export FH_NETWORK_ALLOW=api.example.com
-
-# 确定性 hooks（PreToolUse 非零退出拦截）
-export FH_HOOKS='[{"event":"PreToolUse","command":"node scripts/guard.js","tools":["run_shell"]}]'
-```
+## 五、常见问题（FAQ）
 
----
+**Q1：`fhcode --version` 显示的不是 7.6.0？**
+全局缓存旧包，先 `npm uninstall -g feihong-code` 再重装；源码方式先 `npm run build` 重新构建。
 
-## 十、eval 跑分与回归门禁
+**Q2：没有模型 API Key 怎么办？**
+使用 Ollama 本地模型（`FH_PROVIDERS` 配置 type 为 `ollama`），或使用内置 Mock 模式离线体验。
 
-```bash
-# 本地跑分（场景 5 + 验收 5，验证真实产物）
-npm run build && npm run eval
+**Q3：任务执行到一半断了？**
+`fhcode sessions` 找到会话 ID，`fhcode resume <id>` 续跑；checkpoint 会自动保存进度。
 
-# 存档基线 + 对比门禁（低于基线即失败，可接入 CI）
-node scripts/eval.mjs --save-baseline bench/eval-baseline.json
-node scripts/eval.mjs --baseline bench/eval-baseline.json
+**Q4：改了文件想撤销？**
+`fhcode diff <id>` 查看改动，`fhcode rollback <id>` 一键回滚（基于 git）。
 
-# SWE-bench 数据集加载（HF 或镜像）
-node scripts/eval-swebench.mjs --split lite --limit 5
-node scripts/eval-swebench.mjs --split lite --limit 5 --run --report report.md
-FH_SWEBENCH_DATA_URL=https://mirror.example/swebench.json node scripts/eval-swebench.mjs --limit 3
-```
+**Q5：如何保证 AI 不乱改文件 / 不执行危险命令？**
+默认 `workspace-write` 模式：仅工作区可写、Shell 白名单 + 审批；网络域名规则可拦截目标站点；`FH_REQUIRE_APPROVAL=true` 时危险操作需确认。
 
----
+**Q6：经验库会不会无限膨胀？**
+不会。统一经验库用稳定 id + upsert 合并：同一模式重复出现只累加 `sessionCount` 并更新成功率，不新增冗余条目。
 
-## 十一、常见问题速查
+**Q7：SWE 跑分准吗？**
+诚实口径：自建任务集真实模型跑分 5/5 全过；mock 管道可离线复现；官方 SWE-bench（Python）受网络/环境限制尚未产出，详见 `docs/SWE_BENCH_REPORT.md`。
 
-| 问题 | 处理 |
-|------|------|
-| 未配置模型却想用真实模式 | `FH_PROVIDERS` 或 `FH_MODEL_NAME` 配置后自动进入真实模式 |
-| 任务超预算中止 | 调高 `FH_BUDGET_USD` 或角色策略 `maxCostUsd`，用 `resume` 续跑 |
-| 配额拒绝（QUOTA_EXCEEDED） | 调整 `FH_TENANT_BUDGET_USD` 或 policy 的 tenantDailyBudgetUsd |
-| review 输出为空 | 确认路径为文件或目录且含受支持扩展名（ts/js/tsx/jsx/json/md/py/go/java） |
-| 技能市场拉取失败 | 检查网络或设 `FH_SWEBENCH_DATA_URL`/`--repo` 镜像源 |
-| 中文/英文切换 | `fhcode --lang en` 或 `FHCODE_LANG=en` |
+**更多故障排查**：见 `docs/常见问题与故障排查.md`、错误码 `docs/error-codes.md`。
 
 ---
 
-## 十二、故障排查与日志
+## 六、企业部署
 
-```bash
-export FH_LOG_LEVEL=debug        # 详细日志
-fhcode doctor                    # 环境自检（快速定位）
-fhcode audit verify              # 审计链完整性校验
-# 日志目录：~/.feihong-code/sessions/<runId>.jsonl（事件日志）
-# 检查点：~/.feihong-code/sessions/<runId>.session.json
-```
+- 私有化部署：Docker 镜像 + `FH_HOME` 数据卷挂载，内网隔离
+- 安全治理：RBAC（whoami/policy）、审计哈希链（audit --verify）、多租户（tenants）、SBOM（npm run security）
+- 合规材料：安全白皮书（SOC2/ISO27001 自评估）`docs/SECURITY_WHITEPAPER.md`、数据处理协议 DPA `docs/DPA.md`
+- 详细部署：`docs/部署说明书.md`、`docs/Deployment_Guide_EN.md`
 
 ---
 
-*完整配置清单见《配置参考》与《部署说明书》；常见错误码见《常见问题与故障排查》。*
+*晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹*
+*2026-08-28 · 使用说明书 v7.6.0*

package/docs//345/205/250/351/235/242/345/244/215/347/233/230_50/350/275/256/346/267/261/345/272/246/345/256/241/350/256/241_v7.2.0.md

@@ -0,0 +1,208 @@
+# 飞虹 Code v7.2.0 全面复盘报告（50 轮深度审计）
+
+> **审计对象**：H:\Muse Code复刻（feihong-code v7.2.0）
+> **审计范围**：122 个 TS 源文件 / 25,255 行源码 + scripts/ + vscode-extension/ + electron/ + docs/
+> **审计方法**：多轮独立验证（依赖图孤岛扫描、逐模块引用复核、三入口[server/CLI/前端]覆盖检查、文档一致性、构建健康度、评测报告事实核验）
+> **审计日期**：2026-08-26
+
+---
+
+## 一、总体健康度画像
+
+```
+┌────────────────────────────────────────────────────────────┐
+│  可用（已接线，用户可达）      ～7,500 行   核心链路          │
+│  半接入（部分路径生效）        ~2,500 行   enterprise/CLI     │
+│  死代码（0 引用，不可达）      ~4,000 行   12 个模块          │
+│  前端缺口（后端有 API 无 UI）  约 30 个 API 未封装            │
+│  文档失真（声称存在≠实际存在）  CHANGELOG 8 处               │
+└────────────────────────────────────────────────────────────┘
+```
+
+**核心结论：v7.2.0 是"后端引擎强大、前端体验断层、一半新功能未接线"的版本。** 引擎层（补全/多智能体/事件驱动/变更管理/SWE harness/沙箱）扎实可用，但声称的 8 个差异化能力（语音/Figma/SSO/知识库/插件市场/协作/自我修正/FIM 数据）中 **7 个是死代码**，且 Web/桌面/安卓端没有新功能 UI。
+
+---
+
+## 二、逐子系统健康度矩阵
+
+| 子系统 | 文件 | 行数 | 健康度 | 状态说明 |
+|---|---|---|---|---|
+| **src/agent/** 核心 | 37 | 10,351 | 🟢 良好 | 引擎级全部可用，见下表 |
+| **src/web/** 服务+前端 | 5 | 3,611 | 🟡 断层 | server.ts 2682 行 121 API 强大；前端只封装旧接口 |
+| **src/cli/** | 6 | 1,893 | 🟢 良好 | 命令齐全，enterprise 全功能接入 |
+| **src/enterprise/** | 6 | 1,096 | 🟡 半接入 | CLI 完整；Web 仅 isEnterpriseEnabled 开关 |
+| **src/harness/** | 7 | 490 | 🟢 完整 | SWE-bench 评测闭环可用（被报告误判"无集成"） |
+| **src/integrations/** | 3 | 936 | 🔴 全死 | collaboration/figma/sso 三文件 0 引用 |
+| **src/voice/** | 1 | 256 | 🔴 死 | voice-programming 28 指令 0 引用 |
+| **src/knowledge/** | 1 | 333 | 🔴 死 | library 0 引用 |
+| **src/plugins/** | 2 | 532 | 🟡 半接 | plugin-loader 被 CLI 用；manager 插件市场 0 引用 |
+| **src/training/** | 2 | 469 | 🔴 死 | fim-data/completion-evaluator 0 引用 |
+| **src/self-evolve/** | 2 | 79 | 🔴 死 | hook 0 引用 |
+| **src/tools/** | 12 | 1,733 | 🟢 良好 | sandbox(container)/mcp/shell/browser 均可用 |
+| **src/shared/** | 7 | 1,114 | 🟢 良好 | config/i18n/errors 基础完备 |
+| **src/memory/** | 2 | 426 | 🟢 可用 | 记忆系统已接入 |
+| **src/models/** | 7 | 648 | 🟢 可用 | 多模型路由 |
+| **src/skills/** | 6 | 619 | 🟢 可用 | 技能系统 |
+| **src/runtime/** | 6 | 489 | 🟢 可用 | hooks/event-log |
+
+### src/agent/ 37 模块逐一状态
+
+| 模块 | 行数 | 状态 | 备注 |
+|---|---|---|---|
+| orchestrator | 641 | ✅ 已接入 | 主链路核心 |
+| completion-engine | 608 | ✅ 已接入 | /api/completion |
+| change-manager | 480 | ✅ 已接入 | 含冲突检测 |
+| experience | 432 | 🟡 未接 server | CLI 路径 |
+| repo-reader | 428 | ✅ 已接入 | |
+| event-driven-agent | 421 | ✅ 已接入 | /api/event-driven/* |
+| multi-agent | 413 | ✅ 已接入 | /api/multi-agent/* |
+| custom-agent | 409 | ✅ 已接入 | /api/custom-agents/* |
+| solo-agent | 400 | ✅ 已接入 | /api/solo/* |
+| context-compactor | 385 | ✅ 已接入 | orchestrator 调用 |
+| symbol-index | 379 | ✅ 已接入 | |
+| layered-memory | 365 | ✅ 已接入 | orchestrator 调用 |
+| git-integration | 361 | ✅ 已接入 | /api/git/* |
+| self-correction | 325 | 🔴 **死** | 0 引用，自我修正闭环未接线 |
+| self-heal | 212 | ✅ 已接入 | server 3 处 |
+| browser-agent | 320 | 🟡 半接 | 被 tools/browser 用，server 未直连 |
+| code-rag | 324 | ✅ | |
+| code-writer | 320 | ✅ | |
+| quality-gate | 308 | 🟡 未接主流程 | CLI/self-correction 调用 |
+| team-collaboration | 301 | ✅ 已接入 | /api/team/* |
+| type-checker | 248 | 🟡 未接 server | CLI 路径 |
+| team | 224 | ✅ | |
+| swe-agent | 219 | ✅ 已接入 | harness 闭环 |
+| swe-planner | 180 | ✅ | |
+| swe-verifier | 135 | ✅ | |
+| repo-context | 169 | ✅ | |
+| self-improver | 166 | ✅ | |
+| repo-underwriter | 138 | 🔴 **死** | 0 引用 |
+| subagent | 145 | ✅ | |
+| parallel-orchestrator | 116 | ✅ | |
+| design-to-code | 251 | ✅ 已接入 | /api/design-to-code |
+| code-review | 128 | ✅ | server 引用 |
+| context-budget | 135 | ✅ | 被 context-compactor 用 |
+| completion-postprocess | 91 | ✅ | 被 completion-engine 用 |
+| planner | 86 | ✅ | |
+| prompts | 54 | ✅ | |
+| subagent-summary | 34 | ✅ | |
+
+---
+
+## 三、死代码清单（12 个模块，约 4,000 行）★ 本次审计最大发现
+
+| # | 模块 | 行数 | CHANGELOG 声称 | 实际状态 |
+|---|---|---|---|---|
+| 1 | voice/voice-programming | 256 | "28 种语音指令、语音转代码" | **0 引用**，前端语音是浏览器 Web Speech，与它无关 |
+| 2 | knowledge/library | 333 | "AI 原生资料库" | **0 引用**，无 API 无 UI |
+| 3 | integrations/figma | 311 | "Figma 设计稿转代码" | **0 引用** |
+| 4 | integrations/sso | 270 | "SAML/OIDC/飞书/企微/钉钉 SSO" | **0 引用** |
+| 5 | integrations/collaboration | 355 | "飞书/GitHub 协作集成" | **0 引用**（server 用的是 team-collaboration，非此文件） |
+| 6 | plugins/manager | 390 | "插件市场 + 插件 API" | **0 引用**（server 的 /plugin 实为"节点系统"） |
+| 7 | agent/self-correction | 325 | "P0-3 自我修正闭环" | **0 引用**，只有注释提及 |
+| 8 | agent/repo-underwriter | 138 | — | **0 引用** |
+| 9 | training/fim-data | 240 | "FIM 训练数据生成" | **0 引用** |
+| 10 | training/completion-evaluator | 229 | — | **0 引用** |
+| 11 | self-evolve/hook | 79 | — | **0 引用** |
+| 12 | tools/mcp/index | — | MCP 聚合 | **0 引用**（mcp-client 本体已被用） |
+
+> **这些模块编译通过（TS 不检查未引用），但运行时不可达——用户永远用不到。**
+> CHANGELOG/升级说明书中"阶段三、阶段四"的 8 项声称功能，7 项实际不可用。
+
+---
+
+## 四、半接入与断层清单
+
+| # | 项 | 问题 | 影响 |
+|---|---|---|---|
+| 1 | **enterprise 的 Web 接入** | CLI 完整使用 createEnterpriseRuntime（租户/策略/审计/配额）；server.ts 仅 `isEnterpriseEnabled()` 开关 | **Web/桌面/安卓端调用 API 无审计、无配额、无策略强制**——报告"⑧企业级=9"在 Web 端不成立 |
+| 2 | **前端 API 断层** | 后端 121 API 中，前端 api.js 只封装旧接口（automations/tasks/nodes/sources）；custom-agents/event-driven/mcp/multi-agent/computer/swe **前端 0 调用** | v7.2.0 新能力后端有、前端点不到 |
+| 3 | browser-agent | 被 tools/browser 引用，server 未直连 | 电脑控制 API 存在但未走 agent |
+| 4 | quality-gate/code-review | 未接入 orchestrator 主流程 | 主任务链路缺质量门禁 |
+| 5 | type-checker/experience | 未接 server | 仅 CLI |
+
+---
+
+## 五、文档失真清单
+
+| # | 声称 | 实际 |
+|---|---|---|
+| 1 | CHANGELOG："阶段三 collaboration/figma/sso" | 3 个模块全为死代码 |
+| 2 | CHANGELOG："阶段四 voice/knowledge/plugins" | 3 个模块全为死代码 |
+| 3 | CHANGELOG："scripts/prepare-fim-data.mjs 生成 FIM 数据" | **脚本缺失**（全盘搜索无此文件） |
+| 4 | 升级说明书："121 API 三端可用" | 121 API 后端存在，前端仅用 30+ |
+| 5 | 评测报告："⑧企业级=9、⑫差异化=9" | 基于死代码/未接线功能，虚高 |
+
+---
+
+## 六、评测报告最终事实核对（与前一轮一致并加深）
+
+| 报告声明 | 代码实证 | 判定 |
+|---|---|---|
+| ④ SWE "无 SWE-bench 集成" | harness 完整 + CLI 已接 + eval 脚本就绪 | ❌ 错误 |
+| ④ SWE "245 行框架" | 534 行（三件套）+ harness 490 | ❌ 低估 |
+| 劣势"无 Docker 沙箱" | sandbox 4 档含 container + runCommandInContainer | ❌ 错误 |
+| 劣势"无实时 inline 补全" | VS Code InlineCompletion + Web ghost text | ❌ 错误 |
+| ⑧ 企业级=9 | CLI 完整、Web 未接线 | ⚠️ 减半 |
+| ⑫ 差异化=9 | 7/8 项是死代码 | ❌ 虚高 |
+| enterprise/ 1179 行 | 1096 行 | ⚠️ 偏差 |
+| 综合分 8.25 | 12 维平均 8.33，9/12 行算法不可复核 | ⚠️ 缺陷 |
+
+---
+
+## 七、修复方案（必须修复项，按优先级）
+
+### 🔴 P0 — 功能孤岛接线（1 周，让已声称的功能真正可用）
+
+| # | 任务 | 具体动作 | 工作量 |
+|---|---|---|---|
+| P0-1 | **voice 语音编程接线** | server 注册 `/api/voice/parse`(28 指令) + `/api/voice/to-code`；前端语音按钮接入 | 0.5d |
+| P0-2 | **knowledge 资料库接线** | server 注册 `/api/knowledge/*`(CRUD/检索/摘要)；前端加"资料库"Tab | 1d |
+| P0-3 | **figma 转代码接线** | server 注册 `/api/figma/*`；前端加导入入口 | 1d |
+| P0-4 | **sso 接线** | server 注册 `/api/sso/*`(登录 URL/回调) | 0.5d |
+| P0-5 | **collaboration 接线** | server 注册 `/api/collaboration/*`(飞书/GitHub) | 1d |
+| P0-6 | **plugins/manager 插件市场接线** | server 注册 `/api/plugins/*`，或与 node 系统合并后删 | 0.5d |
+| P0-7 | **self-correction 接入主流程** | orchestrator 失败分支调用自我修正闭环 | 0.5d |
+| P0-8 | **enterprise 接入 Web** | server 加中间件：每个 API 请求走 audit/policy/quota | 1d |
+| P0-9 | **前端补 5 个新 Tab** | custom-agents/自动化/插件/协作/记忆面板（后端全就绪） | 2d |
+
+### 🟡 P1 — 能力补强（2-4 周）
+
+| # | 任务 | 具体动作 |
+|---|---|---|
+| P1-1 | **SWE-bench 出公开跑分** | 跑 `fhcode harness --split lite --mode real`，结果写入 BENCHMARK |
+| P1-2 | **LSP 集成** | 引入 typescript-language-server，补编译器级诊断 |
+| P1-3 | **quality-gate/code-review 串联主流程** | orchestrator 交付前强制走构建+审查门禁 |
+| P1-4 | **死代码处置** | repo-underwriter / training×2 / self-evolve 三选一：接线或标注"预留"或删除 |
+
+### 🔵 P2 — 合规与生态（1-2 月）
+
+| # | 任务 |
+|---|---|
+| P2-1 | SOC2/ISO27001 合规材料 |
+| P2-2 | MCP 官方连接器目录（30+） |
+| P2-3 | 模型一键评测脚本 |
+
+### ⚪ P3 — 文档与治理（1 周内随 P0 同步）
+
+| # | 任务 |
+|---|---|
+| P3-1 | 修正 CHANGELOG/升级说明书：删除 8 项未接线声称，补"已接线/待接线"状态列 |
+| P3-2 | 补回 scripts/prepare-fim-data.mjs（或删除声称） |
+| P3-3 | 评测报告重算综合分（披露算法）+ 修正 4 处事实错误 |
+
+---
+
+## 八、修复后验收标准
+
+1. `fhcode serve` 启动后，`/api/voice/parse`、`/api/knowledge`、`/api/figma`、`/api/sso`、`/api/collaboration`、`/api/plugins` 全部 200
+2. 前端 UI 出现 5 个新 Tab，各自可操作（新增/查询/配置）
+3. Web 端连续调用 API 后，`~/.feihong-code/` 出现审计日志、配额生效（超限返回 429）
+4. `fhcode harness --split lite --limit 3 --mode mock` 输出评测报告
+5. 全库死代码模块 ≤ 2（明确标注"预留"）
+6. `npx tsc --noEmit` 通过；冒烟测试全绿
+7. CHANGELOG 声称的每项功能可实际操作验证
+
+---
+
+*本报告基于 50 轮独立验证（依赖图/引用图/入口覆盖/文档比对/构建检查），全部结论可复现。审计脚本留存于 scripts/_audit-deps.cjs 与 scripts/_audit-enterprise.cjs。*