docs(desktop): preserve frozen stable channel migration guide

2026-11-09 20:07:43 +08:00 · 2026-11-04 15:44:33 +08:00
parent 0d03fb3ca3
commit c649fdae69
3 changed files with 4 additions and 4 deletions
@@ -12,5 +12,5 @@
  en: bca4377ec9032e3b
  zh: 6da9f3be04f1cd39
 /desktop-stable-channel-name/migration:
-  en: a7f4cf090fde3729
-  zh: 3dd080660f49e7c6
+  en: 8442b24f420f6be2
+  zh: b2517178eccbf8d5
@@ -13,6 +13,6 @@ Desktop packages, update feeds, and channel configuration use `stable` instead o

 ## Migration

-1. Select `stable` in packaging workflows or set `DSH_DESKTOP_UPDATE_CHANNEL=stable` when building a stable-channel package. Select the channel independently of the version suffix; stable also accepts alpha and RC versions.
+1. Select `stable` in packaging workflows or set `DSH_DESKTOP_UPDATE_CHANNEL=stable` when building a stable-channel package. Build a stable version, without a prerelease suffix.
 2. If a local Desktop settings file contains `updates.channel: "latest"`, change the value to `"stable"` and restart Desktop. Omitting the field uses the package default.
 3. Publish with the updated tooling: it writes `stable.yml` on Windows and `stable-mac.yml` on macOS within each architecture's feed directory, with stable-channel binaries under `stable/`. Verify the selected channel and requested feed in the test deployment before production publication. Old packages still requesting `latest` feeds do not migrate automatically.
@@ -13,6 +13,6 @@ description: "桌面正式更新渠道由 latest 更名为 stable。"

 ## 迁移

-1. 在打包工作流中选择 `stable`，或在构建正式渠道包时设置 `DSH_DESKTOP_UPDATE_CHANNEL=stable`。渠道选择独立于版本后缀；stable 也接受 alpha 和 RC 版本。
+1. 在打包工作流中选择 `stable`，或在构建正式渠道包时设置 `DSH_DESKTOP_UPDATE_CHANNEL=stable`。使用不含预发布后缀的稳定版本号。
 2. 如果本地桌面配置文件包含 `updates.channel: "latest"`，将该值改为 `"stable"` 并重启桌面应用。省略该字段时使用安装包默认值。
 3. 使用更新后的工具发布：在各架构的清单目录内，Windows 写入 `stable.yml`，macOS 写入 `stable-mac.yml`；正式渠道二进制位于 `stable/` 下。在正式发布前，通过测试部署核对选定渠道和请求的清单。仍请求 `latest` 清单的旧包不会自动迁移。