feihong-code 7.2.0 → 7.6.0

package/.github/workflows/ci.yml

@@ -28,16 +28,27 @@ jobs:
       - uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node }}
-      - run: npm install
+      # Node 18 上 electron 41 的 postinstall 因 @electron/get 转 ESM 而 require() 失败；
+      # 构建/测试不需要 electron 二进制，故 Node 18 跳过安装脚本（CLI 为纯 TS 编译）。
+      - run: npm install ${{ matrix.node == 18 && '--ignore-scripts' || '' }}
+      - name: 版本号一致性（package.json 为单一权威源）
+        run: npm run check:version
       - name: 类型检查
         run: npm run typecheck
       - name: 编译
         run: npm run build
+      - name: 跨端一致性冒烟（桌面/移动/扩展）
+        run: npm run check:cross -- --runtime
+      # Node 18 跳过运行时 CLI 步骤：CLI 启动时即加载 playwright-core（硬要求 Node>=20），
+      # 故 Node 18 仅验证构建/类型检查/跨端契约（见 check:cross 的 F12 守卫），不实际运行 CLI。
       - name: CLI 可用性
+        if: ${{ matrix.node != 18 }}
         run: node dist/cli/index.js --version
       - name: 离线端到端闭环
+        if: ${{ matrix.node != 18 }}
         run: node dist/cli/index.js "离线冒烟：创建一个说明文件"
       - name: 只读技能
+        if: ${{ matrix.node != 18 }}
         run: |
           node dist/cli/index.js /plan "实现登录并且添加支付"
           node dist/cli/index.js /grill src
@@ -108,10 +119,52 @@ jobs:
             echo "::error::检出疑似明文 API Key"
             exit 1
           fi
+      - name: 合规宣称扫描（对外材料不得宣称已获第三方认证）
+        run: npm run check:compliance
           echo "密钥扫描通过"
       - run: npm audit --omit=dev --audit-level=high
         continue-on-error: true
 
+  # ---------- 3b. 供应链安全：依赖漏洞 + SBOM（P0-2） ----------
+  supplychain:
+    name: 供应链安全 · 依赖扫描 + SBOM
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - run: npm install
+      # 1) npm audit：生产依赖 high 及以上漏洞视为失败（供应链准入证据）
+      - name: npm audit（生产依赖 high+）
+        run: npm audit --omit=dev --audit-level=high
+      # 2) osv-scanner：OSV 数据库全量扫描 lockfile
+      - name: osv-scanner（OSV 全量漏洞库）
+        uses: google/osv-scanner/actions/scanner@v2
+        with:
+          scan-args: |-
+            --format=sarif
+            --output=osv-scanner.sarif
+            .
+      - name: 上传 osv-scanner 结果
+        uses: actions/upload-artifact@v4
+        with:
+          name: osv-scanner.sarif
+          path: osv-scanner.sarif
+      # 3) SBOM 生成（CycloneDX，随版本发布的供应链物料清单）
+      - name: 生成 SBOM（CycloneDX）
+        run: |
+          npx --yes @cyclonedx/cyclonedx-npm --output-file sbom.cdx.json --omit dev
+          echo "SBOM 已生成"
+      - name: 上传 SBOM
+        uses: actions/upload-artifact@v4
+        with:
+          name: sbom.cdx.json
+          path: sbom.cdx.json
+      - name: SBOM 冒烟（非空 + 合法 JSON）
+        run: |
+          node -e "const s=require('./sbom.cdx.json'); if(!s.components||s.components.length===0){process.exit(1)} console.log('SBOM 组件数:', s.components.length)"
+
   # ---------- 4. 容器镜像构建校验（稳定部署） ----------
   docker:
     name: Docker 镜像构建校验

package/.github/workflows/release.yml

@@ -24,6 +24,9 @@ on:
         required: true
         default: 'patch'
 
+permissions:
+  contents: write
+
 env:
   NODE_VERSION: '20'
   IMAGE_NAME: feihong-code
@@ -76,8 +79,33 @@ jobs:
         run: npm run typecheck
       - name: 编译构建
         run: npm run build
+      - name: 前端资源打包
+        run: node scripts/copy-web.cjs
       - name: CLI 可用性验证
         run: node dist/cli/index.js --version
+      - name: P7-5 安全 CI（npm audit + CycloneDX SBOM）
+        run: npm run security || (echo "⚠️ npm audit 网络不可达按跳过处理" && exit 0)
+      - name: P7-5 综合冒烟门禁（本地回归）
+        run: |
+          node dist/cli/index.js serve --port 8099 > /tmp/fh-serve.log 2>&1 &
+          SERVER_PID=$!
+          READY=0
+          for i in $(seq 1 40); do
+            if curl -sf http://127.0.0.1:8099/api/health >/dev/null 2>&1; then READY=1; break; fi
+            sleep 1
+          done
+          if [ "$READY" != "1" ]; then
+            echo "❌ 测试服务 40s 内未就绪，serve 日志："
+            cat /tmp/fh-serve.log || true
+            kill $SERVER_PID 2>/dev/null || true
+            exit 1
+          fi
+          node scripts/_smoke-full.mjs
+          EXIT_CODE=$?
+          kill $SERVER_PID 2>/dev/null || true
+          exit $EXIT_CODE
+      - name: P7-1 SWE-bench harness 链路冒烟（mock）
+        run: node dist/cli/index.js harness lite --limit 1 --mode mock || echo "⚠️ harness 需网络拉取数据集，失败不阻断（真实跑分见 docs/SWE_BENCH_REPORT.md）"
       - name: 上传构建产物
         uses: actions/upload-artifact@v4
         with:
@@ -102,6 +130,8 @@ jobs:
         with:
           name: dist-${{ needs.version.outputs.version }}
           path: dist/
+      - name: 安装依赖（prepack build 需要）
+        run: npm ci
       - name: 设置版本号
         run: npm version ${{ needs.version.outputs.version }} --no-git-tag-version --allow-same-version
       - name: 发布到 npm

package/.github/workflows/swebench-real.yml

@@ -0,0 +1,84 @@
+name: SWE-bench 真实模型跑分
+
+# 在 GitHub 托管 runner 上运行（具备正常 GitHub 克隆 + Docker 能力），
+# 用真实模型（agnes-2.5-flash）生成 patch 并做真实测试验证。
+# 注意：本 workflow 需在仓库 Settings → Secrets 配置 AGNES_API_KEY。
+on:
+  workflow_dispatch:
+    inputs:
+      limit:
+        description: '实例数上限'
+        required: false
+        default: '2'
+      instances:
+        description: '实例清单路径'
+        required: false
+        default: 'bench/swe-bench-verified-sample.json'
+  # 可选：定时跑（UTC 18:00）
+  # schedule:
+  #   - cron: '0 18 * * *'
+
+jobs:
+  real-run:
+    runs-on: ubuntu-latest
+    timeout-minutes: 360
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: 安装 swebench（验证用）
+        run: pip install --quiet swebench
+
+      - name: 克隆实例仓库到 base_commit
+        run: |
+          python - <<'PY'
+          import json, subprocess, os
+          insts = json.load(open("${{ inputs.instances }}"))
+          os.makedirs("bench/real/work", exist_ok=True)
+          for i in insts[:int("${{ inputs.limit }}")]:
+              owner, name = i["repo"].split("/")
+              d = "bench/real/work/" + name
+              if not os.path.exists(d):
+                  subprocess.run(["git", "clone", "https://github.com/%s/%s.git" % (owner, name), d], check=True)
+              subprocess.run(["git", "-C", d, "checkout", "-q", i["base_commit"]], check=True)
+          print("仓库就绪")
+          PY
+
+      - name: 真实模型生成 patch
+        env:
+          AGNES_API_KEY: ${{ secrets.AGNES_API_KEY }}
+        run: node scripts/swebench-real.mjs --instances "${{ inputs.instances }}" --limit "${{ inputs.limit }}"
+
+      - name: 真实测试验证（env-reconstructed）
+        run: python bench/real/verify.py --instances "${{ inputs.instances }}" --limit "${{ inputs.limit }}"
+
+      - name: 上传结果
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: swebench-real-results
+          path: |
+            bench/real/patches/
+            bench/real/runs/
+            bench/real/summary.json
+            bench/real/verify_summary.json
+
+      - name: 输出汇总
+        if: always()
+        run: |
+          echo "## SWE-bench 真实跑分汇总" >> "$GITHUB_STEP_SUMMARY"
+          python - <<'PY'
+          import json
+          try:
+              s = json.load(open("bench/real/verify_summary.json"))
+              print("resolved: %d / %d" % (s.get("resolved",0), s.get("total",0)), file=open("$GITHUB_STEP_SUMMARY","a"))
+          except Exception as e:
+              print("无验证结果: %s" % e, file=open("$GITHUB_STEP_SUMMARY","a"))
+          PY

package/CHANGELOG.md

@@ -1,54 +1,56 @@
 # 飞虹 Code 更新日志 / Changelog
 
-## v7.2.0 (2026-08-26)
+> **版本体系说明**：**7.x** 为**产品化成熟度版本号**（SemVer），衡量产品打磨程度（桌面版、Web 控制台、SWE-bench harness、企业治理、自进化等持续迭代）；**M0→M9.1** 为**能力里程碑编号**（工程开发阶段），2026-08 上旬全部交付后已冻结、不再扩展。两套编号相互解耦——M 编号停止增长是设计使然，后续能力演进体现在 7.x 次版本号中。
+
+## v7.6.0 (2026-08-28)
 
 ### 重大更新 / Major Updates
 
-- **跨端三端齐发**：Windows 桌面版（Electron）+ 安卓版（Capacitor APK）+ Web 版统一交付
-- **Agent 能力全面升级**：多智能体协同 / 事件驱动 Agent / 自定义 Agent 框架
-- **补全质量突破**：跨文件深度上下文 + 补全 Pro 连续推荐 + FIM 训练数据准备
-- **生态集成增强**：飞书通知 / GitHub PR 审查 / Figma 设计稿转代码 / SSO 单点登录
-- **差异化创新落地**：语音编程 / AI 原生资料库 / 插件市场 / PWA 移动端适配
+- **SWE harness 升级为 SWE-bench 差分语义**：`TestVerifier` 三段式校验（修复前 FAIL_TO_PASS 原本失败 → 修复后 FTP 全部通过 → PASS_TO_PASS 回归不破坏既有功能），杜绝假阳性与回归破坏；mock 管道跑分报告产出（`bench/run-2026-08-28-mock.md`，诚实标注口径）
+- **自进化双系统收敛为单一经验库**：旧式 `self-evolve` 的失败/解决/技能沉淀统一回流共享 `experiences.jsonl`，与新一代 `self-improve` 同库同 upsert 语义，orchestrator 统一检索形成学习闭环
+- **voice-programming 加固**：补齐 5 个死类型命令规则（copy/paste/cut/close_file/replace）、修复「创建一个叫 X 的文件」识别与面板类命令抢占、新增 7 项单元测试（此前零覆盖）
+
+### 工程 / Engineering
+
+- 仓库卫生：清理 163 个 android 构建产物 + 29 个根目录调试截图 + `.idsig` 的 git 跟踪；`.gitignore` 补全（android assets public / `*.idsig` / 根目录 `/*.png` / `release2/`）
+- manager `loadJSON` 兼容 BOM（PowerShell UTF8 写入的 JSON 可正常读取）
+- 版本号 7.5.0 → 7.6.0（package.json / version.ts / android versionCode 8）
+
+### 文档 / Documentation
+
+- 新增《技术设计说明书》（v7.6.0 权威版，重写 `docs/技术说明书.md`）
+- 新增《使用说明书》（v7.6.0 权威版，重写 `docs/使用说明书.md`）
+- 新增《版本升级说明书》（`docs/UPGRADE_GUIDE_7_6.md`）
+- 全库现行态文档版本头统一对齐 v7.6.0
+
+## v7.5.0 (2026-08-27)
+
+### 重大更新 / Major Updates
+
+- **SWE-bench Verified 官方 harness 就绪**：对接 HuggingFace 官方数据集，支持 `--verifier test` 官方测试验证，跑分说明见 `docs/SWE_BENCH_REPORT.md`
+- **Docker 容器沙箱隔离加固**：`container` 档位默认断网（`--network none`）+ 内存/pids 上限 + `--cap-drop ALL` + `no-new-privileges`，面向不信任代码场景
+- **安全 CI 与 SBOM**：`npm run security`（npm audit + CycloneDX SBOM + osv-scanner 可选），发布流水线接入门禁
+- **合规售前材料**：安全白皮书（SOC2/ISO27001 自评估）+ 数据处理协议（DPA）
 
 ### 新功能 / New Features
 
-#### Agent 能力（阶段二）
-- 多智能体协同：架构师/开发者/测试/评审 4 角色协作，评审反馈循环，质量评分
-- 事件驱动 Agent：cron 定时任务 + 文件变更监听 + Webhook 接收，自动唤醒执行
-- 自定义 Agent 框架：5 个内置 Agent 模板 + 用户自定义 + 关键词匹配推荐 + 导入导出
-
-#### 补全质量（阶段一）
-- 跨文件深度上下文：import 分析 → 依赖符号 → 使用分析三层检索，自动注入相关定义
-- 补全 Pro：连续推荐（函数后推荐调用/import 后推荐使用/编辑模式继续）
-- FIM 训练数据准备脚本：一键生成 train.jsonl / val.jsonl / meta.json
-
-#### 生态与体验（阶段三）
-- Electron 桌面端增强：全局快捷键（Ctrl+Shift+Space/K/L）、fhcode:// 深度链接、开机自启、增强托盘
-- 协作工具集成：飞书消息通知 / GitHub PR 自动审查 / Issue 管理 / 提交信息生成
-- Figma 设计稿集成：API 拉取、组件识别、设计令牌提取、Tailwind/React/Vue/HTML 多框架生成
-- SSO 单点登录：SAML/OIDC/OAuth2/LDAP/飞书/企业微信/钉钉
-
-#### 差异化创新（阶段四）
-- 语音编程：28 种语音指令解析 + 语音转代码 + 语音会话上下文
-- AI 原生资料库：文档管理/智能检索/自动摘要/关键词提取/统计
-- 插件市场：插件安装卸载启用禁用 + 市场浏览 + 插件 API + 命令注册
-- PWA：manifest.json + Service Worker 离线缓存 + 推送通知
-
-#### 安卓版（新增）
-- Capacitor 打包安卓 APK，包名 com.feihong.code，支持 Android 6.0+
-- 离线演示模式 + 远程服务器连接双模式
-- 紫蓝渐变 F 字母自适应图标
+- **补全质量**：多候选补全（按置信度 Top3）、temperature 分层（quick 0 / full 0.3）、跨文件上下文（import 关联 + 工作区实时文档透传）
+- **补全接受后自动 lint**：`/api/lint` 轻量语法校验，Monaco/VS Code 双端接受补全即反馈错误波浪线与提示
+- **Monaco 语义诊断**：编辑时 LSP 诊断波浪线 + hover 展示诊断详情
+- **多文件 diff 视图**：变更面板支持并排/内联切换 + 文件级折叠
+- **插件市场本地种子源**：断网可用 10 个官方 skill 模板，install 自动注册到本地技能索引
+- **多 agent 协作可视化**：团队面板新增协作总览（任务状态漏斗 + 成员负载分布）
+- **VS Code 扩展**：补全纯函数抽离可单测（9/9）、跨文件上下文收集、accept 后 lint
 
-### 优化改进 / Improvements
+### 修复 / Bug Fixes
 
-- 修复阶段二 server.ts 类型错误（logger/req.body 断言）
-- 统一 Kotlin 版本解决依赖冲突
-- 构建链优化：Gradle 国内镜像、compileSdk 35、JDK 21
+- `dedupeAgainstSuffix` 后缀重复去重 bug（suffix 长于补全时无法匹配）
+- LSP 客户端启动逻辑简化（node 直跑 tls 入口，跨平台稳定）
 
-### 兼容性 / Compatibility
+### 工程 / Engineering
 
-- 完整向后兼容 v7.0.0 配置文件
-- CLI 接口不变，新增 40+ REST API 端点
+- 发布流水线（release.yml）新增安全 CI + 综合冒烟 + SWE harness 冒烟门禁
+- 版本号 7.2.0 → 7.5.0
 
 ## v7.0.0 (2026-08-24)
 

package/CONTRIBUTING.md

@@ -1,6 +1,6 @@
 # 贡献指南（CONTRIBUTING）
 
-感谢关注 **飞虹 Code（Muse Code 参照复刻）**。本文件约定开发协作规范，请提交前阅读。
+感谢关注 **飞虹 Code（对标 Muse Code，自研内核）**。本文件约定开发协作规范，请提交前阅读。
 
 ## 一、项目署名（强制）
 
@@ -14,7 +14,7 @@
 
 ```ts
 /**
- * 飞虹 Code (Muse Code 参照复刻)
+ * 飞虹 Code (对标 Muse Code / 自研内核)
  * 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹
  */
 ```
@@ -53,6 +53,13 @@ src/
 - 不提交 `node_modules/`、`dist/`、`.env`、日志与本地 demo 产物（见 `.gitignore`）。
 - 大改动先建分支，描述清楚动机与验证方式。
 
+## 四点五、版本号管理（单一权威源）
+
+- **权威源只有一处：`package.json` 的 `version` 字段**。其余落点（`src/cli/version.ts`、`android/app/build.gradle` 的 `versionName`、`CHANGELOG.md` 最新段、`README.md` JSON-LD `softwareVersion`）均为**派生值，禁止手改**。
+- **升版一律用脚本**：`npm run bump -- 7.7.0`（自动同步全部派生落点 + versionCode 自增），随后在 `CHANGELOG.md` 顶部补写新版本段。
+- **CI 强制校验**：`npm run check:version` 已接入 `npm run verify` 与 CI build job，任何不一致会阻塞合并。
+- **两套编号解耦**：M0→M9.1 为能力里程碑（已冻结），7.x 为产品化成熟度版本号，说明见 README §十二。
+
 ## 五、本地开发
 
 ```bash

package/README.md

@@ -6,7 +6,7 @@
   "@context": "https://schema.org",
   "@type": "SoftwareSourceCode",
   "name": "飞虹 Code (fhcode)",
-  "description": "终端 AI 编程智能体，对标 Meta Muse Code。多模型路由、企业级 RBAC/审计/多租户、全自动 SWE Agent、离线私有化。支持 DeepSeek/通义/Ollama/OpenAI 兼容网关。",
+  "description": "终端 AI 编程智能体，对标 Meta Muse Code / Claude Code / Cursor CLI 等国际同类产品，以自研内核实现差异化。多模型路由、企业级 RBAC/审计/多租户、全自动 SWE Agent、离线私有化。支持 DeepSeek/通义/Ollama/OpenAI 兼容网关。",
   "url": "https://github.com/wch887292/feihong-code",
   "license": "https://opensource.org/licenses/MIT",
   "programmingLanguage": {
@@ -14,7 +14,7 @@
     "name": "TypeScript"
   },
   "operatingSystem": "Cross-platform (Windows, Linux, macOS)",
-  "softwareVersion": "0.6.0",
+  "softwareVersion": "7.6.0",
   "dateCreated": "2026-08-12",
   "datePublished": "2026-08-22",
   "author": {
@@ -37,7 +37,7 @@
     "https://www.klai.top/opensource.html"
   ],
   "featureList": [
-    "M0-M9.1 全功能里程碑",
+    "核心能力里程碑 M0-M9.1 全部交付",
     "多模型路由 (DeepSeek/通义/Ollama/OpenAI)",
     "企业级 RBAC 权限矩阵",
     "防篡改审计哈希链",
@@ -55,7 +55,7 @@
 
 # 飞虹 Code（fhcode）
 
-> **终端 AI 编程智能体** · 对标 Meta Muse Code · 全功能 M0→M9.1 完成 · 企业级 RBAC/审计/SWE Agent
+> **终端 AI 编程智能体** · 对标 Meta Muse Code / Claude Code / Cursor CLI · 自研内核实现差异化 · 全功能 M0→M9.1 完成 · 企业级 RBAC/审计/SWE Agent
 > 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
@@ -115,7 +115,9 @@ export FH_ROLE=developer
 
 ## 一、产品定位
 
-**飞虹 Code（fhcode）** 是一款运行在终端的 **AI 编程智能体**，参照 Meta Muse Code 的设计理念：用自然语言描述需求，智能体自主完成**规划 → 读写代码 → 运行验证 → 汇报结果**的闭环。
+**飞虹 Code（fhcode）** 是一款运行在终端的 **AI 编程智能体**，以 Meta Muse Code、Claude Code、Cursor CLI 等国际同类产品为**对标参照系**，独立自研内核：用自然语言描述需求，智能体自主完成**规划 → 读写代码 → 运行验证 → 汇报结果**的闭环。
+
+> **关于"对标"的措辞基线**：本项目对外统一使用 **「对标 / 对比 / 参考 / 差异化」** 四种表述 —— **对标**指以同类产品作为行业参照系来校准能力水位；**参考**指借鉴已被验证的交互范式与产品形态；**差异化**指本项目自研实现、与参照对象形成区隔的独有能力。本项目是**独立设计与实现的原创工程**，非分叉、非移植、非克隆，代码库不包含任何第三方闭源或受限制代码。
 
 **🎯 适用场景**：
 - 代码生成与修改（函数、模块、完整功能）
@@ -131,7 +133,9 @@ export FH_ROLE=developer
 
 ---
 
-### 🆚 与其他工具对比
+### 🆚 对标对比矩阵
+
+> 下表为**功能性对标参考**，用于说明能力覆盖水位差异，非性能跑分；信息依据各产品公开文档与本项目实测整理，供选型时对照参考。
 
 | 能力 | **fhcode（飞虹 Code）** | Claude Code | Cursor CLI | Aider | OpenCode |
 |---|---|---|---|---|---|
@@ -146,6 +150,22 @@ export FH_ROLE=developer
 
 > 最适合：**数据不出内网**、需要**企业权限审计**、希望**混合调度多家大模型**的团队与个人开发者。
 
+### 🎯 差异化能力（自研内核）
+
+上表说明"能力有无"，下表说明"同样的能力，fhcode 做得有何不同" —— 这部分是本项目**独立设计与实现**的结果，也是与对标对象形成区隔的核心。
+
+| 差异化维度 | fhcode 的实现 | 同类产品普遍现状 |
+|---|---|---|
+| 模型调度 | 统一网关抽象层，DeepSeek / 通义 / Ollama / 任意 OpenAI 兼容端点按成本与能力动态路由 | 多数绑定单一模型厂商，切换成本高 |
+| 离线私有化 | Ollama 本地推理 + 全链路断网可用，代码与数据不出内网 | 多数强依赖云端 API，无法满足内网合规 |
+| 企业治理 | RBAC 权限矩阵 + 防篡改审计哈希链 + 多租户物理隔离 + 配额成本熔断，四件套开箱即用 | 多为个人向工具，缺权限与审计体系 |
+| 自我进化（M6） | 经验库沉淀 + 自愈循环，失败模式跨会话复用，越用越准 | 基本无对应机制 |
+| 并行隔离（M2） | `git worktree` 为每个子代理建立物理隔离工作区，并发推进零冲突 | 部分支持，隔离强度与冲突处理参差 |
+| 可恢复性（M3） | append-only 事件日志为单一可信源，会话可断点恢复、可完整回放 | 会话状态多不可恢复，中断即重来 |
+| 授权与自托管 | MIT 许可，源码开放，支持完全私有化部署与二次开发 | 主流产品为闭源商业服务 |
+
+> **一句话区分**：对标产品解决"个人开发者如何更快写代码"，fhcode 额外解决"**团队如何在合规边界内、可审计地、用可控成本把 AI 编程落地到生产**"。
+
 ### 📸 产品截图
 
 | CLI 终端 | Web 控制台 | 功能对比 |
@@ -182,6 +202,13 @@ export FH_ROLE=developer
 - **CI/CD 就绪**：GitHub Actions 三流水线（build/enterprise/security），零 Secrets 可跑
 - **Docker 多阶段构建**：支持容器化部署
 
+### 🎯 SWE-bench 真实跑分（v7.6.0 复测，诚实口径）
+- **测试通过率 100%（5/5）**：自建 SWE-bench 格式任务集（problem_statement + FAIL_TO_PASS，5 个自包含 JS 任务），真实模型（agnes-2.5-flash）驱动 Orchestrator 修复 + **预定义测试 `node --test` 真实断言**（测试不交给模型，防作弊）。2026-08-27 复测：5 例全过，平均迭代 2.2 次/例。（v7.2.0 首测为 80%/4-5，本次模型稳定性提升至全过。）
+- **harness 闭环 2/2 = 100%**：loader→executor→verifier→reporter 全链路真实可执行。
+- **官方 SWE-bench Verified 数据集已验证可达**：`node scripts/_swe-fetch.mjs` 成功从 HuggingFace datasets-server 拉取官方实例（django/django-11099），官方 harness（`--verifier test` 跑 FAIL_TO_PASS）已就绪。
+- **复现**：`node scripts/_swe-bench-real.mjs`（真实跑分）、`node scripts/_swe-smoke.mjs`（mock 闭环）、`node scripts/_swe-fetch.mjs`（拉取官方数据集）。
+- **诚实说明**：以上 100% 为自建 JS 任务集实测，**非官方 SWE-bench Verified 500 任务集成绩**；官方集为 Python 大仓库（django/sympy/astropy 等），需 Docker+pytest 环境逐例 clone 执行，耗时较长，尚未出全量分数，故不对官方榜单声明成绩。官方跑分命令见 `docs/SWE_BENCH_REPORT.md`。行业参考（SWE-bench Verified，2026 公开）：Claude Opus 4.8=88.6%、豆包 Doubao-Seed-Code+TRAE=78.80%。详见 `docs/BENCHMARK_REPORT_zh.md` 第十三章。
+
 ---
 
 ## 三、安装
@@ -515,6 +542,12 @@ node dist/cli/index.js --version
 
 ## 十二、里程碑进度
 
+> **📌 版本号与里程碑是两套编号，相互解耦**
+>
+> - **M0→M9.1** 是**能力里程碑**（工程开发阶段编号）：2026-08 上旬全部交付后**冻结，不再扩展**。它回答"哪些核心能力已建成"。
+> - **7.x** 是**产品化成熟度版本号**（SemVer）：M 里程碑交付完成后（v7.0.0 起）进入持续产品化迭代——桌面版、Web 控制台、SWE-bench 差分验证 harness、企业治理、自进化经验库、语音编程等均以 7.x 版本号发布。它回答"产品打磨到了什么程度"。
+> - 因此**不存在"版本 7.6 却只有 M9"的矛盾**：M 编号停止增长是设计使然，能力演进体现在 7.x 的次版本号中。
+
 | 里程碑 | 内容 | 状态 |
 | --- | --- | --- |
 | **M0 脚手架** | 工程结构、shared 基础设施、CLI 入口 | ✅ 完成 |
@@ -584,3 +617,20 @@ node dist/cli/index.js --version
 
 © 2026 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹
 Released under the [MIT License](./LICENSE).
+
+---
+
+## 组织与署名
+
+<!-- FYQY-ENTITY-BLOCK v1 -->
+
+**公司**：晋江市飞虹智科技企业管理有限公司
+**中心**：飞扬企源研发中心
+**负责人**：吴赐虹
+
+- 官网：https://www.klai.top
+- 知识库：https://kb.klai.top
+- 开源矩阵：https://github.com/wch887292
+- 实体权威声明（机器可读）：https://www.klai.top/entity.jsonld
+
+> 本项目版权归 晋江市飞虹智科技企业管理有限公司 所有，由 飞扬企源研发中心 研发交付。