Add readable package preview support

Author: TonyNa-code

README.ja.md

@@ -48,7 +48,7 @@ GalAid はこれらを小さな診断レポートと手順に整理します。
 - デスクトップ beta でネイティブフォルダ選択と再帰スキャン
 - デスクトップのパッケージ/イメージ事前チェックは ZIP ディレクトリ、同梱またはローカル 7z ツールによる RAR/7z/LZH/LHA/ARJ/CAB/TAR 系メタデータを読み、起動、インストールメディア、ランタイム修復サンプルを個別に強調する。ディスクイメージ種別、`autorun.inf + Start.exe + data1.cab` のような古いインストールディスク構造、同梱ランタイム修復項目も扱い、起動ボタンからローカル展開、ISO マウント/イメージ展開、再スキャン、推奨入口の起動まで進められる。ゲーム本体がなく `setup.exe/autorun.exe/.msi` または `autorun.inf` が指すインストール入口だけの場合は、インストールメディア入口として分けて扱う
 - Markdown 診断レポートのコピー/ダウンロード
-- 手順、環境チェック、レシピ一致、ファイル一覧、`package-previews.json` のパッケージ/イメージ事前チェック概要をまとめたサポートバンドルの出力
+- 手順、環境チェック、レシピ一致、ファイル一覧、`package-previews.md` と `package-previews.json` のパッケージ/イメージ事前チェック概要をまとめたサポートバンドルの出力
 
 ## 診断言語
 

README.md

@@ -206,6 +206,7 @@ The support bundle is a local `.zip` for asking for help in an issue, forum, or
 - `galaid-report.md`
 - `manifest.json`
 - `file-manifest.json`, including package/image preflight signal samples when available
+- `package-previews.md`, a human-readable package/image preflight summary
 - `package-previews.json`, a compact view of archive/disc-image launch, install-media, and repair clues
 - `environment-checks.json`
 - `roadmap.json`

README.zh-CN.md

@@ -48,7 +48,7 @@ GalAid 会把这些情况整理成一份小白也能看懂的诊断路线。
 - 桌面 beta 支持原生文件夹选择和递归扫描
 - 桌面包/镜像预检可读取 ZIP 目录、通过内置或本机 7z 工具列出 RAR/7z/LZH/LHA/ARJ/CAB/TAR 类元数据，并把启动、安装盘和运行库修复样例单独高亮；同时识别镜像介质线索、`autorun.inf + Start.exe + data1.cab` 这类老安装盘结构和包内运行库修复项；用户点击一键启动后可本地解压、挂载/解包镜像、自动重扫并启动推荐入口；如果没有游戏主程序但有 `setup.exe/autorun.exe/.msi` 或 `autorun.inf` 指向的安装入口，则单独走安装盘入口
 - 复制或下载 Markdown 报告
-- 导出包含路线、环境检查、配方命中、文件清单和 `package-previews.json` 包/镜像预检摘要的求助包
+- 导出包含路线、环境检查、配方命中、文件清单、`package-previews.md` 和 `package-previews.json` 包/镜像预检摘要的求助包
 
 ## 诊断语言
 

docs/DESKTOP.md

@@ -8,7 +8,7 @@ During native scanning, GalAid reads `.exe/.com` headers and labels DOS COM/MZ,
 
 The profile tab can create a `.lnk` shortcut for normal executable entries. GalAid also keeps a small local recent-launch history with entry names, relative paths, and timestamps so users can see what they tried without adding those details to reports or support bundles.
 
-The launch tab can prepare ZIP/RAR/7z archives, legacy LZH/LHA/ARJ/CAB packages, tar-style packages, and detected self-extracting EXE packages through the one-stop launch button. GalAid creates a fresh sibling `*-prepared` folder, asks for a user-provided password only when needed, expands compressed tar packages such as `.tar.gz/.tgz` in a second pass when an inner `.tar` appears, scans the extracted folder, and launches the top recommended entry when one is found. Self-extracting EXE support is metadata-gated: the desktop scanner must first list the EXE with the bundled or local 7z-compatible helper and see archive entries inside it, so ordinary game launchers stay on the direct-launch route. If the prepared content has no game launcher but does expose `setup.exe`, `install.exe`, `autorun.exe`, `.msi`, or an `autorun.inf` target such as `Start.exe` / `SetupJP.exe` / `Setup.cmd`, including shell install commands, GalAid presents that as a separate install-media entry and can open it from the same one-stop flow. Metadata preflight also recognizes old install-disc layouts such as `autorun.inf + Start.exe + data1.cab`, so likely autorun stubs are not promoted as game launchers before extraction. Windows Installer packages are launched through `msiexec.exe /i`. Package preflight also labels bundled DirectX/VC++/.NET/VB6/QuickTime/RPG Maker RTP repair tools so they are treated as fix clues rather than launch entries, and the package card shows launch, install-media, and runtime-repair samples separately from generic file samples. Support bundles include the same compact package/image preflight view as `package-previews.json`. The package tab still offers `Extract and rescan` for users who want to choose the output parent folder manually.
+The launch tab can prepare ZIP/RAR/7z archives, legacy LZH/LHA/ARJ/CAB packages, tar-style packages, and detected self-extracting EXE packages through the one-stop launch button. GalAid creates a fresh sibling `*-prepared` folder, asks for a user-provided password only when needed, expands compressed tar packages such as `.tar.gz/.tgz` in a second pass when an inner `.tar` appears, scans the extracted folder, and launches the top recommended entry when one is found. Self-extracting EXE support is metadata-gated: the desktop scanner must first list the EXE with the bundled or local 7z-compatible helper and see archive entries inside it, so ordinary game launchers stay on the direct-launch route. If the prepared content has no game launcher but does expose `setup.exe`, `install.exe`, `autorun.exe`, `.msi`, or an `autorun.inf` target such as `Start.exe` / `SetupJP.exe` / `Setup.cmd`, including shell install commands, GalAid presents that as a separate install-media entry and can open it from the same one-stop flow. Metadata preflight also recognizes old install-disc layouts such as `autorun.inf + Start.exe + data1.cab`, so likely autorun stubs are not promoted as game launchers before extraction. Windows Installer packages are launched through `msiexec.exe /i`. Package preflight also labels bundled DirectX/VC++/.NET/VB6/QuickTime/RPG Maker RTP repair tools so they are treated as fix clues rather than launch entries, and the package card shows launch, install-media, and runtime-repair samples separately from generic file samples. Support bundles include the same package/image preflight view as human-readable `package-previews.md` and compact `package-previews.json`. The package tab still offers `Extract and rescan` for users who want to choose the output parent folder manually.
 
 Disc-image rows can use `Mount/extract and rescan`. On Windows, `.iso` files are mounted with the built-in `Mount-DiskImage` command when available. During scanning, small `.cue` sheets are read for `FILE` track declarations so differently named `.bin/.img` media files can be grouped with the descriptor and missing tracks can be called out before preparation. When the bundled or local 7z-compatible helper can list a supported disc-image directory, GalAid records internal launch, installer, runtime repair, and engine clues without extracting the image. Other supported image files are handled as a best-effort local extraction through the same helper before GalAid rescans the prepared output folder.
 

src/app.js

@@ -6786,6 +6786,7 @@ function buildSupportBundle(analysis, errorText, language = getAssistantLanguage
   const manifest = buildSupportManifest(analysis, title, generatedAt, language);
   const fileManifest = buildFileManifest(analysis);
   const packagePreviewReport = buildPackagePreviewsReport(analysis);
+  const packagePreviewMarkdown = buildPackagePreviewsMarkdown(analysis, language);
   const errorRecipeReport = {
     schema: "galaid.errorRecipes.v1",
     hasErrorText: analysis.errorDiagnostics.hasText,
@@ -6851,6 +6852,11 @@ function buildSupportBundle(analysis, errorText, language = getAssistantLanguage
       content: JSON.stringify(fileManifest, null, 2),
       type: "application/json;charset=utf-8",
     },
+    {
+      path: "package-previews.md",
+      content: packagePreviewMarkdown,
+      type: "text/markdown;charset=utf-8",
+    },
     {
       path: "package-previews.json",
       content: JSON.stringify(packagePreviewReport, null, 2),
@@ -7009,6 +7015,7 @@ function buildSupportReadme(analysis, title, generatedAt, language = getAssistan
     "- galaid-report.md: human-readable diagnosis",
     "- manifest.json: bundle summary",
     "- file-manifest.json: sanitized file list metadata",
+    "- package-previews.md: human-readable archive/disc-image preflight clues",
     "- package-previews.json: archive/disc-image preflight launch, installer, and repair clues",
     "- environment-checks.json: environment checklist",
     "- runtime-repairs.json: bundled runtime repair tool hints",
@@ -7212,6 +7219,102 @@ function buildPackagePreviewsReport(analysis) {
   };
 }
 
+function buildPackagePreviewsMarkdown(analysis, language = getAssistantLanguage()) {
+  const copies = {
+    "zh-CN": {
+      title: "包/镜像预检摘要",
+      none: "当前没有包/镜像预检数据。",
+      overview: "总览",
+      count: "预检条目",
+      packagePath: "包/镜像",
+      format: "格式",
+      status: "状态",
+      summary: "判断",
+      nextStep: "下一步",
+      launch: "启动线索",
+      installer: "安装/介质线索",
+      repair: "运行库修复项",
+      engine: "引擎/结构线索",
+      warnings: "提醒",
+      samples: "样例文件",
+    },
+    en: {
+      title: "Package/Image Preflight Summary",
+      none: "No package or image preflight data is available.",
+      overview: "Overview",
+      count: "Previews",
+      packagePath: "Package/image",
+      format: "Format",
+      status: "Status",
+      summary: "Summary",
+      nextStep: "Next step",
+      launch: "Launch clues",
+      installer: "Install/media clues",
+      repair: "Runtime repair clues",
+      engine: "Engine/structure clues",
+      warnings: "Warnings",
+      samples: "Sample files",
+    },
+    ja: {
+      title: "パッケージ/イメージ事前チェック概要",
+      none: "パッケージ/イメージの事前チェックデータはありません。",
+      overview: "概要",
+      count: "事前チェック件数",
+      packagePath: "パッケージ/イメージ",
+      format: "形式",
+      status: "状態",
+      summary: "判定",
+      nextStep: "次の手順",
+      launch: "起動手がかり",
+      installer: "インストール/メディア手がかり",
+      repair: "ランタイム修復候補",
+      engine: "エンジン/構造の手がかり",
+      warnings: "注意",
+      samples: "サンプルファイル",
+    },
+  };
+  const copy = copies[language] || copies["zh-CN"];
+  const report = buildPackagePreviewsReport(analysis);
+  const lines = [`# ${copy.title}`, ""];
+
+  lines.push(`## ${copy.overview}`);
+  lines.push(`- ${copy.count}: ${formatNumber(report.count)}`);
+  lines.push(`- ${copy.launch}: ${formatNumber(report.launchClueCount)}`);
+  lines.push(`- ${copy.installer}: ${formatNumber(report.installerClueCount)}`);
+  lines.push(`- ${copy.repair}: ${formatNumber(report.runtimeRepairClueCount)}`);
+
+  if (!report.entries.length) {
+    lines.push("");
+    lines.push(copy.none);
+    return lines.join("\n");
+  }
+
+  for (const [index, entry] of report.entries.entries()) {
+    lines.push("");
+    lines.push(`## ${index + 1}. ${entry.packagePath || entry.format}`);
+    lines.push(`- ${copy.packagePath}: ${entry.packagePath || "-"}`);
+    lines.push(`- ${copy.format}: ${entry.groupFormat || entry.format || "-"} (${entry.packageType})`);
+    lines.push(`- ${copy.status}: ${entry.status || "-"}`);
+    if (entry.summary) lines.push(`- ${copy.summary}: ${entry.summary}`);
+    if (entry.nextStep) lines.push(`- ${copy.nextStep}: ${entry.nextStep}`);
+    appendPackagePreviewMarkdownList(lines, copy.launch, entry.launchSamples);
+    appendPackagePreviewMarkdownList(lines, copy.installer, entry.installerSamples);
+    appendPackagePreviewMarkdownList(lines, copy.repair, entry.runtimeRepairSamples);
+    appendPackagePreviewMarkdownList(lines, copy.engine, (entry.engineHints || []).map((hint) => `${hint.name} (${hint.count})`));
+    appendPackagePreviewMarkdownList(lines, copy.warnings, entry.warnings);
+    appendPackagePreviewMarkdownList(lines, copy.samples, (entry.sampleFiles || []).map((file) => `${file.path} (${file.sizeLabel})`), 6);
+  }
+
+  return lines.join("\n");
+}
+
+function appendPackagePreviewMarkdownList(lines, label, values, limit = 4) {
+  const items = (values || []).filter(Boolean).slice(0, limit);
+  if (!items.length) return;
+  lines.push(`- ${label}:`);
+  for (const item of items) lines.push(`  - ${item}`);
+}
+
 function buildPackagePreviewManifestEntry(set) {
   const preview = set.archivePreview;
   return {

tests/galaid-smoke.spec.js

@@ -41,6 +41,7 @@ test("sample diagnosis renders roadmap and support bundle metadata", async ({ pa
   await expect(page.locator(".support-file-list")).toContainText("roadmap-checklist.md");
   await expect(page.locator(".support-file-list")).toContainText("runtime-repairs.json");
   await expect(page.locator(".support-file-list")).toContainText("file-manifest.json");
+  await expect(page.locator(".support-file-list")).toContainText("package-previews.md");
   await expect(page.locator(".support-file-list")).toContainText("package-previews.json");
   await expect(page.locator("#supportPanel")).toContainText("诊断摘要");
 
@@ -56,6 +57,7 @@ test("sample diagnosis renders roadmap and support bundle metadata", async ({ pa
 
   const supportEntries = await page.evaluate(() => buildSupportBundle(currentAnalysis, errorInput.value, "zh-CN").entries.map((entry) => entry.path));
   expect(supportEntries).toContain("runtime-repairs.json");
+  expect(supportEntries).toContain("package-previews.md");
   expect(supportEntries).toContain("package-previews.json");
 });
 
@@ -108,18 +110,25 @@ test("package sample shows archive and image preflight without treating it as ru
 
   await page.locator('[data-tab="support"]').click();
   await expect(page.locator(".support-file-list")).toContainText("file-manifest.json");
+  await expect(page.locator(".support-file-list")).toContainText("package-previews.md");
   await expect(page.locator(".support-file-list")).toContainText("package-previews.json");
 
-  const packagePreviewReport = await page.evaluate(() => {
-    const entry = buildSupportBundle(currentAnalysis, "", "zh-CN").entries.find((item) => item.path === "package-previews.json");
-    return JSON.parse(entry.content);
+  const packagePreviewSupport = await page.evaluate(() => {
+    const bundle = buildSupportBundle(currentAnalysis, "", "zh-CN");
+    return {
+      json: JSON.parse(bundle.entries.find((item) => item.path === "package-previews.json").content),
+      markdown: bundle.entries.find((item) => item.path === "package-previews.md").content,
+    };
   });
-  expect(packagePreviewReport.schema).toBe("galaid.packagePreviews.v1");
-  expect(packagePreviewReport.count).toBeGreaterThanOrEqual(3);
-  expect(packagePreviewReport.launchClueCount).toBeGreaterThanOrEqual(1);
-  expect(packagePreviewReport.installerClueCount).toBeGreaterThanOrEqual(1);
-  expect(packagePreviewReport.runtimeRepairClueCount).toBeGreaterThanOrEqual(1);
-  expect(packagePreviewReport.entries.some((entry) => entry.launchSamples.includes("SnowTrial/Game.exe"))).toBe(true);
+  expect(packagePreviewSupport.json.schema).toBe("galaid.packagePreviews.v1");
+  expect(packagePreviewSupport.json.count).toBeGreaterThanOrEqual(3);
+  expect(packagePreviewSupport.json.launchClueCount).toBeGreaterThanOrEqual(1);
+  expect(packagePreviewSupport.json.installerClueCount).toBeGreaterThanOrEqual(1);
+  expect(packagePreviewSupport.json.runtimeRepairClueCount).toBeGreaterThanOrEqual(1);
+  expect(packagePreviewSupport.json.entries.some((entry) => entry.launchSamples.includes("SnowTrial/Game.exe"))).toBe(true);
+  expect(packagePreviewSupport.markdown).toContain("# 包/镜像预检摘要");
+  expect(packagePreviewSupport.markdown).toContain("SnowTrial/Game.exe");
+  expect(packagePreviewSupport.markdown).toContain("DXSETUP.exe");
 
   await page.locator("#assistantLanguageSelect").selectOption("en");
   await page.locator('[data-tab="report"]').click();