mimi-desktop-pet
Verifiedmimi-desktop-pet · v0.4.0 · MIT
鲸鱼娘 Mimi 桌宠:DeepSeek Harness 桌面伴侣。支持 DSH 0.1.1-rc.2、任务/工具动作联动、头顶消息气泡、中文输入、桌宠 Agent、分区触摸、投喂与 Live v5 注视表情。
Install
dsh plugin add mimi-desktop-pet Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Published to npm without a public repository. Inspect the package contents before installing.
Tags
Creators
Readme
鲸鱼娘 Mimi — DeepSeek Harness 桌面宠物
mimi-desktop-pet 会在 DeepSeek Harness 启动时自动唤醒 Mimi。她不只是播放动画:会跟随 DSH 的思考、工具调用、提问、完成与失败状态做出动作,并把回复显示成头顶气泡;也可以切换到独立的「Mimi 管家」会话,直接从桌面输入中文任务。
- npm:https://www.npmjs.com/package/mimi-desktop-pet
- GitHub:https://github.com/mekos2772/whale-girl
- 当前版本:
0.4.0 - 已验证 DSH:
0.1.1-rc.2(同时兼容现有0.1.0-rc.6协议面)
安装
先安装最新版 DSH 与 pnpm:
npm install -g @deepseek-ai/[email protected]
npm install -g pnpm
再把 Mimi 装进实际使用的 profile:
# dsh web 使用 web profile
dsh plugin --profile web add [email protected]
# 若使用单独的 desktop profile
dsh plugin --profile desktop add [email protected]
若 npm 镜像尚未同步,可直接从 GitHub 标签安装:
dsh plugin --profile web add github:mekos2772/whale-girl#v0.4.0
重启 DSH 后生效。DSH 会自动把声明了 dsh.bundle.patch 的包加入 profile;无需手工修改 cordis.patch.yml。
DSH 仍处于 developer preview,RC 版本可能发生不兼容变化。Mimi 0.4.0 已实测
session.list、session.prompt、settings.*、/api/events.mux与插件生命周期。
0.4.0 有什么
- 23 套经过筛选的核心完整帧动作;移除 57 套旧库中重复、低密度或视觉不一致的动作。
- Live Rig v5:呼吸、眨眼、微笑、张嘴、独立虹膜视线追踪,角色与正式动作使用同一母版。
- DSH 联动:思考、工具执行、倾听、点头、庆祝、失败六类专用动作。
- 头顶白色气泡:回复、摘要、提问与状态统一呈现,带去重和自动消散。
- 白色中文输入框:支持 Windows 拼音 IME,输入期间冻结窗口跟随。
- 两种 Harness 模式:跟随当前项目会话,或使用归档的独立「Mimi 管家」Agent。
- 桌宠交互:五分区触摸、组合反应、拖拽/落地、拖放投喂、久坐久睡场景链、欢迎回来。
- 单实例保护:手动启动与 DSH 自动启动不会生成两个 Mimi。
- 发布包改用透明 WebP Q95 素材,在保留帧数和时长的前提下显著缩小体积。
操作
| 操作 | Mimi 的反应 |
|---|---|
| 摸头、戳脸、挠肚子、碰手或脚 | 按角色部位播放不同反应 |
| 摸头后 3 秒内击掌 | 组合庆祝 |
| 拖动角色 | 依据方向与速度实时倾斜,释放后落地恢复 |
| 拖入图片 | 作为面包投喂;饱腹时会拒绝 |
| 拖入文件或文本 | 接取文件并交给桌宠交互层 |
| DSH 思考/调用工具/提问/完成 | 自动切换对应动作和气泡 |
| 点击气泡或右键打开 Harness | 聚焦中文输入框,可直接发送任务 |
配置
DSH 设置中的命名空间为 mimiPet:
| 字段 | 说明 |
|---|---|
enabled |
是否随 DSH 启动 Mimi,默认 true |
petDir |
可选的本地完整项目目录;留空时优先使用包内 pet/ |
python |
pythonw.exe 完整路径;留空自动探测 Python 3.11 |
scale |
桌宠缩放百分比,范围 1–200 |
环境与体积
- Windows 10/11
- Node.js 18+(DSH 0.1.1-rc.2 实测环境为 Node.js 24)
- Python 3.11+ 与 PySide6 6.x
- npm 包自带
mimi_app与运行时素材;若配置petDir,会优先运行本地项目版本。
本地开发与验证
$env:PYTHONPATH = (Resolve-Path .\mimi_app\src).Path
python -m pytest .\mimi_app\tests -q
python .\scripts\build_dsh_package.py
dsh plugin --profile web add .\mimi-desktop-pet-0.4.0.tgz
dsh web --dump-config
卸载
dsh plugin --profile web remove mimi-desktop-pet
许可
MIT