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

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # 变更记录
 
+## 2.3.0 - 2026-10-22
+
+以下为相对 `v2.2.0` 的变化：
+
+- 新增主题配置与素材导入导出：可仅导出设置，或包含背景、头像、徽记及排列；保留头像裁剪与徽记编辑参数。导入前展示摘要并发起备份下载，支持恢复当前页面最近一次导入前的配置，并处理保存失败与并发冲突。
+- 自定义会话背景新增默认开启、可关闭的徽记柔光增强，改善新会话徽记辨识度；切换日夜配色时立即重绘徽记。
+- 完善通知卡片的圆角、半透明底色、正文层级与键盘焦点样式，保留宿主折叠和滚动行为；修复 Windows 主栏圆角裁剪造成的背景露底。
+- 修复网页切换到其他浏览器标签页再切回时，新会话粒子徽记意外重复扩散重组的问题。
+- 修复新会话发送后徽记爆散、汇聚卡顿：消除重复动画循环，避免正文加载打断过渡，并在容器尺寸变化时保留粒子位置与速度。
+- 更新内置 Markdown 渲染依赖至修复版本，避免特定多行链接引用及 HTML 输入引起的解析耗时异常。
+- 当前支持 DSH `0.2.1-rc.2` 的 Web 端与官方桌面客户端。本次粒子修复已在本地 Web 容器实机验收；桌面端沿用此前基础功能验收范围，Windows 圆角修复仅经浏览器布局模拟验证。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.2.0 - 2026-10-20
 
 以下为相对 `v2.1.1` 的变化：

package/README.en.md

@@ -95,3 +95,11 @@ Under Appearance → Conversation background, choose the default surface, separa
 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.
 
 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.
+
+### 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.
+
+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

@@ -97,3 +97,11 @@ npm run check
 自定义背景下，可分别调整会话列表侧栏、设置侧栏、Baker 气泡和经典主题用户消息的材质透明度，默认值为 94%、70%、50%、50%（数值越高越透明）。圆环支持鼠标或触屏拖动、方向键微调与直接输入百分比；拖动时本地预览，松手保存，Esc 或指针取消时回退。对应图片启用后，还可用滑杆调整模糊度（0–32px，默认依次为 8、12、8、8px），调节时预览，松手后保存。透明度和模糊度均可单独恢复默认；纯色背景不显示模糊度调节。设置侧栏材质仅在完整背景模式显示并生效；消息材质需要启用正文或完整背景，并在相应会话主题下生效。
 
 “会话主题”和“会话背景”分为独立设置页。输入框增强毛玻璃位于背景页：默认背景下可以开关，分区或完整背景下始终开启，切回默认背景时恢复原有开关选择。Baker 可开启“回复完成前显示加载动画”（默认关闭），每轮正在生成的正文暂以三点明暗动画代替，完成或中断后显示收到的正文；经典主题、思考过程与工具卡片不受此开关影响。
+
+### 导入与导出主题
+
+点击主题设置底部、与「恢复默认」并列的「导入与导出」，在弹窗中下载 `.prts-theme.json` 文件。「包含自定义素材」默认勾选：包含全部主题设置，以及当前已配置的背景图片、用户／AI 头像、首页与正文徽记及排列。头像保留原图和裁剪参数，徽记保留原图和编辑参数，背景保存当前使用的 WebP 图片；历史素材和临时草稿不包含在内。取消勾选则仅导出设置。
+
+导入时先读取文件并显示摘要，确认后保存到当前 DSH 实例。仅配置文件保留目标端现有素材；完整文件替换素材及徽记排列，空素材项恢复默认。旧文件缺少的设置保留当前值；不支持的文件版本会提示更新。文件最大 160 MB，不包含会话、账户或连接凭据。
+
+每次导入前会发起当前配置备份下载，请确认保存。当前页面也可点击「恢复导入前配置」，恢复最近一次导入前的状态；刷新后请使用下载的备份文件。保存失败会尝试回退已确认写入的素材；若连接中断或其他页面并发修改导致无法完整恢复，会显示错误，可在确认当前状态后重新导入备份。

package/THIRD_PARTY_NOTICES.md

@@ -48,7 +48,7 @@ After receiving a verifiable request, the project maintainer will review it prom
 
 ## Markdown preview rendering
 
-Session hover previews use [markdown-it](https://github.com/markdown-it/markdown-it) 14.3.2 (MIT).
+Session hover previews use [markdown-it](https://github.com/markdown-it/markdown-it) 14.3.3 (MIT).
 The browser build includes entities, linkify-it, mdurl, punycode.js, and uc.micro.
 Their copyright and license notices are retained in the generated lib/client.js.
 This is a build-time dependency; DSH does not need to install it separately at runtime.

package/THIRD_PARTY_NOTICES.zh-CN.md

@@ -48,7 +48,7 @@ P.R.T.S. 头像、阵营标识及衍生徽记仅收录于个人、非商业同
 
 ## Markdown 预览渲染
 
-会话悬停预览使用 [markdown-it](https://github.com/markdown-it/markdown-it) 14.3.2（MIT）。
+会话悬停预览使用 [markdown-it](https://github.com/markdown-it/markdown-it) 14.3.3（MIT）。
 构建时将其浏览器版本及所包含的 entities、linkify-it、mdurl、punycode.js、uc.micro 一并打包；
 对应版权与许可全文保留在生成的 lib/client.js 中。该依赖仅用于构建，不要求 DSH 在运行时另行安装。
 预览禁用原始 HTML 和远程图片加载。