ディレクトリに戻る

dsh-pet-indesktop

キュレーションリスト掲載メンテナンス: 活発

gjs9178u/dsh-pet-indesktop

DSH Web GUIに動くクジラのデスクトップペットを表示します。画面上で移動でき、配置を記憶します。

GitHub で見る
$ dsh plugin add dsh-pet-indesktop

インストール方法

dsh には中央のインストールコマンドはありません。このプラグインのエントリ(README に記載)をプロファイルまたはパッチ設定に追加し、再起動します。

インストールの仕組み

7

スター

0

フォーク

JavaScript

言語

NOASSERTION

ライセンス

2026-10-16

作成日

2026-10-20

最終プッシュ

README

dsh-pet-indesktop

状态 / Status

这是一个能用的桌宠(desktop pet),不是占位动画。

它做什么:在 DSH 网页界面右下角放一只手绘的小角色——蓝头发、鳍状耳朵、鲸鱼尾巴,手里捧着一个白色杯子。 它会上下轻轻浮动、左右微微摇摆、缓慢地“呼吸”;按住可以拖动(鼠标和触摸都行),松开后位置会被记住; 点一下会说一句话(中英双语,说完自己消失);侧边栏底部有一个「桌宠 开 / 关」按钮, 可以随时把它藏起来或叫回来。

它的名字是 「大肥鱼」/ "Big Fat Fish",有 八种配色皮肤可以随时切换: 深海蓝 deepsea、樱花粉 sakura、薄荷绿 mint、暮光紫 twilight、焦糖金 caramel、 雪白银 silver、墨黑 ink、余烬红 ember。切换在侧边栏那枚按钮弹出的面板里点一下色块即可, 选择会被记住(存在宿主上),重开页面也还在。

画法:八张随插件一起分发的 PNG 图片,由插件自己的宿主半边提供 (/dsh-pet-indesktop/assets/skins/<id>.png),动效是它外面的 CSS。没有任何第三方请求: 图片、脚本、样式全部来自同一个包、同一个进程。

图片署名(attribution): 画面带有 “OleapCrow” 的画师标记,由仓库所有者提供, 不是本项目的原创绘制,也不是 DeepSeek 的官方素材。授权情况见 LICENSE ——「由仓库所有者提供;详见 LICENSE」。

English summary: a working desktop pet for the DSH web GUI — one hand-drawn character (blue hair, fin ears, whale tail, holding a white cup) that bobs, sways and breathes, can be dragged, remembers where it was left, and says a bilingual line when clicked. The image is one PNG shipped inside the plugin and served by its own host half, so there are no third-party requests, no video and no external assets. The artwork carries an "OleapCrow" mark and was supplied by the repository owner; see LICENSE for the licence situation. It has not been installed against a live DSH host; see "Known limitations".


这是什么

一个 DSH(DeepSeek Harness)插件,在网页界面里加两个挂载点:

插槽 类型 放什么
shell.overlay kind: list 桌宠本体。清单插槽 = 新增一个单元,永远不会顶掉官方界面
sidebar.footer.action kind: list 「桌宠 开 / 关」按钮

宿主半边(Node)只做两件事:报状态、保存桌宠的状态。

半边 做了什么
宿主半边 src/host/index.js 三条路由:status.json(存活探针)、state.json(读状态)、state.json/state(写状态,带严格校验与原子写)
浏览器半边 src/client/index.js 动态注入 slots / uiSession,挂上桌宠与开关按钮;宿主什么都不提供时安静待机

浏览器半边是一个纯 JavaScript 文件,用 DSH 的加载器信封包起来(见下一节)。它没有编译器、没有打包器、 也没有任何 npm 依赖:node scripts/build.mjs 把它原样复制成 lib/client.js,只在最前面加一段生成横幅。

桌宠的行为

行为 怎么做的 为什么
呼吸 CSS keyframes,3.2 秒一个周期 完全静止的贴图看起来像坏了;一个缓慢的上下浮动就够了
眨眼 纯函数 blinkAt(now) 决定,组件只负责加 class 时机要能被测试读到,而不是埋在 CSS 里没法断言
尾巴摆 5.2 秒一个周期,和呼吸的 3.2 秒不互为倍数 两个不整除的周期读起来像活着,像循环动画反而假
拖动 Pointer Events + setPointerCapture,位置在同一个 clamp 里更新 鼠标和触摸同一套代码;拖动中经过的位置一定是能存下去的合法位置
记住位置 松手后 600ms 防抖 POST 给宿主 拖动一次会发出几十个 pointermove,不防抖就是几十个请求
点击说话 一句话(中文一行、英文一行),2600ms 后自己消失 说个不停的宠物等于一个关不掉的对话框
点击 vs 拖动 位移超过 4px 就当作拖动,不触发说话 不然每次搬动它都会聒噪一句
藏起来 侧边栏按钮;状态持久化 只有宠物自己能控制自己,就是一个单向门
减少动态 prefers-reduced-motion: reduce → 静帧 「减少动态」不等于「放慢动画」:慢速的呼吸仍然是动画

决策是数据,不是渲染。 桌宠所有的判断都从 bundle 里导出成纯函数: nextPose(state, event, now)、poseAt(now, options)、stanceAt(state, now)、clampPosition(position)、 clampPercent(value)、pickLine(index)、pickMode(since, now)、blinkAt、swayAt、breathAt。 组件只是它们之上的一层薄渲染,所以 scripts/verify-pet.mjs 能用数字把整个矩阵跑一遍, 完全不需要浏览器。这个模式是从姊妹插件 dsh-boot-animation 的 decidePlay 抄来的, 它是唯一一个在真实宿主上活下来的写法。

性格 / Personality

她不是一张会动的贴图,是一只有脾气的鲸鱼。性格是行为,不是设定——下面每一条都能在界面上看到,也都被 scripts/verify-pet.mjs 逐条断言(台词来自作者写定的文案表,一个字没改)。

性格 界面上怎么表现
只吃米饭 说的话里反复出现米饭:「米饭,去拿。」「米饭上要加一个蛋。」「哼。米饭扣你一半。」
聪明但懒 连点她几次(默认 4 次、2.6 秒内),她会躺平并说「今天不干了」;躺平期间点她不再弹气泡,过一会儿(默认 6 秒)才自己起来
嘴硬心软(傲娇) 嘴上敷衍,下一句就软下来:「……嗯。这个可以叫。」「再叫一次。」,或者干脆用动作代替——「(尾鳍轻轻拍了两下)」
不肯被叫「大肥鱼」 面板上「叫它 大肥鱼」一按她就生气,并且坚持自己不胖:「谁肥了?这叫浮力。」「鲸鱼不叫胖,叫圆润。再说一次试试。」「尾鳍警告。」
叫她「鲸鲸」才高兴 面板上「叫它 鲸鲸」是唯一让她满意的称呼,尾巴会很诚实

两个称呼按钮在侧边栏那个小面板里,就在八色块下面:「叫它 大肥鱼」和「叫它 鲸鲸」。 这是用户唯一能触发傲娇反应的入口,所以它是正式按钮,不是彩蛋。每个按钮都有中英双语的 aria-label。

躺平是什么样:鲸鱼会被压扁一点、歪一点,同时停掉浮动/摇摆/呼吸三组动画——躺着还在上下飘就不叫躺平。 这只是 CSS 变换,没有新增任何图片,八种皮肤照样全部可用。

角落漂移:十分钟没有任何交互,她会慢慢游到离她最近的那个角落(transform 过渡),并且说一句 「没人理我,去角落待着。」。这只改视觉,不改你放她的位置——state.json 里的 x/y 一个字节都不会动, 你下次重开页面她还在你放的地方。任何交互(拖、点、叫她、换皮肤、开关面板)都会立刻取消漂移。 这条在测试里是硬断言:漂移函数返回 persist:false,并且不修改传进去的状态对象。

换皮肤时她会顺口说一句(「换件衣服而已,别大惊小怪。」),第一次出现时会打个招呼(「……来了啊。米饭呢?」)—— 两者用的都是同一个气泡机制。

语气红线(写死在文案表里,也写进了 ARCHITECTURE.md):不自称 AI/程序/插件;拒绝被叫胖但不刻薄, 最多扣你米饭;一次只给一个情绪点,软话放第二句。

她会记着你 / She remembers you

上面五条是「当下」的脾气。下面这三条是跨会话的:它们靠 state.json 里的五个计数活下来, 所以重开页面、重启 DSH、换浏览器,她照样记得今天怎么过的。

性格 怎么养成 她会怎么对你
记仇 今天被叫「大肥鱼」满 3 次 再来时冷冷的:「……又是你。今天不谈肥不肥。」「哼。我记着呢。」
记好 今天被叫「鲸鲸」满 3 次 再来时嘴上不认:「……来了。今天准你叫我一声。」「米饭多煮了半杯。」
黏人 离开超过 30 分钟再回来 「才不是等你。只是水凉了。」「……你走挺久的。」
怕生 累计交互次数还不到 3 次 「……(躲在杯子后面)」「……新来的?」「别靠太近。」

优先级是固定的:冷淡 > 亲近 > 久别 > 怕生 > 平常。 同一天既被叫胖又被叫昵称,她会给你冷脸 —— 仇比好记得久。这条不是随手排的:scripts/verify-pet.mjs 把五种结局和每一条边界(fatCalls 2 与 3、 离开恰好 30 分钟、跨零点、交互次数 2 与 3)各测前后一个单位。

计数怎么算:fatCalls / nickCalls 只统计「她真的回应了」的那一次(躺平期间被吸收的点击不算, 不然可以刷);totalInteractions 数你实际点她的次数;lastSeenAt 记上次见面的时间。 每天零点清零(本地时间),countersDay 记着那份计数属于哪一天,跨天自动重开。 数字有上限(十万)也拒绝负数 —— 手改 state.json 塞不进一个荒谬的值,而且改坏了只会自愈,不会让她消失。

一个诚实的空缺(待确认):这类角色公认还有一条「感知 DSH 状态」——你在忙的时候她安静,闲下来才凑过来。 本插件没有实现,因为我没有验证到宿主真的暴露了一个可信的「忙碌」字段:uiSession 的 adapter.current 在我能看到的材料里只被读出 sessionId 和 blank,没有 busy / streaming / status。 不硬编一个猜出来的字段,所以这条留白,并在 ARCHITECTURE.md 里标为待确认。

八种皮肤

八种皮肤

侧边栏底部那枚按钮(写着「大肥鱼 开 / 关」)点开是一个小面板:上面是显示/隐藏,下面是八个色块。 点一个色块,画面立刻换,同时把选择 POST 给宿主 —— 所以刷新页面、重启 DSH、换个浏览器,皮肤都还在。

id 名字 看起来
deepsea 深海蓝 / Deep Sea 原始配色,蓝色的头发与鳍
sakura 樱花粉 / Sakura 粉
mint 薄荷绿 / Mint 薄荷绿
twilight 暮光紫 / Twilight 紫
caramel 焦糖金 / Caramel 琥珀金
silver 雪白银 / Silver 近乎白色的银发
ink 墨黑 / Ink 接近黑的海军蓝
ember 余烬红 / Ember 红

换肤不会让动画重来一遍。 切换只改 <img> 的 src,包裹它的三层 div(摇摆 / 浮动 / 呼吸) 一直挂着,所以不会跳一下。这是刻意的,也是 scripts/verify-client-boot.mjs 断言的一条: <img> 上没有 React key,元素被复用而不是重建。

GitHub で README 全文を読む →

DSH Plugins は DeepSeek Harness プラグインの独立したコミュニティ ディレクトリです。DeepSeek との提携・公認はありません。サードパーティ製プラグインはセキュリティ監査を受けていません。インストール前にソースコードをご確認ください。

DeepSeek Harnessの新着プラグインを毎週お届け。スパムはありません。