# Desktop Release

> 按需发布 Wyckoff Electron 桌面安装包；仅在用户明确要求发布桌面新版本时使用，不用于日常 PR 验证或 PyPI 发布

- Skill: `youngcan-wang/desktop-release` (Agent Skill)
- Install (CLI): `npx skillmds@latest add youngcan-wang/desktop-release`
- Raw SKILL.md: https://api.skillmd.com/api/skills/youngcan-wang/desktop-release/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: youngcan-wang (https://skillmd.com/u/youngcan-wang)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/youngcan-wang/desktop-release

---


# Desktop Release

从 `main` 发布一次零付费桌面正式版。未指定版本策略时默认递增 patch；接受 `patch`、`minor`、`major` 或明确的 `X.Y.Z`。

## 发布边界

- 只发布桌面 GitHub Release，不发布 PyPI、不部署 Worker，也不修改策略参数和用户数据。
- 不购买或配置代码签名；Windows 保持未签名，macOS 保持 ad-hoc 签名。
- 不覆盖、移动或删除既有 tag/Release。任一前置条件不满足就停止并报告。
- 只有 `desktop-vX.Y.Z` tag 才构建三平台安装包；普通 push/PR 不应进入 package jobs。

## 执行流程

1. 在仓库根目录读取 `AGENTS.md`、`docs/DESKTOP_RELEASE.md`、`.github/workflows/desktop.yml`，并检查 `git status --short --branch`。
2. 要求工作树干净；运行 `git fetch origin`，切到 `main`，再执行 `git pull --ff-only origin main`。如果本地或远端不是快进关系，停止。
3. 读取 `desktop/package.json` 当前版本、最新 `desktop-v*` tag 和 GitHub Release。计算目标版本；若目标 tag 或 Release 已存在，停止。
4. 在 `desktop/` 运行 `npm version <目标版本> --no-git-tag-version`，只允许 `package.json` 与 `package-lock.json` 发生版本变更。
5. 运行 `npm ci`、`npm run typecheck`、`npm test`、`npm run build:ui`。任一失败就停止，不提交也不打 tag。
6. 提交 `chore(release): desktop vX.Y.Z` 并推送 `main`。记录提交 SHA；如果远端在推送前发生变化，停止并重新同步，不强推。
7. 等该 SHA 的主干 `CI` 成功。失败、取消或超时都停止；不要创建发布 tag。
8. 创建 annotated tag `desktop-vX.Y.Z`，指向刚验证的版本提交并推送。该 tag 会触发 `Desktop` workflow。
9. 等 `Desktop` workflow 终态成功，再验证 GitHub Release 非 draft、非 prerelease，并且恰好包含一个 Windows `.exe`、两个 macOS `.dmg` 和 `SHA256SUMS.txt`。
10. 返回版本、提交 SHA、Actions run、Release 下载页和资产清单。工作流失败时保留现场并报告，不自动重跑或删除 tag。