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

package/CHANGELOG.md

@@ -0,0 +1,31 @@
+# 变更记录
+
+## 0.1.93 - 未发布
+
+- 将安装说明改为直接从 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

@@ -13,6 +13,19 @@ A personal, non-commercial Arknights / P.R.T.S. fan UI plugin for DeepSeek Harne
 
 Target: `deepseek-harness: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:
+
+```bash
+docker exec deepseek-harness dsh plugin --profile web add @ash-qw/dsh-theme-prts
+docker restart deepseek-harness
+```
+
+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.
+
+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.
+
 ## Current feature set
 
 - Facility-style P.R.T.S. surfaces with complete SVG contours, distinct workspace/session spines, and compact right-edge actions;
@@ -20,18 +33,18 @@ Target: `deepseek-harness:0.1.1-rc.2`. The theme is disabled by default.
 - 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;
+- 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;
+- 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;
 - 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.
+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.” 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.
+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.
 
 ## Floating surface compatibility
 
@@ -39,44 +52,16 @@ The theme owns only P.R.T.S. UI and Harness surfaces that are stably linked to r
 
 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
+## Development checks
 
 Node.js 18 or newer is required:
 
 ```bash
 npm ci
 npm run check
-npm run pack:plugin
-```
-
-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
-
-The installable tarball can be downloaded directly from npmjs.org without a GitHub login or access token:
-
-```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:
-
-```bash
-git tag v0.1.92
-git push public v0.1.92
-```
-
-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.
-
-## Docker install
-
-```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
-```
-
-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`.
+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
 
@@ -97,6 +82,10 @@ 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).

package/README.md

@@ -13,6 +13,19 @@
 
 目标环境：`deepseek-harness:0.1.1-rc.2`。主题安装后默认关闭，不会立即改变页面。
 
+## 安装与更新
+
+包已公开发布到 npm，无需 GitHub 登录或访问令牌。若 DeepSeek Harness 运行在名为 `deepseek-harness` 的 Docker 容器中，安装或更新均使用：
+
+```bash
+docker exec deepseek-harness dsh plugin --profile web add @ash-qw/dsh-theme-prts
+docker restart deepseek-harness
+```
+
+命令默认安装 npm `latest` 版本；如需锁定版本，可在包名后追加具体版本号，例如 `@ash-qw/dsh-theme-prts@<版本号>`。若 `dsh` 直接运行在宿主机上，去掉命令开头的 `docker exec deepseek-harness` 即可。
+
+打开 `http://<NAS-IP>:3080`，进入“Settings → 插件 → P.R.T.S.”启用主题；启用后通过左上罗德岛徽记调整完整外观。Docker 环境中的插件保存在持久化的 `/data/profiles/web`，正常重建容器不会丢失。
+
 ## 当前特性
 
 - P.R.T.S. / Rhodes Island / RIIC 设施化视觉，工作区与会话采用完整 SVG 轮廓、差异化侧脊和紧凑右侧操作按钮；
@@ -20,18 +33,18 @@
 - Codex 风格的对话刻度栏，支持问答预览、刻度内滚动和点击定位；
 - 日间 / 夜间切换与 Harness 原生主题状态同步；
 - 输入框、菜单、预览和浮层支持关闭、柔和、标准、清晰四档玻璃材质；
-- 罗德岛、龙门、企鹅物流、莱茵生命、整合运动粒子徽记，使用结构完整的正交点阵，并支持独立的新会话 / 普通会话五档密度；密度越高，粒子越小且数量越多；
+- 罗德岛、龙门、企鹅物流、莱茵生命、整合运动粒子徽记，使用结构完整的正交点阵，并支持独立的新会话 / 普通会话五档密度；普通会话还可在 0×–2× 间调整滚动跟随速度，速度越快，徽记越快移动、破碎并换阵营；
 - 主题手动启用及已激活主题刷新时播放 P.R.T.S. 启动序列，使用原始 P.R.T.S. 徽记、阶段进度条、移动端精简和减少动效完成态；
-- 1440px 桌面、1024px 平板和 640px 以下手机布局，并支持减少动效和降低透明度提示；
+- 1440px 桌面、1024px 平板和 640px 以下手机布局，可设置在任意宽度下默认隐藏最左侧 P.R.T.S. 导航，并支持减少动效和降低透明度提示；
 - 无运行时网络请求、分析统计或额外遥测。
 
 ## 设置架构
 
-主界面左上角的罗德岛徽记是完整外观设置入口。展开后可选择三套预设，或分别调整环境底纹、粒子徽记、界面材质、辅助功能和会话导航；会话导航可配置刻度栏离左侧边栏的最大距离，并通过常驻空间剖面预览所选距离、自动居中或隐藏原因。拖动滑块只更新预览，完成操作后才保存并应用。手动修改会显示 `CUSTOM`。预设不会修改刻度栏距离。
+主界面左上角的罗德岛徽记是完整外观设置入口。展开后可选择三套预设，或分别调整环境底纹、粒子徽记、界面材质、导航栏默认隐藏、辅助功能和会话导航；粒子区的跟随速度滑杆会实时预览，显示预计多少个视口后重组，并在操作结束后保存。会话导航可配置刻度栏离左侧边栏的最大距离，并通过常驻空间剖面预览所选距离、自动居中或隐藏原因。手动修改视觉参数会显示 `CUSTOM`；导航栏默认隐藏和跟随速度均与视觉预设独立。
 
 Harness 的“Settings → 插件 → P.R.T.S.”仅保留主题总开关和启动动画开关，并使用宿主标准设置布局。主题关闭或处于安全模式时，启动动画偏好仍可提前修改；完整外观继续由左上罗德岛徽记维护。
 
-偏好继续存放在 `dsh.ui.prts.v1`，当前内容结构为 v6。旧 v1/v2/v3/v4/v5 配置会自动迁移，包含旧玻璃开关、`liquid` 玻璃、`full` 动效字段，以及已退役的有机分布与六边形点阵粒子配置。
+偏好继续存放在 `dsh.ui.prts.v1`，当前内容结构为 v8。旧 v1/v2/v3/v4/v5/v6/v7 配置会自动迁移，导航栏默认隐藏保持关闭，粒子跟随速度保持原有的 1× 行为；迁移还包含旧玻璃开关、`liquid` 玻璃、`full` 动效字段，以及已退役的有机分布与六边形点阵粒子配置。
 
 ## 浮层兼容边界
 
@@ -39,46 +52,16 @@ Harness 的“Settings → 插件 → P.R.T.S.”仅保留主题总开关和启
 
 第三方插件如需主动使用 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 run pack:plugin
-```
-
-成功后会生成 `ash-qw-dsh-theme-prts-0.1.92.tgz`。npm 分发名是 `@ash-qw/dsh-theme-prts`；`cordis.patch.yml` 包名和客户端 ModuleLoader ID 都与它保持一致，内部运行时插件 ID 仍为 `dsh-theme-prts`。
-
-## 公共 npm 包
-
-可从 npmjs.org 直接下载可安装的 tarball，无需 GitHub 登录或访问令牌：
-
-```bash
-npm pack @ash-qw/dsh-theme-prts@0.1.92
 ```
 
-维护者向公开仓库推送与 `package.json` 版本一致的标签后，GitHub Actions 会通过 npm Trusted Publishing（OIDC）发布并生成 provenance；工作流不会从私有镜像仓库发布。例如：
-
-```bash
-git tag v0.1.92
-git push public v0.1.92
-```
-
-`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 安装
-
-以下命令针对容器名 `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` 中，正常重建容器不会丢失。
+项目的 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)。
 
 ## 只读真实环境验收
 
@@ -101,6 +84,10 @@ docker restart deepseek-harness
 
 卸载不会删除浏览器偏好，也不会修改其他已安装皮肤。多个全局主题可能发生 CSS 冲突，建议一次只启用一个完整 UI 主题。
 
+## 变更记录
+
+版本变化见 [CHANGELOG.md](CHANGELOG.md)。
+
 ## 权利说明
 
 原创代码以 MIT 许可证提供。第三方名称、角色图像、徽记及其衍生素材不属于 MIT 授权范围；本项目对这些素材不授予任何下游使用权。详见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。