dsh-ui-zzz-sunna 0.1.0

package/LICENSE

@@ -0,0 +1,34 @@
+# Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International
+
+You are free to:
+
+- **Share** — copy and redistribute the material in any medium or format
+- **Adapt** — remix, transform, and build upon the material
+
+for any non-commercial purpose, under the following terms:
+
+- **Attribution** — You must give appropriate credit, provide a link to the
+  license, and indicate if changes were made. You may do so in any reasonable
+  manner, but not in any way that suggests the licensor endorses you or your
+  use.
+- **NonCommercial** — You may not use the material for commercial purposes.
+- **ShareAlike** — If you remix, transform, or build upon the material, you must
+  distribute your contributions under the same or a compatible license.
+
+No additional restrictions may be applied that legally restrict others from
+doing anything the license permits.
+
+---
+
+## Disclaimers and warranties
+
+For the full legal text, see
+https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode .
+
+- Not affiliated — This is a fan work. It is not affiliated with, endorsed by,
+  or sponsored by HoYoverse, miHoYo, Kuro Games, or any of their related
+  entities.
+- No trademark license — No trademark, trade dress, or publicity license is
+  conveyed. The character "Sunna" (千夏) and "Zenless Zone Zero" (绝区零) are
+  trademarks of their respective owners.
+- No warranty — The material is provided "AS IS", without warranty of any kind.

package/README.md

@@ -0,0 +1,57 @@
+# dsh-ui-zzz-sunna
+
+给 dsh 客户端换上一套《绝区零》千夏（Sunna）外观的主题插件。
+
+两套主题、五个可调图层、一个能拖到任意位置的 Q 版挂件，全部在右下角的画板里实时调整，不用重启。
+
+## 安装
+
+```sh
+dsh plugin --profile desktop add dsh-ui-zzz-sunna
+```
+
+装完重启 dsh。
+
+**从源码装**
+
+```sh
+pnpm install && npm run build
+dsh plugin --profile desktop add /绝对/路径/dsh-ui-zzz-sunna
+```
+
+## 界面预览
+
+两套主题，各带浅色与深色两种形态。
+
+**立绘** —— 侧栏立绘配同角色的柔化背景：
+
+| 浅色 | 深色 |
+| --- | --- |
+| ![立绘 · 浅色](docs/preview-portrait-light.webp) | ![立绘 · 深色](docs/preview-portrait-dark.webp) |
+
+**影画** —— 主视觉影画铺满背景，侧栏立绘默认关闭：
+
+| 浅色 | 深色 |
+| --- | --- |
+| ![影画 · 浅色](docs/preview-overlay-light.webp) | ![影画 · 深色](docs/preview-overlay-dark.webp) |
+
+右下角那个调色板图标就是画板，点开可以：
+
+- **切换主题** —— 「立绘」与「影画」两套；
+- **逐层调节** —— 侧栏立绘、背景氛围、左右贴底立绘、右下挂件，各自的大小、位置、透明度；
+- **换挂件表情** —— 七个官方 Q 版表情任选；
+- **换背景主视觉** —— 「影画」的主题背景有六个候选，默认项跟随明暗（浅色用 09、深色用 08）。
+
+![Q 版挂件表情](docs/widgets.webp)
+
+挂件可以直接**拖到窗口任意位置**。每套主题的数值分别保存，调坏一套不影响另一套。
+
+## 许可
+
+**CC BY-NC-SA 4.0** —— 署名 / 非商业 / 相同方式共享。**不允许任何商业用途。**
+
+本包是同人二创，与 HoYoverse / miHoYo 及其关联公司无关联，也不代表它们认可本包。
+角色与游戏名称属于各自权利人，本协议不授予任何商标或肖像使用权。
+
+`assets/` 里的图是《绝区零》的官方素材，来源与授权审计见
+[`assets/SOURCES.md`](assets/SOURCES.md)。

package/assets/SOURCES.md

@@ -0,0 +1,117 @@
+# 素材来源与处理说明
+
+本目录下的图片是为本插件搜集的《绝区零》千夏（Sunna）美术素材：`sunna-*.webp`，以及插件原有的 `portrait.webp`。
+当前随包分发的共 **2.96 MB**（中途曾精简到 1.16 MB，后因"影画"主题需要背景候选又放回，见文末审计）。
+
+- **来源 A**：[萌娘共享 · 分类:千夏(绝区零)](https://commons.moegirl.org.cn/Category:%E5%8D%83%E5%A4%8F(%E7%BB%9D%E5%8C%BA%E9%9B%B6))（`sunna-01`、`02`、`04`、`07`–`13`）
+- **来源 B**：官方 Q 版表情的**源文件**（`sunna-14-chibi-*`）—— 144×144 PNG、自带 alpha、**文件没有扩展名**（所以双击打不开），共 7 个，文件名本身就是表情名
+- **来源 C**：`portrait.webp` 是插件原有的默认素材。**它同样是这个角色的官方立绘**（与 `sunna-04` 同一造型），属来源 A 一类，只是进包更早、此前没有登记过
+- **站点授权**：萌娘共享的页面内容按 CC BY-NC-SA 4.0 提供
+- **角色版权**：《绝区零》/ miHoYo / HoYoverse
+
+## 文件清单
+
+"透明"一列是实际解码后的完全透明像素占比；`0.0%` 表示该图没有透明区域（整幅不透明）。
+
+| 文件 | 尺寸 | 透明 | 内容 | 用途 / 状态 |
+| --- | --- | --- | --- | --- |
+| `portrait.webp` | 808×1800 | 54.0% | 全身立绘，制服（与 `sunna-04` 同造型，分辨率更高） | 包内 · **"立绘"主题的背景** |
+| `sunna-01-casual.webp` | 618×1600 | 54.0% | 全身立绘，休闲装（印花背心 / 牛仔短裤 / 双肩包） | 包内 · **浅色模式侧栏** |
+| `sunna-02-teatime-flip.webp` | 618×1397 | 60.7% | 午后茶歇装立绘的左右镜像，面朝右 | 包内 · **深色模式侧栏** |
+| `sunna-04-uniform.webp` | 557×1227 | 58.0% | 全身立绘，制服（白衬衫 / 红领带 / 黑裙） | 包内 · **"影画"主题的侧栏立绘**（默认关闭，已裁边） |
+| `sunna-09-art.webp` | 2108×1169 | 0.0% | 意象影画·**亮色版**：人物彩色，近白底 | 包内 · **默认背景**（浅色，`multiply`） |
+| `sunna-08-art.webp` | 2113×1164 | 0.0% | 意象影画·**暗色版**：人物去色，近黑底 + 荧光绿字 | 包内 · **默认背景**（深色，`screen`） |
+| `sunna-07-art.webp` | 2112×1161 | 0.0% | 意象影画·绿粉中间调版 | 包内 · **"影画"背景候选** |
+| `sunna-10-art-wide.webp` | 3200×1799 | 0.0% | 超宽场景插画（旧梦的安可曲） | 包内 · **"影画"背景候选** |
+| `sunna-11-art-newyear.webp` | 2350×1000 | 0.0% | 除夕宽幅贺图 | 包内 · **"影画"背景候选** |
+| `sunna-12-scene-valentine.webp` | 1293×2000 | 0.0% | 情人节竖版海报 | 包内 · **备存，不进候选** |
+| `sunna-13-scene-birthday.webp` | 1293×2000 | 0.0% | 生日贺图（气泡框场景） | 包内 · **备存，不进候选** |
+| `sunna-14-chibi-shy.webp` | 288×288 | 58.8% | Q 版千夏 · 害羞 | 包内 · **右下角挂件** |
+| `sunna-14-chibi-tired.webp` | 288×288 | 57.2% | Q 版千夏 · 心累 | 包内 · **右下角挂件** |
+| `sunna-14-chibi-think.webp` | 288×288 | 59.0% | Q 版千夏 · 思考 | 包内 · **右下角挂件** |
+| `sunna-14-chibi-angry.webp` | 288×288 | 59.0% | Q 版千夏 · 生气 | 包内 · **右下角挂件** |
+| `sunna-14-chibi-confident.webp` | 288×288 | 56.9% | Q 版千夏 · 自信（默认选中） | 包内 · **右下角挂件** |
+| `sunna-14-chibi-music.webp` | 288×288 | 59.4% | Q 版千夏 · 听歌 | 包内 · **右下角挂件** |
+| `sunna-14-chibi-cry.webp` | 288×288 | 57.9% | Q 版千夏 · 哭 | 包内 · **右下角挂件** |
+| `sunna-02-teatime.webp` | 618×1397 | 60.7% | 午后茶歇装立绘，面朝左 | **已移出**（`-flip` 的父本，需要时可重生成镜像） |
+| `sunna-03-group-art.webp` | 1035×1600 | 0.0% | 三人合影活动图（含活动 UI 文字） | 从不入包 |
+| `sunna-05-role-icon.webp` | 142×142 | 21.4% | 角色图标 | 从不入包 |
+| `sunna-06-banner.webp` | 161×60 | 12.2% | 侧栏横幅 | 从不入包 |
+
+两处选择器都在画板里可见：**右下挂件**有七个表情（`LAYERS` 的 `pet.variants`，所有主题共用），
+**"影画"主题的背景氛围**有六个候选（该主题 `background.variants`），固定顺序：
+
+- **跟随明暗 · 浅 09 / 深 08** —— 默认项，画板在它下面画一个圆点。它的**色块**是一张两张色版并排的
+  合成缩略图（`sunna-bg-auto.webp`，本插件自己拼的，只用于显示），这样它不会和下面的"亮"撞脸；
+- `07` **绿粉** / `08` **暗** / `09` **亮** —— 意象影画的三张色版，各自独立可选；
+- `10` **旧梦的安可曲** / `11` **除夕贺图** —— 两张场景海报。
+
+除默认项外，每个候选都用自己那张画同时服务浅色与深色底色，所以**深色底下每一块都能切出效果**——
+包括单独选 `09`。这正是"深色下切 08/09 没反应"的修法：把默认独立成一项，而不是让它和 `09` 合为一项
+（合在一起时，深色下点 `09` 等于回到默认，永远只能得到 08）。主题自身声明的 `file`/`fileDark`
+（09 / 08）只在画板尚未挂载时作为样式表兜底。
+
+`sunna-12` 与 `sunna-13` 按要求**留在包内但不进候选**，画板里不会出现。挂件还能拖到窗口任意位置。
+
+> 移出与从未入包的素材都留在 `sunna-assets/` 下：移出的在 `_spare/`，其余用 `_publish_assets.py` 可重新生成。
+
+## 处理方式
+
+1. **格式与尺寸**：原始 PNG/JPG 统一转 webp（quality 88，Q 版小图用 92），按类别限制最长边 —— 立绘 1600、横版插画 2400、超宽 3200、竖版海报 2000、图标 256。目的是不让插件包背上印刷级原图。
+2. **抠图**：`sunna-02-teatime.webp` 由 `rembg` 的 `isnet-anime` 模型（动漫立绘专用）抠出，随后三步收尾 —— 轮廓收缩 3px（切掉被判成前景的海报底色，也就是那圈粉色描边）、边缘颜色取最近的不透明像素（避免背景色向内扩散）、1.5px 羽化（把硬边还原成自然过渡）。整条链路在 `sunna-assets/_rematte_02.py`，改常数重跑即可复现。早期用 `u2net` 抠的版本在深色界面上有明显的粉色轮廓，已弃用。
+3. **镜像副本**：`-flip.webp` 由同一张成品水平翻转后编码，不是从已发布的 webp 二次转码；透明通道与原图逐像素一致（alpha maxdiff 0）。所以 `02` 与 `02-flip` 是一对朝向相反、剪影严格对称的立绘。
+4. **裁边**：`01`、`02`、`04` 的画框空白都被裁掉（`sunna-assets/_trim_publish.py`）。侧栏是按**画框**高度算立绘大小的，画框里留白越多、同一尺寸下人物就越小，而且底部留白还会让脚底浮在侧栏底边之上 —— 这个悬浮量随尺寸变化，没法用一个百分比位置配对。`02` 原本顶部留 12%、底部留 6%，裁边后画框的 98.9% 都是人物（`01` 是 99.6%，`04` 是 98.7%），于是同一套尺寸设置就能让不同主题的立绘有相同身高，`position: 100%` 也让脚底落在同一条线上。
+5. **表情**：`sunna-14-chibi-*` 直接来自那 7 个官方源文件（`sunna-assets/_chibi-src/`，另在 `_chibi-named/` 留了一份补上 `.png` 扩展名的副本），**没有抠图**。只做了 2× Lanczos 放大 + 轻锐化：144px 的源在 1.5 倍屏上要显示到 180 物理像素，先在无损源上放大、再让浏览器缩回去，比反过来做插值干净得多。
+6. **未抠图的素材**：`03` 与 `07`–`13` 是场景海报而非透明人物立绘 —— 人物与装饰、排版文字、光效交织，分割模型无法把它们干净分离（实测两个模型分别产出碎片和空白）。这些素材以整幅形式保留，作背景/场景用，不做透明化。
+
+## 授权审计
+
+### 素材的权利状态
+
+**所有素材都是《绝区零》官方美术**，版权归 miHoYo / HoYoverse，不是本插件能授权的对象。
+本插件对它们只做三类操作 —— 裁边、抠图/镜像、重采样 —— 都落在官方二创政策允许的**改编**范围内，
+并且只在**非商业**场景下随插件分发。
+
+### 两种许可要分清
+
+| 对象 | 许可 | 说明 |
+| --- | --- | --- |
+| 本插件的**代码**（`src/`、`lib/`、文档） | CC BY-NC-SA 4.0 | 本仓库自己的产出，可以按该协议再分发与改编 |
+| **素材**（`assets/` 里的图） | 官方二创政策 + 本插件的非商业声明 | 权利在 miHoYo；萌娘共享的 CC 声明只覆盖它自己的**页面内容**，**不改变**官方素材的归属 |
+
+也就是说：README/LICENSE 里的 CC BY-NC-SA 4.0 是对代码说的，素材能用是因为在**非商业二创**范围内，
+不能反过来理解成"这些图的版权可以按 CC 协议流转"。
+
+### 逐项获取途径
+
+| 素材 | 获取途径 | 对原图做了什么 | 现状 |
+| --- | --- | --- | --- |
+| `portrait.webp` | 插件原有素材（同属官方立绘） | 仅转码 | 在用（立绘主题背景） |
+| `sunna-01` | 萌娘共享分类页 | 裁边 | 在用 |
+| `sunna-02-flip` | 萌娘共享分类页 | 抠图 + 裁边 + 镜像 | 在用 |
+| `sunna-04` | 萌娘共享分类页 | 裁边 | 在用 |
+| `sunna-08` / `09` | 萌娘共享分类页 | 仅转码 | 在用（默认背景） |
+| `sunna-07`、`sunna-10`、`sunna-11` | 萌娘共享分类页 | 仅转码 | 在用（影画背景候选） |
+| `sunna-12`、`sunna-13` | 萌娘共享分类页 | 仅转码 | 包内备存，不进候选 |
+| `sunna-14-chibi-*` | 官方 Q 版表情源文件 | 2× 重采样 | 在用 |
+| `sunna-02-teatime` | 萌娘共享分类页 | 抠图 + 裁边 | 已移出包 |
+
+### 已知的暴露面
+
+1. **包内的素材里，多数只做了转码**。18 个文件里只有 `sunna-01`（裁边）、
+   `sunna-02-flip`（抠图 + 裁边 + 镜像）、`sunna-14-chibi-*`（2× 重采样）经过实质改编；
+   其余 —— `portrait.webp`、`sunna-04`、`sunna-07`–`sunna-13` —— 只是转码，性质上更接近
+   "原样再分发官方素材"。
+   其中 `04`、默认的 `08`/`09`、以及 `07`/`10`/`11` 都承担功能（侧栏立绘、默认背景、背景候选）；
+   **`sunna-12` 与 `sunna-13` 是按要求留存的备存素材**，既未改编、也不被任何地方引用 ——
+   它们是这份清单里授权上最弱的两张，也是唯一"纯备存"的。
+   **这是一处取舍**：中途曾把六张移出包以收敛暴露面（包体 3.08 → 1.16 MB），
+   后来为做背景候选放回，并按备存要求保留 `12`/`13`（现 **2.96 MB**）。
+   若更看重授权保守度，先移出 `12`/`13` 即可 —— 它们不影响任何功能。
+2. **`sunna-14-chibi-*` 的源文件自带米游社水印**，说明来自二次导出而非官方公开发布渠道。
+   水印无法在不破坏角色的前提下去除。
+3. **本说明不授予任何商标或肖像使用权**，素材不能当官方物料发布，也不能用于商业用途。
+
+## 授权要求
+
+CC BY-NC-SA 4.0：署名 / 非商业 / 相同方式共享。非商业二创可以自由修改与再分发，**必须署名**且衍生品沿用相同协议；商业用途需另行取得授权。角色名称与形象权利属于各自权利人，本说明不授予任何商标或肖像使用权。

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: dsh-ui-zzz-sunna
+      name: dsh-ui-zzz-sunna