feihong-code 7.5.0 → 7.6.0

package/docs//344/272/247/345/223/201/345/274/200/345/217/221/346/226/207/346/241/243.md

@@ -1,4 +1,4 @@
-# 飞虹 Code（Muse Code 参照复刻）产品开发文档
+# 飞虹 Code（对标 Muse Code，自研内核）产品开发文档
 
 > 项目代号：**飞虹 Code / FeiHong Code**
 > 文档类型：完整产品开发文档（定位 + 架构 + 模块 + 接口 + 数据模型 + 里程碑 + 落地计划）
@@ -29,11 +29,11 @@
 
 - Meta 于 2026-08 发布 **Muse Code**（终端 AI 编程 Agent，基于 Muse Spark 1.2），对标 Claude Code / OpenAI Codex，主打多智能体并行、长时任务、仓库级代码变更，并采用低价按量付费策略（贡献者套餐便宜逾 10 倍，但需授权数据留存）。
 - 该形态验证了「终端 Agent 自主完成完整软件工程任务」的市场价值，但**闭源、依赖 Meta 模型、数据留存策略对国内企业不友好**。
-- 飞虹 Code 的目标：**参照其能力范式，复刻一套自主可控、模型可切换、数据不出域、可私有化部署的终端编程智能体**，复用本团队 TS/Node 工程能力与飞扬企源企业管理方法学。
+- 飞虹 Code 的目标：**参照其能力范式，自研一套自主可控、模型可切换、数据不出域、可私有化部署的终端编程智能体**，复用本团队 TS/Node 工程能力与飞扬企源企业管理方法学。
 
 ### 1.3 参照对象能力拆解（Muse Code）
 
-| 能力维度 | Muse Code 实现 | 我们是否复刻 | 我们的差异点 |
+| 能力维度 | Muse Code 实现 | 我们是否覆盖 | 我们的差异点 |
 |----------|----------------|--------------|--------------|
 | 安装方式 | 单命令 `curl … | bash` | ✅ | 增加 `npm i -g` / 国内镜像源 |
 | 多智能体并行 | 主代理 + 多个持久化子代理，隔离 worktree 并行 | ✅ | 子代理角色可配置（规划/编码/审查） |
@@ -518,6 +518,8 @@ FH_REQUIRE_APPROVAL=true
 
 ## 10. 开发里程碑
 
+> **编号体系说明**：M0→M9.1 为**能力里程碑编号**（工程开发阶段），全部交付后冻结不再扩展；对外发布的 **7.x** 为**产品化成熟度版本号**（SemVer），与 M 编号解耦——产品化迭代（桌面版、SWE-bench harness、企业治理、自进化等）以 7.x 版本号持续演进，详见 [CHANGELOG.md](../CHANGELOG.md) 头部说明。
+
 | 里程碑 | 周期(估) | 交付物 | 退出标准 |
 |--------|----------|--------|----------|
 | **M0 脚手架** | 3d | feature-first 工程结构、config/errors/logger、CLI 入口 | `fhcode --version` 可运行，构建通过 ✅(2026-08-10) |

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*