dsh-closure-pet
Manifest valid★ 20《明日方舟》可露希尔卫戍协议皮肤的 DeepSeek Harness 桌宠插件:动画交互、像素气泡、余额与花费提示
dsh-closure-pet
基于《明日方舟》游戏截图二次创作的可露希尔桌宠,运行在 DeepSeek Harness 界面上:透明动画、像素气泡、余额与花费提示。
声明:本插件是个人二次创作,角色形象取自游戏截图,角色形象权利归原权利人;动画为本项目自行制作的透明视频,音效借用自游戏内音效(权利归原权利人)。 本插件的代码可按 MIT 许可证使用;角色形象、音效与动画不在 MIT 授权范围内,仅限个人本机娱乐使用,再分发前请自行确认权利。字体使用 Ark Pixel(SIL OFL 1.1,见
assets/fonts/OFL.txt)。完整说明见NOTICE.md。
结构
lib/index.js 宿主入口:装配(store / events / routes)
lib/store.js 运行时状态、花费累计、持久化、余额轮询
lib/events.js DSH 事件订阅(session/event、agent/*、tools/result)
lib/routes.js /ping、/state、/config、/assets/*
lib/period.js 峰谷时段(纯函数,北京时间)
lib/billing.js 计费价目与单条消息花费(纯函数)
lib/client.js 客户端 bundle(esbuild 打包,自包含,注册到 shell.overlay)
assets/src/ 前端源码(打包进 lib/client.js,不直接由宿主提供)
client-entry.js 客户端 bundle 入口:factory / slot 注册
main.js 组合根:DOM、位置、交互、装配
core/env.js 常量 / 日志
core/settings.js 设置读写与持久化
shared/protocol.js 前后端共享协议(版本 / 路径 / 设置归一化)
render/hit-test.js 静态命中区(图元 → 128×108 掩码)
render/video-player.js 透明视频播放:A/B 双缓冲 + 交叉淡化
anim/library.js 片段表(路径 / 时长 / 循环 / 节奏参数)
anim/director.js 动画导演(分层状态机 / 分段 / Talk 锁 / 思考掷骰)
audio.js 音效(工厂)
ui/layout.js 位置 / 吸附 / 翻转(工厂)
ui/panel.js 设置面板(工厂)
ui/bubble.js 像素气泡(工厂)
ui/sticker.js 谷价贴画(工厂)
input/drag.js 点击 / 拖拽 / 右键(工厂)
io/state.js 宿主状态轮询 + applyState 事件分发
assets/video/ 9 段透明动画(888×748,WebM VP9-alpha)
assets/fonts/ Ark Pixel 12px + OFL
assets/audio/ click / fail / coin / turnfail(Opus 56k)
tests/ node --test 用例(宿主纯函数 / 前端模块 / DOM 桩接线)
cordis.patch.yml bundle 入口
安装
从仓库安装(推荐)
在 Plugins → Add plugin 里填仓库地址:
https://github.com/fengshiyangrouguan/dsh-closure-pet
或手动在 profile 的 package.json 加依赖,并把插件名加进 dsh.profile.bundles:
"dsh-closure-pet": "github:fengshiyangrouguan/dsh-closure-pet"
本地开发安装
"dsh-closure-pet": "link:<本地路径>/dsh-closure-pet"
同样需要把 dsh-closure-pet 放进 dsh.profile.bundles。
开发
| 改动 | 生效方式 |
|---|---|
assets/src/** | npm run build:client 后页面 Ctrl+R |
assets/video/**、assets/audio/**、字体 | 页面 Ctrl+R |
lib/index.js | 插件管理里关→开(重新 import 模块) |
lib/client.js | 由 npm run build:client 生成,不手改 |
cordis.patch.yml | 重启 DSH |
客户端 bundle 由 DSH 以
/plugins/dsh-closure-pet/client.js提供,热启用/停用无需刷新页面;改了源码就要先重新构建 bundle,再 Ctrl+R。
测试(零依赖,Node 内置 runner):
node --test "tests/*.test.mjs" # 或 npm test
tests/host-pure.test.mjs:峰谷/节假日、计费、北京时间归日tests/frontend-pure.test.mjs:常量、设置合并、静态命中区、片段表、音效/布局工厂tests/frontend-wiring.test.mjs:DOM 桩下创建面板/气泡/贴画/导演/状态/拖拽,验证依赖注入与监听注册tests/state-machine.test.mjs:状态机全量回归(base / work / overlay 的所有衔接)tests/client-artifact.test.mjs:lib/client.js是自包含 bundle,注册shell.overlay且不依赖注入回退
调试接口挂在 window.__dshClosurePet:play(name)、showBubble()、settings、layers、debug、startup、dispose() 等。
客户端插件
只有一条加载路径:package.json 的 dsh.client 把 lib/client.js 注册为客户端 bundle,DSH 以 /plugins/dsh-closure-pet/client.js 提供并执行它;bundle 自己把组件注册到 shell.overlay(frame-wide 浮层),组件挂载时调用 startPet() 创建桌宠,卸载时调用返回的 dispose()。
- 不再有
webserver/index-inject注入行,也不再有/pet.js回退路径; - bundle 是自包含的,不从宿主路由动态 import 前端代码,热启用不依赖宿主路由时序;
window.__dshClosurePet仍是调试入口,dispose()可手动卸载(停视频、清定时器、移除监听与 DOM)。
动画状态机
| 层 | 用途 |
|---|---|
overlay | 一次性动画:Happy / Sad_Begin / Special_A / Interact |
work | 进行中:Special_B(思考)/ Talk(输出,强制播完) |
base | 常态:Idle / Sad_Idle(余额偏低) |
- 片段表:
anim/library.js里每段动画对应一个透明视频(assets/video/*.webm),循环与时长都写在同一处。 - 播放:A/B 两个
<video>交替;新片段加载就绪后才交换is-front。只有交互动画结束回状态层做一次 320ms 交叉淡化,其余切换一律硬切。 - 思考:进入思考后的第一次必定播一遍完整的
Special_B;之后每隔 10 秒掷一次骰,50% 概率再播一遍,播完回待机。播放期间不掷骰、不重触发。 - 输出:Talk 强制播完一遍;输出未结束时从头再播,期间状态切换被挂起,播完再兑现。
- 说话中点击交互:这一轮 Talk 视为被显式打断,交互结束回基态(低余额先 Sad_Begin 再 Sad_Idle),不再从头重播;等 work 变成别的状态/空闲后才恢复。
- 互动:
Interact_A暂时停用,只播后半段Interact_B,播完回状态层并做一次 320ms 淡化。 - 难过基态:任何状态回到
Sad_Idle之前,都由导演统一先播一遍Sad_Begin,不靠各事件分支自己补。
触发源:agent/assistant-stream、tools/result、agent/error、agent/status、session/event(assistant/message 计费、turn/end 结束)、账户余额(60s 轮询)。
开屏演出
首次拿到 /state 后等待 10 秒(localStorage['dshcl-startup-delay'] 可改),随后强制插播一遍,即使此刻正在思考或输出也会被打断:
- 峰谷:谷价播
Special_A、峰价播Sad_Begin,并出对应文案 - 间隔 2 秒(
dshcl-startup-gap)后,余额偏低再播Sad_Begin+ 催款文案 - 演完自动回到原本的工作层(思考/说话)或基础层
设置
设置面板(右键桌宠 → 设置):镜像、大小、吸附强度(0%–200%,0% 关闭)、气泡开关、气泡大小(50%–200%,100% 为基准)、更多层次的字体视觉效果(分级排版,默认开)、透明度、音效开关与音量。持久化到 $DSH_HOME/.dshcl.json(settings 与当日 spend)。
拖拽
按住桌宠后,页面交互会一直冻结到松手:文字选不中、图片/链接拖不走、下面的元素不 hover 也不会被点穿,指针滑过 iframe 也不会被里面的文档抢走。
实现见 assets/src/input/drag.js 的 beginDragLock / endDragLock:
- 命中桌宠的
pointerdown(window 捕获阶段)直接preventDefault + stopImmediatePropagation(选区/焦点/原生拖拽都是这次按下的默认动作,页面也收不到这次按下) - 按下到松手之间,在捕获阶段拦掉
mousedown/selectstart/dragstart(pointerdown的preventDefault不保证压掉兼容的mousedown) <html>加dshcl-dragging:user-select:none+cursor:grabbing- 铺一层透明挡板
#dsh-closure-pet-drag-shield吃掉指针命中 - 松手后吞掉浏览器合成的那一次
click(只吞一次,任何新的按下即撤销),避免拖到按钮/链接上松手就点出去 - 窗口失焦 / 切后台 /
pointercancel会自动收尾,挡板不会残留
性能
- 角色不再逐帧绘制:视频由浏览器解码,主线程只处理位置与交互
- 换片段走双缓冲:前台继续播,后台加载,就绪后再淡化,避免加载空档
- 页面隐藏时暂停视频,状态轮询从 1s 降到 5s
- 像素气泡按需创建;文本测量有缓存
- 命中测试用静态命中区(11 个图元 → 128×108 掩码),按下只查表、不读 GPU
峰谷时段维护
规则:工作日 09:00–12:00、14:00–18:00 为峰价;其余时间、周末、法定节假日全天谷价,全部按北京时间判定。
节假日表在 lib/index.js 的 HOLIDAY_RANGES(闭区间),当前收录 2026 全年与 2027 推定日期:
- 官方每年 11 月左右公布下一年调休安排,公布后按实际日期改这两个年份的区间即可
- 未收录的年份只会按“工作日 + 周末”计算(不会算错价,只是少认出节假日)
/state里的holidaysOutdated表示当前年份不在表内,可用于提醒更新
卸载
- 在插件管理里关掉(客户端 bundle 会随停用卸载;宿主代码改动才需要重启 DSH)
- 从 profile 的
dependencies与dsh.profile.bundles里移除 - 可选:删掉
$DSH_HOME/.dshcl.json(设置与当日花费统计)
前端没有常驻定时器跨页面残留;宿主侧的定时器与路由会在插件销毁时通过 ctx.effect 释放。
计费口径
assistant/message 的 usage → cacheRead×谷/峰价 + input×未命中价 + output×输出价,价目内置于 lib/index.js(每百万 token,[谷价, 峰价])。峰谷按北京时间:周末与节假日全天谷价,工作日 09–12、14–18 为峰时。
贡献
- IPC-Wolf(https://github.com/IPC-Wolf):拖动时气泡实时跟随与命中区 grab 光标;气泡分级排版、气泡缩放 100% 基准与使用源脚注;边缘吸附强度可调(0%–200%)。
Comments
Loading…
Similar plugins
by Deepsleep-one
DSH 桌宠额度挂件:可拖拽 / 抛掷 / 散步 / 打瞌睡的桌宠,点开是 ChatGPT · Codex 订阅额度气泡(DeepSeek Harness plugin)
★ 1
MIT
JavaScript
Oct 23, 2026
dsh plugin --profile web add dsh-gpt-niangby Matthew-Laplace
DSH 方舟桌宠:干员库按需下载、自定义 Codex 图集与普通图片导入。Arknights library and custom image pets for DeepSeek Harness.
★ 0
MIT
JavaScript
Oct 8, 2026
dsh plugin --profile web add dsh-ark-petby mengyun233
将 Codex 桌宠皮肤自动迁移到 DeepSeek Harness,在 DSH Web 界面渲染功能一致的桌宠:动画、多会话对话框、设置面板,一键迁移即插即用。
★ 8
↓ 207/wk
JavaScript
Aug 17, 2026
dsh plugin --profile web add dsh-codex-petby Yoshino-JF
DeepSeek 桌宠:把 DSH 账户余额与桌面蓝鲸女仆连起来(立绘 · 游戏屏 · 台词 · 余额播报)
★ 20
↓ 479/wk
MIT
C#
Oct 7, 2026
dsh plugin --profile web add @deepseekstudio/dsh-deepseek-petby nzl153
桌宠小鲸鱼:DSH(DeepSeek Harness)Web 桌宠插件,随 agent 状态切换动画,纯 DOM 零依赖
★ 14
↓ 897/wk
MIT
JavaScript
Oct 2, 2026
dsh plugin --profile web add pet-whaleby alybg
DeepSeek Harness 部署级桌宠:右下角随 Agent 工作状态切换 GIF 动画,气泡实时显示 DeepSeek 余额与语音台词,可拖动、可点击互动,任务完成随机播放语音。
★ 4
↓ 83.4k/wk
JavaScript
Aug 17, 2026
dsh plugin --profile web add dsh-pet