Add Windows Installer diagnostics

Author: TonyNa-code

data/error-recipes.json

@@ -284,6 +284,30 @@
       "不要把安装器残留目录当成最终游戏目录"
     ]
   },
+  {
+    "id": "windows-installer-msi",
+    "title": "Windows Installer/MSI 安装器",
+    "category": "package",
+    "level": "warning",
+    "patterns": [
+      "\\bmsiexec(\\.exe)?\\b",
+      "\\bmsi\\.dll\\b",
+      "windows installer package",
+      "this installation package could not be opened",
+      "there is a problem with this windows installer package",
+      "another installation is already in progress",
+      "\\berror (1603|1618|1619|1620|1639)\\b.*\\b(msi|installer|installation)\\b",
+      "\\b(msi|installer|installation)\\b.*\\berror (1603|1618|1619|1620|1639)\\b"
+    ],
+    "cause": ".msi 是 Windows Installer 安装包，不是普通游戏 exe。旧游戏安装盘常把 MSI 与 CAB、MST、setup.ini 或语言资源分开放置；路径、权限、缺少相邻文件或已有安装进程都可能导致 1603/1618/1619/1620 等错误。",
+    "action": "优先使用 GalAid 的安装介质入口打开 MSI，让系统通过 msiexec 安装；保持 MSI 与同目录 CAB/MST/安装资源在原相对位置，必要时移动到本地英文短路径，安装完成后重扫安装后的游戏目录。",
+    "checklist": [
+      "确认报错来自 .msi 或 msiexec，而不是游戏主程序",
+      "保持 MSI 与 CAB/MST/setup.ini 等相邻文件在同一套目录",
+      "避开网络盘、压缩包预览窗口和过深/乱码路径",
+      "等待其他安装进程结束后再从 GalAid 安装介质入口重试"
+    ]
+  },
   {
     "id": "dotnet-runtime",
     "title": ".NET 运行环境",

docs/ERROR_RECIPES.md

@@ -142,6 +142,21 @@ Good InstallShield clues:
 - `data1.cab is missing`
 - `isdata.hdr could not be opened`
 
+## Windows Installer/MSI Evidence
+
+Keep MSI guidance separate from generic installer wording. The rule should only fire when the error clearly points to Windows Installer, `msiexec`, or MSI-specific error codes with installer context.
+
+Good Windows Installer clues:
+
+- `msiexec.exe`
+- `msi.dll`
+- `This installation package could not be opened`
+- `There is a problem with this Windows Installer package`
+- `Another installation is already in progress`
+- `Error 1603 during installation`
+- `MSI error 1619`
+- `Installer error 1620`
+
 ## Contribution Checklist
 
 - Keep the rule narrow enough to avoid noisy matches.

src/error-recipes.js

@@ -286,6 +286,30 @@ window.GALAID_ERROR_RECIPES = [
       "不要把安装器残留目录当成最终游戏目录"
     ]
   },
+  {
+    "id": "windows-installer-msi",
+    "title": "Windows Installer/MSI 安装器",
+    "category": "package",
+    "level": "warning",
+    "patterns": [
+      "\\bmsiexec(\\.exe)?\\b",
+      "\\bmsi\\.dll\\b",
+      "windows installer package",
+      "this installation package could not be opened",
+      "there is a problem with this windows installer package",
+      "another installation is already in progress",
+      "\\berror (1603|1618|1619|1620|1639)\\b.*\\b(msi|installer|installation)\\b",
+      "\\b(msi|installer|installation)\\b.*\\berror (1603|1618|1619|1620|1639)\\b"
+    ],
+    "cause": ".msi 是 Windows Installer 安装包，不是普通游戏 exe。旧游戏安装盘常把 MSI 与 CAB、MST、setup.ini 或语言资源分开放置；路径、权限、缺少相邻文件或已有安装进程都可能导致 1603/1618/1619/1620 等错误。",
+    "action": "优先使用 GalAid 的安装介质入口打开 MSI，让系统通过 msiexec 安装；保持 MSI 与同目录 CAB/MST/安装资源在原相对位置，必要时移动到本地英文短路径，安装完成后重扫安装后的游戏目录。",
+    "checklist": [
+      "确认报错来自 .msi 或 msiexec，而不是游戏主程序",
+      "保持 MSI 与 CAB/MST/setup.ini 等相邻文件在同一套目录",
+      "避开网络盘、压缩包预览窗口和过深/乱码路径",
+      "等待其他安装进程结束后再从 GalAid 安装介质入口重试"
+    ]
+  },
   {
     "id": "dotnet-runtime",
     "title": ".NET 运行环境",

tests/galaid-smoke.spec.js

@@ -310,6 +310,35 @@ test("InstallShield installer recipe routes old setup media failures", async ({
   expect(result.genericCabinet).not.toContain("installshield-runtime");
 });
 
+test("Windows Installer MSI recipe keeps installer error codes contextual", async ({ page }) => {
+  await page.goto("/");
+
+  const result = await page.evaluate(() => {
+    const examples = [
+      "msiexec.exe failed to open the package.",
+      "MSI.DLL could not be loaded.",
+      "This installation package could not be opened.",
+      "There is a problem with this Windows Installer package.",
+      "Another installation is already in progress.",
+      "Error 1603 during installation.",
+      "MSI error 1619.",
+      "Installer error 1620.",
+    ];
+
+    return {
+      positives: examples.map((text) => buildErrorDiagnostics(text).matches.map((match) => match.id)),
+      genericErrorCode: buildErrorDiagnostics("Error 1603 appeared in the game log.").matches.map((match) => match.id),
+      genericInstaller: buildErrorDiagnostics("The folder has an installer note in the readme.").matches.map((match) => match.id),
+    };
+  });
+
+  for (const matches of result.positives) {
+    expect(matches).toContain("windows-installer-msi");
+  }
+  expect(result.genericErrorCode).not.toContain("windows-installer-msi");
+  expect(result.genericInstaller).not.toContain("windows-installer-msi");
+});
+
 test("package sample shows archive and image preflight without treating it as runnable", async ({ page }) => {
   await page.goto("/");