feihong-code 7.5.0 → 8.0.0

package/CHANGELOG.md

@@ -1,94 +1,117 @@
-# 飞虹 Code 更新日志 / Changelog
-
-## 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
-
-- **补全质量**：多候选补全（按置信度 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
-
-### 修复 / Bug Fixes
-
-- `dedupeAgainstSuffix` 后缀重复去重 bug（suffix 长于补全时无法匹配）
-- LSP 客户端启动逻辑简化（node 直跑 tls 入口，跨平台稳定）
-
-### 工程 / Engineering
-
-- 发布流水线（release.yml）新增安全 CI + 综合冒烟 + SWE harness 冒烟门禁
-- 版本号 7.2.0 → 7.5.0
-
-## v7.0.0 (2026-08-24)
-
-### 重大更新 / Major Updates
-
-- **对话流全面重构**：对标豆包体验，纯文本输出 + 实时思考过程展示
-- **Electron 桌面版正式发布**：独立桌面窗口，系统托盘，应用菜单，权限管理
-- **版本号跨越**：从 0.6.1 直接升级到 7.0.0，标志产品成熟
-
-### 新功能 / New Features
-
-- 截图功能：屏幕捕获 + 框选裁剪，截图直接到输入框
-- 电脑操作：后端 PowerShell API，支持截图、鼠标移动/点击、键盘输入
-- 语音/视频通话：麦克风实时识别 + 摄像头画面 + 视频截图
-- 工作区选择器：驱动器和文件夹分页，支持新建/重命名文件夹
-- 自动化快捷指令：常用快捷指令内置
-- 模板库插件系统：支持自定义来源，节点连接外部插件
-- 记忆系统：长期记忆自定义，添加记录简化为纯文本输入
-- 本地语音识别服务：faster-whisper 本地部署，完全免费离线
-
-### 优化改进 / Improvements
-
-- 界面宽度优化：主区域最大宽度 1400px，不再占满屏幕
-- 用户菜单重构：从底部上拉改为右侧侧边栏
-- 启动逻辑修复：不再打开两次网页
-- 文本选择复制：支持选中部分文字复制
-- 对话历史扩容：conversation 80→300 条，steps 200→500 条
-- 系统提示词升级：编码能力 8 条 + 修复 bug 能力 7 条
-- 自检维护优化：每天仅第一次任务可做环境确认，后续直接执行
-- 中英文国际化：完整的中英文词条
-
-### Bug 修复 / Bug Fixes
-
-- 修复 Electron 桌面版自动退出问题
-- 修复启动后打开两次网页的问题
-- 修复对话历史过长导致前面内容被截断的问题
-- 修复任务执行中思考过程不实时显示的问题
-- 修复桌面版复制粘贴快捷键失效的问题
-- 修复桌面版截图权限反复请求的问题
-- 修复构建错误连续 3 次后错误信息不准确的问题
-
-### 文档 / Documentation
-
-- 新增更新说明书（中英文版）
-- 新增技术说明书（中英文版）
-- 新增横向测评报告（中英文版，豆包 AI 辅助）
-
----
-
-## v0.6.1 (2026-08-24)
-
-- 修复对话流输出格式问题
-- 优化思考过程实时显示
-- 修复构建错误自愈逻辑
-
----
-
-## v0.6.0 (2026-08-24)
-
-- 初始版本发布
-- 多模型路由支持
-- 企业级 RBAC 审计
-- 全自动 SWE Agent
-- Web 控制台
+# 飞虹 Code 更新日志 / Changelog
+
+> **版本体系说明**：**7.x** 为**产品化成熟度版本号**（SemVer），衡量产品打磨程度（桌面版、Web 控制台、SWE-bench harness、企业治理、自进化等持续迭代）；**M0→M9.1** 为**能力里程碑编号**（工程开发阶段），2026-08 上旬全部交付后已冻结、不再扩展。两套编号相互解耦——M 编号停止增长是设计使然，后续能力演进体现在 7.x 次版本号中。
+
+## v7.6.0 (2026-08-28)
+
+### 重大更新 / Major Updates
+
+- **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
+
+- **补全质量**：多候选补全（按置信度 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
+
+### 修复 / Bug Fixes
+
+- `dedupeAgainstSuffix` 后缀重复去重 bug（suffix 长于补全时无法匹配）
+- LSP 客户端启动逻辑简化（node 直跑 tls 入口，跨平台稳定）
+
+### 工程 / Engineering
+
+- 发布流水线（release.yml）新增安全 CI + 综合冒烟 + SWE harness 冒烟门禁
+- 版本号 7.2.0 → 7.5.0
+
+## v7.0.0 (2026-08-24)
+
+### 重大更新 / Major Updates
+
+- **对话流全面重构**：对标豆包体验，纯文本输出 + 实时思考过程展示
+- **Electron 桌面版正式发布**：独立桌面窗口，系统托盘，应用菜单，权限管理
+- **版本号跨越**：从 0.6.1 直接升级到 7.0.0，标志产品成熟
+
+### 新功能 / New Features
+
+- 截图功能：屏幕捕获 + 框选裁剪，截图直接到输入框
+- 电脑操作：后端 PowerShell API，支持截图、鼠标移动/点击、键盘输入
+- 语音/视频通话：麦克风实时识别 + 摄像头画面 + 视频截图
+- 工作区选择器：驱动器和文件夹分页，支持新建/重命名文件夹
+- 自动化快捷指令：常用快捷指令内置
+- 模板库插件系统：支持自定义来源，节点连接外部插件
+- 记忆系统：长期记忆自定义，添加记录简化为纯文本输入
+- 本地语音识别服务：faster-whisper 本地部署，完全免费离线
+
+### 优化改进 / Improvements
+
+- 界面宽度优化：主区域最大宽度 1400px，不再占满屏幕
+- 用户菜单重构：从底部上拉改为右侧侧边栏
+- 启动逻辑修复：不再打开两次网页
+- 文本选择复制：支持选中部分文字复制
+- 对话历史扩容：conversation 80→300 条，steps 200→500 条
+- 系统提示词升级：编码能力 8 条 + 修复 bug 能力 7 条
+- 自检维护优化：每天仅第一次任务可做环境确认，后续直接执行
+- 中英文国际化：完整的中英文词条
+
+### Bug 修复 / Bug Fixes
+
+- 修复 Electron 桌面版自动退出问题
+- 修复启动后打开两次网页的问题
+- 修复对话历史过长导致前面内容被截断的问题
+- 修复任务执行中思考过程不实时显示的问题
+- 修复桌面版复制粘贴快捷键失效的问题
+- 修复桌面版截图权限反复请求的问题
+- 修复构建错误连续 3 次后错误信息不准确的问题
+
+### 文档 / Documentation
+
+- 新增更新说明书（中英文版）
+- 新增技术说明书（中英文版）
+- 新增横向测评报告（中英文版，豆包 AI 辅助）
+
+---
+
+## v0.6.1 (2026-08-24)
+
+- 修复对话流输出格式问题
+- 优化思考过程实时显示
+- 修复构建错误自愈逻辑
+
+---
+
+## v0.6.0 (2026-08-24)
+
+- 初始版本发布
+- 多模型路由支持
+- 企业级 RBAC 审计
+- 全自动 SWE Agent
+- Web 控制台

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 / 自研内核)
  * 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹
  */
 ```
@@ -24,14 +24,24 @@
 ```
 src/
   cli/        入口、参数解析、REPL、运行时装配
-  shared/     配置、错误、日志、共享类型（基础设施）
+  shared/     配置、错误、日志、共享类型、SQLite 统一存储（基础设施）
   agent/      Orchestrator / Planner / Prompts
-  tools/      工具实现（file / shell / search / verify）+ registry
+  tools/      工具实现（file / shell / search / verify / docker-sandbox）+ registry
   models/     模型路由 + providers（openai-compatible / ollama / mock）
   runtime/    事件日志、会话状态（单一可信源）
   skills/     高级技能（/plan /grill /goal）
+  memory/     持久记忆 + Honcho 语义记忆（v8.0）
+  web/        Express Web 控制台 + API 路由
 ```
 
+**v8.0 新增模块**：
+
+| 模块 | 路径 | 说明 |
+|------|------|------|
+| SQLite 统一存储 | `src/shared/sqlite-store.ts` | 10 张表，AES-256-GCM 加密，版本化迁移，基于 node:sqlite 零依赖 |
+| Docker 沙盒执行 | `src/tools/docker-sandbox.ts` | 容器隔离、禁网、只读挂载、资源限制、危险命令拦截、超时强杀 |
+| Honcho 语义记忆 | `src/memory/honcho-store.ts` | 用户建模、事实记忆、跨会话检索、记忆注入提示词 |
+
 铁律：
 
 1. **边界必须校验**：所有外部输入（CLI 参数、模型响应、工具入参）用 zod 校验。
@@ -53,7 +63,40 @@ 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 §十二。
+
+## 五、测试规范
+
+提交 PR 前必须通过以下测试：
+
+```bash
+# 1. 编译检查
+npm run build                    # tsc 编译到 dist/，零错误
+
+# 2. 冒烟测试（v8.0 三项新功能）
+node tests/smoke-v8.js          # 25 项：SQLite 11 + Docker 6 + Honcho 8
+
+# 3. 集成测试（API 全量）
+node tests/integration/api.test.js   # 34 项 API 用例
+
+# 4. 仅运行指定模块（调试用）
+node tests/smoke-v8.js --only=sqlite
+node tests/smoke-v8.js --only=docker
+node tests/smoke-v8.js --only=honcho
+```
+
+**测试要求**：
+- 新功能必须包含测试用例
+- Bug 修复必须包含回归测试（复现该 Bug 的测试）
+- 测试不依赖外部网络（Docker 沙盒测试除外，需本机 Docker）
+- 测试中不包含真实 API Key，使用 Mock 或环境变量
+
+## 六、本地开发
 
 ```bash
 npm install
@@ -65,4 +108,17 @@ node dist/cli/index.js "<需求>"   # 未配 FH_PROVIDERS 自动离线 Mock 闭
 
 ---
 
+## 相关社区文档
+
+| 文档 | 说明 |
+|------|------|
+| [`GOVERNANCE.md`](GOVERNANCE.md) | 社区治理结构、角色职责、决策机制、版本发布流程 |
+| [`COMMUNITY.md`](COMMUNITY.md) | 社区参与指南、贡献方式、支持渠道、活动信息 |
+| [`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md) | 社区行为准则 |
+| [`.github/ISSUE_TEMPLATE/`](.github/ISSUE_TEMPLATE/) | Issue 模板（Bug 报告 / 功能请求） |
+| [`.github/PULL_REQUEST_TEMPLATE.md`](.github/PULL_REQUEST_TEMPLATE.md) | PR 模板 |
+| [`docs/使用说明书-v8.0.0.md`](docs/使用说明书-v8.0.0.md) | 详细使用说明书 |
+
+---
+
 © 2026 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹