@ash-qw/dsh-theme-prts 0.1.91

package/LICENSE

@@ -0,0 +1,24 @@
+MIT License
+
+Copyright (c) 2026 dsh-theme-prts contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of the software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+This license applies to code only. Third-party franchise-identifying material is
+excluded as described in THIRD_PARTY_NOTICES.md.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,103 @@
+# dsh-theme-prts
+
+A personal, non-commercial Arknights / P.R.T.S. fan UI plugin for DeepSeek Harness Web. It keeps Harness behavior and data flow intact while presenting workspaces, sessions, and conversations as a Rhodes Island facility terminal.
+
+> [!IMPORTANT]
+> This is an unofficial, personal Arknights fan theme. It is not affiliated with, sponsored by, authorized by, or endorsed by Shanghai Hypergryph Network Technology Co., Ltd. or any regional publisher.
+>
+> The MIT License covers only original code created for this project. Certain recognizable Arknights names, character images, emblems, and derivative material included in the package are outside the MIT grant. This project grants users no right to copy, modify, redistribute, sublicense, or commercially use that third-party material.
+>
+> Public availability of source material does not itself grant permission to reuse or redistribute it, and free or non-commercial use is not automatically authorized. See [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) for provenance and licensing boundaries.
+>
+> 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.
+
+## 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
+
+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:
+
+```bash
+npm ci
+npm run check
+npm run pack:plugin
+```
+
+The package is emitted as `ash-qw-dsh-theme-prts-0.1.91.tgz`. Its GitHub Packages 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`.
+
+## Private GitHub Packages
+
+Pushing a tag that matches `package.json` triggers the publish workflow. For the current release:
+
+```bash
+git tag v0.1.91
+git push origin v0.1.91
+```
+
+A consumer with `read:packages` can authenticate and download the installable tarball:
+
+```bash
+npm login --scope=@ash-qw --auth-type=legacy --registry=https://npm.pkg.github.com
+npm pack @ash-qw/dsh-theme-prts@0.1.91 --registry=https://npm.pkg.github.com
+```
+
+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.91.tgz deepseek-harness:/workspace/
+docker exec deepseek-harness dsh plugin --profile web add /workspace/ash-qw-dsh-theme-prts-0.1.91.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`.
+
+## 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.
+
+## 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

@@ -0,0 +1,107 @@
+# dsh-theme-prts
+
+面向 DeepSeek Harness Web 的个人、非商业明日方舟 / P.R.T.S. 同人 UI 插件。主题保留 Harness 的原生交互和数据流，将工作区、会话与对话组织成罗德岛设施终端。
+
+> [!IMPORTANT]
+> 本项目是个人制作的非官方《明日方舟》同人主题，与上海鹰角网络科技有限公司及相关发行方不存在隶属、合作、授权或背书关系。
+>
+> MIT 许可证仅覆盖本项目原创代码。安装包中若干可识别的《明日方舟》名称、角色图像、徽记及其衍生素材不属于 MIT 授权范围，本项目不向使用者授予复制、修改、再分发、再许可或商业使用这些第三方素材的权利。
+>
+> 素材可从公开网页访问不代表获得再利用或再分发授权；免费、非商业使用也不当然构成授权。素材来源与许可边界详见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。
+>
+> 本项目及其发行包可能因权利人请求、平台政策或维护者决定，随时暂停发布、限制下载或移除相关素材，不保证持续提供。
+
+目标环境：`deepseek-harness: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 或更高版本：
+
+```bash
+npm ci
+npm run check
+npm run pack:plugin
+```
+
+成功后会生成 `ash-qw-dsh-theme-prts-0.1.91.tgz`。GitHub Packages 分发名是 `@ash-qw/dsh-theme-prts`；`cordis.patch.yml` 包名和客户端 ModuleLoader ID 都与它保持一致，内部运行时插件 ID 仍为 `dsh-theme-prts`。
+
+## 私有 GitHub Packages
+
+推送与 `package.json` 版本一致的标签会触发发布工作流。例如发布当前版本：
+
+```bash
+git tag v0.1.91
+git push origin v0.1.91
+```
+
+具有 `read:packages` 权限的用户可登录并下载可安装的 tarball：
+
+```bash
+npm login --scope=@ash-qw --auth-type=legacy --registry=https://npm.pkg.github.com
+npm pack @ash-qw/dsh-theme-prts@0.1.91 --registry=https://npm.pkg.github.com
+```
+
+`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.91.tgz deepseek-harness:/workspace/
+docker exec deepseek-harness dsh plugin --profile web add /workspace/ash-qw-dsh-theme-prts-0.1.91.tgz
+docker restart deepseek-harness
+```
+
+打开 `http://<NAS-IP>:3080`，进入“Settings → 插件 → P.R.T.S.”启用主题；启用后通过左上罗德岛徽记调整完整外观。插件安装在持久化的 `/data/profiles/web` 中，正常重建容器不会丢失。
+
+## 只读真实环境验收
+
+```bash
+PRTS_LIVE_TARGET=<NAS-IP>:3080 npm run test:e2e:live
+```
+
+测试期间会把受信任的 `127.0.0.1:3080` 临时转发到目标服务，不修改 Docker 网络、反代或 DNS。不设置 `PRTS_LIVE_WRITE` 时不会创建会话或产生模型调用。
+
+## 安全模式与恢复
+
+若主题导致页面不可用，在 Harness 地址后添加 `?prts-safe=1`。安全模式会阻止所有主题视觉挂载，但保留“Settings → 插件 → P.R.T.S.”中的基础开关和恢复提示。也可以删除浏览器 localStorage 的 `dsh.ui.prts.v1`，下次加载会回到默认关闭状态。
+
+## 卸载
+
+```bash
+docker exec deepseek-harness dsh plugin --profile web remove dsh-theme-prts
+docker restart deepseek-harness
+```
+
+卸载不会删除浏览器偏好，也不会修改其他已安装皮肤。多个全局主题可能发生 CSS 冲突，建议一次只启用一个完整 UI 主题。
+
+## 权利说明
+
+原创代码以 MIT 许可证提供。第三方名称、角色图像、徽记及其衍生素材不属于 MIT 授权范围；本项目对这些素材不授予任何下游使用权。详见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,48 @@
+# Third-Party and Franchise Material Notices
+
+This file records provenance and licensing boundaries only. It does not establish or imply permission to include, publish, or redistribute any third-party material listed below.
+
+## Code
+
+The JavaScript, CSS, build scripts, tests, and original DSH-specific vector interface work in this package are licensed under the MIT License in `LICENSE`.
+
+### Adaptive conversation jump reference
+
+The conversation-scale sticky-bottom release, distance-aware scrolling, and landing-verification strategy was independently adapted with reference to [`Wine-Red/dsh-codex-timeline`](https://github.com/Wine-Red/dsh-codex-timeline) at commit [`eb078c58a7662db231c5b8dd5d867f80b0b256af`](https://github.com/Wine-Red/dsh-codex-timeline/tree/eb078c58a7662db231c5b8dd5d867f80b0b256af).
+
+That project is distributed under the MIT License:
+
+- Copyright (c) 2026 DeepSeek
+- Copyright (c) 2026 dsh-codex-timeline contributors
+- License: [`MIT`](https://github.com/Wine-Red/dsh-codex-timeline/blob/eb078c58a7662db231c5b8dd5d867f80b0b256af/LICENSE)
+
+The implementation in this package remains theme-local and does not load or depend on the referenced plugin at runtime.
+
+## Arknights-identifying third-party material
+
+“Arknights”, Rhodes Island, P.R.T.S., RIIC, and related names, characters, symbols, and visual identities are associated with their respective rights holders, including Hypergryph and the game's regional publishers.
+
+The following packaged material is expressly excluded from the MIT License:
+
+- `src/assets/faction-emblems/*.png` — unmodified transparent faction marks obtained from Hypergryph's public Arknights official page (`https://ak.hypergryph.com/`) for Rhodes Island, Lungmen, Penguin Logistics, Rhine Lab, and Reunion. Public accessibility of the source files does not itself grant reuse or redistribution rights;
+- `src/assets/rhodes-dsh.svg` — a derivative redraw based on the recognizable Rhodes Island emblem and used by the P.R.T.S. top bar;
+- `src/assets/prts-original-avatar.png` — the original 180×180 P.R.T.S. avatar obtained from the referenced Arknights Wiki page at `https://arknights.wiki.gg/wiki/File:PRTS.png`. The wiki page's fair-use designation is specific to that page and does not grant this package or its users permission to reuse or redistribute the image;
+- franchise-identifying labels and UI motifs used to create the fan-theme presentation.
+
+The P.R.T.S. avatar, faction marks, and derivative emblem are included only in the personal, non-commercial fan-theme build and are not relicensed. Free or non-commercial use does not itself establish permission from a rights holder.
+
+No license to copy, modify, redistribute, sublicense, or commercially use the excluded material is granted by this project. Any permission required for that material must come from the applicable rights holder. This notice does not itself make inclusion or public distribution of the packaged material authorized.
+
+## Affiliation and ownership
+
+This project is unofficial and does not claim endorsement, affiliation, authorization, or ownership of the underlying franchise. All underlying character, artwork, symbol, trademark, and franchise rights remain with their respective rights holders, including Hypergryph and the game's regional publishers.
+
+## Policy references
+
+For reference, the Arknights global website publishes [Terms and Conditions of Re-creation](https://www.arknights.global/fankit/guidelines) and separate [Fan Kit Terms and Conditions of Use](https://www.arknights.global/fankit/precautions). Those terms may change, may be region- or material-specific, and do not constitute project-specific permission for this package.
+
+## Rights-holder requests
+
+An applicable rights holder or authorized representative may submit a removal or attribution request through the repository's issue tracker. To help identify and review the request, it should identify the requester, the affected files or material, the relevant rights, and a means of follow-up contact.
+
+After receiving a verifiable request, the project maintainer will review it promptly and may suspend public distribution of an affected release, remove or replace the relevant material, or update attribution and provenance records. This process does not imply that the material was previously authorized and does not limit or waive any rights or remedies of a rights holder.

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# dsh-theme-prts — DeepSeek Harness Web client plugin patch layer.
+- insert:
+    - id: theme-prts
+      name: '@ash-qw/dsh-theme-prts'