DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

jmctsh /

jmctsh/dsh-ui-desktop-pet

Topic repository only

deepseek harness 桌宠模块

★ 1 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@02052a0e
dsh-ui-desktop-pet banner

dsh-ui-desktop-pet

DeepSeek Harness 的 Live2D 桌宠模块仓库

License: MIT GitHub Stars Live2D DeepSeek Harness

项目简介 · 当前能力 · 模型资产与许可 · 仓库结构 · 快速开始 · 接入方式 · 封面图与版权说明


项目简介

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,请直接阅读:

  • 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,二者并不相同。另外两个可选形象(鲸鱼娘、DeepSeek 免费公皮)的版权归各自作者,本仓库不收录其模型文件。

本项目 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 相关运行时与模型素材请遵循其各自原始许可条款
  • 封面图相关灵感说明见上方“封面图与版权说明”
—/ 5

No ratings yet

Manifest verification required

Commit 02052a0e0cfe

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout