@ash-qw/dsh-theme-prts 0.1.93 → 0.1.94

package/CHANGELOG.md

@@ -1,6 +1,11 @@
 # 变更记录
 
-## 0.1.93 - 未发布
+## 0.1.94 - 2026-09-03
+
+- 修复工作区与会话悬停动画触发横向滚动条，避免侧栏尺寸跳变。
+- 插件基础设置改为基于实际容器宽度响应，在手机和窄面板中自动纵向排列。
+
+## 0.1.93 - 2026-09-02
 
 - 将安装说明改为直接从 npm 安装和更新。
 - 新增用于 npm 检索的关键词元数据。

package/README.en.md

@@ -11,48 +11,46 @@ A personal, non-commercial Arknights / P.R.T.S. fan UI plugin for DeepSeek Harne
 >
 > This project and its release packages may be suspended, restricted, or have relevant material removed at any time in response to a rights-holder request, platform policy, or maintainer decision. Continued availability is not guaranteed.
 
-Target: `deepseek-harness:0.1.1-rc.2`. The theme is disabled by default.
+Tested with DeepSeek Harness Web `0.1.1-rc.2`. The theme is disabled by default.
 
 ## Install and update
 
-The package is published publicly on npm and requires no GitHub login or access token. If DeepSeek Harness runs in a Docker container named `deepseek-harness`, use the same commands to install or update:
+In an environment where DSH Web already runs normally, execute:
 
 ```bash
-docker exec deepseek-harness dsh plugin --profile web add @ash-qw/dsh-theme-prts
-docker restart deepseek-harness
+npx @deepseek-ai/dsh plugin --profile web add @ash-qw/dsh-theme-prts
 ```
 
-This installs the npm `latest` version. To pin a release, append a specific version to the package name, such as `@ash-qw/dsh-theme-prts@<version>`. If `dsh` runs directly on the host, omit `docker exec deepseek-harness` from the first command.
+Restarting DSH Web after installation or update is recommended to ensure the theme is fully loaded. Then enable it under “Settings → Plugins → P.R.T.S.” The Rhodes Island emblem at the upper left of the main interface opens the complete appearance controls.
 
-Open `http://<NAS-IP>:3080`, enable the theme under “Settings → Plugins → P.R.T.S.,” then use the upper-left Rhodes Island emblem for the complete appearance controls. In Docker deployments, the plugin persists under `/data/profiles/web` and survives normal container recreation.
+The theme is published publicly on npm and requires no GitHub login or access token. Run the install command again to update to `latest`; to pin a release, use `@ash-qw/dsh-theme-prts@<version>`. If the command reports `pnpm not found`, install pnpm first.
 
 ## Current feature set
 
-- Facility-style P.R.T.S. surfaces with complete SVG contours, distinct workspace/session spines, and compact right-edge actions;
-- layered city silhouettes moving like a view through a train window on workspace hover, plus a mixed-tempo recording waveform on session hover;
-- a Codex-like conversation scale with Q/A previews, local wheel scrolling, and click-to-message navigation;
-- day/night switching synchronized with the native Harness theme state;
-- off, soft, standard, and clear material levels for composers, menus, previews, and overlays;
-- Rhodes Island, Lungmen, Penguin Logistics, Rhine Lab, and Reunion particle marks with structure-complete orthogonal layouts and independent five-level conversation/hero density; regular conversations also expose a 0×–2× scroll-follow speed, where faster movement reaches fracture and faction changes sooner;
-- a staged P.R.T.S. startup sequence on manual theme enable and activated-theme refresh, using the original P.R.T.S. mark, progress telemetry, a compact phone treatment, and a reduced-motion completion state;
-- desktop, tablet, phone, reduced-motion, and reduced-transparency accommodations, with an option to keep the leftmost P.R.T.S. navigation hidden by default at every viewport width;
+- Facility-style P.R.T.S. / Rhodes Island / RIIC workspaces, sessions, and conversations;
+- day/night modes synchronized with Harness, three appearance presets, and four material levels;
+- city silhouettes, faction particle marks, session waveforms, and a P.R.T.S. startup sequence;
+- a conversation scale with Q/A previews and click-to-message navigation;
+- desktop, tablet, phone, reduced-motion, and reduced-transparency accommodations;
 - no runtime network requests, analytics, or telemetry.
 
-## Settings architecture
+## Usage and settings
 
-The Rhodes Island emblem at the upper left opens the complete appearance panel. It provides three presets and manual groups for environment texture, particle marks, interface material, default navigation visibility, accessibility, and conversation navigation. The particle follow-speed range previews live, reports the estimated viewports per reassembly, and saves when the interaction completes. Conversation navigation configures the scale rail’s maximum distance from the left sidebar and keeps a spatial cross-section visible for the selected distance, automatic centering, or a specific hidden reason. Visual edits display `CUSTOM`; default navigation visibility and particle follow speed remain independent from visual presets.
+“Settings → Plugins → P.R.T.S.” provides the theme and startup-animation switches. The Rhodes Island emblem at the upper left of the main interface provides presets, environment texture, particle marks, interface material, navigation, accessibility, and conversation navigation controls.
 
-“Settings → Plugins → P.R.T.S.” contains only the theme and startup-animation switches in the standard host layout. The animation preference remains editable while the theme is disabled or safe mode is active; the Rhodes Island emblem continues to own the complete appearance controls.
+The theme does not proactively restyle menus, dialogs, or overlays created by third-party plugins.
 
-Preferences still use the `dsh.ui.prts.v1` browser key, now with a v8 payload. Existing v1/v2/v3/v4/v5/v6/v7 values migrate automatically, with default navigation hiding kept off and particle follow speed retaining the previous 1× behavior; migration also covers the old split glass flags, `liquid`, `full` motion, and retired organic/hex particle settings.
+## Recovery and removal
 
-## Floating surface compatibility
+Append `?prts-safe=1` to block all visual mounts while retaining the basic switches and recovery note under “Settings → Plugins → P.R.T.S.” Deleting `dsh.ui.prts.v1` returns the next load to the default disabled state.
 
-The theme owns only P.R.T.S. UI and Harness surfaces that are stably linked to recognized host controls through `aria-controls`, `aria-describedby`, or `aria-owns`. Unknown Body Portals and menus, tooltips, toasts, dialogs, or drawers created by other plugins keep their original DOM and styling.
+```bash
+npx @deepseek-ai/dsh plugin --profile web remove @ash-qw/dsh-theme-prts
+```
 
-A third-party plugin may explicitly opt in by setting `data-prts-surface="menu|listbox|popover|dialog"` on the surface or its Portal root. Adding, changing, and removing the attribute is supported at runtime. `menu`, `listbox`, and `popover` may use the selected glass level; `dialog` always uses an opaque panel without live backdrop blur to avoid jank on large right-side surfaces. `data-prts-preserve-popup-style` remains available as an explicit opt-out for one compatibility cycle.
+Restarting DSH Web after removal is recommended. Browser theme preferences are retained. Avoid enabling multiple full-page themes at once because their CSS may conflict.
 
-## Development checks
+## Development
 
 Node.js 18 or newer is required:
 
@@ -61,31 +59,4 @@ npm ci
 npm run check
 ```
 
-The npm distribution name is `@ash-qw/dsh-theme-prts`; both `cordis.patch.yml` and the client ModuleLoader ID use that package name while the internal runtime plugin ID remains `dsh-theme-prts`. Maintainer release instructions are in [RELEASING.md](https://github.com/ash-qw/dsh-theme-prts/blob/main/RELEASING.md).
-
-## Read-only live acceptance
-
-```bash
-PRTS_LIVE_TARGET=<NAS-IP>:3080 npm run test:e2e:live
-```
-
-The suite temporarily proxies trusted `127.0.0.1:3080` to the target without changing Docker networking, reverse proxy, or DNS. Without `PRTS_LIVE_WRITE`, it creates no session and performs no model call.
-
-## Recovery and removal
-
-Append `?prts-safe=1` to block all visual mounts while retaining the basic switches and recovery note under “Settings → Plugins → P.R.T.S.” Deleting `dsh.ui.prts.v1` returns the next load to the default disabled state.
-
-```bash
-docker exec deepseek-harness dsh plugin --profile web remove dsh-theme-prts
-docker restart deepseek-harness
-```
-
-Other installed skins are not modified. Avoid enabling multiple full-page themes at once because their CSS may conflict.
-
-## Changelog
-
-See [CHANGELOG.md](CHANGELOG.md) for release history.
-
-## Rights
-
-Original code is provided under the MIT License. Third-party names, character images, emblems, and derivative material are outside the MIT grant, and this project grants no downstream rights in that material. See [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).
+See [CHANGELOG.md](CHANGELOG.md) for release history and [RELEASING.md](RELEASING.md) for maintainer release instructions.

package/README.md

@@ -11,65 +11,34 @@
 >
 > 本项目及其发行包可能因权利人请求、平台政策或维护者决定，随时暂停发布、限制下载或移除相关素材，不保证持续提供。
 
-目标环境：`deepseek-harness:0.1.1-rc.2`。主题安装后默认关闭，不会立即改变页面。
+已适配 DeepSeek Harness Web `0.1.1-rc.2`。主题安装后默认关闭，不会立即改变页面。
 
 ## 安装与更新
 
-包已公开发布到 npm，无需 GitHub 登录或访问令牌。若 DeepSeek Harness 运行在名为 `deepseek-harness` 的 Docker 容器中，安装或更新均使用：
+在已经可以正常运行 DSH Web 的环境中执行：
 
 ```bash
-docker exec deepseek-harness dsh plugin --profile web add @ash-qw/dsh-theme-prts
-docker restart deepseek-harness
+npx @deepseek-ai/dsh plugin --profile web add @ash-qw/dsh-theme-prts
 ```
 
-命令默认安装 npm `latest` 版本；如需锁定版本，可在包名后追加具体版本号，例如 `@ash-qw/dsh-theme-prts@<版本号>`。若 `dsh` 直接运行在宿主机上，去掉命令开头的 `docker exec deepseek-harness` 即可。
+安装或更新后建议重新启动 DSH Web，以确保主题被完整加载。然后进入“Settings → 插件 → P.R.T.S.”启用主题；完整外观设置位于主界面左上角的罗德岛徽记。
 
-打开 `http://<NAS-IP>:3080`，进入“Settings → 插件 → P.R.T.S.”启用主题；启用后通过左上罗德岛徽记调整完整外观。Docker 环境中的插件保存在持久化的 `/data/profiles/web`，正常重建容器不会丢失。
+主题包已公开发布到 npm，无需 GitHub 登录或访问令牌。重新执行安装命令即可更新到 `latest`；如需锁定版本，可使用 `@ash-qw/dsh-theme-prts@<版本号>`。若命令提示 `pnpm not found`，请先安装 pnpm。
 
 ## 当前特性
 
-- P.R.T.S. / Rhodes Island / RIIC 设施化视觉，工作区与会话采用完整 SVG 轮廓、差异化侧脊和紧凑右侧操作按钮；
-- 工作区悬停时以分层城市剪影塑造列车窗外的远近运动，会话悬停时在右侧显示急缓交错的录音声纹；
-- Codex 风格的对话刻度栏，支持问答预览、刻度内滚动和点击定位；
-- 日间 / 夜间切换与 Harness 原生主题状态同步；
-- 输入框、菜单、预览和浮层支持关闭、柔和、标准、清晰四档玻璃材质；
-- 罗德岛、龙门、企鹅物流、莱茵生命、整合运动粒子徽记，使用结构完整的正交点阵，并支持独立的新会话 / 普通会话五档密度；普通会话还可在 0×–2× 间调整滚动跟随速度，速度越快，徽记越快移动、破碎并换阵营；
-- 主题手动启用及已激活主题刷新时播放 P.R.T.S. 启动序列，使用原始 P.R.T.S. 徽记、阶段进度条、移动端精简和减少动效完成态；
-- 1440px 桌面、1024px 平板和 640px 以下手机布局，可设置在任意宽度下默认隐藏最左侧 P.R.T.S. 导航，并支持减少动效和降低透明度提示；
+- P.R.T.S. / Rhodes Island / RIIC 设施化工作区、会话与对话界面；
+- 与 Harness 同步的日间 / 夜间模式、三套外观预设和四档界面材质；
+- 城市剪影、阵营粒子徽记、会话声纹和 P.R.T.S. 启动序列；
+- 支持问答预览与点击定位的对话刻度导航；
+- 桌面、平板、手机、减少动效和降低透明度适配；
 - 无运行时网络请求、分析统计或额外遥测。
 
-## 设置架构
+## 使用与设置
 
-主界面左上角的罗德岛徽记是完整外观设置入口。展开后可选择三套预设，或分别调整环境底纹、粒子徽记、界面材质、导航栏默认隐藏、辅助功能和会话导航；粒子区的跟随速度滑杆会实时预览，显示预计多少个视口后重组，并在操作结束后保存。会话导航可配置刻度栏离左侧边栏的最大距离，并通过常驻空间剖面预览所选距离、自动居中或隐藏原因。手动修改视觉参数会显示 `CUSTOM`；导航栏默认隐藏和跟随速度均与视觉预设独立。
+“Settings → 插件 → P.R.T.S.”提供主题总开关和启动动画开关。主界面左上角的罗德岛徽记提供预设、环境底纹、粒子徽记、界面材质、导航栏、辅助功能和会话导航设置。
 
-Harness 的“Settings → 插件 → P.R.T.S.”仅保留主题总开关和启动动画开关，并使用宿主标准设置布局。主题关闭或处于安全模式时，启动动画偏好仍可提前修改；完整外观继续由左上罗德岛徽记维护。
-
-偏好继续存放在 `dsh.ui.prts.v1`，当前内容结构为 v8。旧 v1/v2/v3/v4/v5/v6/v7 配置会自动迁移，导航栏默认隐藏保持关闭，粒子跟随速度保持原有的 1× 行为；迁移还包含旧玻璃开关、`liquid` 玻璃、`full` 动效字段，以及已退役的有机分布与六边形点阵粒子配置。
-
-## 浮层兼容边界
-
-主题只接管 P.R.T.S. 自有界面，以及通过 `aria-controls`、`aria-describedby` 或 `aria-owns` 与已识别 Harness 控件稳定关联的宿主浮层。未知的 Body Portal、其它插件菜单、提示、Toast、弹窗和抽屉保持原始 DOM 与样式，不再尝试自动套用主题。
-
-第三方插件如需主动使用 P.R.T.S. 浮层材质，可在浮层本身或其 Portal 根节点声明 `data-prts-surface="menu|listbox|popover|dialog"`；运行时支持动态添加、修改和移除该属性。`menu`、`listbox` 与 `popover` 可使用当前玻璃档位，`dialog` 始终使用不含实时模糊的实色面板，以避免大面积右侧弹窗卡顿。兼容属性 `data-prts-preserve-popup-style` 在一个版本周期内继续作为明确退出开关。
-
-## 开发验证
-
-需要 Node.js 18 或更高版本：
-
-```bash
-npm ci
-npm run check
-```
-
-项目的 npm 分发名是 `@ash-qw/dsh-theme-prts`；`cordis.patch.yml` 包名和客户端 ModuleLoader ID 都与它保持一致，内部运行时插件 ID 仍为 `dsh-theme-prts`。维护者发布步骤见 [RELEASING.md](https://github.com/ash-qw/dsh-theme-prts/blob/main/RELEASING.md)。
-
-## 只读真实环境验收
-
-```bash
-PRTS_LIVE_TARGET=<NAS-IP>:3080 npm run test:e2e:live
-```
-
-测试期间会把受信任的 `127.0.0.1:3080` 临时转发到目标服务，不修改 Docker 网络、反代或 DNS。不设置 `PRTS_LIVE_WRITE` 时不会创建会话或产生模型调用。
+主题不会主动改写第三方插件的菜单、弹窗和浮层样式。
 
 ## 安全模式与恢复
 
@@ -78,16 +47,18 @@ PRTS_LIVE_TARGET=<NAS-IP>:3080 npm run test:e2e:live
 ## 卸载
 
 ```bash
-docker exec deepseek-harness dsh plugin --profile web remove dsh-theme-prts
-docker restart deepseek-harness
+npx @deepseek-ai/dsh plugin --profile web remove @ash-qw/dsh-theme-prts
 ```
 
-卸载不会删除浏览器偏好，也不会修改其他已安装皮肤。多个全局主题可能发生 CSS 冲突，建议一次只启用一个完整 UI 主题。
+卸载后建议重新启动 DSH Web。浏览器中的主题偏好不会被删除。多个全局主题可能发生 CSS 冲突，建议一次只启用一个完整 UI 主题。
 
-## 变更记录
+## 开发
 
-版本变化见 [CHANGELOG.md](CHANGELOG.md)。
+需要 Node.js 18 或更高版本：
 
-## 权利说明
+```bash
+npm ci
+npm run check
+```
 
-原创代码以 MIT 许可证提供。第三方名称、角色图像、徽记及其衍生素材不属于 MIT 授权范围；本项目对这些素材不授予任何下游使用权。详见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。
+版本变化见 [CHANGELOG.md](CHANGELOG.md)，维护者发布步骤见 [RELEASING.md](RELEASING.md)。