npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@ljwei-stak/dsh-boot-animation

v0.6.6

Published

鲸鱼娘启动加载动画:点击进入(Esc/空格放行)、多片随机、启动进度可见、失败有兜底;数据驱动开屏模板(分幕/时间线/iframe,兼容 dsh-boot-suite 格式)、用户 BGM、可视化模板编辑器与模板商店。不改 DSH 本体源码。

Readme

dsh-boot-animation

npm 版本 dshfind dshfind 下载量 已收录至 DSH 插件目录 Awesome DSH Plugin

dshfind

语言:简体中文 | English

用选定或随机的本地视频替换 DSH 启动页,或用数据驱动的开屏模板(分幕、时间线、整页 iframe)替换,随后过渡进入应用,并提供可配置的播放与回退控制。它不会修改 DSH 核心源码;未来的兼容性不作保证。

这是一个社区插件,与 DeepSeek 不相关,也未获得 DeepSeek 的认可。

截图

本地 Chromium 演示宿主渲染了实际的 0.6.6 启动页和设置卡片源码,并附带示例 profile 数据。这些不是已登录的 DSH live profile 截图,也不代表已完成跨平台验证。

启动页预览

影片形式:满屏短片 + 跟真实启动进度走的进度条 + 底部提示行。

模板形式预览

模板形式:内置 archive-warm 分幕模板——经典授权序列,正在等待操作员确认。

安装

Web 版

dsh plugin --profile web add @ljwei-stak/[email protected] --save-exact

必须已满足宿主与 Node 的要求。

桌面版

打开 设置 -> 插件 -> 添加插件,粘贴 @ljwei-stak/[email protected],然后按提示从托盘彻底退出并重新打开。

对于 Desktop 升级,如果实时安装 API 报告该软件包已安装,请先从托盘彻底退出,然后使用官方 Desktop 捆绑包装器——而不是较旧的全局 dsh 可执行文件。

Windows 默认位置的可复制离线命令:

& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add '@ljwei-stak/[email protected]' --save-exact

如果 DeepSeek Harness 安装在其他位置,请相应调整包装器路径。如果你使用自定义 DSH_HOME,在运行此命令时请保留该设置。不要在 Linux 或 macOS 上使用这个确切的 Windows 路径。

卸载

Web:

dsh plugin --profile web remove @ljwei-stak/dsh-boot-animation

Desktop:使用官方插件 UI。已有的自定义视频是独立数据;在手动删除前,请先检查并备份。新的软件包安装会自动注册 scoped bundle;不要手动插入第二个 bundle 条目。

配置

该插件使用宿主 profile 配置和一个插件补丁文件。没有单独的 .env、INI 或 JSON 设置加载器。

| 文件 | 作用 | | --- | --- | | <DSH_HOME>/profiles/<profile>/cordis.yml | 宿主基础配置。 | | <DSH_HOME>/profiles/<profile>/cordis.patch.yml | 插件配置修改。随附的 patch 挂载 id 为 boot-animation,名称为 @ljwei-stak/dsh-boot-animation。 | | Profile package.json | 通过安装器跟踪依赖和 dsh.profile.bundles。 |

提供了一个示例片段,仅作为配置对象参考;它不是一个独立的自动加载配置文件。

设置命名空间:boot-animation。优先使用现有设置 UI。预览会立即使用当前设置。重新加载 Web 页面以进行下一次启动;在 Desktop 上,从托盘彻底退出并重新打开以进行下一次启动。Host entry 升级也需要完整重启进程。

| 键 | 默认值 | 说明 | | --- | --- | --- | | enabled | true | 主开关。 | | fadeMs | 2000 | Schema 范围 300–5000 ms;UI 预设 1000、1500、2000、3000、4000。 | | enterMode | tail | tail 在片段末尾溶解;end 在播放结束后淡出;click 循环直到进入。 | | disabledClips | [] | 在池中被禁用的不透明文件名。 | | sound | true | 受浏览器手势策略限制。 | | clickToEnter | false | 启用后,第一次指针按下会立即进入;否则按下可能先用于解锁音频。 | | showHint | true | 显示进入提示。 | | form | video | video 是影片形式;template 把开屏页交给数据驱动的模板运行时。 | | template | archive-warm | 模板形式第一幕的模板 id。 | | template2 | "" | 可选的第二幕;为空则不播。 | | tpl | 见下 | 模板形式自己的设置(速度、主题、时机、配音、身份、配色、转场、玻璃)。 |

tpl 是一个嵌套对象,每个叶子字段都可以单独热更新——设置卡片一次只写一个叶子 ({ op: 'set', path: ['tpl', 'speed'] })。Host 没有下发的字段一律沿用 vendored 运行时的默认值,所以在模板形式出现之前写下的设置文档本身就是完整的。全部字段、 取值范围与默认值见 entry.js 的 TPL_DEFAULTS。

视频素材

导入的视频会复制到 <DSH_HOME>/profiles/<profile>/data/dsh-boot-animation/videos。最初选中的文件不会被改动。assets/videos 下的旧版内置资源可能会被软件包升级替换;推荐使用 UI 导入。

在 UI 中,打开 设置 -> 插件 -> 已安装插件 -> 启动动画(配置区就在插件自己的页面里;每一行的「配置」页是同一张卡。DSH 0.2.1 及更早版本中它在「插件配置」列表里),可以导入最大 256 MiB 的视频、将一个片段设为启动片或启用多个片段进行随机选择、预览当前效果,并在确认后移除自定义片段。

开屏模板

form: template 时,开屏页由 assets/splash/ 下的 vendored 运行时渲染:模板是纯 JSON 加素材。内置三种引擎,任选其一都能跑:分幕 steps(中英文字幕 + 配音 + 可选 等待)、时间线 layers(图层关键帧——文字、线条、面板、图片、视频、字符球、身份卡 等)、iframe(模板自己的整个网页,经能力令牌沙箱加载)。

插件内置 12 个模板,覆盖每种引擎。把模板目录放进 <DSH_HOME>/profiles/<profile>/data/dsh-boot-animation/templates/<id>/ 即可加入列表, 同名的用户模板会覆盖内置模板。为 dsh-boot-suite 写的模板可以直接用——格式是那个项目的,运行时是其引擎的适配副本,完整署名见 CREDITS.md。

动这一半之前值得知道的两条不变量:读不出来或校验不过的模板会回落到影片形式 (绝不是黑屏),以及每个可能读到用户模板目录的路由都过浏览器信任栅栏,栅栏 fail-closed。

音乐、编辑器与商店

模板形式还带着三项能力,同样移植自上游项目,也遵循同样的规则:

  • 自己的音乐:设置卡片的「背景音乐」分段可以导入音频(MP3 / WAV / OGG / M4A / AAC / FLAC,单个不超过 100 MB),文件只写进本机 profile 的数据目录,不上传任何地方。 可以指定主音乐和可选的第二段(两段之间交叉淡入),以及音量、拍速、两段的拍数与 起点、循环方式和配音闪避。存储的文件名是生成的,不取自请求;读取路由在碰磁盘之前 会再校验一次白名单。
  • 可视化编辑器:卡片里的「打开模板编辑器」开一个完整页面,可视化地改文字、图层、 关键帧和配色,带实时预览台;保存写进用户模板目录,覆盖前自动备份旧版本。页面由 tools/vendor-editor.mjs 从上游编辑器生成,路由基准改写到本插件。
  • 模板商店:卡片里的「模板商店」分段列出公开模板(默认索引是 dsh-boot-suite 的 模板库,格式本插件原样支持),点「安装」就把模板和自带素材写进用户目录。拉取在宿主 侧完成,有体积和超时上限;文档在写入前先过校验,且 id 必须与索引条目一致。网络不 通时回答上次读到的列表,而不是把功能藏掉。

兼容性

  • **DSH:**最低 >=0.2.0-rc.2;已针对 Windows Desktop 运行时 0.2.0-rc.2 和 0.2.1-rc.2 验证集成。
  • Node:^22.19.0 || >=24.0.0;ESM。
  • 运行时依赖:@deepseek-ai/schemastery ^3.18.4(声明为依赖,而非 peer dependency)。
  • **浏览器:**目标为 Chromium、Chrome 和 Edge;Firefox 未经验证。
  • **平台:**macOS 和 Linux 脚本路径存在,但在此验收中未经过独立测试。
  • **编解码器:**需要浏览器支持的编解码器。优先使用 H.264/AAC MP4。仅凭 MP4、WebM、M4V 或 MOV 容器格式,无法保证浏览器能够解码。

权限与信任

此 Node 插件以宿主 OS 权限运行;没有按插件划分的沙箱。

  • **读取:**随附的脚本和视频。
  • **写入/移除:**profile 数据目录中导入的视频副本。
  • **Optimize:**使用 Node API 显式重写内置的 MP4,并带有 originals/ 备份和 .faststart-work/ 临时空间。运行时不会执行 shell 命令或 ffmpeg。
  • **凭据/网络:**插件运行时不会使用模型或提供商 API 密钥、遥测或远程服务。浏览器 HTTP 调用为同源。安装器需要 npm 和 GitHub 网络访问,但这与运行时行为不同。

HTTP 访问边界

自定义的 import、read 和 delete 路由会强制执行 DSH connection.requestRejection 身份验证和路径检查。Bundled clip manifest/video 和 Optimize 路由本身不会强制执行相同的钩子。不要假设每条路由都经过身份验证。

请仅在受信任的本地环境中使用。远程或反向代理运营方必须对整个 /plugins/dsh-boot-animation/ 前缀强制执行访问控制。导入的媒体不会发布到 GitHub 或 npm。视频以 no-store 方式提供,因此重复加载会再次传输片段数据。

许可证

代码以 MIT 许可证发布。LICENSE 声明内置 MP4 作品同样采用 MIT 条款。用户导入的媒体保留其自身权利;安装插件不会对其进行再许可。

参考仓库

后两个是本包「模板动画」形式的移植来源;移植内容与改名映射见 CREDITS.md 与 tools/vendor-splash-runtime.mjs。不暗示上游、宿主或来源项目的任何认可。

开发者说明

此仓库中包含的验证命令:

node build-client.mjs      # only if client source changes
node verify/verify-entry.mjs
node verify/verify-degraded.mjs
node verify/verify-options.mjs
node verify/verify-custom-clips.mjs

0.6.6 版本通过了 567 项检查;但这并不意味着每个 Desktop 版本或操作系统都经过了完整的端到端测试。

有关开发和设置详情,请参阅 AGENTS.md、MANUAL.md 和 INSTALL.md。归档的历史记录保存在 docs/DEVELOPMENT_NOTES.md,不具有权威性。

插件目录提交

一份可直接复制的提交草稿遵循 hub 模板。徽章用于标明插件已收录于社区目录,不代表官方背书或质量保证。