docs: document install provenance boundaries

Author: cyfung1031

src/app/service/service_worker/script.ts

@@ -323,6 +323,8 @@ export class ScriptService {
         action: {
           type: "redirect" as chrome.declarativeNetRequest.RuleActionType,
           redirect: {
+            // 直接 URL 入口不经过 UUID 暂存；byWebRequest 只在暂存链路中用于脚本身份匹配，
+            // 不能再作为安装页 history.back()/window.close() 的来源标记。
             regexSubstitution: `${installPageURL}?url=\\1`,
           },
         },

src/pages/install/useInstallData.ts

@@ -301,6 +301,8 @@ export function useInstallData(): UseInstallData {
           });
           const metadata = parseMetadata(code);
           if (!metadata) throw new Error(t("install:script_info_load_failed"));
+          // 直接 URL 入口保持普通脚本准备参数；网页来源身份匹配只由 UUID 暂存选项传递，
+          // 安装页离开方式统一由 history.length 决定，不要为此重新添加 query 标记。
           await loadFromInfo(buildScriptInfo(uuidv4(), code, parsed.href, metadata), false, {});
         } else if (fid) {
           const handle = await loadHandle(fid);

src/pkg/utils/script.ts

@@ -178,7 +178,8 @@ export async function prepareScriptByCode(
   dao?: ScriptDAO,
   options?: {
     byEditor?: boolean; // 是否通过编辑器导入
-    byWebRequest?: boolean; // 是否通过网页连结安装或更新
+    // 仅控制网页来源脚本的身份匹配，不参与安装页 history.back()/window.close() 决策。
+    byWebRequest?: boolean;
   }
 ): Promise<{ script: Script; oldScript?: Script; oldScriptCode?: string; oldInTrash?: boolean }> {
   dao = dao ?? new ScriptDAO();