build(release): prepare v2.9.2

CHANGELOG.md

@@ -2,6 +2,10 @@
 
 Full release narratives now live in versioned files under `releases/`. This file stays as the index and summary entry point.
 
+## [2.9.2] - 2026-04-07
+- EN: This release fixes the desktop updater path for both stable and prerelease downloads, hardens invalid preference-key handling, and expands the bilingual image workflow documentation. See [Release Notes (EN)](releases/v2.9.2.en.md).
+- 中文：本次发布修复了桌面端正式版与预览版下载更新链路，强化了无效偏好键处理，并补充了双语图像工作流文档。参见 [版本说明（中文）](releases/v2.9.2.zh-CN.md)。
+
 ## [2.9.1] - 2026-04-06
 - EN: This hotfix restores a more visible remove affordance in the multi-image upload area, replacing the footer text action with a clearer top-right icon button. See [Release Notes (EN)](releases/v2.9.1.en.md).
 - 中文：本次热修复让多图上传区域的删除入口重新变得更直观，用更明显的右上角图标按钮替代底部文字按钮。参见 [版本说明（中文）](releases/v2.9.1.zh-CN.md)。

package.json

@@ -1,6 +1,6 @@
 {
   "name": "prompt-optimizer",
-  "version": "2.9.1",
+  "version": "2.9.2",
   "private": true,
   "packageManager": "pnpm@10.6.1",
   "engines": {

packages/desktop/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prompt-optimizer/desktop",
-  "version": "2.9.1",
+  "version": "2.9.2",
   "description": "Desktop application for Prompt Optimizer",
   "main": "main.js",
   "repository": {

packages/extension/public/manifest.json

@@ -2,7 +2,7 @@
   "manifest_version": 3,
   "default_locale": "zh_CN",
   "name": "__MSG_extName__",
-  "version": "2.9.1",
+  "version": "2.9.2",
   "description": "__MSG_extDesc__",
   "icons": {
     "16": "icons/icon16.png",

releases/v2.9.2.en.md

@@ -0,0 +1,37 @@
+# Prompt Optimizer v2.9.2
+
+## Summary
+- Fixed desktop updater failures on both stable and prerelease download actions by restoring the missing prerelease preference key and hardening preference-key validation.
+- Expanded the bilingual image workflow documentation with dedicated multi-image workspace guides, richer text-to-image instructions, and updated navigation.
+- Added regression coverage so invalid preference keys are rejected cleanly instead of cascading into runtime storage crashes.
+
+## Highlights
+- Desktop users now have a repaired upgrade path in the packaged app: stable and prerelease download flows no longer depend on a missing updater preference constant.
+
+## Product Updates
+### Desktop
+- Restored the updater preference constant used by the `downloadSpecificVersion` flow so both stable and prerelease buttons read and write the expected channel setting again.
+- Added a defensive preference-key guard so malformed updater state is rejected before it can trip low-level storage assertions.
+### Core/Infra
+- Added a regression test for invalid preference keys in the preference service to keep the updater failure mode covered.
+- Refreshed the MkDocs documentation set in both English and Chinese with new multi-image workspace tutorials, stronger text-to-image guidance, and updated onboarding/navigation references.
+
+## Fixes
+- Fixed a desktop updater crash that could surface as `[error.storage.read] Failed to get preference: Cannot read properties of undefined (reading 'startsWith')` when either download action touched a missing preference key.
+- Fixed the follow-on failure mode where bad stored updater keys were not rejected early enough inside the shared preference service.
+
+## Breaking Changes / Upgrade Notes
+- No breaking API or data format changes.
+- If an older desktop build cannot finish the in-app update, install `v2.9.2` manually once; subsequent updates will use the repaired updater path.
+
+## Developer Notes
+- This release combines a desktop-side constant restoration with a core-side validation guard and regression test, so both the source bug and leftover bad stored keys fail safely.
+- The documentation refresh adds dedicated multi-image workspace pages in both locales to match the current image workflow shipped in the app.
+
+<!-- Release drafting reference:
+Remove every TODO placeholder before running "pnpm release:notes:check v2.9.2".
+
+- Range: v2.9.1..HEAD
+- fix(updater): restore prerelease preference key (7125d411)
+- docs(mkdocs): update image workflow tutorials (b6c001b1)
+-->

releases/v2.9.2.zh-CN.md

@@ -0,0 +1,37 @@
+# Prompt Optimizer v2.9.2
+
+## 概括
+- 修复了桌面端正式版与预览版下载更新时的失败问题，补回缺失的预发布偏好键，并加强了偏好键校验。
+- 双语图像工作流文档得到补充，新增多图工作区教程、文生图说明和更完整的导航入口。
+- 补上了无效偏好键的回归覆盖，避免错误状态继续演变成运行时存储崩溃。
+
+## 亮点
+- 桌面端打包应用里的升级链路已经补好，正式版和预览版下载不再依赖那个缺失的 updater 偏好常量。
+
+## 产品更新
+### Desktop
+- 恢复了 `downloadSpecificVersion` 流程依赖的 updater 偏好常量，让正式版和预览版按钮重新按预期读取、写入更新通道设置。
+- 为偏好服务增加了无效 key 防御，避免异常 updater 状态继续触发底层存储断言。
+### Core/Infra
+- 为偏好服务新增无效 key 回归测试，让这次 updater 故障路径有了持续覆盖。
+- 更新了中英文 MkDocs 文档，补充多图工作区教程、文生图说明，以及更完整的入门和导航链接。
+
+## 修复
+- 修复了桌面端更新器在正式版或预览版下载时，可能报出 `[error.storage.read] Failed to get preference: Cannot read properties of undefined (reading 'startsWith')` 的崩溃问题。
+- 修复了坏的 updater 偏好键没有在共享偏好服务里被尽早拦截的问题，避免错误状态继续扩散。
+
+## 破坏性变更 / 升级说明
+- 无 API 或数据格式层面的破坏性变更。
+- 如果较老的桌面版本仍无法通过应用内更新完成升级，请先手动安装一次 `v2.9.2`；之后会走修复后的更新链路。
+
+## 开发者说明
+- 这次发布同时包含桌面端常量恢复、core 层参数防御和回归测试，因此既修正了源头问题，也让遗留坏数据能以可控方式失败。
+- 文档补齐了双语多图工作区页面，使对外教程与当前应用里的图像工作流保持一致。
+
+<!-- Release drafting reference:
+Remove every TODO placeholder before running "pnpm release:notes:check v2.9.2".
+
+- Range: v2.9.1..HEAD
+- fix(updater): restore prerelease preference key (7125d411)
+- docs(mkdocs): update image workflow tutorials (b6c001b1)
+-->