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

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # 变更记录
 
+## 2.5.1 - 2026-10-25
+
+以下为相对 `v2.5.0` 的变化：
+
+- 扩展 DSH Web 兼容声明，同时支持 `0.2.1-rc.2` 和 `0.2.1-rc.3`。rc.3 新增的左侧「更多」、会话「更多会话视图」和右侧「更多工具」菜单沿用主题外壳材质与原生选项交互，已检查本地真实页面及窄窗口布局。
+- 为主题设置中的「恢复默认」按钮补齐四角悬停、聚焦和按下锁定效果，与「导入与导出」保持一致；恢复前的确认流程不变。
+- 新增菜单交互及设置底部按钮回归覆盖。本次无破坏性变更；官方桌面客户端仍以 DSH `0.2.1-rc.2` 的实机验收为准，rc.3 桌面端尚未单独验证。
+- 旧版对应关系不变：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`。Node.js 要求仍为 `>=20.9.0`。
+
+## 2.5.0 - 2026-10-25
+
+以下为相对 `v2.4.0` 的变化：
+
+- 主题文件读取、导出、导入及恢复新增阶段进度与取消操作。取消导入或恢复时，等待当前写入确认后尝试回退素材；最终保存与回退期间不可取消，回退失败时保留错误提示与备份恢复路径。
+- 背景、头像和徽记图片、徽记素材包及主题文件支持拖拽添加，沿用原有文件校验。替换已有背景时，使用展示新旧图片的主题确认弹窗，支持取消和 Esc 关闭。
+- 优化导入导出弹窗：移除导出按钮常驻选中外观，调整两个分块的悬停效果，并在选择文件、等待确认和处理期间保持对应分块高亮。
+- 会话正文中的操作按钮、文件卡片、加载更早按钮、输入框按钮及主题导入导出按钮新增四角悬停与聚焦效果，支持淡入展开、移开淡出及按下锁定；四角尺寸随目标大小调整。工作区与会话卡片的操作按钮保留原有表现。
+- 四角效果复用单个标记层，缓存目标尺寸，动画结束后停止逐帧更新；修复反复移入移出后的延迟、展开或松开后的二次偏移，并在页面失焦或隐藏时停止动画。
+- 原生菜单选项保留宿主悬停与键盘聚焦背景，修复权限菜单与模型菜单效果不一致的问题；菜单外壳继续使用主题材质。
+- 优化设置界面中正文徽记的拖拽排序：拖动时放大并轻微倾斜，相邻卡片平滑让位，松手落位后保存；保留键盘排序、取消和减少动态效果支持。
+- 修复导入分区背景后输入框透明材质未及时初始化、消息泡尾尖与本体透明度和模糊不一致、工具记录文件路径布局异常，以及思考和上下文压缩摘要展开标题出现不协调深色底框的问题。
+- 当前支持 DSH `0.2.1-rc.2` 的 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.4.0 - 2026-10-23
 
 以下为相对 `v2.3.1` 的变化：

package/README.en.md

@@ -17,9 +17,9 @@ The Baker conversation theme is inspired by the messenger in Arknights: Endfield
 
 ## Compatibility
 
-- Supports DeepSeek Harness `0.2.1-rc.2` on Web and the official desktop client. Web was verified on a live local container; the desktop client received a real-device check with no basic functionality issues found. The earlier `0.2.0-rc.2`, `0.1.7`, `0.1.5`, and `0.1.2` release lines are outside the current compatibility declaration.
-- The theme has been checked on a live Web `0.2.1-rc.2` page for mounting, workspaces and session cards, long-title hover behavior, the native conversation width drag control, and narrow-window layout. Browser regression tests cover session status and pending interaction indicators.
-- `engines.dsh` in `package.json` uses the same exact version for plugin market compatibility checks. Other DSH versions require separate verification.
+- Supports DeepSeek Harness `0.2.1-rc.2` and `0.2.1-rc.3` on Web. Official desktop verification remains limited to `0.2.1-rc.2`; rc.3 desktop has not received a separate check. The earlier `0.2.0-rc.2`, `0.1.7`, `0.1.5`, and `0.1.2` release lines are outside the current compatibility declaration.
+- Web checks cover mounting, workspaces and session cards, long-title hover behavior, the native conversation width drag control, and narrow-window layout. The rc.3 More menus in the left sidebar, conversation view header and right sidebar were checked on the live local page, retaining themed menu surfaces and native item hover backgrounds.
+- `engines.dsh` in `package.json` lists only these two release candidates so the plugin market can evaluate compatibility. Other DSH versions require separate verification.
 - For DSH `0.2.0-rc.2`, pin the previous public theme release `@ash-qw/dsh-theme-prts@1.4.2`. For DSH `0.1.7-rc.2`, pin `1.0.2`. For DSH `0.1.2` or `0.1.5`, pin `0.1.102`.
 
 ## Install and update
@@ -98,10 +98,14 @@ Conversation theme and background use separate settings pages. Enhanced composer
 
 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.
 
+Background, avatar and emblem images, emblem bundles, and theme files can be dropped onto their respective upload areas. Add one file at a time; each area retains its existing type and size limits. Replacing a background opens a themed confirmation dialog showing the current and replacement images before saving.
+
 ### 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. 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.
 
+Reading, exporting, importing and restoring show progress by stage. Reading and exporting can be cancelled. Cancelling an import or restore waits for the current write to settle, then attempts to roll back written assets. Cancellation is unavailable during final saving and rollback. The import or export section stays highlighted while its operation is active.
+
 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

@@ -17,9 +17,9 @@ Baker 会话主题参考《明日方舟：终末地》的通讯界面。在主
 
 ## 兼容性
 
-- 当前支持 DeepSeek Harness `0.2.1-rc.2` 的 Web 端与官方桌面客户端。Web 端已在本地容器的真实页面验证；桌面端已实机验收，基础功能未见明显问题。此前的 `0.2.0-rc.2`、`0.1.7`、`0.1.5`、`0.1.2` 发布线不再列入当前兼容声明。
-- 已在 Web 端 `0.2.1-rc.2` 验证主题挂载、工作区和会话卡片、长标题悬停、原生对话宽度拖动及窄窗口布局；会话状态与待处理提示有浏览器回归覆盖。
-- `package.json` 中的 `engines.dsh` 使用相同的精确版本声明，插件市场可据此判断兼容性。其他 DSH 版本需另行验证。
+- 当前支持 DeepSeek Harness `0.2.1-rc.2` 和 `0.2.1-rc.3` 的 Web 端；官方桌面客户端仍以 `0.2.1-rc.2` 的实机验收为准，rc.3 桌面端尚未单独验证。此前的 `0.2.0-rc.2`、`0.1.7`、`0.1.5`、`0.1.2` 发布线不再列入当前兼容声明。
+- Web 端已验证主题挂载、工作区和会话卡片、长标题悬停、原生对话宽度拖动及窄窗口布局。rc.3 新增的左侧「更多」、会话「更多会话视图」及右侧「更多工具」菜单已在本地真实页面检查，保留主题菜单材质及原生选项悬停效果。
+- `package.json` 中的 `engines.dsh` 仅列出这两个候选版本，插件市场可据此判断兼容性。其他 DSH 版本需另行验证。
 - 若仍使用 DSH `0.2.0-rc.2`，请固定上一公开主题版本 `@ash-qw/dsh-theme-prts@1.4.2`；使用 DSH `0.1.7-rc.2` 时请固定 `1.0.2`，使用 DSH `0.1.2` 或 `0.1.5` 发布线时请固定 `0.1.102`。
 
 主题设置通过 DSH 原生配置服务保存，同一 profile 下的在线页面会同步更新。首次接入时，仅当服务端尚未保存主题配置，才迁移当前浏览器的旧设置；已有服务端配置优先。保存冲突或失败会显示提示，不自动重传旧配置；“重试保存”会按当前版本重新提交失败的修改。部分旧版 DSH 的远程访问仅支持内存配置，此时会提示未保存，需要宿主提供持久化支持。升级后需重新加载主题服务端插件，才能注册新增配置。
@@ -100,10 +100,14 @@ npm run check
 
 背景图片可设置独立的保护区域：点击「保护重要区域」，在弹窗中拖动默认保护框移动或拖动四边或四角缩放，原图边缘显示百分比坐标尺。侧栏按当前高度并排预览较窄／较宽侧栏，正文与完整背景并排预览横向／纵向窗口，实时显示裁剪效果，无法保留完整区域时仅在设置中提示。保存后保持居中铺满，仅在必要时最小幅度移动图片以保住保护框；框无法完整容纳时，横向优先保留中心、纵向优先保留顶端，并限制偏移以避免露底。清除保护区域后恢复居中裁剪；替换图片会清除旧框。保护区域随图片在当前实例同步，并包含在完整主题导入导出中。
 
+背景、头像和徽记图片、徽记素材包以及主题文件均支持拖拽到对应上传区域，一次添加一个文件，沿用各入口的类型和大小限制。替换已有背景时，会先在主题弹窗中显示新旧图片，确认后保存。
+
 ### 导入与导出主题
 
 点击主题设置底部、与「恢复默认」并列的「导入与导出」，在弹窗中下载 `.prts-theme.json` 文件。「包含自定义素材」默认勾选：包含全部主题设置，以及当前已配置的背景图片、用户／AI 头像、首页与正文徽记及排列。头像保留原图和裁剪参数，徽记保留原图和编辑参数，背景保存当前使用的 WebP 图片；历史素材和临时草稿不包含在内。取消勾选则仅导出设置。
 
 导入时先读取文件并显示摘要，确认后保存到当前 DSH 实例。仅配置文件保留目标端现有素材；完整文件替换素材及徽记排列，空素材项恢复默认。旧文件缺少的设置保留当前值；遇到当前版本不认识的配置字段时，确认前会列出导入后无法保留的字段；不支持的文件版本会提示更新。文件最大 160 MB，不包含会话、账户或连接凭据。
 
+读取文件、导出、导入及恢复时会显示阶段进度。读取和导出可中途取消；导入或恢复取消后，会等待当前写入确认并尝试回退已写入素材。最终保存与回退阶段不可取消。导入、导出分块在对应操作期间保持高亮。
+
 每次导入前会发起当前配置备份下载，请确认保存。当前页面也可点击「恢复导入前配置」，恢复最近一次导入前的状态；刷新后请使用下载的备份文件。保存失败会尝试回退已确认写入的素材；若连接中断或其他页面并发修改导致无法完整恢复，会显示错误，可在确认当前状态后重新导入备份。