feihong-code 7.5.0 → 8.0.0

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,37 +1,51 @@
 ---
 name: Bug 报告
-about: 创建报告帮助我们改进
-title: '[Bug] '
-labels: 'bug'
+about: 报告飞虹 Code 的缺陷或异常行为
+title: "[Bug] "
+labels: bug, needs-triage
 assignees: ''
 ---
 
-## 环境信息
+## 缺陷描述
 
-- **操作系统**: （如 Windows 11 / macOS 14 / Ubuntu 22.04）
-- **Node.js 版本**: `node --version`
-- **fhcode 版本**: `fhcode --version`
-- **模型配置**: Ollama / DeepSeek / OpenAI / 其他
-- **CLI 模式**: 单命令 / --parallel / swe
+<!-- 清晰简洁地描述这个 bug 是什么 -->
 
 ## 复现步骤
 
-1. 执行命令: `fhcode "..."`
-2. 输出或错误:
-   ```
-   （粘贴完整错误信息）
-   ```
+1. 启动方式：<!-- 如 `node dist/cli/index.js serve` / CLI / APP -->
+2. 操作步骤：
+   1. 
+   2. 
+   3. 
+3. 预期行为：<!-- 你期望发生什么 -->
+4. 实际行为：<!-- 实际发生了什么 -->
+
+## 环境信息
+
+| 项目 | 值 |
+|------|-----|
+| 飞虹 Code 版本 | <!-- 如 v8.0.0，`fhcode --version` 或 /api/health --> |
+| 操作系统 | <!-- 如 Windows 11 / macOS 14 / Ubuntu 22.04 --> |
+| Node.js 版本 | <!-- `node --version` --> |
+| 部署方式 | <!-- 本地 / Docker / 服务器 / 移动端 --> |
+| 模型提供商 | <!-- 如 Agnes / DeepSeek / Ollama / 免密网络层 --> |
+| Docker 版本（如使用沙盒） | <!-- `docker --version` --> |
+
+## 错误日志
 
-## 预期行为
+<!-- 粘贴相关的错误日志、终端输出或截图 -->
 
-（描述你期望看到什么）
+```
+在此粘贴日志
+```
 
-## 实际行为
+## 附加信息
 
-（描述实际发生了什么）
+<!-- 任何有助于定位问题的附加信息：配置文件（脱敏后）、复现频率、是否偶现等 -->
 
-## 额外上下文
+## 自查清单
 
-- [ ] 我已在本地验证此 bug
-- [ ] 此问题可稳定复现
-- [ ] 相关截图或日志已附加
+- [ ] 我已搜索现有 Issues，未发现重复报告
+- [ ] 我已尝试升级到最新版本，问题仍然存在
+- [ ] 我已提供完整的复现步骤和环境信息
+- [ ] 日志中不包含 API Key、Token 等敏感信息（已脱敏）

package/.github/ISSUE_TEMPLATE/config.yml

@@ -1,14 +1,11 @@
-blank_issues_enabled: true
+blank_issues_enabled: false
 contact_links:
-  - name: 📚 文档与 FAQ
-    url: https://github.com/wch887292/feihong-code/blob/master/docs/%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98%E4%B8%8E%E6%95%85%E9%9A%9C%E6%8E%92%E6%9F%A5.md
-    about: 查看常见问题与故障排查
-  - name: 💬 讨论与交流
-    url: https://github.com/wch887292/feihong-code/discussions
-    about: 发起讨论、分享经验、寻求帮助
-  - name: 🤝 贡献指南
-    url: https://github.com/wch887292/feihong-code/blob/master/CONTRIBUTING.md
-    about: 了解如何参与项目开发
-  - name: 🔐 安全漏洞报告
-    url: https://github.com/wch887292/feihong-code/blob/master/.github/SECURITY.md
-    about: 发现安全问题，请通过安全渠道报告
+  - name: 文档与使用说明
+    url: https://github.com/feihong-code/feihong-code/blob/main/docs/使用说明书-v8.0.0.md
+    about: 先阅读详细使用说明书，常见问题可在故障排查章节找到答案
+  - name: 社区讨论
+    url: https://github.com/feihong-code/feihong-code/discussions
+    about: 一般性问题、使用交流、想法分享请到 Discussions
+  - name: 贡献指南
+    url: https://github.com/feihong-code/feihong-code/blob/main/CONTRIBUTING.md
+    about: 想贡献代码？先阅读贡献指南

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,28 +1,53 @@
 ---
 name: 功能请求
-about: 为这个项目提出想法
-title: '[Feature] '
-labels: 'enhancement'
+about: 为飞虹 Code 提出新功能或改进建议
+title: "[Feature] "
+labels: enhancement, needs-triage
 assignees: ''
 ---
 
 ## 功能描述
 
-（清晰简洁地描述你希望增加的功能）
+<!-- 清晰简洁地描述你希望添加的功能 -->
 
-## 使用场景
+## 解决的问题
 
-（说明这个功能会解决什么问题，适用哪些场景）
+<!-- 这个功能解决了什么问题？当前有什么痛点？ -->
 
-## 建议实现方案
+## 期望的解决方案
 
-（如有技术方案或参考实现，请提供）
+<!-- 描述你期望的实现方式、交互流程或 API 设计 -->
 
-## 备选方案
+### 建议的 API / 命令 / 界面
 
-（你考虑过哪些替代方案？）
+<!-- 如果有具体的 API、CLI 命令或界面设计建议，请描述 -->
 
-## 额外信息
+```
+示例代码或界面草图
+```
 
-- **关联问题**: #（如有）
-- **优先级**: 低 / 中 / 高
+## 替代方案
+
+<!-- 你考虑过哪些替代方案？为什么选择当前方案？ -->
+
+## 适用场景
+
+<!-- 这个功能在什么场景下最有价值？目标用户是谁？ -->
+
+## 优先级建议
+
+- [ ] P0 - 阻塞性问题，必须尽快实现
+- [ ] P1 - 重要功能，近期规划
+- [ ] P2 - 增强功能，可排期
+- [ ] P3 - 想法/探索，长期考虑
+
+## 附加信息
+
+<!-- 任何附加信息：参考实现、相关项目、截图、用户调研等 -->
+
+## 自查清单
+
+- [ ] 我已搜索现有 Issues 和 Discussions，未发现重复请求
+- [ ] 我已描述清楚功能的价值和使用场景
+- [ ] 我已考虑过替代方案
+- [ ] 这个功能不违反安全或合规要求

package/.github/PULL_REQUEST_TEMPLATE.md

@@ -1,46 +1,81 @@
-## 变更类型
+## 变更描述
 
-- [ ] Bug 修复
-- [ ] 新功能
-- [ ] 性能优化
-- [ ] 文档更新
-- [ ] 重构
-- [ ] 测试补充
+<!-- 清晰简洁地描述这个 PR 做了什么变更 -->
 
 ## 关联 Issue
 
-修复 #（issue 编号）
+<!-- 关联的 Issue 编号，如 Closes #123 / Fixes #456 -->
 
-## 变更描述
+## 变更类型
 
-（清晰描述本次 PR 做了什么变更）
+- [ ] 🐛 Bug 修复（修复缺陷）
+- [ ] ✨ 新功能（新增能力）
+- [ ] 💄 界面/样式优化
+- [ ] ♻️ 代码重构（不改变功能）
+- [ ] 📝 文档更新
+- [ ] ⚡ 性能优化
+- [ ] 🧪 测试补充
+- [ ] 🔧 配置/构建/CI 变更
+- [ ] 📦 依赖升级
+- [ ] 其他（请说明）：
 
-## 测试验证
+## 变更范围
 
-- [ ] 本地类型检查通过：`npm run typecheck`
-- [ ] 单元测试通过：`npm test`
-- [ ] M4 企业能力验证：`npm run verify:m4`
-- [ ] 全量验证：`npm run verify`
-- [ ] 手动测试覆盖（如有新功能）
+<!-- 列出主要修改的文件/模块 -->
 
-## 变更影响范围
+- `src/...`
+- `docs/...`
+- `app-mobile/...`
 
-- 影响的模块：
-- 向后兼容性：是 / 否（如有破坏性变更请说明）
-- 需要更新文档：是 / 否
+## 验证方式
 
-## 截图（如有 UI 变更）
+<!-- 描述你如何验证这个变更 -->
 
-（粘贴截图或录屏链接）
+- [ ] 本地编译通过（`npm run build` / `npx tsc`）
+- [ ] 冒烟测试通过（`node tests/smoke-v8.js`）
+- [ ] 集成测试通过（`node tests/integration/api.test.js`）
+- [ ] 手动验证（描述步骤和结果）
+- [ ] 移动端验证（如涉及 APP）
 
-## 提交信息格式
+### 验证结果
+
+<!-- 粘贴测试输出或截图 -->
 
 ```
-feat(scope): 简要描述（符合 Conventional Commits）
-fix(scope): 简要描述
-docs(scope): 简要描述
-test(scope): 简要描述
-refactor(scope): 简要描述
-perf(scope): 简要描述
-chore(scope): 简要描述
+在此粘贴测试结果
 ```
+
+## 版本号
+
+<!-- 如涉及版本变更，确认版本号已同步更新 -->
+
+- [ ] `package.json` version 已更新
+- [ ] `src/cli/version.ts` VERSION 已同步
+- [ ] `CHANGELOG.md` 已更新
+- [ ] `android/app/build.gradle` versionCode/versionName 已同步（如涉及移动端）
+
+## 安全检查
+
+- [ ] 代码中不包含硬编码的 API Key、Token、密码等敏感信息
+- [ ] 日志输出中不包含敏感数据（密钥已脱敏）
+- [ ] 新增的外部输入已做校验（zod / 类型检查）
+- [ ] Shell 命令执行已走沙盒/白名单/审批机制
+- [ ] 不引入已知漏洞的依赖
+
+## 兼容性
+
+- [ ] 向后兼容（旧配置/旧 API 仍可使用）
+- [ ] 包含破坏性变更（已在描述中说明迁移方式）
+- [ ] 不涉及兼容性问题
+
+## 附加说明
+
+<!-- 任何需要评审者特别注意的事项：设计决策、已知限制、后续 TODO 等 -->
+
+## 自查清单
+
+- [ ] 代码遵循项目编码规范（TypeScript、架构分层、署名注释）
+- [ ] 已阅读并遵循 `CONTRIBUTING.md`
+- [ ] 变更最小化，不包含无关修改
+- [ ] 注释清晰，复杂逻辑有说明
+- [ ] 已自测，功能符合预期

package/.github/workflows/ci.yml

@@ -1,180 +1,193 @@
-# 飞虹 Code CI
-# 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹
-#
-# 全流程离线：不使用任何 API key / Secrets，PR 来自 fork 也能安全跑完。
-name: CI
-
-on:
-  push:
-    branches: [master, main]
-  pull_request:
-  workflow_dispatch:
-
-env:
-  FH_OFFLINE: 'true'
-  FH_PROVIDERS: '[]'
-
-jobs:
-  # ---------- 1. 构建与离线闭环冒烟（多 Node 版本矩阵） ----------
-  build:
-    name: 构建 · Node ${{ matrix.node }}
-    runs-on: ubuntu-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        node: [18, 20, 22]
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: ${{ matrix.node }}
-      - run: npm install
-      - name: 类型检查
-        run: npm run typecheck
-      - name: 编译
-        run: npm run build
-      - name: CLI 可用性
-        run: node dist/cli/index.js --version
-      - name: 离线端到端闭环
-        run: node dist/cli/index.js "离线冒烟：创建一个说明文件"
-      - name: 只读技能
-        run: |
-          node dist/cli/index.js /plan "实现登录并且添加支付"
-          node dist/cli/index.js /grill src
-
-  # ---------- 2. M4 企业能力（权限 / 审计 / 多租户 / 配额） ----------
-  enterprise:
-    name: 企业能力冒烟 (M4)
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 20
-      - run: npm install
-      - run: npm run build
-      - name: M4 断言套件（RBAC / 审计链 / 多租户 / 配额）
-        run: node scripts/verify-m4.mjs
-      - name: CLI 企业命令冒烟
-        env:
-          FH_HOME: ${{ runner.temp }}/fhhome
-          FH_TENANT: ci-tenant
-          FH_USER: ci-bot
-          FH_ROLE: developer
-        run: |
-          node dist/cli/index.js whoami
-          node dist/cli/index.js policy
-          node dist/cli/index.js "CI 离线任务"
-          node dist/cli/index.js audit --limit 10
-          node dist/cli/index.js audit verify
-          node dist/cli/index.js tenants
-      - name: 租户隔离断言（beta 不得看到 ci-tenant 的会话）
-        env:
-          FH_HOME: ${{ runner.temp }}/fhhome
-          FH_TENANT: beta-tenant
-          FH_ROLE: viewer
-        run: |
-          out=$(node dist/cli/index.js sessions)
-          echo "$out"
-          if echo "$out" | grep -q "CI 离线任务"; then
-            echo "::error::租户隔离失效：beta-tenant 读到了 ci-tenant 的会话"
-            exit 1
-          fi
-
-  # ---------- 3. 供应链与密钥安全 ----------
-  security:
-    name: 发布包安全检查
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 20
-      - run: npm install
-      - run: npm run build
-      - name: 发布包不得包含密钥或源码
-        run: |
-          npm pack --dry-run 2>&1 | tee pack.txt
-          for bad in ".env" "src/" ".workbuddy" "policy.json" "id_rsa"; do
-            if grep -q "$bad" pack.txt; then
-              echo "::error::发布包中检出敏感条目: $bad"
-              exit 1
-            fi
-          done
-          echo "发布包白名单校验通过"
-      - name: 仓库内不得提交明文密钥
-        run: |
-          if git grep -nIE "sk-[A-Za-z0-9_-]{16,}" -- . ':!*.md' ':!scripts/verify-m4.mjs' ':!tests/unit/redact.test.ts'; then
-            echo "::error::检出疑似明文 API Key"
-            exit 1
-          fi
-          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 镜像构建校验
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - name: 构建镜像（不推送）
-        run: docker build -t feihong-code:ci .
-      - name: 冒烟：容器内企业命令可用
-        run: |
-          docker run --rm \
-            -e FH_ENTERPRISE=true -e FH_TENANT=ci -e FH_USER=ci -e FH_ROLE=developer \
-            feihong-code:ci whoami
-      - name: 冒烟：Web 控制台可启动
-        run: |
-          docker run --rm -d --name fhcode-smoke -p 8099:8080 \
-            -e FH_ENTERPRISE=true -e FH_WEB_TOKEN=ci-token -e FH_WEB_PORT=8080 \
-            feihong-code:ci serve --port 8080
-          sleep 3
-          code=$(curl -s -o /dev/null -w "%{http_code}" -H "Authorization: Bearer ci-token" http://localhost:8099/api/health)
-          docker rm -f fhcode-smoke
-          if [ "$code" != "200" ]; then
-            echo "::error::Web 控制台健康检查失败，HTTP=$code"
-            exit 1
-          fi
-          echo "Web 控制台健康检查通过 (HTTP 200)"
+# 飞虹 Code CI
+# 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹
+#
+# 全流程离线：不使用任何 API key / Secrets，PR 来自 fork 也能安全跑完。
+name: CI
+
+on:
+  push:
+    branches: [master, main]
+  pull_request:
+  workflow_dispatch:
+
+env:
+  FH_OFFLINE: 'true'
+  FH_PROVIDERS: '[]'
+
+jobs:
+  # ---------- 1. 构建与离线闭环冒烟（多 Node 版本矩阵） ----------
+  build:
+    name: 构建 · Node ${{ matrix.node }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        node: [18, 20, 22]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node }}
+      # 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
+
+  # ---------- 2. M4 企业能力（权限 / 审计 / 多租户 / 配额） ----------
+  enterprise:
+    name: 企业能力冒烟 (M4)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - run: npm install
+      - run: npm run build
+      - name: M4 断言套件（RBAC / 审计链 / 多租户 / 配额）
+        run: node scripts/verify-m4.mjs
+      - name: CLI 企业命令冒烟
+        env:
+          FH_HOME: ${{ runner.temp }}/fhhome
+          FH_TENANT: ci-tenant
+          FH_USER: ci-bot
+          FH_ROLE: developer
+        run: |
+          node dist/cli/index.js whoami
+          node dist/cli/index.js policy
+          node dist/cli/index.js "CI 离线任务"
+          node dist/cli/index.js audit --limit 10
+          node dist/cli/index.js audit verify
+          node dist/cli/index.js tenants
+      - name: 租户隔离断言（beta 不得看到 ci-tenant 的会话）
+        env:
+          FH_HOME: ${{ runner.temp }}/fhhome
+          FH_TENANT: beta-tenant
+          FH_ROLE: viewer
+        run: |
+          out=$(node dist/cli/index.js sessions)
+          echo "$out"
+          if echo "$out" | grep -q "CI 离线任务"; then
+            echo "::error::租户隔离失效：beta-tenant 读到了 ci-tenant 的会话"
+            exit 1
+          fi
+
+  # ---------- 3. 供应链与密钥安全 ----------
+  security:
+    name: 发布包安全检查
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - run: npm install
+      - run: npm run build
+      - name: 发布包不得包含密钥或源码
+        run: |
+          npm pack --dry-run 2>&1 | tee pack.txt
+          for bad in ".env" "src/" ".workbuddy" "policy.json" "id_rsa"; do
+            if grep -q "$bad" pack.txt; then
+              echo "::error::发布包中检出敏感条目: $bad"
+              exit 1
+            fi
+          done
+          echo "发布包白名单校验通过"
+      - name: 仓库内不得提交明文密钥
+        run: |
+          if git grep -nIE "sk-[A-Za-z0-9_-]{16,}" -- . ':!*.md' ':!scripts/verify-m4.mjs' ':!tests/unit/redact.test.ts'; then
+            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@v7
+        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@v7
+        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 镜像构建校验
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: 构建镜像（不推送）
+        run: docker build -t feihong-code:ci .
+      - name: 冒烟：容器内企业命令可用
+        run: |
+          docker run --rm \
+            -e FH_ENTERPRISE=true -e FH_TENANT=ci -e FH_USER=ci -e FH_ROLE=developer \
+            feihong-code:ci whoami
+      - name: 冒烟：Web 控制台可启动
+        run: |
+          docker run --rm -d --name fhcode-smoke -p 8099:8080 \
+            -e FH_ENTERPRISE=true -e FH_WEB_TOKEN=ci-token -e FH_WEB_PORT=8080 \
+            feihong-code:ci serve --port 8080
+          sleep 3
+          code=$(curl -s -o /dev/null -w "%{http_code}" -H "Authorization: Bearer ci-token" http://localhost:8099/api/health)
+          docker rm -f fhcode-smoke
+          if [ "$code" != "200" ]; then
+            echo "::error::Web 控制台健康检查失败，HTTP=$code"
+            exit 1
+          fi
+          echo "Web 控制台健康检查通过 (HTTP 200)"