feihong-code 7.5.0 → 8.0.0

package/docs//345/220/210/350/247/204/350/256/244/350/257/201/345/207/206/345/244/207/346/270/205/345/215/225_v7.2.0.md

@@ -1,59 +1,59 @@
-# 飞虹 Code 合规认证准备清单（v7.2.0）
-
-**晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹**
-**更新日期**：2026-08-27
-
-> **诚实声明**：飞虹 Code 当前**未获得** SOC2 / ISO27001 等第三方合规认证。本文档是"差距 + 准备路线"，不是认证声明。认证必须由第三方审计机构（如 A-LIGN、BDO、SGS、TÜV 等）完成独立审计，任何产品不得自行宣称已获认证。
-
----
-
-## 一、现状核查（实测）
-
-| 项 | 现状 | 证据 |
-|---|---|---|
-| 安全控制文档 | ❌ 无 | 未见 security 控制文档 |
-| SOC2 Type I/II | ❌ 无 | 无审计报告 |
-| ISO27001 | ❌ 无 | 无认证证书 |
-| 渗透测试 | ⚠️ 未独立执行 | 仅内部 security CI（GitHub Actions） |
-| 隐私政策/数据处理协议 | ⚠️ 部分 | 无正式 DPA 对外文档 |
-
-## 二、政企采购为何卡合规
-
-政企/金融/医疗客户采购软件时的硬性门槛通常是：
-1. **安全资质**：ISO27001 / 等保 2.0（国内）/ SOC2（出海客户）
-2. **数据安全**：私有化部署 + 数据不出域（飞虹 Code 已具备，是优势项）
-3. **供应链安全**：SBOM（软件物料清单）、依赖漏洞扫描
-4. **审计能力**：操作审计日志、权限隔离（飞虹 Code 已具备 RBAC + 审计日志）
-
-**结论**：飞虹 Code 的**技术控制面（RBAC/审计/私有化/沙箱）已具备相当基础**，缺的是"证书 + 文档 + 第三方背书"，这是可规划的，不是技术不可达。
-
-## 三、技术侧可先行项（代码/工程可立即做）
-
-| # | 项 | 说明 | 优先级 |
-|---|---|---|---|
-| 1 | **依赖漏洞扫描 CI** | 在 GitHub Actions 加 `npm audit --audit-level=high` + `osv-scanner` 步骤，作为 SBOM 与供应链安全证据 | P0 |
-| 2 | **SBOM 生成** | `npx @cyclonedx/cyclonedx-npm` 生成 CycloneDX SBOM，随版本发布 | P0 |
-| 3 | **审计日志完备性** | 已有 `fhcode audit`；补充：模型调用、配置变更、权限变更纳入审计（审计范围清单文档） | P1 |
-| 4 | **敏感信息脱敏** | 配置/日志/诊断输出中密钥脱敏（已有部分，需系统化） | P1 |
-| 5 | **密钥管理** | 文档化：API key 不落盘明文、支持环境变量注入（FH_*） | P1 |
-| 6 | **安全控制文档** | 编写《安全白皮书》：架构/数据流/访问控制/加密/日志/事故响应 | P1 |
-| 7 | **数据留存与删除策略** | 会话/审计/经验库的留存周期、导出与删除机制文档 | P2 |
-| 8 | **DPA 数据处理协议** | 面向企业客户的个人/业务数据处理协议模板 | P2 |
-
-## 四、组织侧（需第三方/法务）
-
-| # | 项 | 说明 |
-|---|---|---|
-| A | SOC2 准备 | 选择审计机构，先做 Type I（设计合理性），再 Type II（运行有效性，需 3-12 个月观察期） |
-| B | ISO27001 | 建立 ISMS 体系、风险登记册、内审 + 外审；通常 6-12 个月 |
-| C | 等保 2.0（国内） | 若面向国内政企，评估定级（二级/三级），对接测评机构 |
-| D | 渗透测试 | 每年一次由第三方执行的渗透测试报告 |
-
-## 五、近期落地建议（本仓库可立即推进）
-
-1. **新增安全 CI**：在 `.github/workflows/security.yml` 增加 `npm audit` + `osv-scanner`（零 Secrets 可跑，与现有 security 流水线一致）
-2. **生成 SBOM**：发布流程加 CycloneDX 产物
-3. **编写《安全白皮书》**：作为政企售前材料
-4. **补齐 DPA 模板**：可调用 doubao-dpa-drafter skill 生成
-
-> 认证是长周期工程（SOC2 Type II 需观察期），但**技术控制面 + 文档 + 供应链证据**可在 1-2 个迭代内补齐，这是政企采购最卡的部分，优先级最高。
+# 飞虹 Code 合规认证准备清单（v7.2.0）
+
+**晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹**
+**更新日期**：2026-08-27
+
+> **诚实声明**：飞虹 Code 当前**未获得** SOC2 / ISO27001 等第三方合规认证。本文档是"差距 + 准备路线"，不是认证声明。认证必须由第三方审计机构（如 A-LIGN、BDO、SGS、TÜV 等）完成独立审计，任何产品不得自行宣称已获认证。
+
+---
+
+## 一、现状核查（实测）
+
+| 项 | 现状 | 证据 |
+|---|---|---|
+| 安全控制文档 | ❌ 无 | 未见 security 控制文档 |
+| SOC2 Type I/II | ❌ 无 | 无审计报告 |
+| ISO27001 | ❌ 无 | 无认证证书 |
+| 渗透测试 | ⚠️ 未独立执行 | 仅内部 security CI（GitHub Actions） |
+| 隐私政策/数据处理协议 | ⚠️ 部分 | 无正式 DPA 对外文档 |
+
+## 二、政企采购为何卡合规
+
+政企/金融/医疗客户采购软件时的硬性门槛通常是：
+1. **安全资质**：ISO27001 / 等保 2.0（国内）/ SOC2（出海客户）
+2. **数据安全**：私有化部署 + 数据不出域（飞虹 Code 已具备，是优势项）
+3. **供应链安全**：SBOM（软件物料清单）、依赖漏洞扫描
+4. **审计能力**：操作审计日志、权限隔离（飞虹 Code 已具备 RBAC + 审计日志）
+
+**结论**：飞虹 Code 的**技术控制面（RBAC/审计/私有化/沙箱）已具备相当基础**，缺的是"证书 + 文档 + 第三方背书"，这是可规划的，不是技术不可达。
+
+## 三、技术侧可先行项（代码/工程可立即做）
+
+| # | 项 | 说明 | 优先级 |
+|---|---|---|---|
+| 1 | **依赖漏洞扫描 CI** | 在 GitHub Actions 加 `npm audit --audit-level=high` + `osv-scanner` 步骤，作为 SBOM 与供应链安全证据 | P0 |
+| 2 | **SBOM 生成** | `npx @cyclonedx/cyclonedx-npm` 生成 CycloneDX SBOM，随版本发布 | P0 |
+| 3 | **审计日志完备性** | 已有 `fhcode audit`；补充：模型调用、配置变更、权限变更纳入审计（审计范围清单文档） | P1 |
+| 4 | **敏感信息脱敏** | 配置/日志/诊断输出中密钥脱敏（已有部分，需系统化） | P1 |
+| 5 | **密钥管理** | 文档化：API key 不落盘明文、支持环境变量注入（FH_*） | P1 |
+| 6 | **安全控制文档** | 编写《安全白皮书》：架构/数据流/访问控制/加密/日志/事故响应 | P1 |
+| 7 | **数据留存与删除策略** | 会话/审计/经验库的留存周期、导出与删除机制文档 | P2 |
+| 8 | **DPA 数据处理协议** | 面向企业客户的个人/业务数据处理协议模板 | P2 |
+
+## 四、组织侧（需第三方/法务）
+
+| # | 项 | 说明 |
+|---|---|---|
+| A | SOC2 准备 | 选择审计机构，先做 Type I（设计合理性），再 Type II（运行有效性，需 3-12 个月观察期） |
+| B | ISO27001 | 建立 ISMS 体系、风险登记册、内审 + 外审；通常 6-12 个月 |
+| C | 等保 2.0（国内） | 若面向国内政企，评估定级（二级/三级），对接测评机构 |
+| D | 渗透测试 | 每年一次由第三方执行的渗透测试报告 |
+
+## 五、近期落地建议（本仓库可立即推进）
+
+1. **新增安全 CI**：在 `.github/workflows/security.yml` 增加 `npm audit` + `osv-scanner`（零 Secrets 可跑，与现有 security 流水线一致）
+2. **生成 SBOM**：发布流程加 CycloneDX 产物
+3. **编写《安全白皮书》**：作为政企售前材料
+4. **补齐 DPA 模板**：可调用 doubao-dpa-drafter skill 生成
+
+> 认证是长周期工程（SOC2 Type II 需观察期），但**技术控制面 + 文档 + 供应链证据**可在 1-2 个迭代内补齐，这是政企采购最卡的部分，优先级最高。

package/docs//345/256/211/345/205/250/347/231/275/347/232/256/344/271/246_v7.2.0.md

@@ -1,82 +1,84 @@
-# 飞虹 Code 安全白皮书（v7.2.0）
-
-**晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹**
-**版本**：v7.2.0（2026-08-27）
-**密级**：公开（面向政企售前 / 合规评估）
-
-> 本白皮书基于实际代码能力编写，逐项对应实现，不作无依据宣称。认证状态见《合规认证准备清单》（飞虹 Code 当前无第三方认证，本文件为技术控制面说明）。
-
----
-
-## 1. 产品安全定位
-
-飞虹 Code 是**本地优先 / 可完全离线**的终端 AI 编程智能体，核心数据（对话、审计、经验库、知识库）默认落盘在用户本机（`~/.feihong-code`），**数据不出域**。这是面向政企私有化部署最核心的安全优势。
-
-## 2. 架构与数据流
-
-```
-用户（终端/Web/VS Code扩展）
-   │
-   ├─▶ 认证（Token / SSO）→ RBAC 权限判定
-   │
-   ├─▶ Orchestrator（Agent 编排）
-   │      ├─▶ 模型路由（OpenAI 兼容 / Ollama 本地 / 国内模型）
-   │      ├─▶ 工具层（shell / 文件 / 浏览器 / 电脑控制）
-   │      │     └─▶ 沙箱（read-only / workspace-write / container）
-   │      └─▶ 变更审批（change-manager）→ 审计日志（audit）
-   │
-   └─▶ 数据存储：会话 / 经验 / 知识库 / 插件（本地，RBAC 保护）
-```
-
-## 3. 身份认证与访问控制
-
-| 控制项 | 实现 |
-|---|---|
-| 认证 | Token 认证（`/api/auth/*`）；SSO 单点登录（`/api/sso/*`，未配置时明确返回状态） |
-| 授权 | RBAC 角色：admin / developer / viewer 等，接口级权限判定 |
-| 多租户 | 企业模式（`FH_ENTERPRISE=true`）下租户隔离（`FH_TENANT`） |
-| 会话 | Web Token 校验；会话落盘管理（M3 会话命令） |
-| 沙箱 | 三档：`read-only`（禁写禁执行）/ `workspace-write`（工作区内写，shell 受限）/ `container`（Docker 容器隔离，网络黑白名单） |
-
-## 4. 数据保护与加密
-
-| 数据 | 保护方式 |
-|---|---|
-| 配置 / API Key | 支持环境变量注入（`FH_*`）；禁止明文密钥提交（CI 密钥扫描强制） |
-| 会话 / 经验 / 知识库 | 本地落盘，目录级权限；敏感字段脱敏（redact 工具） |
-| 审计日志 | 追加式落盘（`fhcode audit`），覆盖命令执行与关键操作 |
-| 网络 | 出站请求可配黑白名单（`FH_NETWORK_ALLOW/DENY`）；离线模式默认关闭出站 |
-
-## 5. 供应链安全（v7.2.0 新增）
-
-| 控制项 | 实现 |
-|---|---|
-| 依赖漏洞扫描 | CI `supplychain` job：`npm audit --audit-level=high`（强制）+ `osv-scanner`（OSV 全量库） |
-| SBOM | CI 生成 CycloneDX SBOM（`sbom.cdx.json`，75 组件实测），随版本发布 |
-| 密钥扫描 | CI 强制：发布包白名单（禁 .env/src/私钥）+ git 明文 API Key 扫描 |
-| 依赖审计 | `npm audit --omit=dev` 生产依赖 high 及以上即失败 |
-
-## 6. 合规基础（技术控制面）
-
-- RBAC + 多租户：满足"最小权限 + 职责分离"要求
-- 审计日志：满足"操作可追溯"要求
-- 本地部署 + 数据不出域：满足"数据主权"要求
-- 供应链（SBOM + 漏洞扫描）：满足"供应链安全"要求
-- 认证状态：无第三方认证（SOC2/ISO27001），详见《合规认证准备清单》
-
-## 7. 事故响应与安全更新
-
-1. **上报**：GitHub Issues（模板：环境 / 复现 / 影响）
-2. **响应**：核心维护者（飞扬企源研发中心）72 小时内响应
-3. **修复**：安全补丁走独立 commit，回归冒烟后发布（`npm publish`）
-4. **披露**：关键修复在 CHANGELOG 标注 `[security]`
-
-## 8. 安全边界与声明（诚实）
-
-- 沙箱 `container` 档依赖本机 Docker，未安装时自动降级提示（`fhcode doctor` 探测）
-- 模型后端为第三方 API 时，提示词与代码会经网络传输至模型服务商（本地 Ollama 可完全避免）；请按政企要求选用本地模型
-- 本白皮书描述**当前已实现**的技术控制面；认证类声明以第三方审计为准
-
----
-
-*飞扬企源研发中心 · 安全与合规工作组*
+# 飞虹 Code 安全白皮书（v7.2.0）
+
+**晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹**
+**版本**：v7.2.0（2026-08-27）
+**密级**：公开（面向政企售前 / 合规评估）
+
+> 本白皮书基于实际代码能力编写，逐项对应实现，不作无依据宣称。认证状态见《合规认证准备清单》（飞虹 Code 当前无第三方认证，本文件为技术控制面说明）。
+
+> **📋 性质声明（自评估材料）**：本文档为**厂商内部自评估**，非第三方审计或认证机构出具；所有安全控制描述均为自评估结论，**不构成** SOC 2 / ISO 27001 等认证背书。如需认证意见，以第三方审计机构正式报告为准。
+
+---
+
+## 1. 产品安全定位
+
+飞虹 Code 是**本地优先 / 可完全离线**的终端 AI 编程智能体，核心数据（对话、审计、经验库、知识库）默认落盘在用户本机（`~/.feihong-code`），**数据不出域**。这是面向政企私有化部署最核心的安全优势。
+
+## 2. 架构与数据流
+
+```
+用户（终端/Web/VS Code扩展）
+   │
+   ├─▶ 认证（Token / SSO）→ RBAC 权限判定
+   │
+   ├─▶ Orchestrator（Agent 编排）
+   │      ├─▶ 模型路由（OpenAI 兼容 / Ollama 本地 / 国内模型）
+   │      ├─▶ 工具层（shell / 文件 / 浏览器 / 电脑控制）
+   │      │     └─▶ 沙箱（read-only / workspace-write / container）
+   │      └─▶ 变更审批（change-manager）→ 审计日志（audit）
+   │
+   └─▶ 数据存储：会话 / 经验 / 知识库 / 插件（本地，RBAC 保护）
+```
+
+## 3. 身份认证与访问控制
+
+| 控制项 | 实现 |
+|---|---|
+| 认证 | Token 认证（`/api/auth/*`）；SSO 单点登录（`/api/sso/*`，未配置时明确返回状态） |
+| 授权 | RBAC 角色：admin / developer / viewer 等，接口级权限判定 |
+| 多租户 | 企业模式（`FH_ENTERPRISE=true`）下租户隔离（`FH_TENANT`） |
+| 会话 | Web Token 校验；会话落盘管理（M3 会话命令） |
+| 沙箱 | 三档：`read-only`（禁写禁执行）/ `workspace-write`（工作区内写，shell 受限）/ `container`（Docker 容器隔离，网络黑白名单） |
+
+## 4. 数据保护与加密
+
+| 数据 | 保护方式 |
+|---|---|
+| 配置 / API Key | 支持环境变量注入（`FH_*`）；禁止明文密钥提交（CI 密钥扫描强制） |
+| 会话 / 经验 / 知识库 | 本地落盘，目录级权限；敏感字段脱敏（redact 工具） |
+| 审计日志 | 追加式落盘（`fhcode audit`），覆盖命令执行与关键操作 |
+| 网络 | 出站请求可配黑白名单（`FH_NETWORK_ALLOW/DENY`）；离线模式默认关闭出站 |
+
+## 5. 供应链安全（v7.2.0 新增）
+
+| 控制项 | 实现 |
+|---|---|
+| 依赖漏洞扫描 | CI `supplychain` job：`npm audit --audit-level=high`（强制）+ `osv-scanner`（OSV 全量库） |
+| SBOM | CI 生成 CycloneDX SBOM（`sbom.cdx.json`，75 组件实测），随版本发布 |
+| 密钥扫描 | CI 强制：发布包白名单（禁 .env/src/私钥）+ git 明文 API Key 扫描 |
+| 依赖审计 | `npm audit --omit=dev` 生产依赖 high 及以上即失败 |
+
+## 6. 合规基础（技术控制面）
+
+- RBAC + 多租户：满足"最小权限 + 职责分离"要求
+- 审计日志：满足"操作可追溯"要求
+- 本地部署 + 数据不出域：满足"数据主权"要求
+- 供应链（SBOM + 漏洞扫描）：满足"供应链安全"要求
+- 认证状态：无第三方认证（SOC2/ISO27001），详见《合规认证准备清单》
+
+## 7. 事故响应与安全更新
+
+1. **上报**：GitHub Issues（模板：环境 / 复现 / 影响）
+2. **响应**：核心维护者（飞扬企源研发中心）72 小时内响应
+3. **修复**：安全补丁走独立 commit，回归冒烟后发布（`npm publish`）
+4. **披露**：关键修复在 CHANGELOG 标注 `[security]`
+
+## 8. 安全边界与声明（诚实）
+
+- 沙箱 `container` 档依赖本机 Docker，未安装时自动降级提示（`fhcode doctor` 探测）
+- 模型后端为第三方 API 时，提示词与代码会经网络传输至模型服务商（本地 Ollama 可完全避免）；请按政企要求选用本地模型
+- 本白皮书描述**当前已实现**的技术控制面；认证类声明以第三方审计为准
+
+---
+
+*飞扬企源研发中心 · 安全与合规工作组*