feat(core,settings,commit,webview): 提升提交生成与多仓库能力，新增模型注册/设置管理并修复 UI 与消息链路稳定性

本次 PR 汇总了多个版本迭代（含 v0.56.x ～ v0.59.0）的核心演进，重点围绕 **提交生成链路、AI/模型管理、设置体系、Webview/UI 架构** 进行增强，同时修复了多项稳定性与类型问题，并完善发布与工程化流程。

- **变更类型**
  - `feat`: 新增模型注册与目录同步、功能设置管理、Commit Chat 实时流式、提示词/i18n 能力、上下文检查器等
  - `fix`: 修复提交去重丢消息、react-hooks lint/TS 报错、缓存键隔离、CI 发布解析、构建脚本兼容等问题
  - `refactor`: 重构 commit 生成编排、core/service 架构、webview 通信与会话管理、settings/profile 流程、SCM 多仓库路由
  - `chore/build/ci/release`: 依赖升级、发布脚本与工作流优化、日志与审计流程补充、版本发布推进

- **核心改动概览**
  1. **Commit 生成与缓存体系增强**
     - 改进生成韧性、提示词感知缓存、分层配置对齐与 diff 快照一致性
     - 统一/去重生成流水线，补全结果类型，返回结构化命令执行状态
     - 隔离 Git/SVN 缓存键，减少跨场景污染与误命中

  2. **SCM 与多仓库能力强化**
     - 加强多仓库边界校验与 provider 路由
     - 优化跨仓库检测、仓库选择与关键路径日志，提升复杂工作区稳定性

  3. **AI 与模型管理升级**
     - 新增 model registry 与 catalog 同步服务
     - 标准化 AI provider 日志与运行时诊断
     - 持续扩展 provider/模型兼容能力并优化配置管理

  4. **Settings / Webview / UI 演进**
     - 新增 features settings 管理与高级运行时控制
     - Webview 消息协议对齐，补充审计工作流，修复页面重入消息去重丢失
     - 修复 settings 流程中的 hooks lint 与 TypeScript 错误，统一命令面板与欢迎页体验
     - 增强提示词 UI、安全存储、国际化与页面交互细节（含最小宽度样式修正）

  5. **工程化与发布流程**
     - 依赖与锁文件更新（含 `@types/vscode` 锁定）
     - CI/release 流程优化：changelog 解析、URL 输出、dry-run/手动触发等
     - 多次发布版本推进（含 `v0.58.x`、`v0.59.0`）

- **重点模块**
  - `core`, `commit`, `commands`, `scm`
  - `ai`, `model-registry`, `prompts`
  - `settings`, `webview`, `webview-ui`
  - `ci/build/release` 工具链与流程

整体上，该 PR 属于一次 **功能增强 + 架构重构 + 稳定性修复** 的综合升级，为后续跨仓库提交生成、模型扩展与设置体系演进打下了更稳固基础。

Author: littleCareless

.github/workflows/protocol-audit.yml

@@ -0,0 +1,55 @@
+name: Protocol Audit
+
+on:
+  pull_request:
+    branches: ["**"]
+  workflow_dispatch:
+
+jobs:
+  protocol-audit:
+    name: Message Protocol Audit (blocking)
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - name: Set up pnpm
+        uses: pnpm/action-setup@v3
+        with:
+          version: 10.24.0
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Run protocol audit (phase B: blocking)
+        id: audit
+        run: |
+          set -o pipefail
+          pnpm protocol:check -- --format both | tee protocol-audit.log
+
+      - name: Upload protocol audit artifacts
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: protocol-audit-report
+          if-no-files-found: warn
+          path: |
+            protocol-audit.log
+            protocol-audit-report.json
+
+      - name: Write workflow summary
+        if: always()
+        run: |
+          echo "## Message Protocol Audit (Phase B)" >> "$GITHUB_STEP_SUMMARY"
+          echo "" >> "$GITHUB_STEP_SUMMARY"
+          echo "- Mode: blocking (ERROR will fail job)" >> "$GITHUB_STEP_SUMMARY"
+          echo "- Step outcome: \`${{ steps.audit.outcome }}\`" >> "$GITHUB_STEP_SUMMARY"
+          echo "- Report artifact: \`protocol-audit-report\`" >> "$GITHUB_STEP_SUMMARY"

CHANGELOG.zh-CN.md

@@ -1,17 +1,38 @@
-## 0.59.0 (2026-03-13)
+## 0.59.0 (2026-03-25)
 
 ### 📦 src 模块
 
 ### ✨ Features
 
-- **commit-chat**: add real-time model streaming in webview chat ([2ead424](https://github.com/littleCareless/dish-ai-commit/commit/2ead424))
+- **commit**: improve generation resilience and prompt-aware cache ([79f57a1](https://github.com/littleCareless/dish-ai-commit/commit/79f57a1))
+- **settings**: add features settings management ([636425a](https://github.com/littleCareless/dish-ai-commit/commit/636425a))
+- **ai**: add model registry and catalog sync services ([14f5bc0](https://github.com/littleCareless/dish-ai-commit/commit/14f5bc0))
+
+### 🐛 Bug Fixes
+
+- **webview**: prevent message dedupe drops on page re-entry ([456066f](https://github.com/littleCareless/dish-ai-commit/commit/456066f))
+- **commit**: align layered generation config and diff snapshots ([07f9f8a](https://github.com/littleCareless/dish-ai-commit/commit/07f9f8a))
+
+### ♻️ Code Refactoring
+
+- **commands**: return structured execution status ([dc447b7](https://github.com/littleCareless/dish-ai-commit/commit/dc447b7))
+- **commit**: remove unused target resources path ([1794064](https://github.com/littleCareless/dish-ai-commit/commit/1794064))
+- **ai**: standardize provider logging and runtime diagnostics ([ea17db8](https://github.com/littleCareless/dish-ai-commit/commit/ea17db8))
+- **commit**: orchestrate generation flow and unify diff targeting ([58c0c59](https://github.com/littleCareless/dish-ai-commit/commit/58c0c59))
+- **core**: remove disconnected orchestration scaffolds ([92cc037](https://github.com/littleCareless/dish-ai-commit/commit/92cc037))
+- **core**: remove duplicate services and orphan command implementations ([3ede345](https://github.com/littleCareless/dish-ai-commit/commit/3ede345))
 
 ### 🔧 Chores
 
-- branch 'feat-commit-chat-real-streaming' into develop ([6b5467a](https://github.com/littleCareless/dish-ai-commit/commit/6b5467a))
-- branch 'chore/save-current-changes-20260301' into develop ([f6e1bc1](https://github.com/littleCareless/dish-ai-commit/commit/f6e1bc1))
-- **chore**: save current local changes ([804ae6a](https://github.com/littleCareless/dish-ai-commit/commit/804ae6a))
-- **commit-chat**: type input handlers for strict ts checks ([446e3c7](https://github.com/littleCareless/dish-ai-commit/commit/446e3c7))
+- **scm**: harden multi-repo boundaries and provider routing ([41459a6](https://github.com/littleCareless/dish-ai-commit/commit/41459a6))
+- **fix**: isolate git/svn cache keys for prompts and commit cache ([beb63fa](https://github.com/littleCareless/dish-ai-commit/commit/beb63fa))
+- **chore**: checkpoint current changes ([f2bd596](https://github.com/littleCareless/dish-ai-commit/commit/f2bd596))
+- **commit**: complete generation result typing ([197cb45](https://github.com/littleCareless/dish-ai-commit/commit/197cb45))
+- **protocol**: add audit workflow and align webview messaging ([54f0cc8](https://github.com/littleCareless/dish-ai-commit/commit/54f0cc8))
+- **scm**: unify critical-path logging/menu and publish verification artifacts ([dc2bb3b](https://github.com/littleCareless/dish-ai-commit/commit/dc2bb3b))
+- **commit**: dedup generation pipeline and enable cross-repo routing ([b9704d9](https://github.com/littleCareless/dish-ai-commit/commit/b9704d9))
+- **ui**: resolve TypeScript errors in settings components ([6b773d8](https://github.com/littleCareless/dish-ai-commit/commit/6b773d8))
+- **ui**: unify command palette and welcome page ([2904def](https://github.com/littleCareless/dish-ai-commit/commit/2904def))
 - **style**: 添加最小宽度以防止内容被压缩 ([0d398ac](https://github.com/littleCareless/dish-ai-commit/commit/0d398ac))
 - v0.58.2 ([1976014](https://github.com/littleCareless/dish-ai-commit/commit/1976014))
 - **ci**: improve release workflow changelog parsing and URL output ([2bc78ea](https://github.com/littleCareless/dish-ai-commit/commit/2bc78ea))
@@ -20,28 +41,70 @@
 
 ### ✨ Features
 
-- **commit-chat**: add real-time model streaming in webview chat ([2ead424](https://github.com/littleCareless/dish-ai-commit/commit/2ead424))
+- **commit**: improve generation resilience and prompt-aware cache ([79f57a1](https://github.com/littleCareless/dish-ai-commit/commit/79f57a1))
+- **settings**: add features settings management ([636425a](https://github.com/littleCareless/dish-ai-commit/commit/636425a))
+- **ai**: add model registry and catalog sync services ([14f5bc0](https://github.com/littleCareless/dish-ai-commit/commit/14f5bc0))
+
+### 🐛 Bug Fixes
+
+- **webview**: prevent message dedupe drops on page re-entry ([456066f](https://github.com/littleCareless/dish-ai-commit/commit/456066f))
+- **commit**: align layered generation config and diff snapshots ([07f9f8a](https://github.com/littleCareless/dish-ai-commit/commit/07f9f8a))
+
+### ♻️ Code Refactoring
+
+- **commands**: return structured execution status ([dc447b7](https://github.com/littleCareless/dish-ai-commit/commit/dc447b7))
+- **commit**: remove unused target resources path ([1794064](https://github.com/littleCareless/dish-ai-commit/commit/1794064))
+- **ai**: standardize provider logging and runtime diagnostics ([ea17db8](https://github.com/littleCareless/dish-ai-commit/commit/ea17db8))
+- **commit**: orchestrate generation flow and unify diff targeting ([58c0c59](https://github.com/littleCareless/dish-ai-commit/commit/58c0c59))
+- **core**: remove disconnected orchestration scaffolds ([92cc037](https://github.com/littleCareless/dish-ai-commit/commit/92cc037))
+- **core**: remove duplicate services and orphan command implementations ([3ede345](https://github.com/littleCareless/dish-ai-commit/commit/3ede345))
 
 ### 🔧 Chores
 
-- branch 'feat-commit-chat-real-streaming' into develop ([6b5467a](https://github.com/littleCareless/dish-ai-commit/commit/6b5467a))
-- branch 'chore/save-current-changes-20260301' into develop ([f6e1bc1](https://github.com/littleCareless/dish-ai-commit/commit/f6e1bc1))
-- **chore**: save current local changes ([804ae6a](https://github.com/littleCareless/dish-ai-commit/commit/804ae6a))
-- **commit-chat**: type input handlers for strict ts checks ([446e3c7](https://github.com/littleCareless/dish-ai-commit/commit/446e3c7))
+- **scm**: harden multi-repo boundaries and provider routing ([41459a6](https://github.com/littleCareless/dish-ai-commit/commit/41459a6))
+- **fix**: isolate git/svn cache keys for prompts and commit cache ([beb63fa](https://github.com/littleCareless/dish-ai-commit/commit/beb63fa))
+- **chore**: checkpoint current changes ([f2bd596](https://github.com/littleCareless/dish-ai-commit/commit/f2bd596))
+- **commit**: complete generation result typing ([197cb45](https://github.com/littleCareless/dish-ai-commit/commit/197cb45))
+- **protocol**: add audit workflow and align webview messaging ([54f0cc8](https://github.com/littleCareless/dish-ai-commit/commit/54f0cc8))
+- **scm**: unify critical-path logging/menu and publish verification artifacts ([dc2bb3b](https://github.com/littleCareless/dish-ai-commit/commit/dc2bb3b))
+- **commit**: dedup generation pipeline and enable cross-repo routing ([b9704d9](https://github.com/littleCareless/dish-ai-commit/commit/b9704d9))
+- **ui**: resolve TypeScript errors in settings components ([6b773d8](https://github.com/littleCareless/dish-ai-commit/commit/6b773d8))
+- **ui**: unify command palette and welcome page ([2904def](https://github.com/littleCareless/dish-ai-commit/commit/2904def))
 - **style**: 添加最小宽度以防止内容被压缩 ([0d398ac](https://github.com/littleCareless/dish-ai-commit/commit/0d398ac))
 - v0.58.2 ([1976014](https://github.com/littleCareless/dish-ai-commit/commit/1976014))
 - **ci**: improve release workflow changelog parsing and URL output ([2bc78ea](https://github.com/littleCareless/dish-ai-commit/commit/2bc78ea))
 
 ### ✨ Features
 
-- **commit-chat**: add real-time model streaming in webview chat ([2ead424](https://github.com/littleCareless/dish-ai-commit/commit/2ead424))
+- **commit**: improve generation resilience and prompt-aware cache ([79f57a1](https://github.com/littleCareless/dish-ai-commit/commit/79f57a1))
+- **settings**: add features settings management ([636425a](https://github.com/littleCareless/dish-ai-commit/commit/636425a))
+- **ai**: add model registry and catalog sync services ([14f5bc0](https://github.com/littleCareless/dish-ai-commit/commit/14f5bc0))
+
+### 🐛 Bug Fixes
+
+- **webview**: prevent message dedupe drops on page re-entry ([456066f](https://github.com/littleCareless/dish-ai-commit/commit/456066f))
+- **commit**: align layered generation config and diff snapshots ([07f9f8a](https://github.com/littleCareless/dish-ai-commit/commit/07f9f8a))
+
+### ♻️ Code Refactoring
+
+- **commands**: return structured execution status ([dc447b7](https://github.com/littleCareless/dish-ai-commit/commit/dc447b7))
+- **commit**: remove unused target resources path ([1794064](https://github.com/littleCareless/dish-ai-commit/commit/1794064))
+- **ai**: standardize provider logging and runtime diagnostics ([ea17db8](https://github.com/littleCareless/dish-ai-commit/commit/ea17db8))
+- **commit**: orchestrate generation flow and unify diff targeting ([58c0c59](https://github.com/littleCareless/dish-ai-commit/commit/58c0c59))
+- **core**: remove disconnected orchestration scaffolds ([92cc037](https://github.com/littleCareless/dish-ai-commit/commit/92cc037))
+- **core**: remove duplicate services and orphan command implementations ([3ede345](https://github.com/littleCareless/dish-ai-commit/commit/3ede345))
 
 ### 🔧 Chores
 
-- branch 'feat-commit-chat-real-streaming' into develop ([6b5467a](https://github.com/littleCareless/dish-ai-commit/commit/6b5467a))
-- branch 'chore/save-current-changes-20260301' into develop ([f6e1bc1](https://github.com/littleCareless/dish-ai-commit/commit/f6e1bc1))
-- **chore**: save current local changes ([804ae6a](https://github.com/littleCareless/dish-ai-commit/commit/804ae6a))
-- **commit-chat**: type input handlers for strict ts checks ([446e3c7](https://github.com/littleCareless/dish-ai-commit/commit/446e3c7))
+- **scm**: harden multi-repo boundaries and provider routing ([41459a6](https://github.com/littleCareless/dish-ai-commit/commit/41459a6))
+- **fix**: isolate git/svn cache keys for prompts and commit cache ([beb63fa](https://github.com/littleCareless/dish-ai-commit/commit/beb63fa))
+- **chore**: checkpoint current changes ([f2bd596](https://github.com/littleCareless/dish-ai-commit/commit/f2bd596))
+- **commit**: complete generation result typing ([197cb45](https://github.com/littleCareless/dish-ai-commit/commit/197cb45))
+- **protocol**: add audit workflow and align webview messaging ([54f0cc8](https://github.com/littleCareless/dish-ai-commit/commit/54f0cc8))
+- **scm**: unify critical-path logging/menu and publish verification artifacts ([dc2bb3b](https://github.com/littleCareless/dish-ai-commit/commit/dc2bb3b))
+- **commit**: dedup generation pipeline and enable cross-repo routing ([b9704d9](https://github.com/littleCareless/dish-ai-commit/commit/b9704d9))
+- **ui**: resolve TypeScript errors in settings components ([6b773d8](https://github.com/littleCareless/dish-ai-commit/commit/6b773d8))
+- **ui**: unify command palette and welcome page ([2904def](https://github.com/littleCareless/dish-ai-commit/commit/2904def))
 - **style**: 添加最小宽度以防止内容被压缩 ([0d398ac](https://github.com/littleCareless/dish-ai-commit/commit/0d398ac))
 - v0.58.2 ([1976014](https://github.com/littleCareless/dish-ai-commit/commit/1976014))
 - **ci**: improve release workflow changelog parsing and URL output ([2bc78ea](https://github.com/littleCareless/dish-ai-commit/commit/2bc78ea))

REFACTOR_PROGRESS.md

@@ -56,4 +56,14 @@
 - 创建进度跟踪文档
 - 准备开始执行重构
 
+### 2026-03-24 - 方案收敛（本轮瘦身）
+
+- 主链未接入的编排层 scaffold 已删除：
+  - `src/services/core/commit-generation-coordinator.ts`
+  - `src/core/generation-orchestrator.ts`
+  - `src/core/generation-transaction.ts`
+  - `src/core/generation-gate.ts`
+- `StreamingGenerationHelper` 中未使用的 `GenerationGate` 引用已移除。
+- 本文件保留为历史记录，不再作为进行中任务清单。
+
 ---

docs/refactor-generation-pipeline-dedup-baseline.md

@@ -0,0 +1,58 @@
+# Generation Pipeline Dedup Baseline (Pre-change)
+
+Date: 2026-03-24
+Change: `refactor-generation-pipeline-dedup`
+
+## Scope
+
+Critical path before refactor:
+
+- `src/commands/base-command.ts`
+- `src/commands/generate-commit/generate-commit-command.ts`
+- `src/commands/generate-commit/handlers/cross-repository-handler.ts`
+- `src/scm/multi-repository-context-manager.ts`
+- `src/scm/scm-provider.ts`
+
+## Baseline Metrics
+
+1. SCM detection calls in single-repository commit path: **2**
+
+- First detection in `prepare()` via `resolveSCMContext()`.
+- Second detection in `GenerateCommitCommand.handleSingleRepositoryScenario()`.
+
+2. Model validation calls in commit path: **1 required + 1 fallback path**
+
+- Required call in `BaseCommand.initializeAIContext()`.
+- Fallback call exists in `StreamingGenerationHelper.processModelConfiguration()` when pre-initialized provider/model are missing.
+
+3. Cross-repository reachability: **Not reachable**
+
+- `isCrossRepository` is hardcoded to `false` in `GenerateCommitCommand.parseArguments()`.
+
+4. `console.*` usage in commit/SCM critical files: **54**
+
+- `src/scm/scm-provider.ts`
+- `src/scm/multi-repository-context-manager.ts`
+- `src/commands/generate-commit/generate-commit-command.ts`
+
+5. Orphan command implementation files (present but unregistered): **3**
+
+- `src/commands/select-model-command.ts`
+- `src/commands/show-token-stats-command.ts`
+- `src/commands/reset-token-stats-command.ts`
+
+## Evidence Commands
+
+```bash
+rg -n "resolveSCMContext\(|detectSCMProvider\(|SCMFactory\.detectSCM\(" \
+  src/commands/base-command.ts src/commands/generate-commit/generate-commit-command.ts
+
+rg -n "ModelValidationService\.validateModel\(|initializeAIContext\(|processModelConfiguration\(" \
+  src/commands/base-command.ts src/commands/generate-commit/utils/streaming-generation-helper.ts
+
+rg -n "isCrossRepository = false|groupFilesByRepository|CrossRepositoryHandler" \
+  src/commands/generate-commit/generate-commit-command.ts src/commands/generate-commit/handlers/cross-repository-handler.ts
+
+rg -n "console\.(log|warn|error|info|debug)" \
+  src/scm/scm-provider.ts src/scm/multi-repository-context-manager.ts src/commands/generate-commit/generate-commit-command.ts | wc -l
+```

docs/refactor-generation-pipeline-dedup-decisions.md

@@ -0,0 +1,36 @@
+# Generation Pipeline Dedup Decisions
+
+Date: 2026-03-24
+Change: `refactor-generation-pipeline-dedup`
+
+## Canonical Paths
+
+- SCM detection: `src/services/core/scm-detector-service.ts`
+- Model picker: `src/services/core/model-picker-service.ts`
+- Token statistics: `src/services/core/token-stats-service.ts`
+- Error handling: `src/services/error-handling/*`
+- Code review report generator: `src/services/reporting/code-review-report-generator.ts`
+
+## Removed in This Refactor
+
+- `src/services/scm-detector-service.ts`
+- `src/services/model-picker-service.ts`
+- `src/services/token-stats-service.ts`
+- `src/services/error-classification.ts`
+- `src/services/error-context.ts`
+- `src/services/error-translation.ts`
+- `src/services/enhanced-error-handler.ts`
+- `src/services/code-review-report-generator.ts`
+- `src/commands/select-model-command.ts`
+- `src/commands/show-token-stats-command.ts`
+- `src/commands/reset-token-stats-command.ts`
+- `src/services/core/commit-generation-coordinator.ts`
+- `src/core/generation-orchestrator.ts`
+- `src/core/generation-transaction.ts`
+- `src/core/generation-gate.ts`
+
+## No-Gray-Area Rule Applied
+
+Each disconnected key module now has an explicit status:
+
+- Removed now.