Add PWA file-handling guide and launch support

AGENTS.md

@@ -126,6 +126,14 @@ and recurring pitfalls only.
 - iOS/iPadOS file pickers can gray out `.apk/.apks/.apkm/.xapk` when `accept`
   is set. Use `file-picker-support.js` to relax picker filtering on Apple
   mobile WebKit while keeping in-app validation.
+- Desktop Chromium PWA file associations are declared in
+  `packages/apk-webui/src/public/manifest.webmanifest`. Keep `launchQueue`
+  handling progressive and route received `File` objects through the existing
+  local analyzer flow; Safari and Firefox must retain picker/drag-and-drop
+  fallback behavior.
+- The PWA currently has no offline guarantee and intentionally has no service
+  worker. Add one only with an explicit cache/update design for the analyzer,
+  locale, report, and generated-rule chunks.
 - Liquid/glass effects must be capability- and power-mode gated, not OS-name
   gated. Keep fallback reasons in `liquid-glass-support.js`.
 - Web UI CSS/JS budgets are intentionally tight. Before raising a budget, prefer

locales/en.json

@@ -82,6 +82,19 @@
     "reportShareCopy": "Copy link",
     "reportShareSystem": "System share",
     "reportShareNoLink": "Link unavailable",
+    "pwaGuideEyebrow": "Desktop shortcut",
+    "pwaGuideTitle": "Analyze from the right-click menu",
+    "pwaGuideBody": "Install LibChecker WebUI, then open APK, APKS, APKM, or XAPK files with it directly from Finder or File Explorer.",
+    "pwaGuideInstall": "Install app",
+    "pwaGuideDismiss": "Dismiss installation guide",
+    "pwaGuideManual": "No install prompt? Use the install icon in the Chrome or Edge address bar, or choose Install LibChecker WebUI from the browser menu.",
+    "pwaGuideFirstOpenNote": "The browser asks you to confirm file access the first time.",
+    "pwaGuideStepInstall": "Install LibChecker WebUI",
+    "pwaGuideStepOpen": "Choose LibChecker WebUI from Open with",
+    "pwaGuideStepAnalyze": "Analyze the package locally",
+    "pwaGuideMenuOpenWith": "Open with LibChecker WebUI",
+    "pwaGuideSceneDone": "Report ready",
+    "pwaFileOpenFailed": "The Android package could not be opened from the system menu.",
     "clear": "Clear",
     "filePrompt": "Choose or drop",
     "fileIdle": "No file selected",

locales/ja.json

@@ -82,6 +82,19 @@
     "reportShareCopy": "リンクをコピー",
     "reportShareSystem": "システム共有",
     "reportShareNoLink": "リンクを利用できません",
+    "pwaGuideEyebrow": "デスクトップショートカット",
+    "pwaGuideTitle": "右クリックメニューから直接解析",
+    "pwaGuideBody": "LibChecker WebUI をインストールすると、Finder またはエクスプローラーから APK、APKS、APKM、XAPK ファイルを直接開けます。",
+    "pwaGuideInstall": "アプリをインストール",
+    "pwaGuideDismiss": "インストールガイドを閉じる",
+    "pwaGuideManual": "インストール案内が表示されない場合は、Chrome または Edge のアドレスバーにあるインストールアイコンか、ブラウザーメニューの「LibChecker WebUI をインストール」を使用してください。",
+    "pwaGuideFirstOpenNote": "初回のみ、ブラウザーがファイルアクセスの確認を求めます。",
+    "pwaGuideStepInstall": "LibChecker WebUI をインストール",
+    "pwaGuideStepOpen": "「このアプリケーションで開く」から LibChecker WebUI を選択",
+    "pwaGuideStepAnalyze": "パッケージをローカルで解析",
+    "pwaGuideMenuOpenWith": "LibChecker WebUI で開く",
+    "pwaGuideSceneDone": "レポートが完成",
+    "pwaFileOpenFailed": "システムメニューから Android パッケージを開けませんでした。",
     "clear": "クリア",
     "filePrompt": "選択またはドロップ",
     "fileIdle": "ファイルが選択されていません",

locales/ko.json

@@ -82,6 +82,19 @@
     "reportShareCopy": "링크 복사",
     "reportShareSystem": "시스템 공유",
     "reportShareNoLink": "링크를 사용할 수 없습니다",
+    "pwaGuideEyebrow": "데스크톱 바로 가기",
+    "pwaGuideTitle": "오른쪽 클릭 메뉴에서 바로 분석",
+    "pwaGuideBody": "LibChecker WebUI를 설치하면 Finder 또는 파일 탐색기에서 APK, APKS, APKM, XAPK 파일을 바로 열 수 있습니다.",
+    "pwaGuideInstall": "앱 설치",
+    "pwaGuideDismiss": "설치 안내 닫기",
+    "pwaGuideManual": "설치 안내가 표시되지 않으면 Chrome 또는 Edge 주소 표시줄의 설치 아이콘이나 브라우저 메뉴의 ‘LibChecker WebUI 설치’를 이용하세요.",
+    "pwaGuideFirstOpenNote": "처음 사용할 때 브라우저가 파일 접근 확인을 요청합니다.",
+    "pwaGuideStepInstall": "LibChecker WebUI 설치",
+    "pwaGuideStepOpen": "‘연결 프로그램’에서 LibChecker WebUI 선택",
+    "pwaGuideStepAnalyze": "패키지를 로컬에서 분석",
+    "pwaGuideMenuOpenWith": "LibChecker WebUI로 열기",
+    "pwaGuideSceneDone": "보고서 준비 완료",
+    "pwaFileOpenFailed": "시스템 메뉴에서 Android 패키지를 열 수 없습니다.",
     "clear": "지우기",
     "filePrompt": "선택하거나 끌어 놓기",
     "fileIdle": "선택한 파일 없음",

locales/zh-Hans.json

@@ -82,6 +82,19 @@
     "reportShareCopy": "复制链接",
     "reportShareSystem": "系统分享",
     "reportShareNoLink": "链接不可用",
+    "pwaGuideEyebrow": "桌面快捷操作",
+    "pwaGuideTitle": "从右键菜单直接分析",
+    "pwaGuideBody": "安装 LibChecker WebUI 后，即可在 Finder 或文件资源管理器中直接用它打开 APK、APKS、APKM 或 XAPK 文件。",
+    "pwaGuideInstall": "安装",
+    "pwaGuideDismiss": "关闭安装指引",
+    "pwaGuideManual": "没有出现安装提示？请点击 Chrome 或 Edge 地址栏中的安装图标，或从浏览器菜单选择「安装 LibChecker WebUI」。",
+    "pwaGuideFirstOpenNote": "首次使用时，浏览器会请求确认文件访问权限。",
+    "pwaGuideStepInstall": "安装 LibChecker WebUI",
+    "pwaGuideStepOpen": "在「打开方式」中选择 LibChecker WebUI",
+    "pwaGuideStepAnalyze": "在本地分析安装包",
+    "pwaGuideMenuOpenWith": "使用 LibChecker WebUI 打开",
+    "pwaGuideSceneDone": "报告已生成",
+    "pwaFileOpenFailed": "无法从系统菜单打开这个 Android 安装包。",
     "clear": "清空",
     "filePrompt": "选择或拖入",
     "fileIdle": "未选择文件",

locales/zh-Hant.json

@@ -82,6 +82,19 @@
     "reportShareCopy": "複製連結",
     "reportShareSystem": "系統分享",
     "reportShareNoLink": "連結無法使用",
+    "pwaGuideEyebrow": "桌面快速操作",
+    "pwaGuideTitle": "從右鍵選單直接分析",
+    "pwaGuideBody": "安裝 LibChecker WebUI 後，即可在 Finder 或檔案總管中直接用它開啟 APK、APKS、APKM 或 XAPK 檔案。",
+    "pwaGuideInstall": "安裝應用程式",
+    "pwaGuideDismiss": "關閉安裝指引",
+    "pwaGuideManual": "沒有出現安裝提示？請按一下 Chrome 或 Edge 網址列中的安裝圖示，或從瀏覽器選單選擇「安裝 LibChecker WebUI」。",
+    "pwaGuideFirstOpenNote": "首次使用時，瀏覽器會要求確認檔案存取權限。",
+    "pwaGuideStepInstall": "安裝 LibChecker WebUI",
+    "pwaGuideStepOpen": "在「開啟方式」中選擇 LibChecker WebUI",
+    "pwaGuideStepAnalyze": "在本機分析安裝包",
+    "pwaGuideMenuOpenWith": "使用 LibChecker WebUI 開啟",
+    "pwaGuideSceneDone": "報告已建立",
+    "pwaFileOpenFailed": "無法從系統選單開啟這個 Android 安裝包。",
     "clear": "清除",
     "filePrompt": "選擇或拖放",
     "fileIdle": "尚未選擇檔案",

packages/apk-webui/scripts/build.mjs

@@ -40,6 +40,13 @@ await writeFile(
     "/index.html",
     "  Cache-Control: no-cache",
     "",
+    "/manifest.webmanifest",
+    "  Content-Type: application/manifest+json; charset=UTF-8",
+    "  Cache-Control: no-cache",
+    "",
+    "/pwa-icon-*.png",
+    "  Cache-Control: public, max-age=3600",
+    "",
     "/social-preview.png",
     "  Cache-Control: public, max-age=3600",
     "",