fix: align .clinerules and .cursor/rules with v10.4.6 stable API

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

Author: JusterZhu

.clinerules/01-generalupdate-init.md

@@ -4,12 +4,20 @@ globs: ["**/*.cs", "**/*.csproj", "**/*.json"]
 tags: ["dotnet", "update", "generalupdate"]
 ---
 
-# GeneralUpdate 快速集成
+# GeneralUpdate 快速集成 (v10.4.6 稳定版 API)
 
-## NuGet: GeneralUpdate.Core(必需), Differential(可选), Bowl(可选)
+## NuGet: GeneralUpdate.Core(必需), Bowl(可选, 与Core互斥), Differential(嵌入Core无需额外引用)
 
 ## 最小集成
-SetSource(url, key) -> SetOption(AppType.Client) -> LaunchAsync()
+```csharp
+new Configinfo { ... }.SetConfig().LaunchAsync()
+```
+
+## 核心 API（非 dev 分支的 SetSource/SetOption）
+- Configinfo 属性: UpdateUrl, AppSecretKey, InstallPath, ClientVersion, MainAppName, UpdateAppName, ProductId
+- AppType 是 class（非 enum），`AppType.ClientApp = 1`, `AppType.UpgradeApp = 2`
+- `LaunchAsync()` 返回 `Task<GeneralUpdateBootstrap>`（非 `Task<bool>`）
+- ❌ 无 `SetSource()`, `SetOption()`, `Hooks<T>()`, `Strategy<T>()`, `SilentOrchestrator`
 
 ## 4 大场景: None/UpgradeOnly/MainOnly/Both
 
@@ -18,4 +26,4 @@ MainAppName, UpdateAppName, ProductId, InstallPath, UpdatePath, ClientVersion, U
 
 ## 关键: UpgradeApp须随首个版本发布, 双进程AppSecretKey一致, 版本4段式
 
-## AppType枚举: Client=1, Upgrade=2, OssClient=3, OssUpgrade=4
+## Bowl 引用规则: 只用 `GeneralUpdate.Bowl`（传递依赖 Core，两者不能同时引用）

.clinerules/03-generalupdate-strategy.md

@@ -36,6 +36,6 @@ tags: ["dotnet", "generalupdate"]
 | Platform | Notes |
 |----------|-------|
 | **Windows** | Uses **Bowl** crash daemon (restarts the app bus on unhandled exception). Full file-system access. |
-| **Linux / macOS** | Uses **UnixPermissionHooks** to handle `chmod +x` / setuid and OS-level permission elevation. |
+| **Linux / macOS** | ⚠️ v10.4.6 无 `UnixPermissionHooks`，需手动 `chmod +x`。目标框架建议 .NET 8+。 |
 
 > For the full Bootstrap pipeline and middleware architecture, see `01-generalupdate-init.md`.

.clinerules/04-generalupdate-advanced.md

@@ -4,12 +4,19 @@ globs: ["**/*.cs"]
 tags: ["dotnet", "generalupdate", "advanced"]
 ---
 
-# 高级定制
+# 高级定制 (v10.4.6 注意事项 ⚠️)
 
-## 扩展点: Hooks/Strategy/UpdateReporter/DownloadSource/DownloadOrchestrator/DownloadPolicy/DownloadExecutor/DownloadPipeline/SslValidationPolicy/HttpAuthProvider
+## ⚠️ v10.4.6 稳定版无以下扩展点
+- ❌ 无 `IUpdateHooks` / `IStrategy` / `IProcessInfoProvider`
+- ❌ 无 `SetOption` / `SilentPollOrchestrator` / `ProcessContract`
+- ❌ 无可编程 Option 配置系统（仅 Configinfo 属性）
 
-## IPC: EncryptedFile(默认)/NamedPipe/SharedMemory/AutoFallback
+## IPC: 仅 EncryptedFile（默认，AES加密文件），无可替换 IPC 接口
+- ❌ 无 NamedPipe / SharedMemory / AutoFallback 接口替换能力
 
-## Bowl: procdump->监控->dump->故障报告->AutoRestore
+## Bowl: procdump->监控->dump->故障报告->AutoRestore（可用，属于独立模块）
+- Bowl 引用规则：只用 `GeneralUpdate.Bowl`，不额外引用 Core
 
-## AOT: v5.0+支持, SignalR用JSON+JsonSerializerContext
+## AOT: v10.4.6 支持 NativeAOT，SignalR 推荐 JSON + JsonSerializerContext
+
+> ⚠️ 以上扩展点仅在 dev 分支（v10.5.0-beta.2）存在。**模板和示例均已针对 v10.4.6 稳定版编写。**

.cursor/rules/generalupdate-advanced.mdc

@@ -4,16 +4,19 @@ globs: ["**/*.cs", "**/*.csproj"]
 alwaysApply: false
 ---
 
-# GeneralUpdate 高级定制
+# GeneralUpdate 高级定制 (v10.4.6 ⚠️)
 
-## 10+ 扩展点
-Hooks, Strategy, UpdateReporter, DownloadSource, DownloadOrchestrator, DownloadPolicy, DownloadExecutor, DownloadPipeline, SslValidationPolicy, HttpAuthProvider
+## ⚠️ v10.4.6 稳定版不支持以下扩展点
+- ❌ 无 Hooks / Strategy / UpdateReporter / DownloadOrchestrator / IHttpAuthProvider
+- ❌ 无 SetOption / SilentPollOrchestrator / ProcessContract
 
-## 4 种 IPC
-EncryptedFile(默认), NamedPipe, SharedMemory, AutoFallback
+## IPC
+- ✅ EncryptedFile（默认，AES加密文件）
+- ❌ 无可替换 IPC 接口（NamedPipe/SharedMemory/AutoFallback 不可用）
 
-## Bowl 崩溃守护
+## Bowl 崩溃守护（可用，独立模块）
 Phase1: procdump准备 -> Phase2: 监控 -> Phase3: 检查dump -> Phase4: MiniDump+故障报告+系统诊断+AutoRestore+OnCrash
+Bowl 引用规则：只用 `GeneralUpdate.Bowl`（传递依赖 Core）
 
 ## AOT/Trim
-v5.0+ 支持。SignalR用JSON协议+JsonSerializerContext
+v5.0+ 支持。SignalR 推荐用 JSON 协议 + JsonSerializerContext

.cursor/rules/generalupdate-init.mdc

@@ -4,15 +4,18 @@ globs: ["**/*.cs", "**/*.csproj", "**/*.json"]
 alwaysApply: false
 ---
 
-# GeneralUpdate 快速集成
+# GeneralUpdate 快速集成 (v10.4.6 稳定版 API)
 
 ## NuGet
-- `GeneralUpdate.Core` — 必需。Bootstrap/策略/下载/IPC/事件
-- `GeneralUpdate.Differential` — 可选。差分更新
-- `GeneralUpdate.Bowl` — 可选。崩溃守护
+- `GeneralUpdate.Core` — 必需
+- `GeneralUpdate.Bowl` — 可选（只用 Bowl，不额外引用 Core，两者互斥）
+- ~~`GeneralUpdate.Differential`~~ — 已嵌入 Core，无需额外引用
 
-## 最小集成
-SetSource(url, key) -> SetOption(AppType.Client) -> LaunchAsync()
+## 最小集成 (v10.4.6)
+```csharp
+new Configinfo { ... }.SetConfig().LaunchAsync()
+```
+❌ 无 SetSource() / SetOption() — 仅 Configinfo 属性
 
 ## 4 大更新场景
 - None, UpgradeOnly, MainOnly, Both
@@ -25,12 +28,10 @@ MainAppName, UpdateAppName, ProductId, InstallPath, UpdatePath, ClientVersion, U
 - Client 和 Upgrade 必须相同 AppSecretKey
 - 版本号必须是 4 段式
 - manifest ClientVersion 不能为空
-- AppType 枚举：Client=1, Upgrade=2, OssClient=3, OssUpgrade=4
+- AppType 是 **class**（非 enum）：`AppType.ClientApp = 1`, `AppType.UpgradeApp = 2`
+- ❌ 无 OssClient/OssUpgrade
 
-## 3 种配置方式
-- Minimal: SetSource + manifest.json
-- Standard: SetConfig(UpdateRequest) + Option + events
-- appsettings: LoadFromConfiguration(config)
-
-## 5 种 HTTP 认证
-HMAC(默认), Basic, Bearer, APIKey, 自定义(IHttpAuthProvider)
+## 配置方式 (v10.4.6)
+- Configinfo 属性直接设置 + SetConfig()
+- appsettings.json 注入（参考模板）
+- ❌ 无 Option 配置系统

.cursor/rules/generalupdate-strategy.mdc

@@ -25,4 +25,4 @@ alwaysApply: false
 
 ## 平台差异
 Windows: Hash->解压->Patch+Bowl+Drivelution
-Linux/macOS: Hash->解压->Patch(无Bowl,需UnixPermissionHooks)
+Linux/macOS: Hash->解压->Patch（⚠️ v10.4.6 无 UnixPermissionHooks，需手动 chmod +x）