插件市场

服务职责

PluginMarketService 负责插件市场索引加载、README 加载、GitHub 镜像解析、下载队列、下载取消、SHA-256 校验和解压结果交付。实际安装逻辑在 PluginPageViewModel.Market.cs 中消费下载完成结果后执行。

默认市场索引：

https://bpsys-plugin-index.plfjy.top/

插件市场页当前定义两个预设源：默认站点和 GitHub raw PluginIndex.json。页面把选中的值保存到 Settings.PluginMarketSource；服务层读取该设置，若为空则回退到内置默认源。服务层本身不关心来源是否来自预设列表，只把它当作插件市场索引 URL 使用。

市场条目

市场索引反序列化为 Dictionary<string, PluginMarketItem>。服务会补齐空字段，并解析：

字段	处理
Icon	解析为 ResolvedIconUrl
Readme	解析为 ResolvedReadmeUrl
DownloadUrl	解析为 ResolvedDownloadUrl
Sha256	下载完成后用于校验

README 加载后会重写相对链接和相对图片地址，避免 WPF Markdown 控件打开相对路径失败。

GitHub 镜像

只有中文环境下才会对 GitHub/GitHubusercontent 地址应用镜像。判断依据是 Settings.CultureInfo.Name 是否以 zh 开头。

镜像优先使用 Settings.GhProxyMirror，失败后尝试 DownloadMirrorPresets.GhProxyMirrorList 中的其他候选。每个镜像会先用 4 秒超时探测可用性，成功后缓存。

非 GitHub 地址或非中文环境下直接使用原地址。

下载队列

下载请求会进入 _pendingDownloads，UI 看到的是只读 DownloadQueue。服务一次处理一个任务，状态通过 DownloadStateChanged 通知页面刷新。

支持：

功能	说明
队列去重	当前下载和等待队列中已有同 ID 插件时拒绝重复入队
当前任务暂停/继续	PauseDownload() / ResumeDownload()
指定任务暂停/继续	PauseDownload(queueId) / ResumeDownload(queueId)；只对当前传输项生效
当前任务取消	CancelDownload()
指定任务取消	CancelDownload(queueId)
进度/速度	来自 IFileDownloadOperation.StateChanged 的进度快照
完成消费	ConsumeCompletedDownload() 返回解压目录

下载过程使用稳定缓存路径保存可续传分片，并用独立会话目录承载解压结果：

%TEMP%\neo-bpsys-wpf\PluginMarket\Downloads\{requestHash}\package.archive.download.part
%TEMP%\neo-bpsys-wpf\PluginMarket\Sessions\{pluginId}\{queueId}\extract

取消或瞬时失败只清理解压会话，保留下载分片和来源元数据；重新提交相同插件版本与下载契约时会从已有字节继续。

SHA-256 校验

如果市场条目提供 Sha256，服务会在解压前计算下载 zip 的 SHA-256 并比较。比较前会去掉连字符并转小写。校验失败会中止流程并清理下载会话目录。

这保证“下载的包与市场声明一致”，但不等于插件是安全沙箱。插件仍是全信任代码。

安装消费

下载完成后，PluginPageViewModel 会：

1. 通过 ConsumeCompletedDownload() 取出解压目录。
2. 检查 manifest.yml。
3. 解析 manifest 并做 API 兼容性检查。
4. 如果插件已存在，移动到 Plugins\.new\{id}，标记重启后更新。
5. 如果是新插件，移动到 Plugins\{id}，加入页面集合并标记需要重启。
6. 清理临时目录。

市场能提供索引、下载和哈希校验；它不提供运行时隔离，也不保证插件没有逻辑风险。

与 .bpui 布局包的关系

起，.bpui v3 导入发现缺失插件控件或插件版本低于依赖 MinVersion 时，FrontManagePage 会按插件 PackageId 聚合依赖并查询插件市场索引。UI 会展示缺失 / 需更新插件、最低版本、已安装版本、受影响控件和市场可用状态，并让用户显式选择：

1. 从插件市场安装或更新可用插件。
2. 继续导入并保留缺失或不满足版本的插件窗口布局 / 控件配置。
3. 取消导入。

安装 / 更新仍复用插件市场下载队列：市场条目的下载地址解析、GitHub 镜像、SHA-256 校验和解压流程仍由 PluginMarketService 负责；已解压插件包的 manifest 校验、API 兼容性检查和 .new 暂存更新由共用安装服务处理。布局导入不会静默安装插件，也不会在安装后把插件当作当前进程已加载继续导入；当前插件系统需要重启，用户可重启后重新导入，也可先继续导入并保留缺失插件配置，等插件可用后恢复完整渲染。

.bpui 包不得包含插件 DLL、插件 zip、安装包或可执行脚本。布局包只保存 Canvas RequiredPlugins 和 manifest PluginDependencies 这样的依赖元数据，插件安装仍必须走插件系统 / 插件市场流程并要求用户确认。起，导入器会直接拒绝包含 Plugins/、Plugin/、.dll、.exe、.msi、.ps1、.bat、.cmd、.sh、.vbs、.js 或 .jar 的 .bpui。