Skip to content

💄 优化更新页权限变化的展示,修复安装页底部回弹空白 - #1847

Merged
CodFrm merged 3 commits into
mainfrom
fix/install-update-ui
Nov 12, 2026
Merged

CodFrm merged 3 commits into
mainfrom
fix/install-update-ui

Conversation

@CodFrm

@CodFrm CodFrm commented Nov 10, 2026 •

Copy link
Copy Markdown
Member

Checklist / 检查清单

  • Fixes mentioned issues / 修复已提及的问题
  • Code reviewed by human / 代码通过人工检查
  • Changes tested / 已完成测试

N/A — 没有关联 issue,问题来自维护者在更新页上的直接反馈。

Description / 描述

背景

脚本更新页的「权限变化」卡有几处读起来吃力:

  • 被移除的 @require 原样显示 URL 编码,折成三行,成了整张卡最显眼的东西。
  • 行头「1 +1 −1」三个数挨在一起,读着像一串算式。
  • 新增的条目只是字加粗,和没变的条目差别很小。
  • 很多脚本每次发版只改 @require …?v=版本号,于是每次更新都冒出一对 +1 −1。

另外,在 macOS 上用触控板滚到底后继续滚,整页回弹,吸底栏下面会露出一截页面底色。

本次改动

三个提交,可以分开审:

💄 优化更新页权限变化的展示

  • 地址类取值(@match/@require/@resource)解码后单行显示:域名突出,中间路径先省略,文件名和参数保留;悬停看原文,点击展开完整地址。全新安装页也用这套显示。
  • 只换了查询参数的外部资源:去掉 ? 之后地址(含 @resource 资源名)完全相同、且两边各只有一条时,合并为一条「~ … ?v旧 → 新」,卡头计「更新 N」,不算新增也不算移除。一边有多条时不猜配对,照常按增删显示。
  • 新增条目:危险(@connect *)和敏感(GM_cookie)的新增继续用风险色,不被新增色盖掉(配色规则见第三个提交)。
  • 截断:新增、移除各最多显示 8 条,其余收进「再显示 N 项新增/已移除」;危险、敏感、不生效的取值永远不收起。
  • 行头/卡头:更新态行头只给变动数,去掉和「未变动 N 项」重复的总数徽章;卡头写「新增 N · 移除 M」和「旧版本 → 新版本」(读屏另有完整句子),移动端版本号单独一行。

💄 权限变化的颜色只留给风险,移除与计数改为中性色

  • 原先移除用红色,和危险的 @connect * 同色,读者分不清「这条被删了」和「这条很危险」,而移除权限其实是好事;同一张卡里还叠着新增绿框、更新蓝框和蓝色折叠按钮。
  • 现在色相只表达风险:红/琥珀只出现在危险、敏感取值上(敏感项和危险项一样改用风险浅底)。变动靠对比度与记号区分:普通新增是实心中性 chip,只留绿色 +;移除退为无框灰色删除线;更新 chip、行头 +N −M ~K、卡头「新增 N · 移除 M」、「未变动 N 项 / +N」按钮都改为中性色。

🐛 修复安装页滚到底后继续滚动会露出底部空白

  • 安装页滚动全在正文容器里,滚到底后滚动会传到根文档,触控板随之整页回弹。给 install.html 的根元素加了 overscroll-behavior: none。

实现考虑

  • 解码只用 decodeURI:它不解码 %2F、%3F 这类保留字符,不会凭空造出路径分隔或查询参数;域名在解码前就切出来。解码结果含控制字符或双向格式字符(如 U+202E)时退回原文,防止伪装文件名;% 序列不完整时也显示原文。
  • @require 默认的 https:// 不显示以省空间,http:// 等其他协议照常显示,明文加载值得被看见。
  • 危险行里的普通条目跟着标红是现有行为,这次没改。

建议审查重点

  • src/pages/install/url_display.ts:URL 切分和解码的安全边界。
  • src/pages/install/permissions.ts 的 pairQueryOnlyUpdates:合并条件是否足够保守。
  • PermissionRow.tsx 的 Chip:新增条目在危险、敏感、普通三种情况下的配色优先级;红色是否只剩风险取值。

已知限制

  • 触控板回弹无法在无头浏览器里复现,只确认了 overscroll-behavior: none 已在 html、body 上生效,回弹不再出现需要在 macOS 上人工确认。
  • 选项页等其他页面可能也有同样的回弹,不在本 PR 范围内。

验证

  • 本 PR 的 diff:base 598cab8e(origin/main)…head 8d351198,22 个文件(`git diff --stat origin/main...HEAD`)。
  • pnpm exec vitest run --no-coverage 跑 install 页的 6 个相关测试文件(permissions、url_display、PermissionRow、PermissionCard、App、useInstallData):188 条通过。新增的测试都先确认过会失败(含第三个提交的两条配色用例)。
  • pnpm run typecheck、eslint src/pages/install、prettier --check、pnpm run check:i18n 均通过。
  • 原有的不稳定用例:一次跑整个 src/pages/install 目录时,有 2~4 条随机失败(移动端 Accordion 两条、webRequestBlocking 一条、compat_docs 两条)。在 origin/main 上不带本次改动跑同样的命令,三次都复现了同一批失败;单独跑对应文件均通过,看起来是用例之间的状态泄漏,未在本 PR 处理。第三个提交后再跑整个目录,只有 webRequestBlocking 那一条失败,单独跑该文件 5/5 通过。
  • 真实扩展:用 pnpm run build 构建后,通过 e2e/session.mjs 渲染了三个更新场景:GitHub 中文化插件 1.9.2.4 → 1.9.4.4、新增 @connect */GM_cookie、新增 30 条 @match 加查询参数合并。桌面亮/暗色和 390 宽移动端亮/暗色都截了图,点击展开地址可用。第三个提交后按同样三个场景重新构建、重新截图(下方截图均为 8d351198)。

Screenshots / 截图

改动前(GitHub 中文化插件 1.9.2.4 → 1.9.4.4,暗色)

改动前

改动后:同一次更新,暗色 / 亮色。移除是灰色删除线,计数和折叠按钮都是中性色

改动后 暗色 改动后 亮色

新增危险 / 敏感项:只有 @connect *、GM_cookie 带颜色,被移除的 old.example.com 是灰色

危险与敏感项新增

新增 30 条 @match 截断到 8 条,@require 只改了 ?v= 合并为一条更新

截断与查询参数合并

点击展开完整地址(被移除的 greasyfork 地址)

点击展开完整地址

移动端 390 宽:暗色 / 亮色 / 截断与合并

移动端

- 地址类取值(@match/@require/@resource)解码后单行展示:域名突出,中段路径优先省略,
  文件名与参数保留,悬停看原文、点击展开完整地址;解码出不可见/双向控制字符时退回原文
- @require/@resource 只换了查询参数(如 ?v=版本号)且能一一对应时合并为一条「更新」,
  不再每次发版都冒出一对增删
- 普通新增用新增色描边与记号;危险/敏感项的新增继续使用风险色,不被新增色盖掉;
  移除改为虚线框 + 删除线
- 新增、移除各最多显示 8 条,其余收进「再显示 N 项」;危险、敏感、不生效取值永不收起
- 更新态行头只给变动数,去掉与「未变动 N 项」重复的总数徽章;卡头写「新增 N · 移除 M」
  与「旧版本 → 新版本」,移动端版本号另起一行
页面滚动全在正文容器里,滚到底后的滚动会链到根文档,macOS 触控板随之整页回弹,在吸底栏下露出一截页面底色。根元素禁用 overscroll 回弹。
移除权限本是好事,却和危险的 @connect * 同用红色,读者分不清哪条该警觉;
同一张卡里还叠着新增绿框、更新蓝框和蓝色折叠按钮。改为色相只表达风险:
移除退为灰色删除线,更新、行头/卡头计数、折叠按钮一律中性色,
普通新增只留绿色 + 记号,敏感项与危险项一样用风险浅底。
@CodFrm
CodFrm merged commit a4ac67d into main Nov 12, 2026
11 checks passed
@CodFrm
CodFrm deleted the fix/install-update-ui branch November 12, 2026 09:24
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