dsh-ui-desktop-pet

DeepSeek Harness 的 Live2D 桌宠模块仓库

项目简介 · 仓库结构 · 快速开始 · 接入方式 · 封面图与版权说明

项目简介

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-pet

2. 安装模块依赖

当前可直接安装依赖的包位于 ui-desktop-pet/：

cd ui-desktop-pet
npm install

3. 查看模块说明

如果你是要把这个桌宠模块接入 DeepSeek Harness，请直接阅读：

• ui-desktop-pet/README.md

如果你想了解完整开发过程和踩坑记录，可以阅读：

• adding-a-desktop-pet.md

接入方式

这个仓库里的核心包是 @deepseek-ai/dsh-client-ui-desktop-pet。它不是单独运行的完整产品，而是一个要接入 DeepSeek Harness 宿主工程的客户端模块。

接入时建议按下面顺序阅读：

1. 根目录 README：了解项目定位和资源说明
2. ui-desktop-pet/README.md：按步骤完成集成
3. adding-a-desktop-pet.md：需要理解实现原理时再看

封面图与版权说明

README 封面图位于仓库根目录的 banner.jpg。

封面图中的角色为项目展示用途的原创 AI 绘制形象；当前程序内实际驱动的模型是 Live2D 官方示例模型 MAO，二者并不相同。

本项目 README 封面图的人设灵感，来自 B 站创作者 @蒙德砍壬 的相关作品，在此保留致谢与说明：

• 视频：@蒙德砍壬 - 【deepseek】人是猫？！

如封面图使用方式需要调整，请通过 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 相关运行时与模型素材请遵循其各自原始许可条款
• 封面图相关灵感说明见上方“封面图与版权说明”