MyAvaloniaManagement.PluginSdk.UI 3.4.1

MyAvaloniaManagement Plugin SDK UI

V6.1 / SDK 3.4.0 新增 IPluginIconRegistration 可选能力与 registration.AddIcon(...) 扩展， 原 IPluginRegistration 接口保持不变。VectorIconDefinition 只包含不可变路径、画布宽高和 IconFillRule；字段校验不依赖 Avalonia 初始化，Host 在 UI 绘制时解析几何。

var reference = registration.AddIcon("review", new VectorIconDefinition(
    "M1,1 H19 V19 H1 Z M4,4 V16 H16 V4 Z", 20, 20));
// 将 reference 用作 DocumentDescriptor 的 iconPath。

只提供规范小写本地名称，Host 生成 plugin:<真实 PluginId>/<本地名称>。同插件重复拒绝， 不同插件同名可共存；注册与其他贡献一起原子提交并在模块返回后封闭。 调用新契约需要 Host/SDK 3.4.0，旧 Host 的注册替身缺少能力时明确抛出 NotSupportedException。 坏几何在 UI 阶段回退默认图标，不影响文档创建；引用归属与可用性由 Host 使用真实贡献快照校验。

公共资源由独立的 MyAvaloniaManagement.Icons 3.4.1 提供，本 UI SDK 不反向依赖资源包。 插件可以复制公共资源的路径及宽高注册专属引用，也可直接用 Host 已知的 builtin:* 名称。 资源包作为普通私有依赖部署，使用同版本 Build 3.4.1 和 ManagedPluginPrivatePackage 声明； 不能将资源包加入共享程序集清单，也不能跨边界传递它的 CommonIconAsset 对象。

本包是 Managed Plugin 的 UI 契约程序集，提供模块入口、插件私有 DI 注册、不可变 Document/Tool 描述符、Avalonia View 绑定、窗口交互端口和全屏展示端口。

本包依赖同版本 Core SDK，并把 Avalonia、Fluent、Semi 和 Ursa 限制为 Host 验证的版本。 Dock 与 Newtonsoft 不属于插件 UI 契约，插件不得通过本包取得或携带这些程序集。

当前仓库已完成 V3 G14 封板。Host 生产模块入口和声明式贡献目录使用本程序集，注册时一次绑定 Descriptor、 模型与 View，Document 为 scoped，Tool/Lifecycle 为插件 singleton。模块返回后注册入口及私有服务集合 均被封闭；Registry 只保存不可变事实，模型创建留在 Host internal Activator。G4 进一步规定模块进入时 Services 为空，插件只登记私有服务和贡献声明；Seal 校验 ID 归属与保留类型后，Host 才最终追加 IPluginWindowInteraction、IDocumentLifetime、Scope 基础设施和固定生命周期贡献根。插件内部消息器由 插件自己登记并归其 Provider 所有，Host 不再提交或转发通用事件总线。 普通及 keyed 影子注册均在 Provider 构建前隔离当前插件；私有开放泛型、keyed 与多实现仍保持原生语义。 Document 通过 Core SDK 的 DocumentActivation、NewDocumentActivation、RestoreDocumentActivation、 DocumentContent、IPluginDocument、 IPersistablePluginDocument 与 IDocumentLifetime 进入唯一异步创建和持久化链。

V2 已完成生命周期编排及四插件迁移；V3 G2–G7 又完成修订保存、互斥激活、注册所有权、插件私有消息、 Workspace/Dock 和 Host/插件目录边界。IPluginWindowInteraction 由 Host 以同一受控实例注入每个插件私有 Provider： 它只返回本地路径或操作结果，不向插件暴露主窗口、StorageProvider 或剪贴板实现。 原生选择器返回后会再次检查取消令牌，以丢弃 Document 关闭期间的迟到结果。

V3 G8 由同一 UI SDK 的 IWindowContentFullscreenHost 承载 MySmallTools 全屏交互，唯一 public 方法为 IDisposable? TryPresent(Control content)。成功租约排他且幂等，Host 自动失效后再次释放为无操作； 插件不取得 Window、Dock、owner 或 TryRestore。既有 UI SDK 45 条签名仍在 v3 Shipped；SDK Workflow Action 以 6 条 UI v3 Unshipped 新增独立 IWorkflowActionRegistration 和朴素扩展方法。Provider 只用 AddWorkflowAction<THandler> 声明 scoped Handler，Consumer 只用 UseWorkflowActionGateway 声明身份； 同一插件不能兼任两者。V3 G9–G12 只用既有声明和 Host internal Workspace/Dock Adapter 验证四插件，G13 又以真实 nupkg 负例证明旧 owner API 不可消费；G14 未增加公共类型、接口或成员，只完成 API 分类和两轮隔离签署。v2 Shipped 继续保存 V2 G14 历史承诺。

Workbench Command G1 继续使用同一兼容模式：IPluginRegistration 原有四个方法不变，新的 IWorkbenchCommandRegistration 由 Host internal 注册对象可选实现。插件通过扩展方法声明 CommandDescriptor、目标 Document、菜单共享末端位置和 Avalonia Key/KeyModifiers；Descriptor 与 Registry 都不保存 Target、Provider、Control、MenuItem、KeyBinding、ICommand 或回调。G2 已在 Host internal 建立无 UI 合并 Catalog 和 Executor；G3–G5 已完成活动 Document Target 路由、Host 打开/保存迁移，以及 Host-owned Menu/KeyBinding Projection。该阶段候选版本为 3.3.0，public API 保持 v3 Shipped 127/45、 Unshipped 91/66；G6 使用真实 nupkg、模板生成项目和独立 ALC 验证外部传播。G9 的最小 Palette 完全位于 Host internal Presentation 层，没有增加 UI SDK public API。

推荐通过解决方案模板开始外部插件开发：

dotnet new install MyAvaloniaManagement.Plugin.Templates@3.4.1
dotnet new myavalonia-plugin -n ExamplePlugin --plugin-id myavalonia.plugin.example

Templates 3.4.1 把三个生成项目精确锁定到 Core/UI SDK、Icons 与 Build 3.4.1， Avalonia.Desktop 为 12.1.2。模板生成中性的 Document 与单次执行 Command 示例，不注册默认快捷键； Provider、Consumer 与 Command Target 的设计边界见生成文档。