Expand locale encoding diagnostics

Author: TonyNa-code

data/error-recipes.json

@@ -102,16 +102,26 @@
       "乱码",
       "mojibake",
       "locale",
+      "shift[-_ ]?jis",
+      "\\bsjis\\b",
+      "\\bcp932\\b",
+      "code page 932",
+      "language for non-unicode programs",
+      "ms gothic",
+      "ms ui gothic",
+      "ms pgothic",
+      "ＭＳ ?ゴシック",
       "\\?{4,}",
       "\\uFFFD",
       "区域设置",
       "日区"
     ],
-    "cause": "脚本、文件名或字体可能按日文系统区域保存，非日区环境下会乱码、找不到文件或直接闪退。",
-    "action": "尝试日区环境或 Locale Emulator，并把游戏移动到英文短路径。",
+    "cause": "脚本、文件名或字体可能按日文系统区域保存，尤其是 Shift-JIS/CP932、MS Gothic/MS UI Gothic 一类旧日文环境线索。非日区环境下会乱码、找不到文件或直接闪退。",
+    "action": "尝试日区环境或 Locale Emulator，并把游戏移动到英文短路径；如果报错点名字体，确认系统有可用日文字体。",
     "checklist": [
       "移动到 C:/Games/VNName",
       "使用日区环境或 Locale Emulator",
+      "确认 Shift-JIS/CP932 文件名没有在解压时变成乱码",
       "安装日文字体"
     ]
   },

docs/ERROR_RECIPES.md

@@ -92,6 +92,25 @@ Keep DirectPlay separate from the DirectX 9-era runtime route because the beginn
 
 The recommended action should point to Windows Features: enable `Legacy Components / DirectPlay`, then retry from GalAid's recommended launcher.
 
+## Locale Encoding Evidence
+
+The `locale-encoding` recipe should catch concrete Japanese locale, Shift-JIS/CP932, and old Japanese font clues without treating every generic font or path issue as locale-related.
+
+Good locale clues:
+
+- `文字化け`
+- `mojibake`
+- `Shift-JIS`
+- `SJIS`
+- `CP932`
+- `code page 932`
+- `Language for non-Unicode programs`
+- `MS Gothic`
+- `MS UI Gothic`
+- `ＭＳ ゴシック`
+
+Avoid broad positives such as plain `font`, `path`, or `unicode` unless the surrounding text clearly names the Japanese locale/code page issue.
+
 ## Flash And Borland Legacy Evidence
 
 Keep Flash/ActiveX and Borland/Delphi rules narrow. They should explain old launcher/config-tool failures without implying every game needs these components.

src/error-recipes.js

@@ -104,16 +104,26 @@ window.GALAID_ERROR_RECIPES = [
       "乱码",
       "mojibake",
       "locale",
+      "shift[-_ ]?jis",
+      "\\bsjis\\b",
+      "\\bcp932\\b",
+      "code page 932",
+      "language for non-unicode programs",
+      "ms gothic",
+      "ms ui gothic",
+      "ms pgothic",
+      "ＭＳ ?ゴシック",
       "\\?{4,}",
       "\\uFFFD",
       "区域设置",
       "日区"
     ],
-    "cause": "脚本、文件名或字体可能按日文系统区域保存，非日区环境下会乱码、找不到文件或直接闪退。",
-    "action": "尝试日区环境或 Locale Emulator，并把游戏移动到英文短路径。",
+    "cause": "脚本、文件名或字体可能按日文系统区域保存，尤其是 Shift-JIS/CP932、MS Gothic/MS UI Gothic 一类旧日文环境线索。非日区环境下会乱码、找不到文件或直接闪退。",
+    "action": "尝试日区环境或 Locale Emulator，并把游戏移动到英文短路径；如果报错点名字体，确认系统有可用日文字体。",
     "checklist": [
       "移动到 C:/Games/VNName",
       "使用日区环境或 Locale Emulator",
+      "确认 Shift-JIS/CP932 文件名没有在解压时变成乱码",
       "安装日文字体"
     ]
   },

tests/galaid-smoke.spec.js

@@ -188,6 +188,37 @@ test("DirectPlay recipe and import hints route old Windows component guidance",
   expect(result.roadmapIds).toContain("error-directplay-legacy");
 });
 
+test("locale recipe covers Shift-JIS code page and Japanese font clues", async ({ page }) => {
+  await page.goto("/");
+
+  const result = await page.evaluate(() => {
+    const examples = [
+      "Failed to decode Shift-JIS script.",
+      "SJIS filename conversion failed.",
+      "CP932 conversion failed.",
+      "Code page 932 is required.",
+      "Language for non-Unicode programs is not Japanese.",
+      "MS Gothic font was not found.",
+      "MS UI Gothic is missing.",
+      "ＭＳ ゴシック が見つかりません。",
+    ];
+
+    return {
+      positives: examples.map((text) => buildErrorDiagnostics(text).matches.map((match) => match.id)),
+      genericFont: buildErrorDiagnostics("The font size is too small.").matches.map((match) => match.id),
+      genericShift: buildErrorDiagnostics("Shift into fullscreen mode before starting.").matches.map((match) => match.id),
+      genericPage: buildErrorDiagnostics("Page 932 of the manual is missing.").matches.map((match) => match.id),
+    };
+  });
+
+  for (const matches of result.positives) {
+    expect(matches).toContain("locale-encoding");
+  }
+  expect(result.genericFont).not.toContain("locale-encoding");
+  expect(result.genericShift).not.toContain("locale-encoding");
+  expect(result.genericPage).not.toContain("locale-encoding");
+});
+
 test("old video component recipe covers DirectShow, MCI, and codec clues", async ({ page }) => {
   await page.goto("/");