@ash-qw/dsh-theme-prts 2.6.1 → 2.7.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # 变更记录
 
+## 2.7.0 - 2026-11-05
+
+以下为相对 `v2.6.1` 的变化：
+
+- 新增 DSH Web `0.2.2-rc.1` 兼容声明，继续支持 `0.2.1-rc.2`、`0.2.1-rc.3` 和 `0.2.1-rc.5`。
+- 适配新版主栏新增的主面板包裹层，使主题背景和区域样式仍覆盖整个主栏；保留宿主移动端抽屉、遮罩及原生交互，不接管页面切换或思考文本处理。
+- **重要实验功能调整：“PRTS 跟随光标（实验）”因实机测试表现不佳，现暂时停用。** 设置中仅保留“系统光标”和“PRTS 原生光标”；已保存或导入的跟随光标配置自动按 PRTS 原生光标运行，无需手动修改配置，不改变其他配色或外观设置。加载旧配置本身不会将回退结果写回服务端。若必须继续使用跟随光标，请保留主题 `2.6.1` 与其支持的 DSH `0.2.1-rc.2`、`0.2.1-rc.3` 或 `0.2.1-rc.5` 组合；主题 `2.6.1` 不声明支持 DSH `0.2.2-rc.1`。
+- 保留跟随光标实现及原生滚动条拖拽时的图层隐藏修正，但不通过设置或导入重新启用该实验模式；补充回退行为、滚动条边界及新版布局定位与清理的回归覆盖。
+- 本次 Web 验证包含 419 项单元测试、49 项浏览器夹具回归和 4 项本地 DSH `0.2.2-rc.1` 实机回归，覆盖主栏与插件页、主题设置及素材配置接口、移动端抽屉与遮罩、设置保存及刷新恢复，以及日夜模式下思考区域的展开和收起。该范围不代表全量浏览器测试均已通过。
+- 官方桌面客户端兼容声明仍以 DSH `0.2.1-rc.2` 的既有实机验收为准；本次改动及其余 DSH 版本尚未单独完成桌面端验收。
+- 旧版对应关系不变：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.6.1 - 2026-11-04
 
 以下为相对 `v2.6.0` 的变化：

package/README.en.md

@@ -17,10 +17,11 @@ The Baker conversation theme is inspired by the messenger in Arknights: Endfield
 
 ## Compatibility
 
-- Supports DeepSeek Harness `0.2.1-rc.2`, `0.2.1-rc.3`, and `0.2.1-rc.5` on Web. Official desktop verification remains limited to `0.2.1-rc.2`; rc.3 and rc.5 desktop have not received separate checks. 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.
+- Supports DeepSeek Harness `0.2.1-rc.2`, `0.2.1-rc.3`, `0.2.1-rc.5`, and `0.2.2-rc.1` on Web. Official desktop verification remains limited to `0.2.1-rc.2`; other desktop versions have not received separate checks. 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.
 - On rc.5, reasoning text processing remains owned by the host; the theme does not override the `text/rawText` contract of `conversation.chat.reasoning.body`. Reasoning expansion, collapse and background surfaces were checked on the live local page.
-- `engines.dsh` in `package.json` lists only these three release candidates so the plugin market can evaluate compatibility. Other DSH versions require separate verification.
+- On `0.2.2-rc.1`, the layout adapter handles the new main-panel wrapper while keeping the entire center column themed. The host retains ownership of the mobile sidebar drawer, mask, and native interactions. Local live Web checks cover the plugin page and theme settings, asset configuration endpoints, the mobile drawer and mask dismissal, settings persistence across reload, and reasoning expansion and collapse in both color schemes. These changes have not received separate desktop verification.
+- `engines.dsh` in `package.json` lists only these four 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
@@ -144,6 +145,8 @@ Full imports delete replaced background WebP files and replace avatar originals;
 
 When the host exposes runtime context registration, each model request also receives the current switch state and these handling instructions proactively.
 
-### Experimental cursor
+### Experimental cursor and upgrade behavior
 
-Under interaction settings, the cursor mode dropdown offers System cursor, PRTS Native cursor and PRTS Follow cursor (experimental). The opt-in Mouse Follower mode animates PRTS images in an isolated DOM layer without a descendant-count cutoff for ordinary backgrounds or large cards. Text, disabled, grab, resize, crop and in-page dialog states share the same renderer. Browser-native menus, iframe boundaries and native drag-and-drop still return control to the browser. Position easing and trails are disabled, but main-thread congestion can still delay movement. Existing preferences remain unchanged; switch back to PRTS Native cursor at any time.
+**PRTS Follow cursor (experimental) is temporarily disabled because it performed poorly in real-device testing.** Interaction settings now offer only System cursor and PRTS Native cursor. The follow cursor implementation is retained. Saved or imported follow cursor preferences run as PRTS Native cursor without changing other colors or appearance settings. New installations default to PRTS Native cursor.
+
+Upgrading the theme from `2.6.1` to `2.7.0` automatically falls back from the experimental follow cursor to PRTS Native cursor without manual configuration changes. System cursor and PRTS Native cursor are unaffected. Loading an old preference alone does not write the fallback back to the server. If the follow cursor is required, keep theme `2.6.1` paired with one of its supported DSH versions: `0.2.1-rc.2`, `0.2.1-rc.3`, or `0.2.1-rc.5`. Theme `2.6.1` does not declare support for DSH `0.2.2-rc.1`.

package/README.md

@@ -17,10 +17,11 @@ Baker 会话主题参考《明日方舟：终末地》的通讯界面。在主
 
 ## 兼容性
 
-- 当前支持 DeepSeek Harness `0.2.1-rc.2`、`0.2.1-rc.3` 和 `0.2.1-rc.5` 的 Web 端；官方桌面客户端仍以 `0.2.1-rc.2` 的实机验收为准，rc.3、rc.5 桌面端尚未单独验证。此前的 `0.2.0-rc.2`、`0.1.7`、`0.1.5`、`0.1.2` 发布线不再列入当前兼容声明。
+- 当前支持 DeepSeek Harness `0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.5` 和 `0.2.2-rc.1` 的 Web 端；官方桌面客户端仍以 `0.2.1-rc.2` 的实机验收为准，其余版本桌面端尚未单独验证。此前的 `0.2.0-rc.2`、`0.1.7`、`0.1.5`、`0.1.2` 发布线不再列入当前兼容声明。
 - Web 端已验证主题挂载、工作区和会话卡片、长标题悬停、原生对话宽度拖动及窄窗口布局。rc.3 新增的左侧「更多」、会话「更多会话视图」及右侧「更多工具」菜单已在本地真实页面检查，保留主题菜单材质及原生选项悬停效果。
 - rc.5 保留宿主对思考文本的处理，主题不接管 `conversation.chat.reasoning.body` 的 `text/rawText`；思考区域展开、收起及背景材质已在本地真实页面验证。
-- `package.json` 中的 `engines.dsh` 仅列出这三个候选版本，插件市场可据此判断兼容性。其他 DSH 版本需另行验证。
+- `0.2.2-rc.1` 适配新版主栏的主面板包裹层，主题区域仍覆盖整个主栏；保留宿主的移动端抽屉侧栏、遮罩及原生交互。已在本地真实 Web 页面验证插件页与主题设置、素材配置接口、移动端抽屉与遮罩关闭、设置保存及刷新恢复，以及思考区域在日夜模式下的展开和收起。本次改动未单独完成桌面端验收。
+- `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 的远程访问仅支持内存配置，此时会提示未保存，需要宿主提供持久化支持。升级后需重新加载主题服务端插件，才能注册新增配置。
@@ -145,6 +146,8 @@ AI 工具与设置界面的文件完全互通，均支持仅配置和包含素
 
 宿主提供运行上下文接口时，主题还会在每轮模型请求中主动提供当前开关状态和以上操作要求，减少 AI 在工具关闭时自行寻找绕行方案。
 
-### 实验光标
+### 实验光标与升级行为
 
-主题设置的交互设置中，光标模式下拉列表可选择“系统光标”“PRTS 原生光标”“PRTS 跟随光标（实验）”。实验模式基于 Mouse Follower，使用独立图层播放 PRTS 按压动画，普通留白和大型卡片不再按后代元素数量停用动画；文字、禁用、抓握、调整尺寸、裁剪及页面内弹窗也由同一图层显示；浏览器原生菜单、跨 iframe 和系统拖放边界仍交还浏览器。位置不加缓动或拖尾，但仍受主线程调度影响，繁忙页面可能出现跟随延迟。实验默认关闭，可随时切回“PRTS 原生光标”，不改变现有光标偏好。
+**“PRTS 跟随光标（实验）”因实机测试表现不佳，现暂时停用。** 主题设置的交互设置中，光标模式仅保留“系统光标”和“PRTS 原生光标”。跟随光标实现代码保留；已保存或导入的跟随光标配置会按 PRTS 原生光标运行，不修改其他配色或外观设置。首次安装默认使用 PRTS 原生光标。
+
+从主题 `2.6.1` 升级至 `2.7.0` 时，实验性跟随光标会自动回退为 PRTS 原生光标，无需手动修改配置；系统光标与 PRTS 原生光标不受影响。加载旧配置本身不会将回退结果写回服务端。若必须继续使用跟随光标，请保留主题 `2.6.1` 及其支持的 DSH `0.2.1-rc.2`、`0.2.1-rc.3` 或 `0.2.1-rc.5` 组合；主题 `2.6.1` 不声明支持 DSH `0.2.2-rc.1`。