dsh-folia 2.0.2 → 2.1.0

package/README.md

@@ -61,7 +61,7 @@
 
 <table>
   <tr>
-    <td width="36%" valign="middle">
+    <td width="64%" valign="middle">
       <ul>
         <li><a href="#能做什么">能做什么</a> · <a href="#支持哪些壁纸类型">支持哪些壁纸类型</a> · <a href="#安装">安装</a> · <a href="#使用">使用</a></li>
         <li><a href="#可选桌宠联动">可选桌宠联动</a> · <a href="#配置与数据">配置与数据</a> · <a href="#兼容与限制">兼容与限制</a> · <a href="#开发与贡献">开发与贡献</a></li>
@@ -73,14 +73,6 @@
         <img src="assets/readme/mascot-eating-rice-1280x1784.jpg" alt="吉祥物干饭插图">
       </a>
     </td>
-    <td width="36%" align="center" valign="middle">
-      <a href="assets/about/sponsor-fish.png">
-        <img src="assets/about/sponsor-fish.png" alt="生鱼的赞赏码" width="320" height="320">
-      </a>
-      <br><strong>生鱼的赞赏码</strong>
-      <br><sub>“大肥鱼的白饭告急，收到的赞赏将统统用于本插件的维护与更新”</sub>
-      <br><sub>自愿赞赏 · 不影响安装与使用</sub>
-    </td>
   </tr>
 </table>
 
@@ -322,20 +314,9 @@ macOS 没有 Wallpaper Engine 官方客户端。可以上传图片 / 视频，
 
 > npm 包不包含 `docs/`。上面的技术资料使用源码仓库地址、演示图使用 Release 资产地址（`media-v1`），避免在 npm 页面中出现无效的相对路径。
 
-<h2 id="联系方式"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/readme/section-community-dark.png"><img src="assets/readme/section-community-light.png" alt="联系方式" width="1440"></picture></h2>
+<h2 id="联系方式">联系方式</h2>
 
-本分支安装与联动回归优先提交到 [维护仓库 Issues](https://github.com/Fish-under-sea/dsh-folia/issues)；正式版本的共性问题提交到 [正式主仓 Issues](https://github.com/elysia395/dsh-folia/issues)，方便追踪与复现。交流也可以加入以下群组；插件「关于」页使用同一份二维码。
-
-<p align="center">
-  <a href="lib/about/qq-group.png"><img src="lib/about/qq-group.png" alt="QQ 群：FOLIAWALLPAPER | LLM 讨论群" width="260" height="259"></a>
-  &nbsp;
-  <a href="lib/about/douyin-group.png"><img src="lib/about/douyin-group.png" alt="抖音群：folia 交流 2 群" width="260" height="260"></a>
-</p>
-
-| 交流入口 | 群组 |
-|---|---|
-| QQ 群 | **FOLIAWALLPAPER \| LLM 讨论群** |
-| 抖音群 | **folia 交流 2 群**，群号 `917001335502` |
+本仓不提供交流群。安装、使用、bug 与功能建议统一走 [仓库 Issues](https://github.com/lehua-art/dsh-folia/issues)。
 
 <h2 id="致谢"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/readme/section-credits-dark.png"><img src="assets/readme/section-credits-light.png" alt="致谢" width="1440"></picture></h2>
 
@@ -384,15 +365,11 @@ macOS 没有 Wallpaper Engine 官方客户端。可以上传图片 / 视频，
 
 README 首屏与分节横条的复古窗口视觉复刻自 [MaiBot](https://github.com/Mai-with-u/MaiBot)，项目图标与菲比使用本仓原始素材，像素字体采用 Jersey 20。详细来源与授权见 [素材说明](assets/readme/SOURCES.md)；未沿用对方的人物、统计数据或排名。
 
-<h2 id="支持与赞赏"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/readme/section-support-dark.png"><img src="assets/readme/section-support-light.png" alt="支持与赞赏" width="1440"></picture></h2>
-
-项目保持开源，赞赏完全自愿，**不影响安装、使用或问题反馈**。给仓库点 Star、提交可复现的 Issue、补充文档与参与测试，同样是在支持项目。
-
-**生鱼的赞赏码**：赞赏用于本插件的维护与更新。以下是生鱼个人的赞赏入口，不代表全部贡献者的收款账户。
-
-> “大肥鱼的白饭告急，收到的赞赏将统统用于本插件的维护与更新”
+<h2 id="支持与赞赏">支持</h2>
 
-赞赏码展示在 [目录](#目录) 右侧，点击图片可查看原图。感谢每一份支持。
+项目保持开源、完全免费，**没有赞赏入口** —— 本仓是上游 MIT 项目的二次开发，
+不代收任何款项。给仓库点一颗 Star、提交可复现的 Issue、补充文档或参与测试，
+就是最好的支持。
 
 <h2 id="star-history"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/readme/section-stars-dark.png"><img src="assets/readme/section-stars-light.png" alt="Star History" width="1440"></picture></h2>
 

package/lib/client.js

@@ -8,11 +8,10 @@ window.__ModuleLoader__.load({
 				/**
 				 * about-assets.js — 「关于」页签与「更新公告」用到的**静态数据**（仓库地址 + 随包图的路径）。
 				 *
-				 * 二维码用随包 PNG（用户要求），**不内联 base64** —— 内联会把两张图压进 `lib/client.js`
-				 * （+240KB，每次冷启动随 bundle 一起解析），而它们与面板逻辑毫无关系。图是随包资源
-				 * `lib/about/*.png`，由宿主路由 `GET <BASE>/about-qr/<文件名>` 直出
-				 * （白名单 + ETag/304，见 packages/about-notice/lib/routes/about-qr.js）；本文件只留**路径**，`<img src>` 经
-				 * `apiUrl()` 拼前缀，换码只要替换那两个 PNG，不必重建客户端产物。
+				 * 本仓自有版本：**不再包含上游的交流群二维码与赞赏码**（QQ 群 / 抖音群 / 原作者收款码）。
+				 * 「关于」页只剩项目简介 / Star / 贡献者致谢三节；联系方式指向仓库 Issues。
+				 * 图片仍走 `lib/about/` + 白名单路由直出（理由见 lib/components/about-notice/routes/about-qr.js），
+				 * 剩下的唯一一张是「更新公告」的配图。
 				 *
 				 * 契约（构建期由 scripts/build-client.mjs 内联进 bundle 的工厂作用域）：纯数据、零依赖，
 				 * 必须保持浏览器安全（无 import / require / Node API）。
@@ -21,15 +20,7 @@ window.__ModuleLoader__.load({
 				// 项目仓库（README / package.json 的同一条地址）：关于页的按钮与可复制文本都用它。
 				const ABOUT_REPO_URL = "https://github.com/lehua-art/dsh-folia";
 
-				// 两张二维码的**路由路径**（相对 BASE，交给 apiUrl 拼前缀）：
-				//   · QQ 群「FOLIAWALLPAPER | LLM 讨论群」     → lib/about/qq-group.png
-				//   · 抖音群「dsh 交流群」            → lib/about/douyin-group.png
-				// 文件名与 packages/about-notice/lib/routes/about-qr.js 的白名单**逐字相同**（守卫两边对账）。
-				const ABOUT_QR_QQ_PATH = "/about-qr/qq-group.png";
-				const ABOUT_QR_DOUYIN_PATH = "/about-qr/douyin-group.png";
-
-				// 「更新公告」一次弹窗的配图（v1.3.0 起：GitHub 求星插画，JPEG 720×720）：
-				//   · 派生自 assets/about/update-notice-star-1254x1254.png（缩到 720px、JPEG q88）
+				// 「更新公告」一次弹窗的配图（JPEG 720×720，本仓自有素材）：
 				//   · 随包发布 lib/about/update-notice.jpg，由 /about-qr 路由族直出（同一白名单）
 				//   · 版本换图 = 替换 lib/about/update-notice.jpg 的字节，路径与产物都不动（ETag 会变）。
 				const NOTICE_ART_PATH = "/about-qr/update-notice.jpg";
@@ -16111,25 +16102,8 @@ window.__ModuleLoader__.load({
 				    // star 数那一行（模块级：值 + 三态文案都在 client.js 的 starCountLabel 里；
 				    // 这里的"读"与 SliderRow 一类模块级助手同口径 —— 只读，不发请求）。
 				    const stars = starCountLabel();
-				    // 两张码的参数表：图（路由 URL）/ 图题 / 替代文本 / 一句话说明。渲染一次 map 两遍，
-				    // 免得两段几乎一样的 createElement 各自演化（改一处忘一处正是这类页面最容易烂的地方）。
-				    const qrCards = [
-				      {
-				        key: "qq",
-				        title: weT("🐧 QQ 群 · FOLIAWALLPAPER | LLM 讨论群"),
-				        // 图本体是随包 PNG（lib/about/），这里只给路径 —— apiUrl 补 BASE 前缀。
-				        src: apiUrl(ABOUT_QR_QQ_PATH),
-				        alt: weT("QQ 群二维码"),
-				        hint: weT("手机 QQ 扫码加入 · 群里见 👋"),
-				      },
-				      {
-				        key: "douyin",
-				        title: weT("🎵 抖音群 · dsh 交流群"),
-				        src: apiUrl(ABOUT_QR_DOUYIN_PATH),
-				        alt: weT("抖音群二维码"),
-				        hint: weT("抖音扫码加入 · 群号 252729465001"),
-				      },
-				    ];
+				    // 本仓自有版本：**不再带上游的交流群二维码与赞赏码**（那是原作者的社群与收款渠道）。
+				    // 「关于」页只剩项目简介 / Star / 贡献者致谢三节，联系方式留给仓库的 Issues。
 				    // 贡献者致谢逐条列出（名字 / 做了什么）——「谢谢」要能落到具体的人身上，
 				    // 一句笼统的"感谢所有贡献者"没有信息量。
 				    const credits = [
@@ -16197,27 +16171,8 @@ window.__ModuleLoader__.load({
 				        React.createElement("p", { className: "we-about__p" },
 				          weT("想要新功能、遇到问题，或者想看看接下来要做什么，都欢迎来仓库提 Issue / PR —— 一起把它做得更好 🧰")),
 				      ),
-				      // ── ③ 交流群（两张二维码）──
-				      React.createElement("div", { className: "we-picker__section" },
-				        React.createElement("div", { className: "we-picker__section-head" },
-				          React.createElement("span", { className: "we-picker__section-label" }, weT("💬 加入交流群")),
-				        ),
-				        React.createElement("p", { className: "we-about__p" },
-				          weT("卡住了、想吐槽、或者想第一时间拿到新版本，都欢迎来群里找我们 👋")),
-				        React.createElement("div", { className: "we-about__qr-row" },
-				          qrCards.map((c) => React.createElement("figure", { key: c.key, className: "we-about__qr" },
-				            React.createElement("figcaption", { className: "we-about__qr-title" }, c.title),
-				            React.createElement("img", {
-				              className: "we-about__qr-img",
-				              src: c.src,
-				              alt: c.alt,
-				              draggable: false,
-				            }),
-				            React.createElement("figcaption", { className: "we-about__qr-hint" }, c.hint),
-				          )),
-				        ),
-				      ),
-				      // ── ④ 贡献者致谢（**压尾**：用户口径——先讲清"这是什么、去哪支持、怎么找我们"，
+				      // ── ③ 交流群：**已整节移除**（本仓不带上游社群二维码；见上方 qrCards 位置的说明）──
+				      // ── ④ 贡献者致谢（**压尾**：用户口径——先讲清"这是什么、去哪支持"，
 				      //    最后再把功劳簿摆出来。💌 那句收尾也并进这一段，页面结束在"谢谢"上。）──
 				      React.createElement("div", { className: "we-picker__section" },
 				        React.createElement("div", { className: "we-picker__section-head" },

package/lib/components/about-notice/routes/about-qr.js

@@ -30,10 +30,13 @@ import { resolve, relative, isAbsolute } from 'node:path';
 
 /**
  * 白名单：URL 段 → 文件名。**唯一**把请求映射到磁盘的地方。
- * 名字用 `String` 的精确比较（`===`），不看前缀/后缀 —— 于是 `qq-group.png.bak`、
- * `./qq-group.png`、`qq-group.png/` 之类都过不了。
+ * 名字用 `String` 的精确比较（`===`），不看前缀/后缀 —— 于是 `update-notice.jpg.bak`、
+ * `./update-notice.jpg`、`update-notice.jpg/` 之类都过不了。
+ *
+ * 本仓自有版本只保留「更新公告」配图：上游那两张交流群二维码（qq-group / douyin-group）
+ * 已连同文件一起删除 —— 那是原作者的社群，不该随我们的包分发。
  */
-const ABOUT_QR_FILES = ['qq-group.png', 'douyin-group.png', 'update-notice.jpg'];
+const ABOUT_QR_FILES = ['update-notice.jpg'];
 
 /**
  * 命中白名单返回绝对路径（含目录包含性复查），否则 null。

package/package.json

@@ -1,6 +1,6 @@
 {
     "name":  "dsh-folia",
-    "version":  "2.0.2",
+    "version":  "2.1.0",
     "description":  "Folia 壁纸引擎：把本机 Wallpaper Engine 壁纸搬进 DSH 界面（场景实时渲染 / 视频 / 网页），内置液态玻璃与 Folia 吉祥物，并可从自建站点拉取壁纸。单包形态（组件已合并）。",
     "type":  "module",
     "engines":  {
@@ -150,7 +150,6 @@
                   "assets/readme/section-stars-dark.png",
                   "assets/readme/SOURCES.md",
                   "assets/readme/OFL-Jersey20.txt",
-                  "assets/about/sponsor-fish.png",
                   "assets/readme/mascot-eating-rice-1280x1784.jpg",
                   "README.md",
                   "README.en.md",

package/assets/about/README.md

@@ -1,89 +0,0 @@
-# 「关于」页签的联系方式二维码 + 更新公告配图（源资产）
-
-本目录归档设置页**「关于」页签**里两张联系方式二维码的**原始截图**，以及「更新公告」弹窗
-配图的**原始插画**。与 `assets/mascot/` 同一口径：它们是**源资产**，不是运行时载荷。
-
-- 运行时用的是这两张图**裁到码区**的派生版本，落在 **`lib/about/*.png`**（随包发布），由插件路由
-  `GET <BASE>/about-qr/<文件名>` 直出（白名单 + ETag/304，见 `packages/about-notice/lib/routes/about-qr.js`）；
-  客户端只存路径（`src/about-assets.js`）。2026-10-01 之前那版把派生图**内联 base64** 进客户端
-  bundle，用户要求改成 PNG 引入 —— bundle 因此省下约 240KB，换码也不必重建产物。
-- 因此**本目录**（源资产）**不进 npm 包**（不在 `package.json` 的 `files` 白名单内），只随仓库源码分发；
-  派生产物 `lib/about/` 进包（`verify-package-files` 盯着）。
-
-## 文件与用途
-
-| 文件 | 尺寸 | 用途 |
-|---|---|---|
-| `qq-group-folia-llm-702x852.png` | 702×852 | **QQ 群「FOLIAWALLPAPER \| LLM 讨论群」** 群二维码（含图内标题）。对应 `lib/about/qq-group.png` / `ABOUT_QR_QQ_PATH` |
-| `douyin-group-folia-2-748x748.png` | 748×748 | **抖音群「folia 交流 2 群」**（群号 917001335502）二维码（含图内群名与群号）。对应 `lib/about/douyin-group.png` / `ABOUT_QR_DOUYIN_PATH`。2026-10-10 换码：旧码 `douyin-group-dsh-1044x1026.png`（「dsh 交流群」，群号 252729465001）已退役 |
-| `update-notice-star-1254x1254.png` | 1254×1254 | **v1.3.0 更新公告配图**「求个 star 喵！」GitHub 求星插画（原图）。对应 `lib/about/update-notice.jpg` / `NOTICE_ART_PATH`（缩到 720px + JPEG q88，Pillow LANCZOS） |
-
-> **派生版只取"码"那块**（裁掉图内的标题带 / 群名 / 群号），因为这些文字在页面里由**卡片自己的
-> 标题与说明行**承担（重复两遍没有信息量），而裁掉之后两张码在面板里**尺寸一致、并排对齐**、
-> 码点也更大更好扫。裁剪框（含 36px 留白）见下面的派生脚本注释。
-
-## 替换素材时怎么重新生成派生版本
-
-1. 把新二维码存成 PNG 放到本目录（原始尺寸留着，便于日后重新派生）。
-2. 派生：缩到**宽 520px**（等比），转**128 色调色板** PNG（quantize + optimize）——
-   码点仍足够清晰（QQ 码约 9 px/模块），而体积只有原图的 1/4 左右。
-3. 把派生 PNG 覆盖到 **`lib/about/`**（文件名固定：`qq-group.png` / `douyin-group.png`），
-   **不需要重建客户端产物** —— 客户端只存路径；README 引用的也是这两张（中英两份同步显示新码）。
-
-参考命令（本机 `Pillow`；换尺寸 / 色数只改这两个参数）：
-
-```python
-from PIL import Image
-import base64, io
-# 裁剪框 = 码的内容 bbox（含 36px 留白）；两张图各自的框见下面的常量。
-BOXES = {
-    "qq-group-folia-llm-702x852.png":      (63, 249, 634, 819),   # 标题带 / 分隔线之下
-    "douyin-group-folia-2-748x748.png":    (185, 116, 567, 497),  # 群名 / 群号文字之上
-}
-MARGIN, W, COLORS = 36, 520, 128
-
-def derive(path):
-    im = Image.open(path).convert("RGB")
-    x0, y0, x1, y1 = BOXES[path.split("/")[-1]]
-    im = im.crop((max(0, x0 - MARGIN), max(0, y0 - MARGIN),
-                  min(im.width, x1 + MARGIN), min(im.height, y1 + MARGIN)))
-    im = im.resize((W, round(im.height * W / im.width)), Image.LANCZOS)
-    im = im.convert("P", palette=Image.ADAPTIVE, colors=COLORS)
-    buf = io.BytesIO(); im.save(buf, "PNG", optimize=True)
-    return "data:image/png;base64," + base64.b64encode(buf.getvalue()).decode()
-```
-
-（bbox 由一次性的内容扫描得到：行 / 列方向上都统计"非近白"像素，取 ≥3 像素的区间端点。
-派生结果直接写进 `lib/about/` —— **不要再转 base64 内联**。）
-
-## 派生版怎么验证（两档，都做过）
-
-1. **结构保真**：把派生图上采样回裁剪框分辨率、与裁剪后的原图逐像素比 —— 两图平均通道差
-   `0.90 / 0.72`（满量程 255）、99 分位差 `9 / 8`、按墨色二值化后一致率 `99.30% / 99.75%`。
-2. **真解码**：会用 macOS Vision（`VNDetectBarcodesRequest`，见下面的自检命令）对**派生版**扫码。
-   **实测：QQ 码解出 `https://qm.qq.com/q/yxDL6BdsFW`**；抖音那种"点划 + 渐变 + 中心头像"的
-   装饰码连**原图**都解不出来（Vision 认不了这一型），所以它的验证只到第 1 档 ——
-   **换抖音码时请务必用手机真机扫一次**再提交。
-
-```bash
-# ① 扫的就是插件运行时直出的那两份字节（lib/about/ 下的 PNG）
-# ② 用 Vision 扫（一行一个文件；本命令就是上面第 2 档验证用的）
-cat > /tmp/qrdecode.swift <<'SWIFT'
-import Foundation; import Vision; import AppKit
-for path in CommandLine.arguments.dropFirst() {
-  guard let i = NSImage(contentsOfFile: path), let t = i.tiffRepresentation,
-        let r = NSBitmapImageRep(data: t), let cg = r.cgImage else { continue }
-  let req = VNDetectBarcodesRequest(); req.symbologies = [.qr]
-  try? VNImageRequestHandler(cgImage: cg, options: [:]).perform([req])
-  print(path, (req.results ?? []).compactMap { $0.payloadStringValue })
-}
-SWIFT
-swiftc -O /tmp/qrdecode.swift -o /tmp/qrdecode && /tmp/qrdecode lib/about/qq-group.png lib/about/douyin-group.png
-```
-
-## 公告配图（update-notice-star-1254x1254.png）的派生口径
-
-跟二维码不是一回事：整图**无裁剪**，Pillow LANCZOS 缩到 **720×720**，存 **JPEG q88**
-（progressive + optimize，约 146KB；PNG 同尺寸要 753KB）。派生覆盖 `lib/about/update-notice.jpg`
-—— 路径与客户端产物都不动（`/about-qr` 路由带 ETag/304，换图即生效）。下个版本换公告图时：
-新图存本目录（原始尺寸留着），按同口径重派生覆盖即可，白名单与客户端不用改。

package/lib/about/README.md

@@ -1,28 +0,0 @@
-# 联系方式二维码 + 公告配图（随包发布的运行时资源）
-
-「关于」页签里那两张二维码与「更新公告」配图的**运行时字节**。与本目录并列的 `lib/fontsets/`（随包预设）、
-`lib/webwallgl/`（随包渲染页）同一口径：**随包发布、由插件自己的路由提供**。
-
-- 提供方：`packages/about-notice/lib/routes/about-qr.js`（`GET/HEAD <BASE>/about-qr/<文件名>`，白名单 + ETag/304）。
-  客户端只存路径（`src/about-assets.js`），`<img src>` 直接指过来。
-- **为什么不用内联 base64**：那版把两张图压进 `lib/client.js`（+240KB，每次冷启动都要解析这串
-  字符），而它们与面板逻辑毫无关系 —— 拆成静态文件后 bundle 回到原大小，换码也只需要替换这里的
-  PNG（不必重建客户端产物）。
-- 本目录**进 npm 包**（`package.json` 的 `files` 里 `lib/about/`；`verify-package-files` 盯这件事）。
-  **源资产**（未裁剪的原始截图）在仓库的 `assets/about/`，那一份**不进包**。
-- **README 也引用这两张图**（中英两份的联系方式段）——展示的就是插件里真用的同一份字节，
-  不另存副本。
-
-## 这两张图是什么
-
-| 文件 | 内容 | 派生自 |
-|---|---|---|
-| `qq-group.png` | QQ 群「FOLIAWALLPAPER \| LLM 讨论群」二维码（520×517） | `assets/about/qq-group-folia-llm-702x852.png` |
-| `douyin-group.png` | 抖音群「folia 交流 2 群」（群号 917001335502）二维码（520×519） | `assets/about/douyin-group-folia-2-748x748.png` |
-| `update-notice.jpg` | v1.3.0 更新公告配图「求个 star 喵！」GitHub 求星插画（720×720） | `assets/about/update-notice-star-1254x1254.png` |
-
-派生口径（只取码区 + 缩到 520px 宽 + 128 色调色板）与验证方式（逐像素比对 + macOS Vision 扫码）
-见 [`assets/about/README.md`](../../assets/about/README.md) —— 那里是**怎么生成**，这里是**发布什么**。
-公告配图另有自己的口径（原图 1254² 缩到 720px、JPEG q88），客户端路径常量 `NOTICE_ART_PATH`
-（`src/about-assets.js`）与路由白名单逐字对账（`verify-about` 盯着）—— 下个版本换公告图时替换
-本文件字节即可，路径与客户端产物都不动。