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,元素被复用而不是重建。
更多「纯属好玩」插件
dsh-pet
作者 pc2005-cloud
DSH 桌面宠物:一行命令装好即用的透明动画小桌宠,支持多开、大小位置随心配置;还内置 DIY 素材链,能用 AI 视频自造专属宠物
dsh-tavern
作者 flizzywine
基于DSH的Agent酒馆。类酒馆文字游戏Agent。兼容SillyTavern生态,人物卡直接导入就能玩。更快、更稳、更鲜活。所有模型都能用。手机也能玩。
dsh-dafeiyu
作者 qcytsn
DeepSeek Harness 的桌面原生大飞鱼陪伴插件,实时展示智能体状态,Windows 上置顶显示。
dsh-meme
作者 yyh-001
DeepSeek Harness 表情包插件:输入框一键发图、文字 token 斗图、情绪主动发图、AI 自动学图,图库市场一键安装。 · Meme/sticker plugin for DeepSeek Harness: one-click picker in the composer, text-token memes, mood-driven sending, AI learns your images, marketplace packs.
