DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-closure-pet

f

dsh-closure-pet

Manifest valid★ 20

《明日方舟》可露希尔卫戍协议皮肤的 DeepSeek Harness 桌宠插件:动画交互、像素气泡、余额与花费提示

UI (client)hasBundlePatch

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'] 可改),随后强制插播一遍,即使此刻正在思考或输出也会被打断:

  1. 峰谷:谷价播 Special_A、峰价播 Sad_Begin,并出对应文案
  2. 间隔 2 秒(dshcl-startup-gap)后,余额偏低再播 Sad_Begin + 催款文案
  3. 演完自动回到原本的工作层(思考/说话)或基础层

设置

设置面板(右键桌宠 → 设置):镜像、大小、吸附强度(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 表示当前年份不在表内,可用于提醒更新

卸载

  1. 在插件管理里关掉(客户端 bundle 会随停用卸载;宿主代码改动才需要重启 DSH)
  2. 从 profile 的 dependencies 与 dsh.profile.bundles 里移除
  3. 可选:删掉 $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

dsh-gpt-niang

by Deepsleep-one

DSH 桌宠额度挂件:可拖拽 / 抛掷 / 散步 / 打瞌睡的桌宠,点开是 ChatGPT · Codex 订阅额度气泡(DeepSeek Harness plugin)

Tools & CapabilitiesManifest valid

★ 1

MIT

JavaScript

Oct 23, 2026

dsh plugin --profile web add dsh-gpt-niang

by Matthew-Laplace

DSH 方舟桌宠:干员库按需下载、自定义 Codex 图集与普通图片导入。Arknights library and custom image pets for DeepSeek Harness.

Just for FunManifest valid

★ 0

MIT

JavaScript

Oct 8, 2026

dsh plugin --profile web add dsh-ark-pet

by mengyun233

将 Codex 桌宠皮肤自动迁移到 DeepSeek Harness,在 DSH Web 界面渲染功能一致的桌宠:动画、多会话对话框、设置面板,一键迁移即插即用。

Just for FunManifest valid

★ 8

↓ 207/wk

JavaScript

Aug 17, 2026

dsh plugin --profile web add dsh-codex-pet

by Yoshino-JF

DeepSeek 桌宠:把 DSH 账户余额与桌面蓝鲸女仆连起来(立绘 · 游戏屏 · 台词 · 余额播报)

UI & ExperienceManifest valid

★ 20

↓ 479/wk

MIT

C#

Oct 7, 2026

dsh plugin --profile web add @deepseekstudio/dsh-deepseek-pet

by nzl153

桌宠小鲸鱼:DSH(DeepSeek Harness)Web 桌宠插件,随 agent 状态切换动画,纯 DOM 零依赖

Just for FunManifest valid

★ 14

↓ 897/wk

MIT

JavaScript

Oct 2, 2026

dsh plugin --profile web add pet-whale

by alybg

DeepSeek Harness 部署级桌宠:右下角随 Agent 工作状态切换 GIF 动画,气泡实时显示 DeepSeek 余额与语音台词,可拖动、可点击互动,任务完成随机播放语音。

Manifest valid

★ 4

↓ 83.4k/wk

JavaScript

Aug 17, 2026

dsh plugin --profile web add dsh-pet