Skip to content

feat(plugin): 官方核心插件首次安装引导与安装流程防护 - #169

Merged
SoftBlack42 merged 7 commits into
mainfrom
feat/official-plugins-onboarding
Sep 25, 2026
Merged

SoftBlack42 merged 7 commits into
mainfrom
feat/official-plugins-onboarding

Conversation

@SoftBlack42

Copy link
Copy Markdown
Collaborator

变更概述

实现 StarPie 5 项官方核心内置插件(weburl, launch, shelltool, system, folder)的首次启动一次性交互式引导与安装流程防护。

核心设计与保障

  1. 五项基础插件须用户同意后才下载:

    • 严格遵循知情同意原则,在用户明确点击同意/安装之前,不发起任何后台目录拉取或插件下载请求。
    • 弹窗展示核心插件清单、内置权限说明、官方仓库安全提示及 SHA-256 校验说明。
  2. 已安装或用户禁用的插件保持原状:

    • 状态精确区分:已启用、已安装但未启用(或启用失败)、已安装但被用户主动禁用、未安装。
    • 用户主动禁用的插件严格保留禁用状态,不强制或误将其激活。
    • 对“已安装但本次启用失败”的插件走本地直接重试启用逻辑,不依赖网络,不重复下载覆盖或升级已有插件;缺失插件走下载安装流程。
    • 只有在弹窗实际向用户完成视觉呈现(OnContentRendered)且用户进行交互/关闭后才消耗首次提示;构造失败、渲染前退出绝不消耗提示。
  3. 本地自动检查结果:

    • dotnet build .\WinPieGestures\WinPieGestures.csproj -c Release --nologo:0 警告,0 错误。
    • powershell -NoProfile -ExecutionPolicy Bypass -File .\scratch\test_onboarding.ps1:18 个场景全部通过(148 Tests Passed / 0 Failed)。
    • python .\scratch\check_i18n.py --since origin/main:55 个新增引导词条在 4 语系(zh-CN, zh-TW, en, ja)中完整定义且占位符一致,全局检查全部通过。
    • git diff --check origin/main...HEAD:格式检查干净,无空白与冲突标记异常。
  4. 实机验收状态:

    • 用户已完成实机验收。

@SoftBlack42
SoftBlack42 merged commit acaf629 into main Sep 25, 2026
1 check passed
@ztzpro
ztzpro deleted the feat/official-plugins-onboarding branch September 27, 2026 20:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant