DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-pet-lucky

d

dsh-pet-lucky

Manifest valid

A cute DeepSeek 3D desktop pet named after my budgie, Lucky

UI (client)hasBundlePatchMachine translated

Lucky — DeepSeek Harness 桌宠

一只真正会动的 3D 鹦鹉,站在 DeepSeek Harness 窗口右下角。它会跟着你在做什么切换动作:

  • 闲着的时候收着翅膀站着,轻轻呼吸晃动
  • 你一开始打字,它就走起来
  • AI 开始思考、干活,它就小跑
  • 答案出来了,它张开翅膀飞一下再落下

可以拖动它,点一下听它说句话,右键让它"播报"。它会打瞌睡(4 分钟没动静),窗口切走再回来会欢迎你。

https://github.com/don2ccc/dsh-pet-lucky


image

安装

dsh plugin add github:don2ccc/dsh-pet-lucky

也可以用完整地址,效果一样:

dsh plugin add https://github.com/don2ccc/dsh-pet-lucky

不想用命令行的话,界面里也能装:设置 → 插件 → 添加插件,把 github:don2ccc/dsh-pet-lucky 填进输入框。

装完完全退出 DeepSeek Harness 再重新打开,鹦鹉就出现在右下角了。

卸载:

dsh plugin remove dsh-pet-lucky

要求

  • DeepSeek Harness 的 Web UI(桌面版或 dsh web)
  • 显卡支持 WebGL 2(2015 年之后的集显/独显基本都支持)
  • 首次显示需要联网:会从 Polyfork 的 CDN 下载 6.1 MB 的模型,之后就存在 IndexedDB 里,不再重复下载

如果 WebGL 用不了、或者模型下载失败,它会自动退回内联的 2D 立绘——不会变成空白,也不会拖垮界面。

动作对照

你在做什么它在做什么
没有操作Idle (folded wings) 收翅站立
在输入框打字Walk (folded wings) 走
消息已发出、AI 在干活Run (folded wings) 跑
把它拖起来 / 答案到达Fly 张开翅膀飞

剪辑之间是 0.26 秒交叉淡入淡出,不是硬切。相机是 3/4 视角(方位 44°、俯角 12°),飞行时会轻微拉远,避免翅膀被切掉。

改台词和名字

所有可见文案在 tools/3d/lines.json,中文和英文各一套:名字、点击台词、打字时的碎碎念、唤醒/完成/重连/播报各有对应字段。加 line9、line10… 会自动发现,不用改代码。

git clone https://github.com/don2ccc/dsh-pet-lucky
cd dsh-pet-lucky
# 编辑 tools/3d/lines.json
python tools/3d/apply_lines.py     # 写回 client.js,自动备份并校验
dsh plugin add /absolute/path/to/dsh-pet-lucky   # 用本地这份替换掉线上版本

然后重启应用。line1..line8 和 chatter1..chatter8 是必填的,少一个脚本会拒绝写入。

想调动作快慢、机位远近、状态映射,都在 client.js 里的 CLIP_SPEED / CAMERA / const sceneState 几个常量上,tools/3d/README.md 有说明。改完源码用 python tools/3d/build3d.py 重新生成 client.js。

它是怎么实现的

ESP32 之类的硬件无关——纯前端插件
├── client.js          预构建产物(DSH 没有打包器,直接 __ModuleLoader__.load)
│   ├── three.js r147  内联,MIT
│   ├── GLTFLoader     内联,MIT
│   ├── 渲染器/状态机  见 tools/3d/stage.js
│   └── 2D 立绘兜底    内联 base64 WebP
├── cordis.patch.yml   把自己的 Loader 条目插进 profile 的 bundle 链
└── assets/            图标 + 兜底立绘
  • 模型带骨骼和 7 段动画,只用其中 4 段(收翅待机、收翅走、收翅跑、飞)
  • 材质换成 Lambert:这些低多边形模型用顶点色,没有环境贴图时 PBR 会发灰
  • 不做 ACES 色调映射(Polyfork 官方提示:会让这类模型暗三分之一)
  • 相机取景不能用绑定姿态:绑定姿态是张翅的(宽 1.66),收翅待机只有 0.41,按绑定姿态算相机会把鸟缩成一个点

更多实测数据(每段动画的包围盒、循环接缝、相机标定过程)在 tools/3d/README.md。

排查

装了没反应? 先确认真的重启了(不是刷新窗口)。插件在启动时读取,热更新不生效。

它变成不动的 2D 图片了? 说明 3D 那条路没走通,会退回兜底立绘。构建里带了诊断:它会往 localStorage 写一段加载日志,键名 dsh-pet:trace,里面能看出是 WebGL 不可用、模型下载失败、还是渲染出错。提 issue 时附上这段会很有帮助。

第一帧要等一两秒? 正常,首次会下载 6.1 MB 模型。之后是本地缓存。

致谢

  • 模型 —— Cove Parrot by Polyfork,CC BY 4.0
  • 3D 渲染 —— three.js r147,MIT

完整第三方声明见 THIRD-PARTY-NOTICES.md。

License

MIT © 2026 don2ccc

Comments

Loading…

Similar plugins

dolphin-pet-plugin

by bo961386926

Cute desktop pet for DeepSeek Harness - custom name, upload your own pet image, or generate one with AI. DSH 桌面宠物插件

Tools & CapabilitiesUI & ExperienceDevelopment & InfrastructureManifest valid

★ 0

MIT

JavaScript

Aug 26, 2026

dsh plugin --profile web add dolphin-pet-plugin

by YangShen-SWE

A Windows desktop pet for official DeepSeek API balance, usage, and animated reactions in DSH.

UI & ExperienceManifest valid

★ 8

NOASSERTION

PowerShell

Oct 21, 2026

dsh plugin --profile web add dsh-plugin-simple-pet

by sereinmono

A plugin that adds a desktop pet to your DeepSeek Harness, supporting the Codex pet format.

UI & ExperienceManifest valid

★ 6

↓ 507/wk

TypeScript

Sep 11, 2026

dsh plugin --profile web add dsh-desktop-pet

by miku00039-01

🐋 DSH 桌宠:DeepSeek Harness 的 Windows 桌面宠物,一键启动/停止/监测服务,双击唤起 GUI,零依赖单文件 exe

Just for FunDevelopment & InfrastructureManifest valid

★ 3

↓ 209/wk

MIT

C#

Oct 1, 2026

dsh plugin --profile web add @miku00039-01/dsh-whale-pet

by CLICGGER-TYPES

🐖 DeepSeek Harness 养成插件,也可作为 Windows/Linux/macOS 桌面宠物运行;支持成长、学习、打工、钓鱼、图鉴与换肤

Just for FunManifest valid

★ 34

↓ 408/wk

NOASSERTION

JavaScript

Nov 17, 2026

dsh plugin --profile web add dsh-piggy

by xiaoshihou514

DeepSeek Harness:鲸鱼娘桌宠!

UI & ExperienceManifest valid

★ 65

↓ 507/wk

MIT

JavaScript

Aug 21, 2026

dsh plugin --profile web add dsh-desktop-pet