feat: deep refine all 5 skills with comprehensive coverage

General update of all skills based on thorough analysis of 50+ GitHub/Gitee
issues, full code audit findings, and all 10 Hub samples:

generalupdate-init:
  - 4 update scenes (None/UpgradeOnly/MainOnly/Both)
  - 3 configuration methods (SetSource/SetConfig/LoadFromConfiguration)
  - 5 HTTP auth methods (HMAC/Basic/Bearer/APIKey/Custom)
  - Complete API reference with all Options + events
  - Production deployment checklist
  - 8 known-issue workarounds integrated into templates

generalupdate-ui (core highlight):
  - Full 11-state UI state machine (Idle→Checking→Found→Downloading→
    Paused→Error→Applying→Success→Failed→RollingBack→AlreadyLatest)
  - Enhanced IDownloadService with CanCheck/CanStart/CanPause/CanRetry
  - RealDownloadService bridge (GeneralUpdate.Core → UI)
  - Framework-specific templates: SemiUrsa, LayUI, WPFDevelopers,
    AntdUI, MAUI

generalupdate-strategy:
  - Decision tree for strategy selection
  - 6 strategies with full code examples
  - 4 mixed/cascading strategy combinations
  - Platform-specific behavior (Windows/Linux/Mac)
  - CVP + chain fallback architecture

generalupdate-advanced:
  - All 10+ extension points documented
  - 4 IPC providers (encrypted file/named pipe/shared memory/auto-fallback)
  - Bowl crash daemon with full lifecycle
  - Download subsystem layered architecture
  - FileTree/Blacklist/Event system docs
  - AOT/trim compatibility

generalupdate-troubleshoot:
  - 50+ symptoms classified C/H/M/L (8 Critical, 11 High, 20 Medium, 12 Low)
  - Every symptom traces to real issue/code-audit source
  - 6-step universal diagnostic workflow
  - Platform-specific checks
  - Quick diagnostic commands

Co-Authored-By: Claude <noreply@anthropic.com>

Author: JusterZhu

.claude/skills/generalupdate-advanced/SKILL.md

@@ -1,59 +1,63 @@
 # GeneralUpdate 参考手册
 
-## NuGet 包版本对照表
-
-下载页面：[nuget.org/profiles/GeneralLibrary](https://www.nuget.org/profiles/GeneralLibrary)
-
-| 包名 | 用途 | 是否必需 | .NET版本要求 |
-|------|------|---------|-------------|
-| `GeneralUpdate.Core` | 核心引擎（Bootstrap/策略/下载/IPC/事件） | ✅ 是 | .NET 8+ |
-| `GeneralUpdate.Differential` | BSDIFF/HDiffPatch差分补丁 | ❌ 可选 | .NET 8+ |
-| `GeneralUpdate.Bowl` | 进程崩溃监控、MiniDump、自动回滚 | ❌ 可选 | .NET 8+ |
-| `GeneralUpdate.Extension` | 插件管理 | ❌ 可选 | .NET 8+ |
-| `GeneralUpdate.Drivelution` | Windows驱动更新 | ❌ 可选 | .NET 8+ |
-| `GeneralUpdate.Avalonia.Android` | Avalonia Android更新 | ❌ 可选 | .NET 10+ |
-| `GeneralUpdate.Maui.Android` | MAUI Android更新 | ❌ 可选 | .NET 10+ |
-
-## UpdateRequest 字段速查
-
-| 字段 | 类型 | 必需 | 说明 |
-|------|------|------|------|
-| `UpdateUrl` | string | ✅ | 服务器版本验证 API 地址 |
-| `AppSecretKey` | string | ✅ | HMAC 认证密钥 |
-| `InstallPath` | string | ⚠️ | 应用安装目录（未设置则从 manifest 读取） |
-| `UpdatePath` | string | ⚠️ | Upgrade.exe 所在路径 |
-| `ClientVersion` | string | ⚠️ | 当前版本号（4段式） |
-| `MainAppName` | string | ⚠️ | 主程序文件名（含.exe） |
-| `UpdateAppName` | string | ⚠️ | 升级程序文件名（含.exe） |
-| `ProductId` | string | ⚠️ | 产品标识 |
-| `ReportUrl` | string | ❌ | 状态上报地址 |
-| `BasicUsername` | string | ❌ | Basic 认证用户名 |
-| `BasicPassword` | string | ❌ | Basic 认证密码 |
-
-> ⚠️ = 可通过 `generalupdate.manifest.json` 自动发现，非必需手动传入
-
-## Option 选项速查
+## NuGet 包
+
+所有包的最新版本：[nuget.org/profiles/GeneralLibrary](https://www.nuget.org/profiles/GeneralLibrary)
+
+| 包名 | 用途 | 必需 | .NET 版本 | 典型版本 |
+|------|------|------|-----------|---------|
+| `GeneralUpdate.Core` | 核心引擎（Bootstrap/策略/下载/IPC/事件） | ✅ 是 | net8.0;net10.0 | ≥ 5.0.0 |
+| `GeneralUpdate.Differential` | BSDIFF/HDiffPatch 差分补丁 | ❌ 可选 | net8.0;net10.0 | ≥ 5.0.0 |
+| `GeneralUpdate.Bowl` | 进程崩溃监控、MiniDump、自动回滚 | ❌ 可选 | net8.0;net10.0 | ≥ 1.0.0 |
+| `GeneralUpdate.Extension` | 插件管理系统 | ❌ 可选 | net8.0;net10.0 | ≥ 1.0.0 |
+| `GeneralUpdate.Drivelution` | Windows 驱动更新 | ❌ 可选 | net8.0;net10.0 | ≥ 1.0.0 |
+| `GeneralUpdate.Avalonia.Android` | Avalonia Android 更新 | ❌ 可选 | net10.0-android | ≥ 1.0.0 |
+| `GeneralUpdate.Maui.Android` | MAUI Android 更新 | ❌ 可选 | net10.0-android | ≥ 1.0.0 |
+
+## UpdateRequest 字段完整说明
+
+| 字段 | 类型 | 必需 | 默认 | 说明 |
+|------|------|:----:|------|------|
+| `UpdateUrl` | string | ✅ | — | 版本验证 API 地址（必填） |
+| `AppSecretKey` | string | ✅ | — | HMAC 认证 + IPC 加密密钥（必填） |
+| `InstallPath` | string | ⚠️ | manifest | 应用安装目录 |
+| `UpdatePath` | string | ⚠️ | manifest | Upgrade.exe 所在目录 |
+| `ClientVersion` | string | ⚠️ | manifest | 当前版本号（4段式） |
+| `MainAppName` | string | ⚠️ | manifest | 主程序文件名（含.exe） |
+| `UpdateAppName` | string | ⚠️ | manifest | 升级程序文件名（含.exe） |
+| `ProductId` | string | ⚠️ | manifest | 产品标识 |
+| `ReportUrl` | string | ❌ | — | 状态上报 API 地址 |
+| `UpdateLogUrl` | string | ❌ | — | 更新日志 API 地址 |
+| `BasicUsername` | string | ❌ | — | Basic Auth 用户名 |
+| `BasicPassword` | string | ❌ | — | Basic Auth 密码 |
+
+> ⚠️ = 可通过 `generalupdate.manifest.json` 自动发现
+
+## Option 选项完整列表
 
 | Option | 类型 | 默认值 | 说明 |
 |--------|------|--------|------|
-| `AppType` | AppType | `Client` | 应用角色 |
+| `AppType` | AppType | Client | 应用角色 |
 | `MaxConcurrency` | int | 3 | 并行下载数 |
-| `PatchEnabled` | bool | `false` | 启用差分（需Differential包） |
-| `BackupEnabled` | bool | `false`（v5+） | 更新前备份 |
-| `Silent` | bool | `false` | 静默后台轮询 |
-| `SilentPollIntervalMinutes` | int | 60 | 静默轮询间隔 |
-| `Format` | CompressionFormat | `Zip` | 压缩格式 |
-| `Encoding` | CompressionEncoding | `Default` | 压缩编码 |
-| `DownloadTimeout` | int | 60 | 下载超时(秒) |
-| `HooksEnabled` | bool | `true` | 启用生命周期Hooks |
-| `EnableResume` | bool | `true` | 断点续传 |
+| `PatchEnabled` | bool | false | 启用差分更新（需安装 Differential 包） |
+| `BackupEnabled` | bool | false (v5+) | 更新前备份 |
+| `Silent` | bool | false | 静默后台轮询 |
+| `SilentPollIntervalMinutes` | int | 60 | 静默轮询间隔（分钟） |
+| `Format` | CompressionFormat | Zip | 压缩格式 |
+| `Encoding` | CompressionEncoding | Default | 压缩编码 |
+| `DownloadTimeout` | int | 60 | HTTP 下载超时（秒） |
+| `MaxRetryCount` | int | 3 | 下载重试次数 |
+| `EnableResume` | bool | true | 断点续传 |
+| `VerifyChecksum` | bool | true | 下载后 SHA256 校验 |
+| `AutoCleanTemp` | bool | false | 自动清理临时目录 |
+| `HooksEnabled` | bool | true | 启用生命周期 Hooks |
 
 ## 后端 API 协议
 
-### 版本验证接口
+### 版本验证
 
 ```
-POST {UpdateUrl}/Upgrade/Verification
+POST {UpdateUrl}
 Content-Type: application/json
 
 {
@@ -66,52 +70,87 @@ Content-Type: application/json
 }
 ```
 
-### 成功响应
-
+成功响应：
 ```json
 {
+  "code": 200,
+  "message": "",
   "body": [
     {
       "id": "guid",
       "version": "1.1.0.0",
       "url": "https://storage/packages/v1.1.0.0.zip",
       "hash": "sha256-hex",
       "size": 1048576,
-      "name": "update-v1.1.0.0.zip",
+      "name": "update.zip",
       "appType": 0,
       "isCrossVersion": false,
       "fromVersion": null,
       "isForcibly": false,
       "publishDate": "2026-01-01T00:00:00Z",
-      "description": "更新说明"
+      "description": "修复了若干 Bug"
     }
-  ],
-  "code": 200,
-  "message": ""
+  ]
 }
 ```
 
-### 状态上报接口
+### 状态上报
 
 ```
 POST {ReportUrl}
 Content-Type: application/json
 
 {
-  "recordId": "upgrade-record-guid",
-  "type": 1,        // 1=主动拉取, 2=服务端推送
-  "status": 0,      // 0=更新中, 1=成功, 2=失败
-  "message": ""
+  "recordId": "升级记录 ID",
+  "type": 1,
+  "status": 0,
+  "message": "更新成功"
 }
 ```
 
-## 支持的 UI 框架
+## appsettings.json 模板
+
+```json
+{
+  "GeneralUpdate": {
+    "UpdateUrl": "https://your-server.com/Upgrade/Verification",
+    "ReportUrl": "https://your-server.com/Upgrade/Report",
+    "AppSecretKey": "your-secret-key-here",
+    "InstallPath": "",
+    "UpdatePath": "update",
+    "ClientVersion": "1.0.0.0",
+    "UpgradeClientVersion": "1.0.0.0",
+    "MainAppName": "MyApp.exe",
+    "UpdateAppName": "UpgradeApp.exe",
+    "ProductId": "my-product-001",
+    "MaxConcurrency": 3,
+    "PatchEnabled": false,
+    "BackupEnabled": true,
+    "DownloadTimeout": 60
+  }
+}
+```
 
-| 框架 | 技术栈 | UI技能支持 |
-|------|--------|-----------|
-| WPF + LayUI.Wpf | .NET 6+ / .NET 8 | ✅ 生成LayUI风格更新窗口 |
-| WPF + WPFDevelopers | .NET 8 | ✅ 生成WPFDevelopers风格 |
-| WinForms + AntdUI | .NET 9+ Windows | ✅ 生成AntdUI风格(暗黑模式+本地化) |
-| Avalonia + Semi.Ursa | .NET 8 | ✅ 生成SemiUrsa风格(Client+Upgrade双视图) |
-| .NET MAUI | .NET 10+ Android | ✅ 生成MAUI更新页面 |
-| 原生WPF/WinForms | 任何版本 | ✅ 生成通用更新窗口 |
+## 框架兼容性矩阵
+
+| 框架 | 最低版本 | AOT 兼容 | SignalR 支持 |
+|------|---------|---------|------------|
+| WPF (.NET Framework) | .NET 8 | ✅ | ✅ (JSON协议) |
+| WPF (.NET Core) | .NET 8 | ✅ | ✅ |
+| WinForms | .NET 8 | ✅ | ✅ |
+| Avalonia | .NET 8 | ✅ | ✅ |
+| MAUI | .NET 10 | ✅ | ❌ (无 SignalR) |
+| 控制台 | .NET 8 | ✅ | ✅ |
+| Linux 桌面 | .NET 8 | ✅ | ❌ |
+| macOS 桌面 | .NET 8 | ✅ | ❌ |
+
+## 常见问题快速链接
+
+| 问题 | 参考文件 |
+|------|---------|
+| "Method not found" NuGet 版本冲突 | `/generalupdate-troubleshoot` Q2 |
+| 静默模式不生效 | `/generalupdate-troubleshoot` Q7 |
+| 版本号更新后错误 | `/generalupdate-troubleshoot` Q13 |
+| Linux 下无权限 | `/generalupdate-troubleshoot` Q17 |
+| 升级进程没启动 | `/generalupdate-troubleshoot` Q1 |
+| IPC 加密文件问题 | `/generalupdate-troubleshoot` Q5 |