@ash-qw/dsh-theme-prts 2.3.0 → 2.3.1

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # 变更记录
 
+## 2.3.1 - 2026-10-22
+
+以下为相对 `v2.3.0` 的变化：
+
+- 背景图片新增保护区域设置：在预览图上通过独立按钮打开编辑弹窗，拖动默认保护框或四边、四角调整范围，并查看不同窗口及侧栏宽度下的裁剪效果。窗口变化时尽量保留重要区域；无法完整显示时，横向优先保留中心、纵向优先保留顶端。保护区域在当前实例同步，并随完整主题配置导入导出。
+- 调整预览进入会话的顺序：先展开目标工作区、高亮会话卡片并完成侧栏滚动，位置稳定后再执行真实会话跳转，避免正文加载阻塞主线程时出现定位失败或回弹。补齐超时收尾、手动操作取消及连续点击替换旧任务的处理。
+- 修复刷新后新会话徽记向下漂移：提前预留会话顶栏空间，使徽记首次显示即处于稳定布局位置。
+- 修复 Baker 主题半透明消息气泡尾尖与主体之间的明显接缝。
+- 当前支持 DSH `0.2.1-rc.2` 的 Web 端与官方桌面客户端。本次改动已在本地 Web 容器实机验收；桌面端沿用此前基础功能验收范围。DSH `0.2.0-rc.2` 用户请固定主题 `1.4.2`，`0.1.7-rc.2` 用户请固定 `1.0.2`，`0.1.2` 或 `0.1.5` 发布线用户请固定 `0.1.102`。运行环境要求不变。
+
 ## 2.3.0 - 2026-10-22
 
 以下为相对 `v2.2.0` 的变化：

package/README.en.md

@@ -96,6 +96,8 @@ With custom backgrounds, material transparency is independently adjustable for t
 
 Conversation theme and background use separate settings pages. Enhanced composer glass lives on the background page: optional with the default background and always active in split/full modes, preserving the previous default-mode choice. Baker's optional loading animation (off by default) replaces each streaming response body with three pulsing square dots until it settles or is interrupted. Classic messages, reasoning and tool cards remain unaffected.
 
+Each background can have its own protected region. Open the modal editor from the image preview and drag the default box to move it, or drag its edges and corners to resize; percentage rulers are shown along the image edges. Sidebar previews compare narrow and wide tracks at the current sidebar height; conversation and full backgrounds use side-by-side landscape and portrait previews to show the crop; a notice appears only in settings when the entire region cannot fit. After saving, cover sizing stays centered unless a minimal shift is needed to keep the region visible. Oversized regions prioritize their horizontal center and vertical top, with offsets clamped to avoid empty edges. Clearing the region restores centered cropping; replacing the image clears the old region. Regions sync with images across the instance and are included in full theme exports and imports.
+
 ### Theme import and export
 
 Click **导入与导出** beside Restore defaults at the bottom of theme settings to open the transfer dialog to download a `.prts-theme.json` file. **包含自定义素材** is checked by default and includes all theme preferences, configured backgrounds, user/AI avatars, and the hero/conversation emblem selection and order. Avatars retain original images and crop parameters; emblems retain original images and editing parameters. Backgrounds use their stored WebP images. Historical assets and temporary drafts are excluded. Uncheck the option to export preferences only.

package/README.md

@@ -98,6 +98,8 @@ npm run check
 
 “会话主题”和“会话背景”分为独立设置页。输入框增强毛玻璃位于背景页：默认背景下可以开关，分区或完整背景下始终开启，切回默认背景时恢复原有开关选择。Baker 可开启“回复完成前显示加载动画”（默认关闭），每轮正在生成的正文暂以三点明暗动画代替，完成或中断后显示收到的正文；经典主题、思考过程与工具卡片不受此开关影响。
 
+背景图片可设置独立的保护区域：点击「保护重要区域」，在弹窗中拖动默认保护框移动或拖动四边或四角缩放，原图边缘显示百分比坐标尺。侧栏按当前高度并排预览较窄／较宽侧栏，正文与完整背景并排预览横向／纵向窗口，实时显示裁剪效果，无法保留完整区域时仅在设置中提示。保存后保持居中铺满，仅在必要时最小幅度移动图片以保住保护框；框无法完整容纳时，横向优先保留中心、纵向优先保留顶端，并限制偏移以避免露底。清除保护区域后恢复居中裁剪；替换图片会清除旧框。保护区域随图片在当前实例同步，并包含在完整主题导入导出中。
+
 ### 导入与导出主题
 
 点击主题设置底部、与「恢复默认」并列的「导入与导出」，在弹窗中下载 `.prts-theme.json` 文件。「包含自定义素材」默认勾选：包含全部主题设置，以及当前已配置的背景图片、用户／AI 头像、首页与正文徽记及排列。头像保留原图和裁剪参数，徽记保留原图和编辑参数，背景保存当前使用的 WebP 图片；历史素材和临时草稿不包含在内。取消勾选则仅导出设置。