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

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # 变更记录
 
+## 2.7.1 - 2026-11-05
+
+以下为相对 `v2.7.0` 的变化：
+
+- 修复新版 DSH 中工作区卡片悬停时操作按钮错位、会话卡片悬停时操作按钮不可见的问题，同时兼容旧版嵌套按钮和新版直接按钮结构。
+- 修复会话置顶标记的布局及可见性：置顶会话在悬停、菜单展开及设为当前会话时仍显示标记；修复当前会话长标题在未悬停时越出卡片边缘的问题。
+- 将输入框玻璃材质从 SVG 折射和通道分色调整为原生 5px 背景模糊及 50% 底色不透明度，保留凹槽轮廓、描边和高光，降低侧栏交互时的渲染开销。用户已在 Edge Web 端确认侧脊弹出更流畅；未修改侧脊动画本身，不代表桌面端性能实测结论。
+- 修复切换会话时输入框先显示基础底板、再切换玻璃材质的闪烁：在新输入框的 DOM 变更微任务中挂载装饰层，并在宿主 React 提交前使用同材质占位，保留原生 5px 模糊、50% 底色及现有轮廓，不修改会话切换逻辑或草稿内容。
+- 修复 DSH `0.2.2-rc.1` 在 macOS 桌面端暗色外观下，原生侧栏底色覆盖分区壁纸、遮挡完整背景的问题（#4）。仅提高对应背景规则的选择器优先级，不使用 `!important`，保留悬浮导航条透明效果。新增 12 项浏览器回归，模拟新旧 macOS 宿主样式及 Web 布局；该覆盖不等同于 macOS 官方桌面客户端实机验收。
+- 验证：`npm run check` 的 423 项检查通过。侧栏卡片、输入框、背景及相关扩展浏览器回归 61 项中 60 项通过，1 项旧版正文内边距断言失败，已在未修改基线复现；不宣称全量浏览器回归通过。本地 DSH `0.2.2-rc.1` 连续切换 5 次现有会话，105 次采样未出现可见输入框缺失玻璃材质状态，无页面错误，未发送 AI 请求；已部署并核对客户端构建一致。
+- 无配置格式或插件接口的破坏性变更，无需迁移；输入框材质外观按上述说明调整。**“PRTS 跟随光标（实验）”继续因实机测试表现不佳而暂时停用，本次未重新启用。**
+- DSH 支持范围不变：Web 支持 `0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.5` 和 `0.2.2-rc.1`；官方桌面客户端仍以 `0.2.1-rc.2` 的既有实机验收为准，本次修改及其余版本尚未单独完成桌面端验收。
+- 旧版对应关系不变：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.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`。

package/THIRD_PARTY_NOTICES.md

@@ -61,7 +61,8 @@ Raw HTML and remote image loading are disabled in previews.
 - Retrieved: 2026-10-17
 - License: MIT + Commons Clause License Condition v1.0. This is not plain MIT.
 - The upstream-derived component and CSS are included in `src/vendor/react-bits/`, together with the full license. Used as part of the P.R.T.S. theme message composer, not distributed as a standalone component library.
-- Integration: compile JSX against the host React runtime, scope the original CSS, and mount decorative surfaces behind the native message composer, using the original shape option with the composer notch. The integration uses reduced refraction and channel offsets, a calm center, padded sampling, 5px blur, and 50% composer background opacity.
+- Integration: compile JSX against the host React runtime, scope the original CSS, and mount decorative surfaces behind the native message composer, using the original shape option with the composer notch. The composer uses native 5px backdrop blur and 50% background opacity, with SVG refraction and channel splitting disabled to reduce rendering overhead during sidebar interaction. The notched shape, outline, and glow remain.
+- Newly mounted composers receive a matching native-CSS material placeholder before the first paint; the host React root replaces it on commit, avoiding a bare background while rendering is pending.
 - Local modifications: retain the valid displacement map while a resized shape loads, and stretch shape artwork to current bounds instead of fitting its source aspect ratio. Live boundaries and borders are drawn by CSS; refraction maps update after resizing settles so asynchronous artwork cannot control composer layout.
 - Attached composer menus reuse the host material plate with CSS tint and blur overrides; they do not mount this component or change menu layout, borders, or shadows.
 

package/THIRD_PARTY_NOTICES.zh-CN.md

@@ -60,7 +60,8 @@ P.R.T.S. 头像、阵营标识及衍生徽记仅收录于个人、非商业同
 - 获取日期：2026-10-17
 - 许可证：MIT + Commons Clause License Condition v1.0，并非纯 MIT。
 - 基于上游的组件、样式及完整许可文本保存在 `src/vendor/react-bits/`。作为 P.R.T.S. 主题输入框的一部分使用，不作为独立组件库分发。
-- 接入方式：将 JSX 编译后使用宿主 React，限定原样式作用域，在输入框内容后挂载装饰层，通过原组件的 shape 参数适配输入框凹槽，降低折射及分色偏移，设置平稳中央区域并为采样画布留边；使用 5px 模糊，输入框底色不透明度为 50%。
+- 接入方式：将 JSX 编译后使用宿主 React，限定原样式作用域，在输入框内容后挂载装饰层，通过原组件的 shape 参数适配输入框凹槽。输入框使用原生 5px 背景模糊及 50% 底色不透明度，停用 SVG 折射和通道分色以降低侧栏交互期间的渲染开销，保留凹槽轮廓、描边和高光。
+- 新输入框在首次绘制前挂载同材质的原生 CSS 占位层，由宿主 React 根节点在提交时替换，避免等待渲染期间短暂露出基础底板。
 - 本地修改：尺寸变化、新轮廓加载期间保留有效折射图，轮廓按当前尺寸铺满，不按原图宽高比等比适配。实际边界与描边由 CSS 同步绘制，折射图在缩放稳定后更新，避免异步轮廓影响输入框布局。
 - 输入框附属菜单复用宿主已有背景层，仅调整 CSS 底色和模糊参数，不挂载此组件，不改变菜单布局、描边或阴影。