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

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # 变更记录
 
+## 2.4.0 - 2026-10-23
+
+以下为相对 `v2.3.1` 的变化：
+
+- 右侧边栏新增独立的材质透明度与模糊度设置，和左侧边栏分别保存。旧配置首次启用时继承左侧数值；旧主题文件缺少右侧字段时保留目标端现有设置。
+- 分区背景的正文图片固定在主框架坐标中，展开或收起左侧边栏时不再随正文宽度重新缩放。仅设置正文图片时，左侧边栏通过半透明材质显示下方背景；右侧边栏在分区和完整背景下也可透出背景。
+- 修复侧栏宽度变化时，背景布局与宿主几何变量延迟更新造成的短暂错位，并覆盖设置了图片保护区域的场景。
+- 导入主题文件前提示当前版本无法识别、导入后会丢失的设置与素材字段，便于确认前保留原文件。
+- 当前支持 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.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

@@ -90,16 +90,18 @@ Theme preferences now use DSH native profile configuration. Connected pages shar
 
 ### Custom conversation backgrounds
 
-Under Appearance → Conversation background, choose the default surface, separate sidebar/content images, or a single full background. Images use centered cover sizing with an adjustable readability mask. Switching modes retains images; removal deletes the selected asset. PNG, JPEG, WebP and AVIF uploads are limited to 10 MB and 40 million pixels, converted to WebP within 3840×2160, and stored in `$DSH_HOME/plugins/dsh-theme-prts/backgrounds`. Replacements delete obsolete files. Mode and mask settings use native DSH configuration; assets are shared within the instance.
+Under Appearance → Conversation background, choose the default surface, separate left sidebar/content images, or a single full background. In split mode, a content image is anchored to the stable frame, so opening the sidebar does not rescale it. Without a separate left sidebar image, translucent material reveals the content image; a configured left sidebar image still appears on its own. The right sidebar also uses translucent material over a content or full background. Images use centered cover sizing with an adjustable readability mask. Switching modes retains images; removal deletes the selected asset. PNG, JPEG, WebP and AVIF uploads are limited to 10 MB and 40 million pixels, converted to WebP within 3840×2160, and stored in `$DSH_HOME/plugins/dsh-theme-prts/backgrounds`. Replacements delete obsolete files. Mode and mask settings use native DSH configuration; assets are shared within the instance.
 
-With custom backgrounds, material transparency is independently adjustable for the session sidebar, settings rail, Baker bubbles, and Classic user messages (defaults: 94%, 70%, 50%, 50%; higher values are more transparent). Dials support mouse/touch dragging, arrow keys and exact percentage entry. Dragging previews locally; release saves, while Escape or pointer cancellation restores the saved value. When the matching image is active, a slider also adjusts blur from 0–32px (defaults: 8, 12, 8, and 8px), previews changes immediately, and saves on release. Transparency and blur each have their own reset; blur controls stay hidden with solid backgrounds. Rail glass appears and takes effect only in full-background mode; message glass requires a conversation or full background and its matching conversation theme.
+With custom backgrounds, material transparency is independently adjustable for the left sidebar, right sidebar, settings rail, Baker bubbles, and Classic user messages (defaults: 94%, 94%, 70%, 50%, 50%; higher values are more transparent). The left and right sidebar settings are independent; older configurations without right sidebar values initially inherit the left values. Dials support mouse/touch dragging, arrow keys and exact percentage entry. Dragging previews locally; release saves, while Escape or pointer cancellation restores the saved value. When the matching image is active, a slider also adjusts blur from 0–32px (defaults: 8, 8, 12, 8, and 8px), previews changes immediately, and saves on release. Transparency and blur each have their own reset; blur controls stay hidden with solid backgrounds. Right sidebar glass requires a conversation or full background; settings rail glass requires a left sidebar or full background; message glass requires a conversation or full background and its matching conversation theme.
 
 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.
 
-Import displays a summary before confirmation. Preferences-only files preserve destination assets; complete files replace assets and emblem order, with empty slots restoring defaults. Settings absent from older files retain their current values. Unsupported versions are rejected. The maximum file size is 160 MB. Chat data, accounts and connection credentials are not included.
+Import displays a summary before confirmation. Preferences-only files preserve destination assets; complete files replace assets and emblem order, with empty slots restoring defaults. Settings absent from older files retain their current values. Before confirmation, the importer lists fields it does not recognize and cannot preserve. Unsupported versions are rejected. The maximum file size is 160 MB. Chat data, accounts and connection credentials are not included.
 
 A backup download starts before each import. Keep that file for recovery after a refresh, or use **恢复导入前配置** in the current page to restore the state before the latest import. Failed imports attempt to roll back confirmed asset writes. Connection loss or concurrent edits can prevent full recovery; the UI reports failures so the saved backup can be imported after checking the current state.

package/README.md

@@ -90,18 +90,20 @@ npm run check
 
 ### 自定义会话背景
 
-在主题设置的“会话外观 → 会话背景”中，可选择默认背景、分区背景或完整背景。分区模式分别设置侧边栏与会话正文，未上传的一侧沿用默认背景；完整模式以同一张图片贯穿两侧。图片居中铺满，可调节背景遮罩提高文字可读性；切换模式或恢复默认设置不会删除图片，点击“移除图片”才会删除对应素材。
+在主题设置的“会话外观 → 会话背景”中，可选择默认背景、分区背景或完整背景。分区模式分别设置左侧边栏与会话正文；只有正文图片时，左侧边栏使用半透明材质显示其下方的背景；左侧边栏有独立图片时，仍显示自己的图片。右侧边栏在正文或完整背景上也使用半透明材质。完整模式以同一张图片贯穿各区域。图片居中铺满，可调节背景遮罩提高文字可读性；分区模式下正文图片固定在主框架坐标上，侧栏展开时不重新缩放图片。切换模式或恢复默认设置不会删除图片，点击“移除图片”才会删除对应素材。
 
 支持 PNG、JPEG、WebP、AVIF，单张不超过 10 MB、4000 万像素。服务端自动转为 WebP 并限制在 3840×2160 内，保存在 `$DSH_HOME/plugins/dsh-theme-prts/backgrounds`。替换或移除后清理旧图片，不保留历史原图。模式和遮罩通过 DSH 原生配置同步，图片在当前实例共享。
 
-自定义背景下，可分别调整会话列表侧栏、设置侧栏、Baker 气泡和经典主题用户消息的材质透明度，默认值为 94%、70%、50%、50%（数值越高越透明）。圆环支持鼠标或触屏拖动、方向键微调与直接输入百分比；拖动时本地预览，松手保存，Esc 或指针取消时回退。对应图片启用后，还可用滑杆调整模糊度（0–32px，默认依次为 8、12、8、8px），调节时预览，松手后保存。透明度和模糊度均可单独恢复默认；纯色背景不显示模糊度调节。设置侧栏材质仅在完整背景模式显示并生效；消息材质需要启用正文或完整背景，并在相应会话主题下生效。
+自定义背景下，可分别调整左侧边栏、右侧边栏、设置侧栏、Baker 气泡和经典主题用户消息的材质透明度，默认值依次为 94%、94%、70%、50%、50%（数值越高越透明）。左侧边栏与右侧边栏的透明度和模糊度可独立设置；旧配置没有右侧边栏数值时，初始沿用左侧边栏数值。圆环支持鼠标或触屏拖动、方向键微调与直接输入百分比；拖动时本地预览，松手保存，Esc 或指针取消时回退。对应图片启用后，还可用滑杆调整模糊度（0–32px，默认依次为 8、8、12、8、8px），调节时预览，松手后保存。透明度和模糊度均可单独恢复默认；纯色背景不显示模糊度调节。右侧边栏材质需要启用正文或完整背景；设置侧栏材质需要启用左侧边栏或完整背景；消息材质需要启用正文或完整背景，并在相应会话主题下生效。
 
 “会话主题”和“会话背景”分为独立设置页。输入框增强毛玻璃位于背景页：默认背景下可以开关，分区或完整背景下始终开启，切回默认背景时恢复原有开关选择。Baker 可开启“回复完成前显示加载动画”（默认关闭），每轮正在生成的正文暂以三点明暗动画代替，完成或中断后显示收到的正文；经典主题、思考过程与工具卡片不受此开关影响。
 
+背景图片可设置独立的保护区域：点击「保护重要区域」，在弹窗中拖动默认保护框移动或拖动四边或四角缩放，原图边缘显示百分比坐标尺。侧栏按当前高度并排预览较窄／较宽侧栏，正文与完整背景并排预览横向／纵向窗口，实时显示裁剪效果，无法保留完整区域时仅在设置中提示。保存后保持居中铺满，仅在必要时最小幅度移动图片以保住保护框；框无法完整容纳时，横向优先保留中心、纵向优先保留顶端，并限制偏移以避免露底。清除保护区域后恢复居中裁剪；替换图片会清除旧框。保护区域随图片在当前实例同步，并包含在完整主题导入导出中。
+
 ### 导入与导出主题
 
 点击主题设置底部、与「恢复默认」并列的「导入与导出」，在弹窗中下载 `.prts-theme.json` 文件。「包含自定义素材」默认勾选：包含全部主题设置，以及当前已配置的背景图片、用户／AI 头像、首页与正文徽记及排列。头像保留原图和裁剪参数，徽记保留原图和编辑参数，背景保存当前使用的 WebP 图片；历史素材和临时草稿不包含在内。取消勾选则仅导出设置。
 
-导入时先读取文件并显示摘要，确认后保存到当前 DSH 实例。仅配置文件保留目标端现有素材；完整文件替换素材及徽记排列，空素材项恢复默认。旧文件缺少的设置保留当前值；不支持的文件版本会提示更新。文件最大 160 MB，不包含会话、账户或连接凭据。
+导入时先读取文件并显示摘要，确认后保存到当前 DSH 实例。仅配置文件保留目标端现有素材；完整文件替换素材及徽记排列，空素材项恢复默认。旧文件缺少的设置保留当前值；遇到当前版本不认识的配置字段时，确认前会列出导入后无法保留的字段；不支持的文件版本会提示更新。文件最大 160 MB，不包含会话、账户或连接凭据。
 
 每次导入前会发起当前配置备份下载，请确认保存。当前页面也可点击「恢复导入前配置」，恢复最近一次导入前的状态；刷新后请使用下载的备份文件。保存失败会尝试回退已确认写入的素材；若连接中断或其他页面并发修改导致无法完整恢复，会显示错误，可在确认当前状态后重新导入备份。