🐛 批量更新页打开更新详情复用检查缓存并挡住重复点击 (#1719)

* 🐛 批量更新页打开更新详情复用检查缓存并挡住重复点击

点击脚本名查看更新时，openUpdatePageByUUID 会重新 fetch 一次脚本代码，
而这份新版代码在检查更新阶段已经存进 scriptUpdateCheck 的记录缓存里
（行内「更新」按钮装的就是它）。用户因此要为每次点击白等一次网络往返，
期间页面又没有任何反馈，连点几下就会开出多个安装页。

- SW: 拆出 prepareUpdateOrInstallPage，openUpdatePage 命中缓存代码时
  跳过 fetchScriptBody；openUpdatePageByUUID 改为回报 boolean
- 页面: 打开期间行内转圈并同步挡住重复点击，失败弹 toast，
  点击脚本名同样取消自动关闭倒计时

* 🐛 更新页与安装页补齐骨架屏与异步中间态，失败不再被渲染成成功 (#1721)

* 🐛 打开更新详情区分静默更新，忽略动作补齐逐条回执

页面此前无从判断服务端到底做了什么：openUpdatePageByUUID 在命中静默更新时
不开安装页却同样返回 true，用户点完脚本名只看到转一圈、什么都没发生；
IGNORE 分支根本没有返回值，页面只能 fire-and-forget。

- openUpdatePageByUUID / openUpdatePage 返回 "opened" | "silent" | "failed"
- IGNORE 逐条回报结果。忽略写的是脚本自身的 ignoreVersion，与检查缓存无关，
  因此缓存随 Service Worker 回收后忽略照样生效，这里如实回报而不是谎报失效
- checkScriptUpdate 的结果收敛成 TCheckScriptUpdateResult 并用 reason 区分
  「已有检查在跑」与真正的失败，页面才能分别提示

* 🐛 安装页补齐加载分档、代码骨架与提交忙态

从批量更新页点脚本名进来的必然是「更新」，加载屏却把上下文 chip 写死成
「脚本安装」，几百毫秒后再闪成「脚本更新」；描述写着「正在从来源下载」，
但这条入口的代码 Service Worker 早已备好，根本不下载。

- 状态屏按来路分档，未确知场景不渲染 chip（不猜），并补一条与就绪态操作栏
  等高的底部占位，避免就绪瞬间内容区高度再跳一次
- 暂存代码被定时清理回收时落到专属终态，出口换成「重新检查更新」——
  原来的「重试」在这个最常见的失败原因下重试多少次都是同一结果
- Monaco 实例就绪前渲染代码骨架，替代此前 340px 的纯空白
- toggleWatch / rejectExternalAccess 补忙态，install 加重入守卫：
  这两个动作全程不置忙态，连点会发出两次安装/两次决定

* 🐛 批量更新页补齐取数失败、检查空窗期与忽略/批量的中间态

取数失败时记录仍是空的，页面直接走到空态，把一次加载失败渲染成
「所有脚本均为最新（已检查 0 个脚本）」这条与事实相反的成功终态；
点「检查更新」到服务端广播回来之间页面完全静止，期间可以连点。

- 取数失败落错误终态：等宽 detail 框 + 重试 / 脚本列表出口
- 主动检查由本地 pending 立刻接管忙态，并把服务端的「正忙」「结果够新已跳过」
  「通道异常」三条回执分别说出来；跳过时就地清掉待反馈标记，
  否则会在下一次后台检查完成时冒出一条用户没点过的 toast
- 忽略复用与更新相同的行级阶段（working → success → 退场），不再 fire-and-forget
- 批量进行中互斥（行内勾选、两个批量按钮、全部恢复），避免两条进度互相覆盖；
  被「结果失效」中断时保留已完成条数，不把汇总抹掉
- 骨架补齐工具条（桌面）与顶部选择栏/底部操作栏（移动）占位，消除数据到达时的
  布局跳动，并加 role="status" / aria-busy；空态下重新检查不再整页闪回骨架
- 脚本名改用 aria-disabled + onClick 早退：disabled 会让浏览器不派发指针事件，
  正好在名字被截断、最需要看全名时把 tooltip 一起关掉，键盘触发后焦点还会掉到 body

Author: CodFrm

src/app/service/service_worker/client.ts

@@ -3,7 +3,15 @@ import { type Resource } from "@App/app/repo/resource";
 import { type Subscribe } from "@App/app/repo/subscribe";
 import { type Logger } from "@App/app/repo/logger";
 import { type Permission } from "@App/app/repo/permission";
-import type { InstallSource, ScriptMenu, ScriptMenuItem, TBatchUpdateListAction, TPopupPageStatus } from "./types";
+import type {
+  InstallSource,
+  ScriptMenu,
+  ScriptMenuItem,
+  TBatchUpdateListAction,
+  TCheckScriptUpdateResult,
+  TOpenUpdatePageResult,
+  TPopupPageStatus,
+} from "./types";
 import { Client } from "@Packages/message/client";
 import type { MessageSend } from "@Packages/message/types";
 import type PermissionVerify from "./permission_verify";
@@ -273,15 +281,15 @@ export class ScriptClient extends Client {
   }
 
   async openUpdatePageByUUID(uuid: string) {
-    return this.do<void>("openUpdatePageByUUID", uuid);
+    return this.do<TOpenUpdatePageResult>("openUpdatePageByUUID", uuid);
   }
 
   async openBatchUpdatePage(opts: TOpenBatchUpdatePageOption) {
     return this.do<boolean>("openBatchUpdatePage", opts);
   }
 
   async checkScriptUpdate(opts: TCheckScriptUpdateOption) {
-    return this.do<void>("checkScriptUpdate", opts);
+    return this.do<TCheckScriptUpdateResult>("checkScriptUpdate", opts);
   }
 }
 

src/app/service/service_worker/script.test.ts

@@ -23,6 +23,24 @@ import { ScriptClient } from "./client";
 import { SELF_METADATA_ONLY_RUN_ON_URL } from "@App/app/repo/metadata";
 import { BatchUpdateListActionCode } from "./types";
 import { stackAsyncTask } from "@App/pkg/utils/async_queue";
+import type * as ScriptUtils from "@App/pkg/utils/script";
+import type * as Utils from "@App/pkg/utils/utils";
+
+// 打开更新详情页会真的发网络请求并开标签页；这两处替换成可断言的桩
+const h = vi.hoisted(() => ({
+  fetchScriptBody: vi.fn(),
+  openInCurrentTab: vi.fn(),
+}));
+
+vi.mock("@App/pkg/utils/script", async (importOriginal) => ({
+  ...(await importOriginal<typeof ScriptUtils>()),
+  fetchScriptBody: h.fetchScriptBody,
+}));
+
+vi.mock("@App/pkg/utils/utils", async (importOriginal) => ({
+  ...(await importOriginal<typeof Utils>()),
+  openInCurrentTab: h.openInCurrentTab,
+}));
 
 initTestEnv();
 
@@ -1434,3 +1452,159 @@ describe("ScriptService._checkScriptUpdate —— 检查期间脚本被更新",
     expect(service["scriptUpdateCheck"].cacheFull?.list?.find((e) => e.uuid === "u-stable")?.checkUpdate).toBe(true);
   });
 });
+
+describe("ScriptService.openUpdatePageByUUID —— 打开单条更新详情", () => {
+  const URL = "https://example.test/open.user.js";
+  const userscript = (version: string) =>
+    [
+      "// ==UserScript==",
+      "// @name        更新详情目标",
+      "// @namespace   scriptcat-test",
+      `// @version     ${version}`,
+      "// ==/UserScript==",
+      "console.log(1);",
+    ].join("\n");
+
+  const saveTarget = async (service: ScriptService, scriptDAO: ScriptDAO) => {
+    await scriptDAO.save(
+      makeScript({
+        uuid: "u-open",
+        name: "更新详情目标",
+        namespace: "scriptcat-test",
+        metadata: { name: ["更新详情目标"], namespace: ["scriptcat-test"], version: ["1.0.0"] },
+        downloadUrl: URL,
+        checkUpdateUrl: URL,
+        checkUpdate: true,
+      })
+    );
+    await service.scriptCodeDAO.save({ uuid: "u-open", code: userscript("1.0.0") });
+  };
+
+  const primeCache = (service: ScriptService, newCode: string) =>
+    service["scriptUpdateCheck"].setCacheFull({
+      checktime: Date.now(),
+      list: [
+        {
+          uuid: "u-open",
+          checkUpdate: true,
+          oldCode: userscript("1.0.0"),
+          newCode,
+          newMeta: { version: ["2.0.0"], connect: [] },
+          script: makeScript({ uuid: "u-open", name: "更新详情目标", namespace: "scriptcat-test" }),
+          codeSimilarity: 0.9,
+          sites: [],
+          withNewConnect: false,
+        },
+      ],
+    });
+
+  beforeEach(() => {
+    h.fetchScriptBody.mockReset();
+    h.openInCurrentTab.mockReset();
+  });
+
+  it("检查记录里已带新版代码时直接打开安装页,不再重新拉取脚本", async () => {
+    const { service, scriptDAO } = buildService();
+    await saveTarget(service, scriptDAO);
+    primeCache(service, userscript("2.0.0"));
+
+    await expect(service.openUpdatePageByUUID("u-open")).resolves.toBe("opened");
+
+    expect(h.fetchScriptBody).not.toHaveBeenCalled();
+    expect(h.openInCurrentTab).toHaveBeenCalledWith("/src/install.html?uuid=u-open");
+  });
+
+  it("检查记录已失效时回退到网络拉取并照常打开安装页", async () => {
+    const { service, scriptDAO } = buildService();
+    await saveTarget(service, scriptDAO);
+    h.fetchScriptBody.mockResolvedValue(userscript("2.0.0"));
+
+    await expect(service.openUpdatePageByUUID("u-open")).resolves.toBe("opened");
+
+    expect(h.fetchScriptBody).toHaveBeenCalledWith(URL);
+    expect(h.openInCurrentTab).toHaveBeenCalledWith("/src/install.html?uuid=u-open");
+  });
+
+  it("拉取失败时回报 failed,让更新页能给出失败反馈而不是一直转圈", async () => {
+    const { service, scriptDAO } = buildService();
+    await saveTarget(service, scriptDAO);
+    h.fetchScriptBody.mockRejectedValue(new Error("network error"));
+
+    await expect(service.openUpdatePageByUUID("u-open")).resolves.toBe("failed");
+
+    expect(h.openInCurrentTab).not.toHaveBeenCalled();
+  });
+
+  it("脚本已不存在时回报 failed 而不是静默无反应", async () => {
+    const { service } = buildService();
+
+    await expect(service.openUpdatePageByUUID("missing")).resolves.toBe("failed");
+
+    expect(h.openInCurrentTab).not.toHaveBeenCalled();
+  });
+
+  it("命中静默更新时回报 silent:不开安装页,由调用方补一条反馈", async () => {
+    const { service, scriptDAO, systemConfig } = buildService();
+    await saveTarget(service, scriptDAO);
+    systemConfig.setSilenceUpdateScript(true);
+    primeCache(service, userscript("2.0.0"));
+
+    await expect(service.openUpdatePageByUUID("u-open")).resolves.toBe("silent");
+
+    // 静默更新是真的装了,只是页面上什么都不会发生
+    expect(h.openInCurrentTab).not.toHaveBeenCalled();
+    expect((await scriptDAO.get("u-open"))?.metadata.version?.[0]).toBe("2.0.0");
+  });
+});
+
+describe("ScriptService.batchUpdateListAction —— 忽略更新", () => {
+  const saveIgnoreTarget = (scriptDAO: ScriptDAO) =>
+    scriptDAO.save(
+      makeScript({
+        uuid: "u-ignore",
+        name: "忽略目标",
+        namespace: "scriptcat-test",
+        metadata: { name: ["忽略目标"], namespace: ["scriptcat-test"], version: ["1.0.0"] },
+      })
+    );
+
+  it("逐条回报忽略结果,页面据此收起该行", async () => {
+    const { service, scriptDAO } = buildService();
+    await saveIgnoreTarget(scriptDAO);
+
+    const res = await service.batchUpdateListAction({
+      actionCode: BatchUpdateListActionCode.IGNORE,
+      actionPayload: [{ uuid: "u-ignore", ignoreVersion: "2.0.0" }],
+    });
+
+    expect(res).toEqual({ ok: true, items: [{ uuid: "u-ignore", success: true }] });
+    expect((await scriptDAO.get("u-ignore"))?.ignoreVersion).toBe("2.0.0");
+  });
+
+  it("检查缓存已随 Service Worker 回收时,忽略照样生效并照常回报", async () => {
+    const { service, scriptDAO } = buildService();
+    await saveIgnoreTarget(scriptDAO);
+    // 忽略写的是脚本自身的 ignoreVersion,与检查缓存无关
+    expect(service["scriptUpdateCheck"].cacheFull).toBeFalsy();
+
+    const res = await service.batchUpdateListAction({
+      actionCode: BatchUpdateListActionCode.IGNORE,
+      actionPayload: [{ uuid: "u-ignore", ignoreVersion: "2.0.0" }],
+    });
+
+    expect(res).toEqual({ ok: true, items: [{ uuid: "u-ignore", success: true }] });
+    expect((await scriptDAO.get("u-ignore"))?.ignoreVersion).toBe("2.0.0");
+  });
+
+  it("脚本已不存在时该条回报失败,而不是静默当作成功", async () => {
+    const { service } = buildService();
+
+    const res = await service.batchUpdateListAction({
+      actionCode: BatchUpdateListActionCode.IGNORE,
+      actionPayload: [{ uuid: "missing", ignoreVersion: "2.0.0" }],
+    });
+
+    expect(res?.ok).toBe(true);
+    expect(res?.items[0]).toMatchObject({ uuid: "missing", success: false });
+  });
+});