补齐桌面壳产物验收

原生壳总验收检查 Tauri release 二进制产物宿主壳方案和项目记忆同步桌面产物验收口径
2026-06-20 06:35:10 +08:00
parent a51ed00712
commit aba6d14eb9
3 changed files with 67 additions and 1 deletions
@@ -2894,6 +2894,13 @@
 - 影响范围：`apps/mobile-shell/app.json`、`apps/mobile-shell/scripts/check-config.mjs`、`apps/mobile-shell/scripts/check-expo-config.mjs`、原生壳方案文档。
 - 验证方式：`npm run mobile-shell:typecheck`、`npm run mobile-shell:config`、`npm run check:native-shells`、`npm run check:encoding`、`git diff --check`。

+## 2026-06-20 桌面壳 release 二进制产物验收
+
+- 背景：桌面壳统一验收已经执行 `tauri build --no-bundle`，但如果只看命令退出码，后续产物路径、二进制名称或平台输出发生漂移时，可能无法证明本机确实产出了可执行桌面壳。
+- 决策：`npm run check:native-shells` 在桌面 release build smoke 后必须检查 `apps/desktop-shell/src-tauri/target/release/genarrative-desktop-shell` 存在、体积非空，并按当前平台校验 Linux ELF / macOS Mach-O / Windows PE 文件头和可执行位。该检查不启动 GUI，也不生成平台安装包。
+- 影响范围：`scripts/check-native-shells.mjs`、原生壳方案文档。
+- 验证方式：`npm run check:native-shells`、`npm run check:encoding`、`git diff --check`。
+
 ## 2026-06-20 移动壳 ShellApp HostBridge 事件注入必须可执行覆盖

 - 背景：Expo 移动壳声明 `host.events`、`app.lifecycle`、`network.statusChanged` 和 `navigation.canGoBack`，但 ShellApp 真实 AppState、Network 和 WebView 返回栈注入链路需要和扫码链路一样有可执行测试覆盖，不能只靠字符串门禁。
@@ -483,7 +483,7 @@ GameBridge 禁止：

 2026-06-19 追加：桌面壳 macOS 媒体权限说明进入门禁。Tauri 桌面壳仍不新增摄像头或麦克风 HostBridge method，不把系统媒体能力暴露成桌面命令；同源 H5 页面可继续使用浏览器标准 `getUserMedia` 承接儿童动作热身 Demo 的实时摄像头输入和汪汪声浪正式 runtime 的实时麦克风输入。macOS 分发包必须通过 `bundle.macOS.infoPlist="Info.plist"` 合并受控用途说明：`NSCameraUsageDescription` 只描述同源 H5 实时动作输入，`NSMicrophoneUsageDescription` 只描述同源 H5 实时声音玩法。`apps/desktop-shell/scripts/check-config.mjs` 会校验 plist 路径和两条文案，并把 `Info.plist` 纳入生产壳替身词扫描，防止桌面包缺少系统授权说明、把媒体权限扩写成通用采集能力，或在 macOS 分发配置里留下临时替身文本。

-2026-06-18 追加：桌面壳 release 构建烟测进入统一验收。`npm run check:native-shells` 会在 H5 HostBridge、Expo 壳和 Tauri 单测通过后执行 `npm run desktop-shell:build -- --no-bundle`，确认根 `dist` H5 资产、Tauri release 入口、受控命令白名单、图标和 Rust release 编译可以共同产出桌面二进制；该烟测不生成平台安装包，避免把 Linux 本机缺少的系统打包器误判为 HostBridge 回归。
+2026-06-18 追加：桌面壳 release 构建烟测进入统一验收。`npm run check:native-shells` 会在 H5 HostBridge、Expo 壳和 Tauri 单测通过后执行 `npm run desktop-shell:build -- --no-bundle`，确认根 `dist` H5 资产、Tauri release 入口、受控命令白名单、图标和 Rust release 编译可以共同产出桌面二进制；构建后还必须检查 `target/release/genarrative-desktop-shell` 存在、非空且符合当前平台可执行文件头。该烟测不生成平台安装包，避免把 Linux 本机缺少的系统打包器误判为 HostBridge 回归。

 2026-06-18 追加：移动壳 Expo managed config 烟测进入统一验收。`npm run check:native-shells` 会执行 `npm run mobile-shell:config`，在 `apps/mobile-shell` 目录内调用 `expo config --type public --json`，校验 Expo CLI 实际解析结果中的包名、scheme、深链、ATS / cleartext / backup / 相机与麦克风权限、启动页、adaptive icon、插件配置和 HostBridge 版本没有漂移。

@@ -1983,6 +1983,62 @@ function assertHostBridgeLayerLayout() {
  );
 }

+function assertDesktopReleaseBinaryArtifact() {
+  const releaseDir = path.join(
+    'apps',
+    'desktop-shell',
+    'src-tauri',
+    'target',
+    'release',
+  );
+  const executableName =
+    process.platform === 'win32'
+      ? 'genarrative-desktop-shell.exe'
+      : 'genarrative-desktop-shell';
+  const executablePath = path.join(releaseDir, executableName);
+
+  if (!fs.existsSync(executablePath)) {
+    throw new Error(`desktop release binary is missing: ${executablePath}`);
+  }
+
+  const stat = fs.statSync(executablePath);
+  if (!stat.isFile() || stat.size < 1024 * 1024) {
+    throw new Error('desktop release binary must be a real non-empty executable file');
+  }
+
+  const header = fs.readFileSync(executablePath, { start: 0, end: 7 });
+  if (process.platform === 'linux') {
+    const isElf =
+      header[0] === 0x7f &&
+      header[1] === 0x45 &&
+      header[2] === 0x4c &&
+      header[3] === 0x46;
+    if (!isElf || (stat.mode & 0o111) === 0) {
+      throw new Error('desktop Linux release binary must be an executable ELF file');
+    }
+    return;
+  }
+
+  if (process.platform === 'darwin') {
+    const machMagic = header.readUInt32BE(0);
+    const isMachO =
+      machMagic === 0xcafebabe ||
+      machMagic === 0xcafed00d ||
+      machMagic === 0xfeedface ||
+      machMagic === 0xfeedfacf;
+    if (!isMachO || (stat.mode & 0o111) === 0) {
+      throw new Error('desktop macOS release binary must be an executable Mach-O file');
+    }
+    return;
+  }
+
+  if (process.platform === 'win32') {
+    if (header[0] !== 0x4d || header[1] !== 0x5a) {
+      throw new Error('desktop Windows release binary must be a PE executable');
+    }
+  }
+}
+
 for (const step of steps) {
  console.log(`[check:native-shells] ${step.label}`);
  const result = spawnSync(step.command, step.args, {
@@ -2009,6 +2065,9 @@ for (const step of steps) {
  }
 }

+console.log('[check:native-shells] desktop-release-binary-artifact');
+assertDesktopReleaseBinaryArtifact();
+
 console.log('[check:native-shells] host-bridge-layer-layout');
 assertHostBridgeLayerLayout();