
dsh-ui-desktop-pet
DeepSeek Harness 的 Live2D 桌宠模块仓库
项目简介
dsh-ui-desktop-pet 是一个围绕 DeepSeek Harness 桌宠能力整理出来的独立仓库,主要包含:
- 一个可复用的 Live2D 桌宠模块源码,位于
ui-desktop-pet/ - 项目接入说明与开发记录
- README 封面图等展示资源
这个模块的目标是在 DeepSeek Harness 界面中挂载一个可拖拽、可点击、会主动搭话的 Live2D 角色。仓库最初只驱动 Live2D 官方示例模型 MAO,现在已支持三个形象并在右键菜单里切换:
| 形象 | 来源 | 是否随仓库分发 |
|---|---|---|
| Mao 猫娘 | Live2D 官方示例模型(免费可商用) | 是 |
| DS 鲸鱼娘(Q 版) | B 站作者作品:BV16yYi69EQT | 否,仅保留目录与说明 |
| DeepSeek 免费公皮(全身) | B 站作者作品:BV1KmxY66EZ3 | 否,仅保留目录与说明 |
说明:这个仓库更接近「模块源码仓库」,而不是一个已经打包好的独立应用发布仓库。除 Mao 之外的角色美术版权归原作者,请自行下载后放入
ui-desktop-pet/assets/<形象>/。
当前能力
- Live2D 角色渲染(PixiJS v6 + pixi-live2d-display,挂在
shell.overlay浮层) - 拖拽移动并记住落点,点击头/身体触发台词,眼睛与头部跟随鼠标
- 右键切换形象;只列出本机已放好模型的形象,没放的不显示、也不会加载失败
- 基于 DeepSeek Harness 状态的主动搭话(开始 / 中途 / 结束 / 点击各一次)
- 动作播放:作者自带的成对动作按「播出→还原」播放,空闲时每 18–36 秒自动来一次
- 本地托管模型资源与 Cubism Core,不依赖任何外部 CDN
模型资产与许可
除 Mao 外,本仓库不包含任何模型文件。 三个形象目录的约定写在 ui-desktop-pet/assets/README.md:
assets/mao/:Live2D 官方示例模型,免费可商用,随仓库分发;assets/whale-girl/、assets/deepseek-girl/:只有 README 占位,模型由各自作者授权,请勿提交到本仓库;assets/templates/:本项目为上述两个形象整理好的model3.json清单(原包没有声明Expressions/Motions,缺了这两张表就调不到表情与动作);assets/runtime/:Live2D Cubism Core 运行时。
放入模型后无需改代码:模块的 node 半会扫描 assets/<形象>/ 下任意 *.model3.json,把结果告诉前端。文件名不限,把作者的文件夹按原样放进去即可。
两个形象各有一处开发期踩过的坑,已写进模块文档:
- 公皮的鼻子依赖 Cubism 4.2+ 的逐 drawable 颜色混合,旧渲染器会把它画成黑点,代码里用
drawableFilter.colorBlendInParts精确屏蔽了那 2 个 drawable(说明); - 鲸鱼娘与公皮的身体/头部绑在面捕追踪轴上,需要
sway/gaze才会「活」起来;鲸鱼娘的动作还是 exp3 姿势开关,用poses接。
仓库结构
dsh-ui-desktop-pet/
├─ README.md
├─ LICENSE
├─ banner.jpg
├─ adding-a-desktop-pet.md
└─ ui-desktop-pet/
├─ package.json
├─ src/ # node 半 + browser 半源码
├─ assets/ # Mao 模型、Cubism Core、模板与占位说明
└─ README.md # 模块接入文档
其中:
- 根目录
README.md用于 GitHub 项目首页展示 ui-desktop-pet/README.md是模块接入文档adding-a-desktop-pet.md记录了从零实现这个模块的过程、关键设计决策与踩坑
快速开始
1. 克隆仓库
git clone https://github.com/jmctsh/dsh-ui-desktop-pet.git
cd dsh-ui-desktop-pet
2. 安装模块依赖
当前可直接安装依赖的包位于 ui-desktop-pet/:
cd ui-desktop-pet
npm install
3. 查看模块说明
如果你是要把这个桌宠模块接入 DeepSeek Harness,请直接阅读:
如果你想了解完整开发过程和踩坑记录,可以阅读:
接入方式
这个仓库里的核心包是 @deepseek-ai/dsh-client-ui-desktop-pet。它不是单独运行的完整产品,而是一个要接入 DeepSeek Harness 宿主工程的客户端模块。
接入时建议按下面顺序阅读:
- 根目录 README:了解项目定位和资源说明
ui-desktop-pet/README.md:按步骤完成集成adding-a-desktop-pet.md:需要理解实现原理时再看
封面图与版权说明
README 封面图位于仓库根目录的 banner.jpg。
封面图中的角色为项目展示用途的原创 AI 绘制形象;程序内默认驱动的模型是 Live2D 官方示例模型 MAO,二者并不相同。另外两个可选形象(鲸鱼娘、DeepSeek 免费公皮)的版权归各自作者,本仓库不收录其模型文件。
本项目 README 封面图的人设灵感,来自 B 站创作者 @蒙德砍壬 的相关作品,在此保留致谢与说明:
如封面图使用方式需要调整,请通过 GitHub Issues 联系维护者处理。
相关链接
- 仓库地址:https://github.com/jmctsh/dsh-ui-desktop-pet
- Issues:https://github.com/jmctsh/dsh-ui-desktop-pet/issues
- Releases:https://github.com/jmctsh/dsh-ui-desktop-pet/releases
- Star History:https://star-history.com/#jmctsh/dsh-ui-desktop-pet&Date
License
本仓库采用 MIT License。
其中:
- 代码部分遵循 MIT License
- Live2D 相关运行时与模型素材请遵循其各自原始许可条款
- 封面图相关灵感说明见上方“封面图与版权说明”
No comments yet. Be the first to write one.