启停动画 samsam560/dog-kjdh

dsh-open-exit-animation

给 DeepSeek Harness 的开场 + 退场动画插件。默认纯代码自绘（CSS/SVG + 自定义属性粒子），零视频素材，也可以换成你自己的视频 / 动图（二进制存在浏览器本地库，不上传、不联网）：

- 开场：DSH 启动、页面就绪后自动播一次（默认样式约 2.26s）。
- 退场（真正关闭时）：托盘右键 → 退出 / 退出应用时，桌面壳会先把窗口亮出来（点过 X 后它在托盘里藏着）， await globalThis.__dshExitAnimation() 播完退场动画再真正退出（默认约 1.42s）。
- 点窗口 X：默认不播动画，直接隐藏到托盘（跟没装插件一样）。想让它也播，就在面板里打开「点 X 关窗也播」（对应配置 exitOnClose）——补丁在 close 收尾里问的是 globalThis.__dshCloseAnimation()，播不播由页面按配置决定，不用重打补丁。

5 套可切换样式，全部在设置页里即时改、即时试播：

| 样式 id | 名字 | 长什么样 |
| whale | 鲸鱼光扫（默认） | 鲸鱼标志描边自绘 → 光扫掠过 → 粒子汇聚 → 字标浮现 |
| pulse | 极简脉冲 | 实心鲸鱼 + 3 圈呼吸扩散，克制、短（1.9s / 1.2s） |
| stardust | 星尘汇聚 | 无标志，54 粒子向中心核汇聚成字（2.4s / 1.5s） |
| typewriter | 打字机 | 无标志，光标 + 扫描线逐字打出（2.1s / 1.1s） |
| rings | 雷达环 | 描边鲸鱼 + 网格 + 3 圈雷达扫过（2.0s / 1.3s） |

除样式外还可调：速度（0.5–3×）、粒子数（0–60）、主色（7 个预设 + 任意取色）、 三段文案（字标 / 开场副标题 / 退场副标题）。

截图

| 开场（鲸鱼光扫，默认） | 雷达环 | 打字机 |
| 开场 | 雷达环 | 打字机 |

| 退场（真正退出时） | 设置页「开关动画」面板 |
| 退场 | 设置面板 |

截图由无头 Chrome 加载同一份 lib/client.js 实拍（不是设计稿），清单见 screenshots.json（插件市场详情页读它）。

在设置页改参数

重启 DSH 后：设置 → 开关动画（左侧导航最下面，齿轮图标）。面板里能：

- 点样式卡切换样式（会立刻试播一次，并保存该样式的推荐粒子数）；
- 开关「开场动画」「退场动画」（退场总开关关掉后，托盘退出也不会被动画拖延）；
- 开关「点 X 关窗也播」：默认关（点 X 直接隐藏到托盘）；打开后点 X 也先播完退场动画再隐藏；
- 拉速度 / 粒子数滑条，点主色块或取色器，改文案输入框；
- 换成你自己的视频 / 动图：「视频素材（可选）」卡里给开场和退场各选一个文件（选择… / 清除），可调静音、素材最长播放（0.8–15 秒）、画面适配（铺满裁切 / 完整显示），并显示本机存储用量；
- 「预览开场」「预览退场」「恢复默认」，以及实时 JSON 配置回显。

不重启也能看效果：双击 preview.html（加载同一份 lib/client.js，浏览器里直接播，面板也是同一份 DOM）。

自己的视频怎么用

1. 设置 → 开关动画 → 「开场素材」/「退场素材」点 选择…，挑一个本机文件（mp4 / webm / mov / mkv / gif / png…）；
2. 选完立刻试播一次，满意就不用管了 —— 下次打开 DSH 播这个开场，真正退出（托盘退出）时播这个退场。

素材存在浏览器本地库里（IndexedDB），不上传、不联网、重启后仍在（不需要重选）。为什么这样存：窗口是沙箱（nodeIntegration:false / contextIsolation / sandbox / webSecurity），file:// 不能当 ，所以选文件时读成 Blob 存本地库，播放时换成同源的 blob: URL —— 零宿主改动、零资源请求。

细节：开场/退场可以各配一个也可以只配一个；没配的那一向继续用代码自绘。素材播完会淡出 240ms 再收场；退场素材最长按 7 秒收尾（桌面壳补丁的兜底是 8 秒，保证窗口不会被卡住）；读不出来或解不了码时自动回落成代码自绘（控制台留一条 console.warn），不会黑屏。

安装

插件市场里搜索「开关动画」直接装；或手动：
dsh plugin add github:samsam560/dog-kjdh # 从 GitHub（仓库里就是源码，无需构建）
dsh plugin add link:/path/to/dsh-open-exit-animation # 本地源码（开发用）

装完完全退出并重启 DSH：开场动画、设置页「开关动画」面板、自备视频素材全部可用。

退场动画（真正退出时）是可选的加强项：它需要给桌面壳打一个小补丁 —— node tools/patch-asar.mjs --apply（或双击 tools/apply-shell-patch.cmd）。补丁只对 app.asar 里 lib/main.js 做字节等长替换、可随时 --restore；不打补丁时插件其余部分照常工作（开场 / 面板 / 素材）。

维护者本机验证状态

| 部分 | 状态 |
| 插件包 ~/.dsh/plugin-packages/dsh-open-exit-animation | 已落盘（lib/client.js 为手写 bundle，无构建步骤） |
| 装配进 desktop profile | 已装（dependencies 加 link: + bundles 数组加包名 + node_modules junction） |
| 桌面壳补丁（托盘退出的 await 钩子 + 关窗问页面） | 已写入 app.asar 的 lib/main.js（等长替换，asar 头未动） |
| 离线自检 | node tools\selftest.mjs → 171/171 通过 |
| 生效条件 | 需要完全退出并重新启动 DeepSeek Harness（补丁与 client bundle 都只在启动时读取） |

验收（重启后）

1. 开场：重启 DSH，进入界面后立刻会看到全屏动画，播完淡出，不挡住后续操作。
2. 点 X 关窗：窗口立刻隐藏到托盘、不播动画（默认）。想让它播：设置 → 开关动画 → 「点 X 关窗也播」打开。
3. 托盘退出：托盘右键 → 退出 → 原生确认框点确定 → 窗口会先亮出来，播完退场动画再退出。
4. 设置面板：设置 → 开关动画，换样式/速度/主色/文案，再点「预览开场」看效果。
5. 页面控制台可用：__dshAnim.open() / __dshAnim.exit()；快捷键 Ctrl+Alt+O / Ctrl+Alt+X。
6. 自备素材：设置 → 开关动画 → 「视频素材（可选）」→ 开场 / 退场各点「选择…」挑一个本地视频或动图；选完会立刻试播一次，之后重启 DSH 看开场片头、托盘退出看退场是不是你自己的素材（没配的那一向仍是代码自绘）。

配置与 API

配置存在页面 localStorage 的 dsh-open-exit-animation:config：

| 键 | 默认 | 含义 |
| open | true | 启动时自动播开场 |
| exit | true | 真正退出（托盘退出 / 退出应用）时播退场（关掉后桌面壳拿到的 Promise 立即 resolve，退出不会被动画拖延） |
| exitOnClose | false | 点 X 关窗时是否也播退场动画；默认 false = 直接隐藏到托盘（补丁问页面 __dshCloseAnimation()，页面按这个键决定） |
| speed | 1 | 整体速度倍率（0.5–3），所有时长都是 calc(<基准>ms / speed) |
| style | "whale" | 样式 id（见上表） |
| particleCount | 26 | 粒子数 0–60（0 = 不画粒子） |
| accent | "" | 主色 #rrggbb；空串 = 内置蓝青配色 |
| word / subOpen / subExit | 见下 | 字标 / 开场副标题 / 退场副标题，最长 48 字 |
| mediaOpen / mediaExit | null | 该方向的素材元信息 { name, size, kind: "video"\|"image", type }；二进制在 IndexedDB（dsh-open-exit-animation-media → assets → 键 open/exit），这里只记文件名 |
| mediaMuted | true | 素材静音播放 |
| mediaMaxMs | 6000 | 素材最长播放时间 800–15000ms（退场再多一层 7000ms 硬上限） |
| mediaFit | "cover" | 画面适配：cover 铺满裁切 / contain 完整显示 |

默认文案：word = DeepSeek Harness，subOpen = 正在启动 · starting，subExit = 正在退出 · shutting down。

__dshAnim.get() // 读当前配置
__dshAnim.set({ style: "typewriter", speed: 1.4 }) // 写（自动钳制 + 持久化 + 同步面板）
__dshAnim.reset() // 恢复默认
__dshAnim.open() / __dshAnim.exit() // 手动播（force，忽略开关）
__dshAnim.open("rings") // 一次性试播别的样式，不写配置
__dshAnim.styles() // 5 套样式的 { id, label, note, dots }
__dshAnim.version // "0.3.1"

__dsaMedia.supported() // 当前环境能不能存素材（IndexedDB + blob URL）
__dsaMedia.pick("open", file) // 手动喂一个 File（等价于面板里点「选择…」）
__dsaMedia.clear("exit") // 清掉某个方向的素材
__dsaMedia.hydrate() // 从本地库重新读一遍（改过库之后用）
__dsaMedia.state() // { supported, open, exit, ready:{open,exit}, urls:{open,exit} }

__dsaPanel.mount(element) // 把同一份设置面板裸挂到任意容器（preview.html 用的就是这个）
__dsaStyles // 等同 __dshAnim.styles()
globalThis.__dshExitAnimation() // 桌面壳 await 的钩子（托盘退出 / 退出应用）：返回退场动画 Promise
globalThis.__dshCloseAnimation() // 桌面壳在"点 X 关窗"时 await 的钩子：配置 exitOnClose 为 false 时立刻 resolve(false)
__dshAnim.get().exitOnClose // 点 X 关窗是否也播（默认 false）

所有配置都经过一层 sanitize：速度/粒子越界钳制、未知样式回落 whale、非法主色回落内置配色、空白文案回落默认值；旧版的 particles: true/false 会自动迁移成 particleCount: 26/0。

桌面壳补丁改了什么

只动 resources\app.asar 里的 lib/main.js 两个位置，字节等长替换（多出来的代码从同文件纯 ASCII 的 JSDoc 注释正文里等量删除，因此 asar 头与文件偏移全部不变；已实测该安装包关闭了 EnableEmbeddedAsarIntegrityValidation）：

1. createMainWindow 的 close 处理器（原 main.js:12038-12039）：把 hide() 换成一个包装，先 window.webContents.executeJavaScript("globalThis.__dshCloseAnimation ? ... : null", true)，await 到页面回答再隐藏。页面按配置 exitOnClose 决定：默认关 ⇒ 立刻 resolve(false)，窗口马上隐藏到托盘（行为等于没打补丁）；打开后才会播完退场动画再隐藏。setTimeout(..., 8000) 兜底，动画异常/挂死不会卡住窗口。
2. app.on("before-quit") 里用户确认退出后的分支（原 main.js:12250-12253）：先把窗口 show() 出来（点过 X 后它在托盘里藏着，不 show 就看不到告别动画），再 executeJavaScript("globalThis.__dshExitAnimation ? ... : null", true) await 动画 Promise，最后 finishQuit()；窗口缺失/已销毁时直接走原逻辑。

备份与还原：

备份：~/.dsh/open-exit-animation/main.js.orig （490,173 字节，原始 main.js 区域）记录：~/.dsh/open-exit-animation/shell-patch.json（原始/补丁后 sha256）状态：node tools\patch-asar.mjs --check 还原：node tools\patch-asar.mjs --restore （或双击 tools\restore-shell-patch.cmd）重打：node tools\patch-asar.mjs --apply （或双击 tools\apply-shell-patch.cmd）预演：node tools\patch-asar.mjs --apply --dry-run

--restore 会先校验当前 main.js 区域的 sha256 是否等于补丁后的值，不等（例如 DSH 升级过）就拒绝覆盖，避免把新版本的文件写坏。DSH 升级后补丁会失效：升级会换掉 app.asar，此时 --check 会提示未打补丁，重新 --apply 即可（--restore 不再适用）。

脚本自己找安装位置（Windows %LOCALAPPDATA%\Programs\DeepSeek Harness\resources\app.asar、macOS /Applications/DeepSeek Harness.app/Contents/Resources/app.asar、Linux /opt 与 /usr/lib 下的 deepseek-harness）；自定义安装路径用 --asar <path> 或环境变量 DSH_ASAR 指定。备份 / manifest / 语法检查临时文件都放 ~/.dsh/open-exit-animation/。

卸载

1. node tools\patch-asar.mjs --restore 还原桌面壳。
2. 从 ~/.dsh/profiles/<profile>/package.json 里删掉 dependencies.dsh-open-exit-animation 和 dsh.profile.bundles 里的这一项（本机备份见同目录 package.json.bak-dsh-anim）。
3. 删掉 ~/.dsh/profiles/<profile>/node_modules/dsh-open-exit-animation junction。
4. 重启 DSH。

目录

lib/index.js 宿主半：空实现（本插件不需要宿主能力） lib/client.js 浏览器半：手写 window.__ModuleLoader__.load({...}) bundle，含全部动画与设置面板 cordis.patch.yml bundle patch：把自己 insert 进 profile preview.html 浏览器里直接预览动画 + 裸挂同一份设置面板 tools/fill-fish-path.mjs 把 @@FISH_PATH@@ 占位符换成真实鲸鱼路径（已跑过，幂等） tools/dsh-paths.mjs 跨机器定位 app.asar（DSH_ASAR / --asar / Windows·macOS·Linux 常见安装位置）与状态目录 tools/selftest.mjs 离线自检（DOM shim + 微型 React + 内存 IndexedDB + 171 项断言） tools/scan-comments.mjs 统计 main.js 可删注释字节预算（补丁用） tools/patch-asar.mjs 桌面壳补丁：等长替换 + 备份 + 校验 + 还原 tools/probe-asar-writable.mjs DSH 运行时 asar 是否可写的探针（1 字节空写）

tools/selftest.mjs 覆盖：bundle 注册契约 / 只 require react / 5 套样式各自成画 / 退出去重与打断开场 / 自清理 / 快捷键 / reduced-motion 降级 / 配置钳制与旧键迁移 / 主色变量注入 / settings.section 注册契约 / 面板 DOM 结构与全部控件交互（含外部改配置后面板自动同步）/ 「点 X 关窗也播」开关与 __dshCloseAnimation()（默认不播、打开后播、exit 总开关优先）/ 自备视频素材全路径（选中→本地库→blob URL→素材层参数→解码失败回落自绘→首帧守卫（700ms 没出画就回落自绘）→退场 7 秒钳制→重新 apply 自动水合→清除后回到自绘→面板状态回显）。

版本记录

- 0.3.1 — 退场动画只在真正关闭时播：桌面壳补丁的 close 分支改成先问页面
globalThis.__dshCloseAnimation()，页面按新配置 exitOnClose（默认 false）决定——默认点 X 立刻隐藏到托盘、不播动画；面板「开关」卡新增「点 X 关窗也播」开关，想播的人打开即可（不用重打补丁）。
补丁的 before-quit 分支补一句 mainWindow.show()：点过 X 后窗口在托盘里藏着，不亮出来就看不到告别动画。
自检 164 → 171 项（新增关窗开关与 __dshCloseAnimation() 行为断言）。
- 0.3.0 — 加「用户自备视频 / 动图素材」：面板里给开场、退场各选一个本地文件（也可 __dsaMedia.pick()），二进制存浏览器本地库（IndexedDB），播放时用 blob: URL；新增 mediaMuted / mediaMaxMs / mediaFit 三项调节；视频元素预建复用保证首帧即出，播完淡出 240ms 收场，退场硬上限 7 秒（桌面壳兜底 8 秒），解码/读取失败自动回落代码自绘；另加首帧守卫：素材 700ms 还没解出画面（readyState === 0）就立刻回落自绘，不让用户盯着黑屏。
自检从 134 项加到 164 项（新增内存版 IndexedDB shim 与首帧守卫断言）。
- 0.2.1 — 修「设置页里没有『开关动画』」。根因：Cordis v4 里读未声明 inject 的服务会直接抛 cannot get property "slots" without inject，旧代码 if (ctx.slots) … else if (ctx.inject) … 在第一个分支就抛错，被自己的 catch 吞掉，动态 ctx.inject(["slots"]) 分支永远到不了 ⇒ 面板从不注册（动画不受影响）。
现在只走 ctx.inject(["slots"], scoped => …)，ctx.slots 只在没有 inject 的平台里、包在独立 try 里退化读取；
bundle 导出的 inject 保持 []（声明 inject: ["slots"] 会让 apply 一直等到服务出现，动画会被连累）。
自检加了 5 条回归断言（ctx.slots 抛错时仍走 inject、仍注册、无异常日志、仍包在 effect 里、最坏情况 apply 不抛）。
- 0.2.0 — 5 套样式 + 设置页「开关动画」面板（样式/开关/速度/粒子/主色/文案，实时试播与 JSON 回显）。

已知限制

- 自备素材受浏览器存储配额限制（Chrome/Electron 里通常按磁盘可用空间给，面板会显示用量并自动申请持久化）；超大视频建议先压到几十 MB 以内。
- 素材能否播放取决于 Electron 自带的解码器：mp4(H.264) / webm / gif / png / jpg 稳，mov / mkv / HEVC 不一定，解不了会回落到代码自绘。
- 退场动画挂在主窗口上：真正退出（before-quit）一定会播；点 X 关窗默认不播（面板里可打开）。
关机（session-end）路径刻意不等动画。
- 桌面壳 await 的超时是 8s；把 speed 调到 0.2 以下时动画会被截断（默认 1.42s 有充足余量）。
- 补丁是改安装包的做法：DSH 每次升级后需要重打；不升级则长期有效。
- 设置页导航图标由壳里硬编码映射，第三方 section 一律显示兜底齿轮图标。
- 粒子数是全局设置：换成"打字机"这类本身不带粒子的样式时，如果粒子数不为 0 仍会画粒子（点样式卡会带上该样式的推荐值，打字机是 0）。