build(release): prepare v2.10.0

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.10.0] - 2026-05-03
+- EN: This release standardizes prompt model/session structures, turns favorites into resource-aware prompt assets, adds Prompt Garden discovery/import/favorite flows, expands resource-complete backups, and improves desktop IPC reliability. See [Release Notes (EN)](releases/v2.10.0.en.md).
+- 中文：本次发布标准化提示词模型与会话结构，将收藏升级为资源感知的提示词资产，加入 Prompt Garden 发现 / 导入 / 收藏流程，扩展资源完整备份，并提升桌面端 IPC 可靠性。参见 [版本说明（中文）](releases/v2.10.0.zh-CN.md)。
+
 ## [2.9.6] - 2026-04-27
 - EN: This release enhances favorites with reproducibility example editing, media management, and one-click example application to workspace sessions. See [Release Notes (EN)](releases/v2.9.6.en.md).
 - 中文：本次发布增强收藏功能，支持可复现性示例编辑、媒体管理，以及一键将示例应用到工作区会话。参见 [版本说明（中文）](releases/v2.9.6.zh-CN.md)。

package.json

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

packages/desktop/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prompt-optimizer/desktop",
-  "version": "2.9.6",
+  "version": "2.10.0",
   "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.6",
+  "version": "2.10.0",
   "description": "__MSG_extDesc__",
   "icons": {
     "16": "icons/icon16.png",

releases/v2.10.0.en.md

@@ -0,0 +1,65 @@
+# Prompt Optimizer v2.10.0
+
+## Summary
+- Introduces a prompt model standardization layer that normalizes prompt modes, sessions, histories, examples, favorites, and source assets across workspace types.
+- Reworks favorites into resource-aware prompt assets with version history, reproducibility examples, source bindings, workspace application, and dedicated asset management UI.
+- Adds resource-complete backup/import flows for favorites and related assets, while making Data Manager more compact and easier to scan.
+- Makes Prompt Garden a first-class discovery, import, and favorite source across web, desktop, and extension builds.
+- Improves reliability across variable generation, Electron IPC, desktop preferences, backups, and docs-only CI behavior.
+
+## Highlights
+This release is a broad foundation upgrade for reusable prompt work. Prompt sessions now have a standardized projection model, favorites can preserve the assets and examples needed to reproduce a prompt, Garden imports can become real favorites with source media, and backups can carry the resources needed to move that work between environments.
+
+## Product Updates
+### Desktop
+- Prompt Garden import and favorite flows are available in desktop builds through the shared built-in Garden defaults.
+- Favorite prompt asset version APIs are exposed through the Electron preload bridge.
+- Preference IPC handlers are registered in desktop startup so preference reads and writes are available through the Electron bridge.
+- Electron proxy payloads are serialized safely before crossing IPC boundaries, reducing failures caused by non-serializable response objects.
+
+### Web
+- Added Prompt Garden discovery and paste-import entry points from workspace utility menus and empty image prompt states.
+- Added Prompt Garden favorite import support, including a save-favorite confirmation flow with Garden metadata, media previews, examples, variables, and source details.
+- Pasted full Prompt Garden links now preserve `exampleId` and `subModeKey` for workspace imports, while favorite imports intentionally drop `exampleId` and save the prompt-level favorite.
+- Prompt Garden imports now show a persistent loading message while prompt data and image assets are fetched.
+- Reworked favorite surfaces with a split panel shell, source asset badges, an asset management dialog, prompt asset version list, and prompt asset version preview modal.
+- Favorite editors and detail panels now support richer reproducibility data and source-bound prompt assets.
+- Added workspace application helpers so favorites and saved examples can apply content, variables, image inputs, and source metadata back into matching workspaces.
+- Data Manager now uses a more compact layout and supports resource-complete backup package imports.
+- Filled variables can now be used as generation context when applying or generating prompt content.
+
+### Extension
+- Prompt Garden import and favorite flows are available in extension builds through the same built-in online Garden endpoint used by production web and desktop builds.
+- Full Prompt Garden link paste compatibility is supported in the extension UI as part of the shared workspace and favorites components.
+
+### Core/Infra
+- Added a prompt model service layer for prompt content, modes, sessions, histories, examples, favorite mapping, and shared prompt-model types.
+- Added prompt session projection and session asset binding utilities so workspace state can be represented consistently across basic, context, pro, and image modes.
+- Added built-in defaults for `VITE_ENABLE_PROMPT_GARDEN_IMPORT` and `VITE_PROMPT_GARDEN_BASE_URL`, with runtime and build-time env overrides still taking priority.
+- Added prompt asset version management and standardized prompt asset session handling for favorites.
+- Added resource-complete backup import support and included image model configuration in backups.
+- Added favorite resource package and data manager resource package utilities for moving favorite content together with referenced assets.
+- Added source asset utilities and history source binding helpers to preserve where generated or saved content came from.
+- Added explicit docs-only workflow path ignores for `docs/**`, `mkdocs/**`, and `releases/**` changes.
+- Consolidated prompt model standardization notes for implementation and review reference.
+
+## Fixes
+- Fixed Prompt Garden full-link paste compatibility so workspace imports no longer lose the selected example.
+- Fixed a silent waiting period during Prompt Garden favorite import by surfacing visible loading feedback.
+- Fixed duplicate or overly heavy Prompt Garden detail rendering in favorite detail views.
+- Fixed missing image model configurations in exported backups.
+- Fixed desktop preference IPC handler registration.
+- Fixed Electron proxy IPC serialization for payloads that cannot cross the bridge directly.
+- Fixed favorite asset cleanup and source rendering edge cases while moving favorite details into the new surface layout.
+- Fixed workspace routing and restore behavior around externally applied favorite/example content.
+
+## Breaking Changes / Upgrade Notes
+- None.
+
+## Developer Notes
+- Garden integration is gated by `VITE_ENABLE_PROMPT_GARDEN_IMPORT`; `VITE_PROMPT_GARDEN_BASE_URL` controls the source endpoint and defaults to `https://garden.always200.com`.
+- Web Docker/runtime deployments can still override Garden settings through `window.runtime_config`; Vite builds for web, desktop, and extension use the root env files plus core defaults.
+- New prompt-model utilities live under `packages/core/src/services/prompt-model/*`; use them instead of re-deriving prompt mode/session/history/favorite shapes in UI code.
+- Source-aware workspace flows should preserve `SourceAssetRef` / history binding metadata instead of flattening everything into prompt text.
+- Backup/import work should use the resource package utilities so referenced assets travel with the user-facing data.
+- Release CI no longer runs for pure docs, mkdocs, or release-note directory changes, which also prevents the Docker workflow from following those docs-only updates.

releases/v2.10.0.zh-CN.md

@@ -0,0 +1,66 @@
+# Prompt Optimizer v2.10.0
+
+## 概括
+- 引入提示词模型标准化层，统一表达提示词模式、会话、历史、示例、收藏和来源资源。
+- 将收藏升级为资源感知的提示词资产，支持版本历史、可复现示例、来源绑定、工作区应用和独立资源管理界面。
+- 新增收藏与相关资源的完整备份 / 导入流程，并让 Data Manager 更紧凑、更易扫描。
+- 让 Prompt Garden 成为 Web、Desktop、Extension 共用的一等发现、导入和收藏来源。
+- 强化变量生成、Electron IPC、桌面端偏好设置、备份和 docs-only CI 行为的可靠性。
+
+## 亮点
+这是一次面向“可复用提示词资产”的基础升级：工作区会话现在有统一的标准投影，收藏可以保留复现提示词所需的资源和示例，Garden 导入可以沉淀为带来源媒体的收藏，备份也可以携带跨环境迁移所需的资源。
+
+## 产品更新
+### Desktop
+- 桌面端构建通过共享的内建 Garden 默认配置支持 Prompt Garden 导入和收藏流程。
+- 通过 Electron preload bridge 暴露收藏提示词资产版本相关 API。
+- 启动时注册偏好设置 IPC handler，确保 Electron bridge 中的偏好读取和写入可用。
+- Electron proxy payload 在跨 IPC 前会进行安全序列化，减少不可序列化响应对象带来的失败。
+
+### Web
+- 在工作区工具菜单和图像提示词空状态中增加 Prompt Garden 发现与粘贴导入入口。
+- 新增从 Prompt Garden 导入收藏能力，保存确认流程会带入 Garden 元数据、媒体预览、示例、变量和来源详情。
+- 粘贴完整 Prompt Garden 链接时，工作区导入会保留 `exampleId` 和 `subModeKey`；导入为收藏时会按提示词级收藏语义主动丢弃 `exampleId`。
+- Prompt Garden 导入期间会显示持续的加载提示，覆盖提示词数据和图片资源获取阶段。
+- 重构收藏相关界面，新增分区面板、来源资源标识、资源管理弹窗、提示词资产版本列表和版本预览弹窗。
+- 收藏编辑器和详情面板现在支持更完整的可复现数据与来源绑定提示词资产。
+- 新增工作区应用辅助能力，收藏和保存的示例可以把内容、变量、图像输入和来源元数据应用回匹配工作区。
+- 数据管理界面改为更紧凑的备份与导入布局。
+- 数据管理支持资源完整备份包导入。
+- 已填写变量可以作为生成上下文参与提示词应用和生成。
+
+### Extension
+- 扩展端构建通过同一套内建线上 Garden 地址支持 Prompt Garden 导入和收藏流程。
+- 完整 Prompt Garden 链接粘贴兼容性通过共享工作区和收藏组件同步覆盖到扩展端。
+
+### Core/Infra
+- 新增提示词模型服务层，覆盖提示词内容、模式、会话、历史、示例、收藏映射和共享类型。
+- 新增 prompt session projection 和 session asset binding 工具，让 basic、context、pro、image 等模式的工作区状态可以被一致表达。
+- 为 `VITE_ENABLE_PROMPT_GARDEN_IMPORT` 和 `VITE_PROMPT_GARDEN_BASE_URL` 增加内建默认值，同时保留运行时和构建时环境变量的更高优先级。
+- 新增收藏提示词资源版本管理，并统一收藏的提示词资源会话处理。
+- 新增资源完整备份导入能力，并将图像模型配置纳入备份。
+- 新增 favorite resource package 与 data manager resource package 工具，用于连同被引用资源一起迁移收藏内容。
+- 新增来源资源工具与历史来源绑定辅助能力，用于保留内容生成或保存时的来源信息。
+- 对 `docs/**`、`mkdocs/**` 和 `releases/**` 明确配置 docs-only workflow 路径忽略。
+- 整理提示词模型标准化说明，方便后续实现与审查。
+
+## 修复
+- 修复粘贴完整 Prompt Garden 链接导入工作区时丢失所选示例的问题。
+- 修复从 Prompt Garden 导入收藏时等待阶段没有任何界面反馈的问题。
+- 修复收藏详情中 Prompt Garden 来源详情重复或过重展示的问题。
+- 修复导出备份中遗漏图像模型配置的问题。
+- 修复桌面端偏好设置 IPC handler 未注册的问题。
+- 修复 Electron proxy 中不能直接跨 IPC 传输的 payload 序列化问题。
+- 修复收藏详情迁移到新分区布局时的资源清理和来源展示边界问题。
+- 修复外部应用收藏 / 示例内容时的工作区路由和恢复行为问题。
+
+## 破坏性变更 / 升级说明
+- 无。
+
+## 开发者说明
+- Garden 集成由 `VITE_ENABLE_PROMPT_GARDEN_IMPORT` 开关控制；`VITE_PROMPT_GARDEN_BASE_URL` 控制来源地址，默认值为 `https://garden.always200.com`。
+- Web Docker / runtime 部署仍可通过 `window.runtime_config` 覆盖 Garden 配置；Web、Desktop、Extension 的 Vite 构建会读取根目录环境变量并合并 core 内建默认值。
+- 新的提示词模型工具位于 `packages/core/src/services/prompt-model/*`；UI 代码不应再自行推导提示词模式、会话、历史或收藏结构。
+- 涉及来源的工作区流程应保留 `SourceAssetRef` / history binding 元数据，而不是只把所有内容压平为提示词文本。
+- 备份 / 导入相关工作应使用资源包工具，确保用户可见数据引用的资源可以一起迁移。
+- 纯 `docs`、`mkdocs` 或 `releases` 目录变更不再触发 Release CI 的 test workflow，也不会继续带起 Docker workflow。