dsh-plugin-startup-animation 1.12.4 → 1.12.6

package/README.md

@@ -8,8 +8,7 @@
 
 <a href="https://github.com/WWFZS/dsh-plugin-startup-animation/releases"><img src="https://img.shields.io/github/v/release/WWFZS/dsh-plugin-startup-animation?style=flat-square&label=VERSION&color=4d6bfe" alt="Version"></a>
 <img src="https://img.shields.io/badge/DSH-0.2.0%2B-4d6bfe?style=flat-square" alt="DSH">
-<img src="https://img.shields.io/badge/依赖-0%20npm%20包-2ea44f?style=flat-square" alt="No deps">
-<img src="https://img.shields.io/badge/体积-27%20MB-6e7681?style=flat-square" alt="Size">
+<img src="https://img.shields.io/badge/运行时-零依赖-2ea44f?style=flat-square" alt="No deps">
 <img src="https://img.shields.io/badge/License-MIT-2ea44f?style=flat-square" alt="License">
 <img src="https://img.shields.io/badge/Author-WWFZS-8957e5?style=flat-square" alt="Author">
 
@@ -26,11 +25,12 @@
 你等的永远是应用本身，不是动画。
 
 插件通过内核的两个扩展点接入：`webserver/index-inject` 注入覆盖层与样式，
-`webServer.register` 提供素材与管理路由。**没有任何 npm 依赖**，浏览器半边只从宿主的
+`webServer.register` 提供素材与管理路由。**运行时不依赖任何 npm 包**，浏览器半边只从宿主的
 模块表 `require('react')`，装好即用、无需构建。
 
-开箱自带 **5 段视频 / 7 张壁纸 / 9 段语音**，也支持上传你自己的 MP4 / WebM / GIF /
-PNG / JPG / MP3。声音有两个彼此独立的开关：视频自己的音轨，以及单独的开机音频。
+开箱自带 **6 段视频 / 7 张壁纸 / 9 段语音**，也支持上传你自己的 MP4 / WebM / GIF /
+PNG / JPG / MP3。素材在设置页里点卡片即用，展示时长可以在 **3–30 秒**之间调；声音有两个
+彼此独立的开关——视频自己的音轨，以及单独的开机音频。
 
 ## 核心特性
 
@@ -40,29 +40,37 @@ PNG / JPG / MP3。声音有两个彼此独立的开关：视频自己的音轨
 - **绝不扣住你** —— 点击、`Esc` / `Enter` / `空格`、或者干等，每条路都能出去
 - **失败即降级** —— 任何一步出错都退回 Harness 原生启动页，不阻塞启动
 - **真实进度条** —— 内核给出启动进度弧就用真实进度，否则走流光
+- **时长自己定** —— 3–30 秒，视频与壁纸共用；点击跳过不受它限制
+- **更新前先看清** —— 设置页的「更新公告」直接显示 Release 说明，不用跳 GitHub
 - **卸载与升级都由你** —— 有新版只提示、你点一下才装；不需要了就卸载
 
 ## 界面预览
 
 **视频素材库** —— 卡片点选即用，来源直接标在卡片上（内置 / 上传），当前在用的那张标「使用中」：
 
-<img src="docs/library.jpg" width="520" height="268" alt="视频素材库">
+<img src="docs/library.jpg" width="520" height="261" alt="视频素材库">
 
 **壁纸素材库** —— 同样点卡片即生效，来源标记同上：
 
 <img src="docs/library-wallpapers.jpg" width="520" height="268" alt="壁纸素材库">
 
-**开机动画效果** —— 内置《欢迎回来》（720p / 8 秒 / 带语音音轨）选中后，Harness 启动时看到的就是这一段：
+## 安装
 
-<img src="docs/preview-welcome.gif" width="440" alt="《欢迎回来》开机动画效果">
+四种方式，任选一种。装好后都在 **设置 → 开机动画** 里配置，首次安装完刷新一次页面即可。
 
-完整版（含语音）在 [`builtin/MP4/欢迎回来.web.mp4`](builtin/MP4/欢迎回来.web.mp4)。
+### 方式一：搜包名（最简单）
 
-## 安装
+插件已发布到 npm，DSH 0.2.1+ 的插件管理器能直接装。
+
+1. 打开 **设置 → 插件**，点 **添加插件**
+2. **插件名**填 `dsh-plugin-startup-animation`
+3. 点 **安装**，完成后刷新页面
 
-### 方式一：插件管理器 + 直链（推荐）
+包名也可以在 [npm 页面](https://www.npmjs.com/package/dsh-plugin-startup-animation) 上核对版本。
 
-DSH 0.2.1+ 自带插件管理器。这条路**不需要 npm，也不需要 git**。
+### 方式二：直链（不走 npm）
+
+GitHub 慢、或想直接从 Release 装时用这条。这条路**不需要 npm，也不需要 git**。
 
 1. 打开 **设置 → 插件**，点 **添加插件**
 2. **插件名**填下面这条地址
@@ -77,22 +85,26 @@ https://github.com/WWFZS/dsh-plugin-startup-animation/releases/latest/download/d
 **文件的绝对路径**填进「插件名」（例如 `C:\Users\你\Downloads\dsh-plugin-startup-animation.tgz`），
 效果一样。
 
-### 方式二：命令行
+### 方式三：命令行
 
 ```sh
+# 从 npm（profile 需要能访问 npm registry）
+dsh plugin --profile <你的 profile> add dsh-plugin-startup-animation
+
+# 或从 GitHub 直链
 dsh plugin --profile <你的 profile> add https://github.com/WWFZS/dsh-plugin-startup-animation/releases/latest/download/dsh-plugin-startup-animation.tgz
 ```
 
 本地 `.tgz` 文件或本地目录路径同样可以，把最后一个参数换掉即可。然后重启 `dsh`。
 
-### 方式三：从源码
+### 方式四：从源码
 
 ```sh
 git clone https://github.com/WWFZS/dsh-plugin-startup-animation.git
 dsh plugin --profile <你的 profile> add /该仓库的绝对路径
 ```
 
-> **官方 DSH 桌面版**：请从应用内的 **设置 → 插件** 安装（即方式一）。那个 profile
+> **官方 DSH 桌面版**：请从应用内的 **设置 → 插件** 安装（方式一或方式二）。那个 profile
 > 归应用的插件管理器管，命令行改动无效。
 
 ## 怎么用
@@ -107,7 +119,7 @@ dsh plugin --profile <你的 profile> add /该仓库的绝对路径
 | 展示时长 | 3–30 秒，视频与壁纸共用。**跳过不受它限制**。 |
 | 启动画面素材 | 当前素材预览，以及「恢复默认」（回到内置动画）。 |
 | MP4 / 壁纸 / 音频 / 更新公告 四个页签 | 前三个是素材分类：点卡片即选用、上传即入库。**更新公告**是只读页，显示最新版 Release 的更新说明。 |
-| 卸载 / 更新 | 装在当前 profile 里时显示。**卸载插件**会把它移除（设置与上传素材保留在磁盘）；有新版时出现**更新到 x.y.z**。两者都要重启 DSH 才生效。从源码目录 `link:` 进来的安装不给更新按钮——那条依赖不指向任何版本。 |
+| 卸载 / 更新 | 装在当前 profile 里时显示。**卸载插件**会把它移除（设置与上传素材保留在磁盘）；有新版时版本号变成一个更新按钮。两者都要重启 DSH 才生效。从源码目录 `link:` 进来的安装不给更新按钮——那条依赖不指向任何版本。 |
 
 没选素材时，插件会播放**自己的内置动画**（配色随应用深浅色走的旋转徽标）。
 选了素材就用素材；「恢复默认」把它换回内置动画。把总开关关掉，才是 Harness
@@ -117,13 +129,16 @@ dsh plugin --profile <你的 profile> add /该仓库的绝对路径
 
 ### 版本与更新
 
-设置页标题旁有一枚很小的版本号——显示你**实际装上的**版本，直接读包自己的清单。
+设置页标题旁有一枚版本号，显示你**实际装上的**版本（直接读包自己的清单）。
 
-- **已是最新**：只显示 `v1.2.3`（你装的那一版），不打扰你。
-- **有新版**：变成 `v1.2.3 · 更新到 1.2.4` 按钮，点一下**就地更新**（下载 Release 里的
-  tgz、替换自己的文件），完成后重启 DSH 即可——不用去 GitHub 手动下包。
-- **检查不到**：离线、防火墙拦了、或者 GitHub 不可达时，就只是一枚安静的版本号。
-  它**不会变成报错状态**——更新检查是锦上添花，不是插件的依赖。
+- **已是最新**：就只是一枚版本号，不打扰你。
+- **有新版**：它变成一个按钮，点一下**就地更新**（下载 Release 里的 tgz、替换自己的文件），
+  完成后重启 DSH 即可——不用去 GitHub 手动下包。更新成功后标题立刻换成新版本号。
+- **检查不到**：离线、防火墙拦了、或者 GitHub 不可达时，只是一枚安静的版本号，
+  **不会变成报错状态**——更新检查是锦上添花，不是插件的依赖。
+
+**不管你是从 npm、直链还是源码装的，一键更新都从 GitHub Release 取包**——那条 tgz 直链是
+唯一的更新来源，所以哪怕当初用 `npm i` 装的，点了更新之后也会切到 Release 版本。
 
 设置页还有一个 **更新公告** 页签：内容就是最新版 Release 的发布说明（同一次更新检查
 顺手带回来，不另发请求），装没装新版都能先看清"这次改了什么"；取不到就安静地显示
@@ -159,13 +174,13 @@ dsh plugin --profile <你的 profile> add https://github.com/WWFZS/dsh-plugin-st
 ```
 
 `file` 可以写 `builtin/...` 包内相对路径，也可以写你自己素材的绝对路径。
-其余键都有合理默认值，见 [`index.js`](index.js) 的 `DEFAULT_CONFIG`。
+`durationSec` 默认 **5**、范围 3–30；其余键都有合理默认值，见 [`index.js`](index.js) 的 `DEFAULT_CONFIG`。
 
 ## 支持的素材
 
 | 类型 | 格式 | 说明 |
 |---|---|---|
-| 视频 | `mp4` `m4v` `webm` `ogv` `ogg` | 等待期间循环播放。内置为 1080p / 5–8s / faststart（`dsh-大肥鱼` 与 `欢迎回来` 为 720p）。 |
+| 视频 | `mp4` `m4v` `webm` `ogv` `ogg` | 等待期间循环播放。内置为 1080p / 8–16s / faststart（`dsh-大肥鱼` 为 720p）。 |
 | 图片 | `gif` `apng` `webp` `png` `jpg` `jpeg` | `gif`/`apng`/`webp` 会动；静图带缓慢呼吸缩放。 |
 | 音频 | `mp3` `wav` `m4a` `aac` `flac` `opus` | 仅用于开机音频。 |
 
@@ -175,11 +190,14 @@ dsh plugin --profile <你的 profile> add https://github.com/WWFZS/dsh-plugin-st
 
 以下全部随包分发，在列表里直接可选：
 
-- **MP4** —— 5 段，全部为 H.264 faststart（可直接流式播放，每段 1.6–6.6 MB）。
-  `dsh-大肥鱼` 与 `欢迎回来` 带语音音轨（打开「视频带声播放」即可听到），另外三段无音轨
+- **MP4** —— 6 段，全部为 H.264 faststart（可直接流式播放，每段 1.6–6.9 MB）。
+  `dsh-大肥鱼` 与 `剑一` 带语音音轨（打开「视频带声播放」即可听到），另外四段无音轨
 - **壁纸** —— 7 张，附带预生成的 480px 缩略图供列表使用
 - **音频** —— 9 段语音
 
+> 所有素材均来自网络，感谢各位 UP 主的优秀作品。仅作演示用途，版权归原作者所有；
+> 商业再分发前请先看 [ASSETS.md](ASSETS.md) 确认每个文件的来源。
+
 ## 它如何做到"不添乱"
 
 - 覆盖层挂在 `document.body` 上、**不在 `#root` 里**，不会干扰应用的水合（hydration）。
@@ -202,7 +220,7 @@ Harness"来处理：
 | 运行期其它任何意外 | 每条失败路径都回落到原生启动页——覆盖层永远不允许阻塞启动 |
 
 声明的兼容范围（`engines.dsh`，并镜像一份到 `dsh.engines`，让插件管理器和市场从
-任一位置都能读到）是 `>=0.2.0`。插件**没有任何 npm 依赖**，浏览器半边只从宿主的模块表
+任一位置都能读到）是 `>=0.2.0`。插件**运行时不依赖任何 npm 包**，浏览器半边只从宿主的模块表
 `require('react')`——不存在"随包打进了某个会和内核版本脱节的库"这种隐患。
 
 启动日志会同时写明插件版本和（能读到时）宿主内核版本。万一哪次升级把动画弄没了，
@@ -213,7 +231,7 @@ Harness"来处理：
 - DeepSeek Harness **0.2.0+**（Web 界面）
 - Node.js ≥ 22.12.0（跟随 Harness 自带的运行时即可）
 
-插件**没有任何 npm 依赖**，安装时也不需要构建——纯 ESM + 静态素材。
+插件**运行时不依赖任何 npm 包**，安装时也不需要构建——纯 ESM + 静态素材。
 
 ## 卸载
 
@@ -233,6 +251,7 @@ node tools/client-test.mjs           # 设置页行为测试（React 垫片）
 node tools/boot-css-test.mjs         # 开机动画样式测试（真浏览器）
 node tools/host-smoke.mjs            # 用真实路由处理器跑一遍 HTTP
 node tools/make-thumbs.mjs           # 重新生成列表缩略图（需要 ffmpeg）
+node tools/make-posters.mjs          # 重新生成视频卡片封面（需要浏览器）
 node tools/optimize-builtin.mjs      # 重新生成 faststart 变体（需要 ffmpeg）
 ```
 

package/client.js

@@ -472,7 +472,7 @@ window.__ModuleLoader__.load({
     /**
      * 视频封面取帧点：在 25% / 50% / 75% 三个候选位置里，选**画面最亮**的那一帧。
      *
-     * 为什么不能固定取首帧：素材常从黑场淡入（《大肥鱼-欢迎回来》前几秒几乎全黑），
+     * 为什么不能固定取首帧：素材常从黑场淡入（前一两秒几乎全黑），
      * 固定取 0.1s 会得到一张纯黑卡片，看起来像素材坏了。也不能只取中点 ——
      * 中间恰好是转场/黑场的视频同样会黑。
      *

package/index.js

@@ -336,7 +336,12 @@ export const DEFAULT_CONFIG = Object.freeze({
   sound: false,
   /** 音量 0..1。 */
   volume: 1,
-  /** 开机音频总开关：开 = 动画期间播放所选音频，并强制视频静音（要听视频声就关掉它）；跳过动画时音频同步停止。 */
+  /**
+   * 开机音频总开关：开 = 动画期间另播所选音频。
+   * 它与视频音轨是**两条独立的路**，可以同时开 —— 用户自己决定要听哪个，
+   * 插件不替用户做"开一个就关另一个"的决定（早期版本会强制静音视频，那是错的）。
+   * 跳过动画时音频同步停止。
+   */
   audioEnabled: false,
   /** 开机音频素材：'' = 不播；绝对路径或包内相对路径（builtin/音频/…）= 自己的文件。 */
   audioFile: '',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-startup-animation",
-  "version": "1.12.4",
+  "version": "1.12.6",
   "type": "module",
   "description": "Animated full-screen startup screen shown while DeepSeek Harness boots — click to skip. Ships a built-in MP4/wallpaper/audio library and accepts your own files. 开机动画 / 启动动画：启动 Harness 时显示全屏动画，随包内置视频、壁纸与开机音频，也可以用自己的素材。",
   "license": "MIT",