@ash-qw/dsh-theme-prts 1.0.6 → 1.1.1

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # 变更记录
 
+## 1.1.1 - 2026-10-12
+
+- 修复宽屏触屏设备弹出虚拟键盘时会话区域闪烁、输入框失去焦点的问题，移除整区隐藏的窗口缩放保护，保留粒子自身的尺寸调整处理。
+- 去掉输入框填充层的毛玻璃滤镜，修复 Windows 桌面客户端顶部梯形缺口出现实心填充的问题；保留半透明底色和其他区域的毛玻璃效果。
+- 适配伙伴挂牌与挂点的可抓取、握住光标，并补充禁止状态图案；避免点击动画覆盖拖拽状态，沿用原有第三方素材来源并补齐中英文说明。
+- 将恢复默认入口移至左侧设置导航底部，窄屏置于顶部分类栏右侧，通过确认浮层明确全局重置范围，保存状态保留在标题区域。
+
+## 1.1.0 - 2026-10-12
+
+- 新增自定义粒子徽记管理：新会话单图与正文轮换列表独立设置，支持上传图片、调整轮廓提取与裁剪参数、预览后应用；正文可混合内置与自定义徽记，支持新增、替换、删除及长按拖动或键盘排序，两处均可独立恢复内置设置。
+- 新增徽记素材包导入与导出：携带原图和调整参数，便于不同 DSH 实例共享素材，导入后可预览并继续编辑。
+- 新增 DSH 原生徽记工具：可在会话中让 AI 读取上传图片、生成与调整粒子预览，并应用到新会话或正文列表。原图、参数和配置保存在服务端，跨工作区、会话和浏览器共享，设置页面自动同步。
+- 主题设置由长页面分区导航改为外观、交互、会话流线和粒子效果四页，保留各页滚动位置与未完成的徽记编辑，支持窄屏顶部导航和键盘切换。
+- 运行环境：服务端图片处理使用 sharp，要求 Node.js ≥20.9.0；当前支持的 DSH 0.2.0-rc.2 已有更高的 Node.js 依赖要求。
+
 ## 1.0.6 - 2026-10-10
 
 - 强化主题设置的四类分区边界和标题层级，将外观设置归为完整分区，并让导航高亮跟随正文滚动与定位。

package/README.en.md

@@ -47,6 +47,14 @@ Cursor artwork comes from [crowninggg/prts-cursor v1.1.4](https://github.com/cro
 
 “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, and accessibility controls.
 
+The appearance panel has four pages: Appearance, Interaction, Session Flow, and Particle Effects. Switching pages preserves each page’s scroll position and unfinished emblem edits. On narrow screens, tabs appear above the content; arrow keys also switch pages.
+
+Under Particle Effects → Emblem Management, configure the new-session emblem independently from the conversation rotation list. Mix built-in and uploaded images in the list, preview or replace individual entries, add or remove entries (1–12). Long-press anywhere on an emblem card to drag it into a new position; release to save or press Escape to cancel. Keyboard users can press Space on the thumbnail, use arrow keys to reorder, and press Enter to save. Each area can be restored independently. Upload a PNG, WebP, or JPEG and adjust extraction, threshold, scale, and crop position before applying. Conversation emblems retain scroll-driven rotation, interaction, and reassembly. Images are uploaded to the current DSH host and processed in a separate worker thread. Sources, parameters, drafts, and applied settings are stored under `$DSH_HOME/plugins/dsh-theme-prts/emblems`, shared across workspaces, sessions, and browsers connected to that instance. Saved emblems remain editable and pages synchronize automatically. The theme does not send images to third-party image services. Images are limited to 8 MB and 16 megapixels; transparent logos or monochrome silhouettes work best.
+
+Click Export Asset on a custom emblem to download a single `.prts-emblem.json` package containing its source image and editing parameters. In another DSH instance, choose Add Emblem or Preview / Replace, then import the package and review it before applying. Imported emblems remain editable; importing does not automatically overwrite the hero or rotation list. Packages are limited to 12 MB; particles are rebuilt from the original parameters on import.
+
+In any DSH session where the tools are allowed, upload an image and ask the AI to preview it as a PRTS particle emblem. `prts_emblem_inspect`, `prts_emblem_preview`, and `prts_emblem_apply` let the AI adjust extraction, threshold, scale, and crop, then apply a draft to the new-session emblem or conversation rotation list. Previews do not change applied settings; conflicting writes require a fresh read. Previews appear in native chat tool cards; image-capable models also receive the preview as image input. Redrawing still requires an image-editing tool in that session. Around 200 recent drafts are retained, while editing sources for applied emblems are protected. Server-side processing requires Node.js 20.9 or later.
+
 The theme does not proactively restyle menus, dialogs, or overlays created by third-party plugins.
 
 ## Recovery and removal
@@ -61,7 +69,7 @@ Restarting DSH Web after removal is recommended. Browser theme preferences are r
 
 ## Development
 
-Node.js 18 or newer is required:
+Node.js 20.9 or newer is required (Node.js 24 is recommended, matching DSH):
 
 ```bash
 npm ci

package/README.md

@@ -45,7 +45,13 @@ npx @deepseek-ai/dsh plugin --profile web add @ash-qw/dsh-theme-prts
 
 ## 使用与设置
 
-“Settings → 插件 → P.R.T.S.”提供主题总开关和启动动画开关。主界面左上角的罗德岛徽记提供预设、环境底纹、粒子徽记、界面材质、导航栏和辅助功能设置。
+“Settings → 插件 → P.R.T.S.”提供主题总开关和启动动画开关。主界面左上角的罗德岛徽记提供完整外观设置，按外观、交互、会话流线、粒子效果四页切换。各页保留滚动位置，切换不会丢失尚未应用的徽记编辑；窄屏使用顶部分类栏，也支持方向键切换。
+
+在“粒子效果 → 徽记管理”中，可分别设置新会话的单张徽记与正文的轮换列表。正文列表支持内置与自定义图案混排，每张可预览、上传替换或删除，长按徽记选项任意位置即可拖动排序，松开自动保存，Esc 取消，也可新增徽记（最多 12 张，至少保留 1 张）；两处均可独立恢复内置设置。上传 PNG、WebP 或 JPEG 后可调整轮廓提取、阈值、缩放及裁剪位置，点击“应用到此处”后才会保存。正文沿用滚动触发的轮换、扰动与重组效果。图片上传到当前 DSH 实例，在独立后台线程处理；原图、参数、草稿和已应用配置保存在 `$DSH_HOME/plugins/dsh-theme-prts/emblems`，不同工作区、会话及连接此实例的浏览器共享徽记设置。已应用图案可以重新打开继续调整，页面会自动同步。不会由主题插件发送给第三方图片服务。支持最大 8 MB、1600 万像素的图片，推荐透明底标志或黑白剪影。
+
+自定义徽记可点击“导出素材”，下载单张 `.prts-emblem.json` 素材包，包含原图和调整参数。在另一套 DSH 的“新增徽记”或“预览 / 替换”中选择“导入徽记素材包”，预览确认后应用；导入后仍可继续编辑，不会自动覆盖首页徽记或正文列表。素材包上限 12 MB，导入时会按原参数重新生成粒子。
+
+也可以在任意允许这些工具的 DSH 会话上传图片，说“帮我把这张图做成 PRTS 粒子徽记，先给我预览”。AI 可调用 `prts_emblem_inspect`、`prts_emblem_preview` 和 `prts_emblem_apply`，继续调整提取方式、阈值、缩放和裁剪，并按要求应用到新会话或正文轮换列表。生成预览不会改变已应用徽记，配置冲突会要求重新读取。预览图可在会话工具卡片中展示；使用支持图像输入的模型时，工具也会把预览图片交给模型分析。重画图案仍需要该会话另有图片编辑工具。保留最近约 200 份草稿，已应用徽记的编辑源不会被自动清理。服务端图片处理需要 Node.js 20.9 或更高版本。
 
 主题不会主动改写第三方插件的菜单、弹窗和浮层样式。
 
@@ -63,7 +69,7 @@ npx @deepseek-ai/dsh plugin --profile web remove @ash-qw/dsh-theme-prts
 
 ## 开发
 
-需要 Node.js 18 或更高版本：
+需要 Node.js 20.9 或更高版本（推荐与 DSH 一致使用 Node.js 24）：
 
 ```bash
 npm ci

package/THIRD_PARTY_NOTICES.md

@@ -39,7 +39,9 @@ After receiving a verifiable request, the project maintainer will review it prom
 
 ## PRTS hand, text and resize cursors
 
-- Files: `src/assets/cursors/prts-hand*.png`, `prts-link*.png`, `prts-text*.png`, `prts-resize-*.png` and `animation.json`.
+- Files: `src/assets/cursors/prts-hand*.png`, `prts-link*.png`, `prts-text*.png`, `prts-resize-*.png`, `prts-grab.png`, `prts-grabbing.png`, `prts-not-allowed.png` and `animation.json`.
 - Source: embedded `PRTS-Replica-v8-96x-normal.cur`, `normal_hold.cur`, `normal_press.ani`, `normal_release.ani`, `beam.cur`, `beam_click.ani`, `link.cur`, `link_hold.cur`, `link_press.ani`, `link_release.ani` and `sel_1_static.cur` through `sel_4_static.cur` resources in `程序文件/PRTS-Setup.exe` from [crowninggg/prts-cursor v1.1.4, PRTS-Windows-1.1.4.zip](https://github.com/crowninggg/prts-cursor/releases/tag/v1.1.4), retrieved 2026-10-09. Resources were read without executing the installer.
-- Adaptation: each 96×96 hand frame is cropped to (18, 10, 82, 84) and resized to 42×48. Source hotspot (28, 20) maps to (7, 6). ANI frame durations are preserved in the manifest; terminal 60-second hold frames are represented by static held/resting states at runtime. Text frames retain the full 96×96 canvas, resized to 48×48 with hotspot (24, 24). Link frames are cropped to (18, 10, 96, 96), resized to 51×56 with hotspot (7, 7), retaining the arrow. The four static resize cursors retain the full canvas, resized to 32×32 with hotspot (16, 16). Text click frames remain in the source archive but are no longer bundled or played. Continuous text-loop and unavailable variants are not included.
+- Adaptation: each 96×96 hand frame is cropped to (18, 10, 82, 84) and resized to 42×48. Source hotspot (28, 20) maps to (7, 6). ANI frame durations are preserved in the manifest; terminal 60-second hold frames are represented by static held/resting states at runtime. Text frames retain the full 96×96 canvas, resized to 48×48 with hotspot (24, 24). Link frames are cropped to (18, 10, 96, 96), resized to 51×56 with hotspot (7, 7), retaining the arrow. The four static resize cursors retain the full canvas, resized to 32×32 with hotspot (16, 16). Text click frames remain in the source archive but are no longer bundled or played. Continuous text-loop variants are not included.
 - Upstream Credits.txt describes an unofficial personal derivative tool and attributes Arknights character/interface assets to their original rights holders. No explicit redistribution license for this artwork was found in the inspected package. This artwork is excluded from this project's MIT license; inclusion does not grant rights to the underlying artwork.
+
+- Grab and unavailable assets added on 2026-10-12 from the same release: `grab_enter_0011.cur` and `grab_loop_0000.cur` provide static grab/grabbing states, cropped to (18, 40, 86, 96) and resized to 45×37 with a web hotspot at the hand center (22, 19). `unavail1_static.cur` provides the unavailable state, cropped to (18, 10, 96, 96) and resized to 51×56 with hotspot (7, 7). The installer was not executed; loop animations are not played.

package/THIRD_PARTY_NOTICES.zh-CN.md

@@ -39,7 +39,9 @@ P.R.T.S. 头像、阵营标识及衍生徽记仅收录于个人、非商业同
 
 ## PRTS 手形、文本与调整大小光标
 
-- 文件：`src/assets/cursors/prts-hand*.png`、`prts-link*.png`、`prts-text*.png`、`prts-resize-*.png` 及 `animation.json`。
+- 文件：`src/assets/cursors/prts-hand*.png`、`prts-link*.png`、`prts-text*.png`、`prts-resize-*.png`, `prts-grab.png`, `prts-grabbing.png`, `prts-not-allowed.png` 及 `animation.json`。
 - 来源：[crowninggg/prts-cursor v1.1.4 的 PRTS-Windows-1.1.4.zip](https://github.com/crowninggg/prts-cursor/releases/tag/v1.1.4)，获取日期为 2026-10-09。使用其中 `程序文件/PRTS-Setup.exe` 内嵌的 `PRTS-Replica-v8-96x-normal.cur`、`normal_hold.cur`、`normal_press.ani`、`normal_release.ani`、`beam.cur`、`beam_click.ani`、`link.cur`、`link_hold.cur`、`link_press.ani`、`link_release.ani` 及 `sel_1_static.cur` 至 `sel_4_static.cur` 资源。提取时仅读取资源，未运行安装程序。
-- 适配方式：每张 96×96 手形帧裁剪至矩形 (18, 10, 82, 84)，再缩放为 42×48；原始点击热点 (28, 20) 映射为 (7, 6)。ANI 帧时长保留在清单中，末尾 60 秒停留帧在运行时由静态按住或静止状态代替。文本帧保留完整的 96×96 画布，缩放至 48×48，热点为 (24, 24)。链接帧裁剪至 (18, 10, 96, 96)，缩放为 51×56，热点为 (7, 7)，保留箭头。四种静态调整大小光标保留完整画布，缩放至 32×32，热点为 (16, 16)。文本点击帧保留在源码素材中，但不再打包或播放；未收录持续循环的文本动画和禁止操作变体。
+- 适配方式：每张 96×96 手形帧裁剪至矩形 (18, 10, 82, 84)，再缩放为 42×48；原始点击热点 (28, 20) 映射为 (7, 6)。ANI 帧时长保留在清单中，末尾 60 秒停留帧在运行时由静态按住或静止状态代替。文本帧保留完整的 96×96 画布，缩放至 48×48，热点为 (24, 24)。链接帧裁剪至 (18, 10, 96, 96)，缩放为 51×56，热点为 (7, 7)，保留箭头。四种静态调整大小光标保留完整画布，缩放至 32×32，热点为 (16, 16)。文本点击帧保留在源码素材中，但不再打包或播放；未收录持续循环的文本动画。
 - 权利说明：上游 `Credits.txt` 将其描述为非官方自用衍生工具，并注明明日方舟角色及界面素材归原权利人所有。在已检查的安装包中，未发现这些美术素材的明确再分发许可。它们不属于本项目 MIT 许可证的授权范围；本项目收录这些素材并不授予原美术作品的相关权利。
+
+- 2026-10-12 补充同一发行包中的抓握与禁止素材：取 `grab_enter_0011.cur` 和 `grab_loop_0000.cur` 为静态可抓取、握住状态，裁剪 (18, 40, 86, 96)，缩放至 45×37，网页抓握热点设为手形中心 (22, 19)。取 `unavail1_static.cur` 为禁止状态，裁剪 (18, 10, 96, 96)，缩放至 51×56，热点 (7, 7)。未运行安装程序，未播放循环动画。