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

package/CHANGELOG.md

@@ -0,0 +1,36 @@
+# 变更记录
+
+## 0.1.94 - 2026-09-03
+
+- 修复工作区与会话悬停动画触发横向滚动条，避免侧栏尺寸跳变。
+- 插件基础设置改为基于实际容器宽度响应，在手机和窄面板中自动纵向排列。
+
+## 0.1.93 - 2026-09-02
+
+- 将安装说明改为直接从 npm 安装和更新。
+- 新增用于 npm 检索的关键词元数据。
+- 新增普通会话粒子徽记 0×–2× 跟随移动速度设置，支持视口周期提示、实时预览、净滚动位移触发及旧偏好迁移。
+- 固定长对话会话刻度栏的几何基准，避免位置随内容高度和刷新偏移。
+- 保留 Harness 宿主弹窗按钮的原生前景与背景配色，避免主题切换后文字不可见。
+- 将维护者发布流程从用户 README 移至独立文档。
+
+## 0.1.92 - 2026-08-31
+
+- 通过 npm Trusted Publishing 发布首个正式公开版本，并生成来源证明。
+- 对齐 npm 包名、Host patch 包名和客户端 ModuleLoader ID。
+
+## 0.1.91 - 2026-08-31
+
+- 发布用于在 npmjs 建立包及 Trusted Publisher 关联的引导版本。
+
+## 历史开发版本
+
+以下版本早于当前受支持的 npmjs 公开发布线：
+
+- `0.1.35` 从过时代码分支构建，`cordis.patch.yml` 使用了错误的包名。
+- `0.1.66` 修复了 Host patch 包名，但没有同步客户端 ModuleLoader ID。
+- `0.1.67` 对齐了三处包名。
+- `0.1.68` 在 Operations Shell 延迟挂载期间继续保持基础主题生效。
+- `0.1.69` 不再占用宿主共享的详情侧栏。
+- `0.1.70` 新增工作区城市剪影、会话录音声纹、刷新启动接管和结构完整的正交粒子徽记。
+- `0.1.73` 保留常规浮层接管与 composer 越界显示，让启动动画主题样式立即生效，并将非启动工作延后至宿主原生启动完成。

package/README.en.md

@@ -11,92 +11,52 @@ 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.
 
-## 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;
-- 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;
-- no runtime network requests, analytics, or telemetry.
-
-## Settings architecture
-
-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, accessibility, and conversation navigation. 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. Range input updates this preview while dragging and saves the preference when the interaction completes. Manual edits display `CUSTOM`; presets do not change the scale distance.
-
-“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.
-
-Preferences still use the `dsh.ui.prts.v1` browser key, now with a v6 payload. Existing v1/v2/v3/v4/v5 values migrate automatically, including the old split glass flags, `liquid`, `full` motion, and retired organic/hex particle settings.
-
-## Floating surface compatibility
+## Install and update
 
-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.
-
-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.
-
-## Build
-
-Node.js 18 or newer is required:
+In an environment where DSH Web already runs normally, execute:
 
 ```bash
-npm ci
-npm run check
-npm run pack:plugin
+npx @deepseek-ai/dsh plugin --profile web add @ash-qw/dsh-theme-prts
 ```
 
-The package is emitted as `ash-qw-dsh-theme-prts-0.1.92.tgz`. Its 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`.
-
-## Public npm package
+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.
 
-The installable tarball can be downloaded directly from npmjs.org without a GitHub login or access token:
+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.
 
-```bash
-npm pack @ash-qw/dsh-theme-prts@0.1.92
-```
-
-When a maintainer pushes a tag matching `package.json` to the public repository, GitHub Actions publishes through npm Trusted Publishing (OIDC) with provenance. The workflow does not publish from the private mirror. For example:
+## Current feature set
 
-```bash
-git tag v0.1.92
-git push public v0.1.92
-```
+- 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.
 
-Version `0.1.35` came from an outdated code branch and shipped an incorrect package name in `cordis.patch.yml`. Version `0.1.66` fixed the Host patch but not the client ModuleLoader ID, `0.1.67` aligned all three package names, `0.1.68` kept the base theme active while Operations Shell mounting was deferred, and `0.1.69` stopped occupying the host's shared details sidebar. Version `0.1.70` added workspace city silhouettes, the session recording waveform, refresh startup takeover, and structure-complete orthogonal particle emblems. Version `0.1.73` retains general floating-surface takeover and composer overflow, applies startup-animation theme styles immediately, and defers non-startup work such as particle fields and interface adapters until native boot completes.
+## Usage and settings
 
-## Docker install
+“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.
 
-```bash
-docker cp ash-qw-dsh-theme-prts-0.1.92.tgz deepseek-harness:/workspace/
-docker exec deepseek-harness dsh plugin --profile web add /workspace/ash-qw-dsh-theme-prts-0.1.92.tgz
-docker restart deepseek-harness
-```
+The theme does not proactively restyle menus, dialogs, or overlays created by third-party plugins.
 
-Enable the theme from “Settings → Plugins → P.R.T.S.,” then use the upper-left Rhodes Island emblem for the complete appearance controls. The plugin persists under `/data/profiles/web`.
+## Recovery and removal
 
-## Read-only live acceptance
+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
-PRTS_LIVE_TARGET=<NAS-IP>:3080 npm run test:e2e:live
+npx @deepseek-ai/dsh plugin --profile web remove @ash-qw/dsh-theme-prts
 ```
 
-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.
+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.
 
-## Recovery and removal
+## Development
 
-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.
+Node.js 18 or newer is required:
 
 ```bash
-docker exec deepseek-harness dsh plugin --profile web remove dsh-theme-prts
-docker restart deepseek-harness
+npm ci
+npm run check
 ```
 
-Other installed skins are not modified. Avoid enabling multiple full-page themes at once because their CSS may conflict.
-
-## 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,96 +11,54 @@
 >
 > 本项目及其发行包可能因权利人请求、平台政策或维护者决定，随时暂停发布、限制下载或移除相关素材，不保证持续提供。
 
-目标环境：`deepseek-harness:0.1.1-rc.2`。主题安装后默认关闭，不会立即改变页面。
+已适配 DeepSeek Harness Web `0.1.1-rc.2`。主题安装后默认关闭，不会立即改变页面。
 
-## 当前特性
-
-- P.R.T.S. / Rhodes Island / RIIC 设施化视觉，工作区与会话采用完整 SVG 轮廓、差异化侧脊和紧凑右侧操作按钮；
-- 工作区悬停时以分层城市剪影塑造列车窗外的远近运动，会话悬停时在右侧显示急缓交错的录音声纹；
-- Codex 风格的对话刻度栏，支持问答预览、刻度内滚动和点击定位；
-- 日间 / 夜间切换与 Harness 原生主题状态同步；
-- 输入框、菜单、预览和浮层支持关闭、柔和、标准、清晰四档玻璃材质；
-- 罗德岛、龙门、企鹅物流、莱茵生命、整合运动粒子徽记，使用结构完整的正交点阵，并支持独立的新会话 / 普通会话五档密度；密度越高，粒子越小且数量越多；
-- 主题手动启用及已激活主题刷新时播放 P.R.T.S. 启动序列，使用原始 P.R.T.S. 徽记、阶段进度条、移动端精简和减少动效完成态；
-- 1440px 桌面、1024px 平板和 640px 以下手机布局，并支持减少动效和降低透明度提示；
-- 无运行时网络请求、分析统计或额外遥测。
-
-## 设置架构
-
-主界面左上角的罗德岛徽记是完整外观设置入口。展开后可选择三套预设，或分别调整环境底纹、粒子徽记、界面材质、辅助功能和会话导航；会话导航可配置刻度栏离左侧边栏的最大距离，并通过常驻空间剖面预览所选距离、自动居中或隐藏原因。拖动滑块只更新预览，完成操作后才保存并应用。手动修改会显示 `CUSTOM`。预设不会修改刻度栏距离。
-
-Harness 的“Settings → 插件 → P.R.T.S.”仅保留主题总开关和启动动画开关，并使用宿主标准设置布局。主题关闭或处于安全模式时，启动动画偏好仍可提前修改；完整外观继续由左上罗德岛徽记维护。
-
-偏好继续存放在 `dsh.ui.prts.v1`，当前内容结构为 v6。旧 v1/v2/v3/v4/v5 配置会自动迁移，包含旧玻璃开关、`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 或更高版本：
+在已经可以正常运行 DSH Web 的环境中执行：
 
 ```bash
-npm ci
-npm run check
-npm run pack:plugin
+npx @deepseek-ai/dsh plugin --profile web add @ash-qw/dsh-theme-prts
 ```
 
-成功后会生成 `ash-qw-dsh-theme-prts-0.1.92.tgz`。npm 分发名是 `@ash-qw/dsh-theme-prts`；`cordis.patch.yml` 包名和客户端 ModuleLoader ID 都与它保持一致，内部运行时插件 ID 仍为 `dsh-theme-prts`。
+安装或更新后建议重新启动 DSH Web，以确保主题被完整加载。然后进入“Settings → 插件 → P.R.T.S.”启用主题；完整外观设置位于主界面左上角的罗德岛徽记。
 
-## 公共 npm 包
-
-可从 npmjs.org 直接下载可安装的 tarball，无需 GitHub 登录或访问令牌：
-
-```bash
-npm pack @ash-qw/dsh-theme-prts@0.1.92
-```
+主题包已公开发布到 npm，无需 GitHub 登录或访问令牌。重新执行安装命令即可更新到 `latest`；如需锁定版本，可使用 `@ash-qw/dsh-theme-prts@<版本号>`。若命令提示 `pnpm not found`，请先安装 pnpm。
 
-维护者向公开仓库推送与 `package.json` 版本一致的标签后，GitHub Actions 会通过 npm Trusted Publishing（OIDC）发布并生成 provenance；工作流不会从私有镜像仓库发布。例如：
+## 当前特性
 
-```bash
-git tag v0.1.92
-git push public v0.1.92
-```
+- P.R.T.S. / Rhodes Island / RIIC 设施化工作区、会话与对话界面；
+- 与 Harness 同步的日间 / 夜间模式、三套外观预设和四档界面材质；
+- 城市剪影、阵营粒子徽记、会话声纹和 P.R.T.S. 启动序列；
+- 支持问答预览与点击定位的对话刻度导航；
+- 桌面、平板、手机、减少动效和降低透明度适配；
+- 无运行时网络请求、分析统计或额外遥测。
 
-`0.1.35` 来自旧代码分支，发布产物中的 `cordis.patch.yml` 包名错误；`0.1.66` 修复了 Host patch，但客户端 ModuleLoader ID 未同步；`0.1.67` 对齐了三处包名；`0.1.68` 修复了 Operations Shell 延迟挂载；`0.1.69` 不再占用宿主共享右侧栏。`0.1.70` 加入工作区城市剪影、会话录音声纹、刷新启动接管及结构完整正交粒子徽记；`0.1.73` 保留常规浮层接管与 composer 越界显示，让启动动画主题样式立即生效，并把粒子场和界面适配器等非启动初始化延后到原生 boot 结束。
+## 使用与设置
 
-## Docker 安装
+“Settings → 插件 → P.R.T.S.”提供主题总开关和启动动画开关。主界面左上角的罗德岛徽记提供预设、环境底纹、粒子徽记、界面材质、导航栏、辅助功能和会话导航设置。
 
-以下命令针对容器名 `deepseek-harness`：
+主题不会主动改写第三方插件的菜单、弹窗和浮层样式。
 
-```bash
-docker cp ash-qw-dsh-theme-prts-0.1.92.tgz deepseek-harness:/workspace/
-docker exec deepseek-harness dsh plugin --profile web add /workspace/ash-qw-dsh-theme-prts-0.1.92.tgz
-docker restart deepseek-harness
-```
+## 安全模式与恢复
 
-打开 `http://<NAS-IP>:3080`，进入“Settings → 插件 → P.R.T.S.”启用主题；启用后通过左上罗德岛徽记调整完整外观。插件安装在持久化的 `/data/profiles/web` 中，正常重建容器不会丢失。
+若主题导致页面不可用，在 Harness 地址后添加 `?prts-safe=1`。安全模式会阻止所有主题视觉挂载，但保留“Settings → 插件 → P.R.T.S.”中的基础开关和恢复提示。也可以删除浏览器 localStorage 的 `dsh.ui.prts.v1`，下次加载会回到默认关闭状态。
 
-## 只读真实环境验收
+## 卸载
 
 ```bash
-PRTS_LIVE_TARGET=<NAS-IP>:3080 npm run test:e2e:live
+npx @deepseek-ai/dsh plugin --profile web remove @ash-qw/dsh-theme-prts
 ```
 
-测试期间会把受信任的 `127.0.0.1:3080` 临时转发到目标服务，不修改 Docker 网络、反代或 DNS。不设置 `PRTS_LIVE_WRITE` 时不会创建会话或产生模型调用。
+卸载后建议重新启动 DSH Web。浏览器中的主题偏好不会被删除。多个全局主题可能发生 CSS 冲突，建议一次只启用一个完整 UI 主题。
 
-## 安全模式与恢复
-
-若主题导致页面不可用，在 Harness 地址后添加 `?prts-safe=1`。安全模式会阻止所有主题视觉挂载，但保留“Settings → 插件 → P.R.T.S.”中的基础开关和恢复提示。也可以删除浏览器 localStorage 的 `dsh.ui.prts.v1`，下次加载会回到默认关闭状态。
+## 开发
 
-## 卸载
+需要 Node.js 18 或更高版本：
 
 ```bash
-docker exec deepseek-harness dsh plugin --profile web remove dsh-theme-prts
-docker restart deepseek-harness
+npm ci
+npm run check
 ```
 
-卸载不会删除浏览器偏好，也不会修改其他已安装皮肤。多个全局主题可能发生 CSS 冲突，建议一次只启用一个完整 UI 主题。
-
-## 权利说明
-
-原创代码以 MIT 许可证提供。第三方名称、角色图像、徽记及其衍生素材不属于 MIT 授权范围；本项目对这些素材不授予任何下游使用权。详见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。
+版本变化见 [CHANGELOG.md](CHANGELOG.md)，维护者发布步骤见 [RELEASING.md](RELEASING.md)。