docs: 跨平台架构文档、共享库审计报告与 Android CI 构建

docs/cross-platform-shared-audit.md

@@ -0,0 +1,55 @@
+# 共享库跨平台依赖审计报告
+
+> 审计目标：确认以下共享库可被 Android head（net10.0-android）安全引用。
+> 审计方法：源码级扫描 `DllImport`/`LibraryImport`/`Microsoft.Win32`/`System.Drawing`/`WindowsRuntime`/`System.Management` + csproj 包引用检查。
+
+## 结论总览
+
+| 项目 | 状态 | 说明 |
+|---|---|---|
+| LanMountainDesktop.Shared.Contracts | ✅ 干净 | 仅引用 Avalonia，无平台 API |
+| LanMountainDesktop.Shared.IPC | ⚠️ 可编译，运行时受限 | 依赖 dotnetCampus.Ipc（命名管道）。Android 上可编译但命名管道不可用，移动端必须走进程内传输 |
+| LanMountainDesktop.Settings.Core | ✅ 干净 | 无包引用，纯托管 |
+| LanMountainDesktop.Appearance | ✅ 干净 | 无包引用，纯托管 |
+| LanMountainDesktop.DesktopComponents.Runtime | ✅ 干净 | 无包引用，纯托管 |
+| LanMountainDesktop.PluginSdk | ⚠️ 需验证 | 引用 FluentAvaloniaUI / FluentIcons.Avalonia（ExcludeAssets=runtime，仅编译期）与 dotnetCampus.Ipc；Android 引用时需实测还原 |
+| LanMountainDesktop.Host.Abstractions | ✅ 干净 | 无包引用 |
+
+## 详细发现
+
+### 1. 源码扫描
+
+7 个项目的 `.cs` 源码中均未发现：
+- `DllImport` / `LibraryImport`（P/Invoke）
+- `Microsoft.Win32`（注册表）
+- `System.Drawing`
+- `System.Runtime.WindowsRuntime`
+- `System.Management`
+
+平台专属代码全部集中在主工程 `LanMountainDesktop\`（9 个服务文件，正在迁往
+`LanMountainDesktop.Platform.Windows`）。
+
+### 2. dotnetCampus.Ipc（Shared.IPC、PluginSdk）
+
+- 编译期：跨平台 net 库，Android 目标可编译。
+- 运行期：传输基于命名管道，Android 不可用。
+- 处置：移动端一律使用 PluginIsolation 的进程内传输（InProc transport）；
+  Shared.IPC 在移动端应仅作为契约/类型来源，不建立管道连接。
+- 后续（可选）：若希望编译期硬隔离，可把"管道传输"从 Shared.IPC 拆到
+  Shared.IPC.Pipes 子项目，移动端不引用。当前不阻塞。
+
+### 3. FluentAvaloniaUI / FluentIcons.Avalonia（PluginSdk）
+
+- `ExcludeAssets="runtime"`，仅编译期类型引用。
+- 两者均为纯托管 Avalonia 库，预期可在 Android 还原；由 Mobile head 构建实测确认。
+
+### 4. 面向未来移动 AOT 的裁剪风险（仅报告，不修复）
+
+- 主工程使用 YamlDotNet、反射式配置读取——不在本次 7 个共享库范围内，
+  但如后续把相关逻辑下沉共享层，需加 `DynamicallyAccessedMembers` 注解或源生成序列化。
+- Settings.Core 若存在基于 `Activator.CreateInstance` 的设置实例化路径，
+  迁移到移动端 AOT（未来 iOS）前需要审计；Android（JIT/interp 可用）不阻塞。
+
+## 修复记录
+
+本次审计未发现需要修改共享库源码的问题，未做代码改动。