release(main): 准备 v0.1.0 候选版本 (#5)

* docs: add desktop project plan

* feat(desktop): implement phase 1 tauri client

* refactor(client): unify web and desktop release workflow

* feat(desktop): implement phase 2 native capabilities

* 完善桌面端交互体验与发布检查

* 完善桌面端界面、发布检查与邮箱域名同步

* fix(deploy): 修复数据库初始化复用旧镜像

* fix(deploy): 增加部署更新实时进度

* fix(auth): 支持无邮箱后缀时手动输入

* feat(desktop): 稳定桌面端界面与文件操作反馈

- 重构 DesktopPreferences 为分栏式设置面板，整合连接、外观、通知、更新与诊断信息分区，并补充过渡动效与暗色主题样式
- DesktopLayout 侧边栏导航分组支持展开折叠，调整管理/项目区块顺序并统一图标与标题
- 新增 fileTaskFeedback 工具，统一 pickFiles/saveFile/openFile 的成功/取消提示，替换审计导出、权限日志、附件、文档、线程、项目配置等处的直接调用
- desktopUpdateManager 暴露更新状态快照与状态变更监听，区分检查中、安装中、已推迟、失败等状态
- DesktopServerSettings 增加连接诊断信息（检查时间、健康地址、耗时、HTTP 状态）
- unified-page.css 与 ProjectMilestones 引入 CSS 变量以适配暗色主题
- WebLayout 将服务器设置入口改为打开系统偏好面板，管理菜单中邮件服务归入系统设置分组
- ProfileSettings 移除已迁入偏好面板的桌面端专属区块
- 补充 Layout.desktop 布局与偏好面板契约测试

* feat(desktop): 支持桌面端三十天免登录

* 完善桌面端发布稳定化门禁

* 完善桌面端端到端回归收口

* 补齐桌面端附件文件流回归

* 完善桌面端回归与安全边界复审

* 完善桌面体验与系统通知收口

* feat(desktop): 收口桌面工作台视觉与活动反馈

* 优化桌面端界面布局

* style: 优化个人中心和偏好设置弹窗样式，重构工作入口为精致分屏布局并移除首字徽标

* 功能（桌面端）：增加在线辅助本地缓存

* 优化桌面端标签导航与后台交互

* ci: 新增 Windows 桌面端内测构建

* fix: 修复桌面检查脚本的 Windows 路径判断

* test: 兼容 Windows 换行的桌面布局断言

* test: 兼容 Windows 换行的路由断言

* ci: 修复 Windows 内测构建配置传参

* ci: 避免 Windows 安装器构建交互等待

* 修复桌面端界面显示与稳定性问题

* feat(网页端): 完善登录后工作台与项目管理体验

* docs(desktop): 精简桌面端约束入口

* feat(admin): 完善审计访问上下文与后台布局

* fix(git): 跟踪原生图标资源

* fix(web): 修正工作台端侧标识

* feat(监控): 完善系统监控、登录状态与访问审计能力

* 修复(权限管理)：统一 PM 系统导航与权限校验

* feat(工作台): 优化入口布局与连接安全状态

* feat(桌面与监控): 完善工作台导航和登录活动定位

- 优化桌面标签、上下文标题、前进后退、导航栏隐藏和原生菜单体验

- 补充登录会话 IP 采集、地理位置回退、管理端展示及数据库迁移

- 更新桌面发布检查、运维文档和前后端测试覆盖

* 功能(文档与桌面)：完善文件预览下载与客户端构建基线

- 保存文档版本原始文件名，规范下载响应并持久化上传目录\n- 增加 PDF.js 预览、桌面保存打开流程及统一错误反馈\n- 统一 Node.js 22.13 构建基线并收紧临时文件权限门禁\n- 补充迁移、单元测试、发布检查与运维文档

* 功能(文档预览)：集成 ONLYOFFICE 安全只读预览与工作台体验

新增 ONLYOFFICE 配置签名、内部内容接口、容器编排与反向代理。

打通网页端和桌面端独立预览工作区，完善文档入口、布局及帮助体验。

补充桌面安全发布门禁、开发脚本、使用文档和前后端测试。

* feat(collaboration): 完善在线文档协作与通知闭环

- 新增协作文件夹、文件、不可变修订、成员、会话、回调回执、编辑申请与分享链接数据模型。

- 补齐新建、导入、复制、下载、回收站、恢复、成员授权、所有权转让及文件级权限接口。

- 接入 ONLYOFFICE 共同编辑、历史版本预览与恢复、修订另存副本、导出下载审计和幂等回调保存。

- 增加编辑权限申请、审批通知、项目提醒聚合、通知 Feed、已读处理及历史待办数据回填。

- 支持公开分享的查看或编辑模式、有效期、密码哈希、失败锁定、短时访问凭证与固定分享地址。

- 增加协作者导出、申请编辑、工作表结构保护和所有权管理策略，并纳入项目接口权限矩阵。

- 新增协作文件库、编辑工作区、公开分享页、下载与另存为对话框，以及导航、路由和权限入口。

- 统一网页端与桌面端通知布局，增加沉浸式工作区和浏览器、Tauri 双端全屏能力。

- 扩展运行时文件下载适配、Tauri 环境识别和原生全屏命令，继续保持业务代码运行时边界。

- 加固 ONLYOFFICE 消息桥的同源下载、签名地址隔离和保存为能力校验，并更新桌面发布检查。

- 增加连续数据库迁移、50MB 上传限制、OnlyOffice 中文文案与开发启动路由校验。

- 补充协作、通知、权限、路由、运行时、布局和 OnlyOffice 相关测试及模块说明文档。

* refactor(frontend): 按需加载页面并清理未使用代码

- 将业务页面路由统一改为动态导入，拆分首屏入口与各功能模块构建产物。

- 将网页端和桌面端布局改为异步组件，避免两套平台布局同时进入初始包。

- 新增 Element Plus 按需安装入口，并通过全局配置组件统一注入中文语言包。

- 提取 API 运行时钩子，在应用启动时注入项目清理、令牌续期和认证失效退出能力。

- 将权限监控面板及地图资源改为延迟加载，补充地图加载状态、失败提示和切换竞态保护。

- 删除已被现有工作流替代的项目成员、接口权限、中心绑定、培训表单及旧项目首页等页面。

- 清理废弃的快捷操作、项目选择、用户选择、FAQ 表单、风险占位组件和旧地图辅助模块。

- 移除未使用的 API 方法、类型、字典、状态机、展示工具、样式和项目详情编辑逻辑。

- 开启 TypeScript 未使用变量与参数检查，并同步收紧相关测试和组件暴露类型。

- 移除未使用的 updater、date-fns 和 Sass 前端依赖，更新锁文件并删除旧 CSS 清洗插件。

- 更新路由、Axios、ETMF、通知、权限监控和桌面布局测试以覆盖重构后的边界。

* fix(审计): 移除共享库审计与预览噪声

* 功能(提醒)：统一项目提醒中心与桌面通知链路

增加通用提醒状态、数据库迁移和定时同步，覆盖风险时效、文件回执、项目里程碑、访视窗口与协作申请。

新增网页端和桌面端提醒中心、真实投递诊断与固定隐私通知正文，并补齐登录来源聚合、测试和说明文档。

* feat(deploy): 默认安装 ONLYOFFICE 标准组件

* build(release): 加固 v0.1.0 桌面发布链路 (#3)

frontend/scripts/create-desktop-update-feed.mjs

@@ -1,6 +1,6 @@
+import { createHash } from "node:crypto";
 import { copyFile, mkdir, readFile, stat, writeFile } from "node:fs/promises";
 import { basename, resolve } from "node:path";
-import { createHash } from "node:crypto";
 import { fileURLToPath } from "node:url";
 
 const frontendDir = fileURLToPath(new URL("../", import.meta.url));
@@ -25,7 +25,7 @@ const assert = (condition, message) => {
   if (!condition) fail(message);
 };
 
-const artifactPath = value("--artifact") || process.env.DESKTOP_UPDATE_ARTIFACT;
+const macosArtifactPath = value("--artifact") || process.env.DESKTOP_UPDATE_ARTIFACT;
 const outputDir = resolve(
   frontendDir,
   value("--output-dir") || process.env.DESKTOP_UPDATE_OUTPUT_DIR || "src-tauri/target/release/desktop-update-feed",
@@ -34,18 +34,40 @@ const baseUrlRaw = value("--base-url") || process.env.DESKTOP_UPDATE_BASE_URL;
 const pubDate = value("--date") || process.env.DESKTOP_UPDATE_PUB_DATE || new Date().toISOString();
 const notes = value("--notes") || process.env.DESKTOP_UPDATE_NOTES;
 const includes = values("--include").map((path) => resolve(frontendDir, path));
+const platformArtifactSpecs = values("--platform-artifact");
+const platformPattern = /^(?:darwin|windows|linux)-(?:x86_64|aarch64|i686|armv7)$/;
 
-assert(Boolean(artifactPath), "--artifact or DESKTOP_UPDATE_ARTIFACT is required.");
+assert(Boolean(macosArtifactPath), "--artifact or DESKTOP_UPDATE_ARTIFACT is required for the Universal macOS updater artifact.");
 assert(Boolean(baseUrlRaw), "--base-url or DESKTOP_UPDATE_BASE_URL is required.");
 
-const resolvedArtifactPath = artifactPath ? resolve(frontendDir, artifactPath) : undefined;
-const artifactName = resolvedArtifactPath ? basename(resolvedArtifactPath) : undefined;
-const signaturePath = resolvedArtifactPath ? `${resolvedArtifactPath}.sig` : undefined;
-const uploadFiles = [];
+const platformArtifacts = new Map();
+if (macosArtifactPath) {
+  const resolvedMacosArtifact = resolve(frontendDir, macosArtifactPath);
+  platformArtifacts.set("darwin-aarch64", resolvedMacosArtifact);
+  platformArtifacts.set("darwin-x86_64", resolvedMacosArtifact);
+}
+
+for (const spec of platformArtifactSpecs) {
+  const separator = spec.indexOf("=");
+  if (separator <= 0 || separator === spec.length - 1) {
+    fail(`--platform-artifact must use <os>-<arch>=<path>: ${spec}`);
+    continue;
+  }
+
+  const platform = spec.slice(0, separator);
+  const path = spec.slice(separator + 1);
+  assert(platformPattern.test(platform), `Unsupported updater platform key: ${platform}`);
+  assert(!platformArtifacts.has(platform), `Updater platform is configured more than once: ${platform}`);
+  if (platformPattern.test(platform) && !platformArtifacts.has(platform)) {
+    platformArtifacts.set(platform, resolve(frontendDir, path));
+  }
+}
 
 const readRequiredFile = async (path, description) => {
   try {
-    return await readFile(path);
+    const data = await readFile(path);
+    assert(data.length > 0, `${description} must not be empty: ${path}`);
+    return data;
   } catch (error) {
     fail(`${description} cannot be read: ${path} (${error.message})`);
     return undefined;
@@ -72,20 +94,16 @@ const normalizedBaseUrl = () => {
   }
 };
 
-const copyIntoOutput = async (sourcePath) => {
-  const destination = resolve(outputDir, basename(sourcePath));
-  if (sourcePath !== destination) {
-    await copyFile(sourcePath, destination);
-  }
-  return destination;
-};
-
-if (resolvedArtifactPath && signaturePath) {
-  await readRequiredFile(resolvedArtifactPath, "Updater artifact");
+const artifactSignatures = new Map();
+const uniqueArtifactPaths = [...new Set(platformArtifacts.values())];
+for (const artifactPath of uniqueArtifactPaths) {
+  const signaturePath = `${artifactPath}.sig`;
+  await readRequiredFile(artifactPath, "Updater artifact");
   const signature = await readRequiredFile(signaturePath, "Updater artifact signature");
   if (signature) {
     const signatureText = signature.toString("utf8").trim();
-    assert(signatureText.length > 80, "Updater artifact signature is unexpectedly short.");
+    assert(signatureText.length > 80, `Updater artifact signature is unexpectedly short: ${signaturePath}`);
+    artifactSignatures.set(artifactPath, signatureText);
   }
 }
 
@@ -98,56 +116,75 @@ for (const includePath of includes) {
   }
 }
 
+for (const [platform, artifactPath] of platformArtifacts) {
+  if (platform.startsWith("darwin-")) {
+    assert(artifactPath.endsWith(".app.tar.gz"), `${platform} must use a macOS .app.tar.gz updater artifact.`);
+  }
+  if (platform === "windows-x86_64") {
+    assert(artifactPath.endsWith(".nsis.zip"), "windows-x86_64 must use an NSIS .nsis.zip updater artifact.");
+  }
+}
+
+const uploadSources = [
+  ...uniqueArtifactPaths.flatMap((path) => [path, `${path}.sig`]),
+  ...includes,
+];
+const sourceByName = new Map();
+for (const sourcePath of uploadSources) {
+  const name = basename(sourcePath);
+  const existing = sourceByName.get(name);
+  assert(!existing || existing === sourcePath, `Release files must have unique basenames: ${name}`);
+  sourceByName.set(name, sourcePath);
+}
+
 const baseUrl = normalizedBaseUrl();
 
-if (failures.length === 0 && resolvedArtifactPath && signaturePath && artifactName && baseUrl) {
+if (failures.length === 0 && baseUrl) {
   await mkdir(outputDir, { recursive: true });
 
-  const artifactUrl = new URL(artifactName, baseUrl).toString();
-  assert(!artifactUrl.endsWith("/latest.json"), "Updater artifact URL must not point at latest.json.");
-  assert(!/[?&]token=/i.test(new URL(artifactUrl).search), "Updater artifact URL must not include token query parameters.");
+  const platforms = {};
+  for (const [platform, artifactPath] of platformArtifacts) {
+    const artifactUrl = new URL(basename(artifactPath), baseUrl).toString();
+    assert(!artifactUrl.endsWith("/latest.json"), "Updater artifact URL must not point at latest.json.");
+    assert(!/[?&]token=/i.test(new URL(artifactUrl).search), "Updater artifact URL must not include token query parameters.");
+    platforms[platform] = {
+      signature: artifactSignatures.get(artifactPath),
+      url: artifactUrl,
+    };
+  }
 
-  const signature = (await readFile(signaturePath, "utf8")).trim();
   const latest = {
     version: packageInfo.version,
     pub_date: pubDate,
-    platforms: {
-      "darwin-aarch64": {
-        signature,
-        url: artifactUrl,
-      },
-      "darwin-x86_64": {
-        signature,
-        url: artifactUrl,
-      },
-    },
+    platforms,
   };
-
   if (notes) {
     latest.notes = notes;
   }
 
-  uploadFiles.push(await copyIntoOutput(resolvedArtifactPath));
-  uploadFiles.push(await copyIntoOutput(signaturePath));
-  for (const includePath of includes) {
-    uploadFiles.push(await copyIntoOutput(includePath));
+  const copiedFiles = [];
+  for (const sourcePath of sourceByName.values()) {
+    const destination = resolve(outputDir, basename(sourcePath));
+    if (sourcePath !== destination) {
+      await copyFile(sourcePath, destination);
+    }
+    copiedFiles.push(destination);
   }
 
   const latestPath = resolve(outputDir, "latest.json");
   await writeFile(latestPath, `${JSON.stringify(latest, null, 2)}\n`);
-  uploadFiles.push(latestPath);
+  copiedFiles.push(latestPath);
 
-  const uniqueFiles = [...new Map(uploadFiles.map((path) => [basename(path), path])).values()];
   const checksumLines = [];
-  for (const filePath of uniqueFiles) {
+  for (const filePath of copiedFiles) {
     checksumLines.push(`${await sha256(filePath)}  ${basename(filePath)}`);
   }
   const checksumPath = resolve(outputDir, "SHA256SUMS.txt");
   await writeFile(checksumPath, `${checksumLines.join("\n")}\n`);
 
   console.log(`Desktop update feed created in ${outputDir}`);
-  console.log(`  - ${uniqueFiles.map((path) => basename(path)).join("\n  - ")}`);
-  console.log(`  - SHA256SUMS.txt`);
+  console.log(`  - ${copiedFiles.map((path) => basename(path)).join("\n  - ")}`);
+  console.log("  - SHA256SUMS.txt");
 }
 
 if (failures.length > 0) {

frontend/scripts/verify-desktop-release-readiness.mjs

@@ -11,13 +11,11 @@ const failures = [];
 const env = process.env;
 const fullShaPattern = /^[0-9a-f]{40}$/i;
 const expectedTag = `v${packageInfo.version}`;
-const requiredSecretLikeEnv = [
-  "TAURI_SIGNING_PRIVATE_KEY",
-  "TAURI_SIGNING_PRIVATE_KEY_PASSWORD",
-  "APPLE_ID",
-  "APPLE_PASSWORD",
-  "APPLE_TEAM_ID",
-];
+const requiresMacosSigning = env.REQUIRE_DESKTOP_SIGNING === "true";
+const requiresWindowsSigning = env.REQUIRE_WINDOWS_SIGNING === "true";
+const requiredUpdaterEnv = ["TAURI_SIGNING_PRIVATE_KEY", "TAURI_SIGNING_PRIVATE_KEY_PASSWORD"];
+const requiredMacosEnv = ["APPLE_ID", "APPLE_PASSWORD", "APPLE_TEAM_ID"];
+const requiredWindowsEnv = ["WINDOWS_CERTIFICATE", "WINDOWS_CERTIFICATE_PASSWORD"];
 
 const fail = (message) => failures.push(message);
 const assert = (condition, message) => {
@@ -65,6 +63,24 @@ const validateBaseUrl = () => {
   );
 };
 
+const validateWindowsTimestampUrl = () => {
+  const raw = env.WINDOWS_TIMESTAMP_URL;
+  requireEnv("WINDOWS_TIMESTAMP_URL");
+  if (!raw) return;
+
+  let url;
+  try {
+    url = new URL(raw);
+  } catch (error) {
+    fail(`WINDOWS_TIMESTAMP_URL is invalid: ${error.message}`);
+    return;
+  }
+
+  assert(["http:", "https:"].includes(url.protocol), "WINDOWS_TIMESTAMP_URL must use HTTP or HTTPS.");
+  assert(url.username === "" && url.password === "", "WINDOWS_TIMESTAMP_URL must not include credentials.");
+  assert(!/[?&]token=/i.test(url.search), "WINDOWS_TIMESTAMP_URL must not include token query parameters.");
+};
+
 const headSha = gitMaybe(["rev-parse", "HEAD"]);
 const exactTag = gitMaybe(["describe", "--tags", "--exact-match", "HEAD"]);
 const status = gitMaybe(["status", "--porcelain"]);
@@ -79,16 +95,39 @@ if (headSha && env.VITE_BUILD_COMMIT) {
   assert(env.VITE_BUILD_COMMIT === headSha, "VITE_BUILD_COMMIT must match the current release commit.");
 }
 
-for (const name of requiredSecretLikeEnv) {
+assert(
+  requiresMacosSigning || requiresWindowsSigning,
+  "Release readiness requires REQUIRE_DESKTOP_SIGNING=true or REQUIRE_WINDOWS_SIGNING=true.",
+);
+assert(
+  !(requiresMacosSigning && requiresWindowsSigning),
+  "macOS and Windows signing readiness must be checked in their native jobs.",
+);
+
+for (const name of requiredUpdaterEnv) {
   requireEnv(name);
 }
 
-assert(
-  Boolean(env.APPLE_CERTIFICATE || env.APPLE_SIGNING_IDENTITY),
-  "APPLE_CERTIFICATE or APPLE_SIGNING_IDENTITY must be configured for macOS signing.",
-);
-if (env.APPLE_CERTIFICATE) {
-  requireEnv("APPLE_CERTIFICATE_PASSWORD");
+if (requiresMacosSigning) {
+  assert(process.platform === "darwin", "Signed macOS desktop release readiness must run on macOS.");
+  for (const name of requiredMacosEnv) {
+    requireEnv(name);
+  }
+  assert(
+    Boolean(env.APPLE_CERTIFICATE || env.APPLE_SIGNING_IDENTITY),
+    "APPLE_CERTIFICATE or APPLE_SIGNING_IDENTITY must be configured for macOS signing.",
+  );
+  if (env.APPLE_CERTIFICATE) {
+    requireEnv("APPLE_CERTIFICATE_PASSWORD");
+  }
+}
+
+if (requiresWindowsSigning) {
+  assert(process.platform === "win32", "Signed Windows desktop release readiness must run on Windows.");
+  for (const name of requiredWindowsEnv) {
+    requireEnv(name);
+  }
+  validateWindowsTimestampUrl();
 }
 
 validateBaseUrl();

frontend/scripts/verify-desktop-release.mjs

@@ -392,6 +392,7 @@ const verifyWorkflowGates = async () => {
   assert(packageInfo.engines?.node === ">=22.13.0", "package.json must require Node.js >=22.13.0.");
   const requiredScripts = [
     "desktop:build:macos-release",
+    "desktop:build:windows-release",
     "desktop:update-feed:create",
     "desktop:update-feed:check",
     "desktop:release-readiness:check",
@@ -424,15 +425,30 @@ const verifyWorkflowGates = async () => {
 
   const releaseWorkflow = await readFile(resolve(rootDir, ".github/workflows/desktop-release-candidate.yml"), "utf8");
   const requiredReleaseWorkflowTokens = [
+    "runs-on: macos-latest",
+    "runs-on: windows-latest",
     "REQUIRE_DESKTOP_SIGNING",
+    "REQUIRE_WINDOWS_SIGNING",
     "TAURI_SIGNING_PRIVATE_KEY",
     "APPLE_ID",
     "APPLE_PASSWORD",
     "APPLE_TEAM_ID",
+    "WINDOWS_CERTIFICATE",
+    "WINDOWS_CERTIFICATE_PASSWORD",
+    "WINDOWS_TIMESTAMP_URL",
+    "npm audit",
     "npm run desktop:build:macos-release",
+    "npm run desktop:build:windows-release",
+    "Get-AuthenticodeSignature",
+    "EnhancedKeyUsageList",
+    "TimeStamperCertificate",
+    ".nsis.zip",
     "npm run desktop:update-feed:create",
+    "--platform-artifact",
     "npm run desktop:update-feed:check",
+    "--require-platform windows-x86_64",
     "npm run desktop:release-readiness:check",
+    "actions/download-artifact",
     "actions/upload-artifact",
   ];
 

frontend/scripts/verify-desktop-update-feed.mjs

@@ -12,6 +12,8 @@ const optionValue = (name) => {
   const index = args.indexOf(name);
   return index >= 0 ? args[index + 1] : undefined;
 };
+const optionValues = (name) =>
+  args.reduce((result, argument, index) => (argument === name && args[index + 1] ? [...result, args[index + 1]] : result), []);
 
 const feedPath = resolve(
   frontendDir,
@@ -19,6 +21,12 @@ const feedPath = resolve(
 );
 const artifactDir = optionValue("--artifacts-dir") || process.env.DESKTOP_UPDATE_ARTIFACTS_DIR;
 const expectedBaseUrl = optionValue("--base-url") || process.env.DESKTOP_UPDATE_BASE_URL;
+const requiredPlatforms = new Set([
+  "darwin-aarch64",
+  "darwin-x86_64",
+  ...optionValues("--require-platform"),
+]);
+const platformPattern = /^(?:darwin|windows|linux)-(?:x86_64|aarch64|i686|armv7)$/;
 const checksumManifestPath =
   optionValue("--checksum-manifest") ||
   process.env.DESKTOP_UPDATE_CHECKSUM_MANIFEST ||
@@ -103,15 +111,16 @@ if (feed) {
 
   assert(normalizedFeedVersion === packageInfo.version, `latest.json version must match package version ${packageInfo.version}.`);
   assert(Boolean(feed.pub_date || feed.pubDate), "latest.json must include a publication date.");
-  assert(Boolean(darwinArm), "latest.json must include darwin-aarch64.");
-  assert(Boolean(darwinIntel), "latest.json must include darwin-x86_64.");
+  for (const platform of requiredPlatforms) {
+    assert(platformPattern.test(platform), `Required updater platform key is unsupported: ${platform}.`);
+    assert(Boolean(platforms[platform]), `latest.json must include ${platform}.`);
+  }
 
-  const entries = [
-    ["darwin-aarch64", darwinArm],
-    ["darwin-x86_64", darwinIntel],
-  ];
+  const entries = Object.entries(platforms);
+  assert(entries.length > 0, "latest.json must include at least one platform entry.");
 
   for (const [platform, entry] of entries) {
+    assert(platformPattern.test(platform), `latest.json contains an unsupported platform key: ${platform}.`);
     const rawUrl = entry?.url;
     const signature = entry?.signature;
     assert(typeof signature === "string" && signature.length > 80, `${platform} must include an updater signature.`);
@@ -133,6 +142,12 @@ if (feed) {
     if (expectedBaseUrl) {
       assert(rawUrl.startsWith(expectedBaseUrl), `${platform} artifact URL must start with ${expectedBaseUrl}.`);
     }
+    if (platform.startsWith("darwin-")) {
+      assert(url.pathname.endsWith(".app.tar.gz"), `${platform} must point to a macOS .app.tar.gz updater artifact.`);
+    }
+    if (platform === "windows-x86_64") {
+      assert(url.pathname.endsWith(".nsis.zip"), "windows-x86_64 must point to an NSIS .nsis.zip updater artifact.");
+    }
 
     if (artifactDir) {
       const artifactPath = resolve(artifactDir, basename(url.pathname));

frontend/scripts/verify-release-build-env.mjs

@@ -1,8 +1,10 @@
+import { execFileSync } from "node:child_process";
 import { readFile } from "node:fs/promises";
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 
 const frontendDir = fileURLToPath(new URL("../", import.meta.url));
+const rootDir = resolve(frontendDir, "..");
 const packageInfo = JSON.parse(await readFile(resolve(frontendDir, "package.json"), "utf8"));
 const failures = [];
 
@@ -16,6 +18,8 @@ const commit = env.VITE_BUILD_COMMIT || "local";
 const isCi = env.CI === "true" || env.GITHUB_ACTIONS === "true";
 const isTagBuild = env.GITHUB_REF_TYPE === "tag";
 const isReleaseBuild = env.RELEASE_BUILD === "true" || isTagBuild || channel === "release";
+const requiresMacosSigning = env.REQUIRE_DESKTOP_SIGNING === "true";
+const requiresWindowsSigning = env.REQUIRE_WINDOWS_SIGNING === "true";
 
 const fail = (message) => failures.push(message);
 const assert = (condition, message) => {
@@ -26,6 +30,18 @@ const requireEnv = (name) => {
   assert(Boolean(env[name]), `${name} must be configured for signed desktop release builds.`);
 };
 
+const gitHead = () => {
+  try {
+    return execFileSync("git", ["rev-parse", "HEAD"], {
+      cwd: rootDir,
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"],
+    }).trim();
+  } catch {
+    return undefined;
+  }
+};
+
 assert(allowedChannels.has(channel), `VITE_BUILD_CHANNEL must be one of ${[...allowedChannels].join(", ")}.`);
 
 if (isCi || isReleaseBuild) {
@@ -40,12 +56,25 @@ if (env.GITHUB_SHA) {
   );
 }
 
+if (isReleaseBuild && fullShaPattern.test(commit)) {
+  const headSha = gitHead();
+  assert(Boolean(headSha), "Release builds must be able to resolve the current Git commit.");
+  if (headSha) {
+    assert(commit === headSha, "VITE_BUILD_COMMIT must match the current Git HEAD for release builds.");
+  }
+}
+
 if (isTagBuild) {
   assert(env.GITHUB_REF_NAME === semverTag, `Release tag must be ${semverTag}; found ${env.GITHUB_REF_NAME || "<missing>"}.`);
   assert(channel === "release", "Release tag builds must set VITE_BUILD_CHANNEL=release.");
 }
 
-if (env.REQUIRE_DESKTOP_SIGNING === "true") {
+assert(
+  !(requiresMacosSigning && requiresWindowsSigning),
+  "macOS and Windows signing requirements must be checked in their native jobs.",
+);
+
+if (requiresMacosSigning) {
   assert(process.platform === "darwin", "Signed macOS desktop release builds must run on macOS.");
   if (isCi) {
     assert(isTagBuild, "Signed desktop release candidate builds in CI must run from a release tag.");
@@ -64,6 +93,18 @@ if (env.REQUIRE_DESKTOP_SIGNING === "true") {
   }
 }
 
+if (requiresWindowsSigning) {
+  assert(process.platform === "win32", "Signed Windows desktop release builds must run on Windows.");
+  if (isCi) {
+    assert(isTagBuild, "Signed Windows desktop release candidate builds in CI must run from a release tag.");
+  }
+  requireEnv("TAURI_SIGNING_PRIVATE_KEY");
+  requireEnv("TAURI_SIGNING_PRIVATE_KEY_PASSWORD");
+  requireEnv("WINDOWS_CERTIFICATE");
+  requireEnv("WINDOWS_CERTIFICATE_PASSWORD");
+  requireEnv("WINDOWS_TIMESTAMP_URL");
+}
+
 if (failures.length > 0) {
   console.error(`Release build environment check failed:\n${failures.map((item) => `  - ${item}`).join("\n")}`);
   process.exitCode = 1;