# dsh-ui-desktop-pet
DeepSeek Harness 的 Live2D 桌宠模块仓库
[](https://raw.githubusercontent.com/jmctsh/dsh-ui-desktop-pet/main/LICENSE)
[](https://github.com/jmctsh/dsh-ui-desktop-pet/stargazers)
[](https://www.live2d.com/)
[](https://github.com/deepseek-ai/deepseek-harness)
[项目简介](#项目简介) · [仓库结构](#仓库结构) · [快速开始](#快速开始) · [接入方式](#接入方式) · [封面图与版权说明](#封面图与版权说明)
项目简介
dsh-ui-desktop-pet 当前是一个围绕 DeepSeek Harness 桌宠能力整理出来的独立仓库，主要包含：
- 一个可复用的 Live2D 桌宠模块源码，位于
ui-desktop-pet/ - 项目接入说明与开发记录
- README 封面图等展示资源
这个模块的目标是在 DeepSeek Harness 界面中挂载一个可拖拽、可点击、会主动搭话的 Live2D 角色。当前实际使用的模型是 Live2D 官方示例模型 MAO。
说明：这个仓库目前更接近“模块源码仓库”，而不是一个已经打包好的独立桌面应用发布仓库。
当前能力
- Live2D 角色渲染
- 拖拽与点击互动
- 基于 DeepSeek Harness 状态的主动搭话
- 本地托管模型资源与 Cubism Core
仓库结构
dsh-ui-desktop-pet/
├─ README.md
├─ LICENSE
├─ banner.jpg
├─ adding-a-desktop-pet.md
└─ ui-desktop-pet/
├─ package.json
├─ src/
├─ assets/
└─ 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-pet2. 安装模块依赖
当前可直接安装依赖的包位于 ui-desktop-pet/：
cd ui-desktop-pet
npm install3. 查看模块说明
如果你是要把这个桌宠模块接入 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，二者并不相同。
本项目 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 相关运行时与模型素材请遵循其各自原始许可条款
- 封面图相关灵感说明见上方“封面图与版权说明”