前言¶
在 DeepSeek Harness（DSH）里装上开屏动画插件 dsh-boot-animation 之后，开屏视频能播，但上游自带的设置卡片通常只能开关、调淡入时长、勾选素材池——没法在应用内把新视频放进池子，也没法稳定控制「下一次播哪一支」。若你希望顺序轮播、随机抽片或固定同一支，还得自己摸素材目录和上游的随机逻辑。
dsh-boot-video-manager（维护者 Firefly-TheHerta）是上游开屏插件的配套管理端：界面挂在 设置 → 插件管理，不离开 DSH 就能维护播放列表、三种播放方式，以及开屏声音相关选项与上次启动的音频自检。本插件自己不播视频，而是维护上游的素材池目录和播放顺序；未安装 dsh-boot-animation 时，页面会提示找不到上游插件，此时无法管理。
社区目录将其归类为「趣味换装」；仓库在 GitHub 上当前为 1 star（以目录页统计为准）。DSH 生态强调「一切皆插件」；SkillHub 插件目录 是社区站点，与 DeepSeek / 幻方无官方从属关系。
这是什么¶
一句话：dsh-boot-video-manager 给 dsh-boot-animation 提供 开屏视频播放列表面板，装在设置里的「插件管理」导航下。
- 仓库：github.com/Firefly-TheHerta/dsh-boot-video-manager
- npm 包名：
dsh-boot-video-manager（npmjs.com/package/dsh-boot-video-manager） - 许可证：MIT（见仓库
package.json）
核心功能¶
下面按 README 已写明的能力归纳；未列出的不要当作已支持。
视频与列表¶
- 添加视频：从文件选择框多选，直接传入上游素材池。支持
.mp4、.webm、.m4v、.mov，单文件上限 512 MB；上游不认.mkv。 - 排序：可用每行的
↑/↓，或整列重排。 - 勾选参与：取消勾选即可暂时不参与播放，不必删文件。
- 回收：将某支移出播放列表（挪入
recycle\，可随时找回）。 - 打开素材文件夹：在资源管理器中定位素材目录。
三种播放方式¶
| 方式 | 行为 | 池目录里留什么 |
|---|---|---|
| 顺序播放 | 第一次启动播 1 号、第二次 2 号……播完最后一支回到 1 号 | 只留「下一个」那一支 |
| 随机播放 | 每次启动在勾选参与的视频里随机抽一支 | 参与播放的全部留着 |
| 单次播放 | 每次都播同一支（用「固定播这支」选定） | 只留固定那一支 |
上游插件每次启动会在素材池里随机抽一支。本插件在不改上游代码的前提下，用「池目录里只留该播的那一支」实现顺序与单次：顺序模式下，仅「下一个」留在 assets\videos\，其余参与项在 assets\videos\disabled\ 排队；每次 DSH 启动时插件 apply() 推进游标。因此在资源管理器里看到 disabled\ 下有视频是正常现象，不要手动搬文件。随机模式则让所有勾选参与的视频都留在池目录，由上游随机抽。
面板上的徽章含义（README）：下一个、每次播、在池中、上次启动播了。
开屏声音与音频自检¶
- 播放影片声音、点鼠标直接进入：改的是上游
dsh-boot-animation的设置（命名空间boot-animation），通过 DSH 的configForms读写，与上游设置页是同一值，改完立刻生效，无需重启 DSH。 - 音频自检：声音卡片下方显示上次启动时
<video>的真实状态（是否静音、autoplay 策略、用户手势、拒播原因等）。上游会把结论写入.dshba根元素的data-sound（如on:/late:/muted:加毫秒数）。 - README 说明：旧版上游曾在约 1.2 秒窗口内误判「播不动」而自行静音，导致冷启动第一次常无声；修复逻辑在上游
boot-screen.js。本仓库还提供tools\autoplay-on.ps1，可为 DSH 快捷方式追加 Chromium 启动参数--autoplay-policy=no-user-gesture-required作为保险；加完后需完全退出再启动 DSH。卸载脚本tools\uninstall.ps1会调用-Revert还原。
安装与启用¶
前置要求：已安装 DSH，并已安装 dsh-boot-animation。
dsh plugin 命令必须带 --profile <profile 名>，否则会报错 error: required option '--profile <name>' not specified。profile 名对应 %USERPROFILE%\.dsh\profiles\ 下的目录名。在 PowerShell 中可列出：
Get-ChildItem "$env:USERPROFILE\.dsh\profiles" -Directory | Select-Object -ExpandProperty Name
方式 A：从 npm 安装（README 推荐）¶
dsh plugin --profile <profile 名> add dsh-boot-video-manager
通过 cordis.patch.yml（dsh.bundle.patch）自动挂载宿主入口，装完刷新页面即可。仓库 package.json 中版本为 1.3.1；README 亦提到可通过 npm view dsh-boot-video-manager version 查看 npm 上的发布版本。
方式 B：从 GitHub 安装¶
dsh plugin --profile <你的 profile 名> add github:Firefly-TheHerta/dsh-boot-video-manager
同样由 cordis.patch.yml 自动挂载，无需手改配置文件。
方式 C：desktop profile 的 junction 脚本¶
desktop profile 由 Electron 应用管理；官方建议先完全退出 DSH 再执行 dsh plugin --profile desktop ...。若需不退出或本地调试，可用仓库内脚本：
powershell -NoProfile -ExecutionPolicy Bypass -File .\tools\install.ps1 -ProfileName desktop
卸载（只摘插件，不动视频文件）：
powershell -NoProfile -ExecutionPolicy Bypass -File .\tools\uninstall.ps1 -ProfileName desktop
此种 junction 装法不会出现在 dsh plugin --profile desktop list 的输出里，README 说明这是正常现象。
装好后：打开 设置（齿轮）→ 插件管理，即可看到「开屏视频播放列表」面板（顶部有素材体积与条数、添加视频、刷新、播放方式等）。改动刷新页面即生效。
典型用法¶
在面板里排片¶
- 点击 添加视频…，多选本地文件；第一个加入的排在最上面（上传有进度条）。
- 在 播放方式 中选择顺序、随机或单次。
- 顺序模式可用 设为下一个；单次模式用 固定播这支。
- 不需要的条目点 回收；需要时用 已回收 区域找回。
- 需要确认磁盘与列表一致时点 刷新。
冷启动声音保险（可选）¶
先看会改哪些快捷方式（不改动）：
powershell -NoProfile -ExecutionPolicy Bypass -File .\tools\autoplay-on.ps1 -DryRun
追加启动参数：
powershell -NoProfile -ExecutionPolicy Bypass -File .\tools\autoplay-on.ps1
完全退出 DSH 后重新从被修改的快捷方式启动；面板音频自检行若显示已出声，说明路径生效。还原：
powershell -NoProfile -ExecutionPolicy Bypass -File .\tools\autoplay-on.ps1 -Revert
数据与路径（排障时对照）¶
| 内容 | 位置 |
|---|---|
| 视频文件（池） | <dsh-boot-animation>\assets\videos\ |
| 顺序模式排队 | …\videos\disabled\ |
| 回收 | …\videos\recycle\<时间戳>-原文件名 |
| 播放列表状态 | 默认 %USERPROFILE%\.dsh\boot-video-manager\playlist.json |
素材目录探测顺序（README）：环境变量 DSH_BOOT_VIDEO_DIR → 与本插件同级的 node_modules\dsh-boot-animation\assets\videos → 老位置 D:\dsh-boot-animation\assets\videos。状态文件可用 DSH_BOOT_VIDEO_STATE 显式指定。
宿主 API 挂在 /plugins/dsh-boot-video-manager 下（如 GET /state、POST /upload、POST /mode 等），供面板调用；一般用户只需使用设置界面。
适用场景与注意¶
适合谁：已经在用 dsh-boot-animation、希望在本机轮换或固定开屏视频、并希望在同一处调节开屏声音与查看上次启动音频状态的用户。
依赖：无上游开屏插件则无法使用管理功能；Node 引擎要求见 package.json（^22.19.0 || >=24.0.0）。
安全与权限：插件以当前 DSH 进程的权限运行，可读写素材目录与 playlist.json、接收上传。安装前请自行查看仓库源码与 MIT 许可证，确认符合你的环境策略；不要安装来源不明的同名包。
平台说明：README 中路径示例与 install.ps1、autoplay-on.ps1 面向 Windows 布局；其他系统请以仓库文档与实际上游插件路径为准。
结尾¶
dsh-boot-video-manager 补的是开屏动画「管片单」这一环：列表、顺序/随机/单次、回收与素材夹入口，并把上游声音设置和冷启动无声问题的说明、自检与可选启动参数工具集中到一个面板里。需要详情与更新时，可看社区目录页与 GitHub 仓库 README。
- 目录页：https://www.skillhub.cn/plugins/Firefly-TheHerta/dsh-boot-video-manager
- GitHub：https://github.com/Firefly-TheHerta/dsh-boot-video-manager
