dsh-anime25d-pets 🐾

Anime2.5DRig × DSH 桌宠：用 Anime2.5DRig 的 WebGL PSD 自动装配渲染引擎，为 DeepSeek Harness 提供 2.5D 桌面宠物。

只需准备一张分图层 PSD，即可获得带自动装配、发丝物理、表情动画和状态镜像的桌宠。

Demo

项目介绍

解决什么问题？

原 dsh-live2d-pets 需要 Live2D 模型（.model3.json），模型制作门槛高、成本大
Anime2.5DRig 只需一张分图层 PSD 即可自动装配 WebGL 2.5D 动画
本项目将两者结合：用 PSD 自动装配替代 Live2D 渲染，保留完整的桌宠交互框架

适合谁？

已有分图层 PSD 角色立绘、想把它变成 DSH 桌宠的用户
不想使用 Live2D、偏好开源 WebGL 渲染的用户
希望桌面宠物反映 agent 状态的 DSH 用户

兼容性

项目	要求
DeepSeek Harness (DSH)	需支持 DSH 插件 API（`dsh.profile.bundles` 机制）
Node.js	`^22.19.0
包管理器	pnpm / npm / bun
浏览器	Chrome / Edge / Firefox / Safari（需支持 WebGL）
最后验证日期	2026-08-23

安装与卸载

安装（源码构建）

# 方式一：克隆后构建安装
git clone https://github.com/coldfish486/dsh-anime25d-pets.git
cd dsh-anime25d-pets
pnpm install
pnpm build
dsh plugin --profile web add /path/to/dsh-anime25d-pets

# 方式二：手动复制
# 构建后把整个项目（含 lib/）复制到 DSH profile 的 node_modules 下：
cp -r dsh-anime25d-pets /root/.dsh/profiles/web/node_modules/
# 然后在 /root/.dsh/profiles/web/package.json 的
# dependencies 和 dsh.profile.bundles 中添加 dsh-anime25d-pets

升级

cd dsh-anime25d-pets
git pull
pnpm install
pnpm build
# 重新安装/重启 DSH

禁用

在 DSH 设置 →「桌宠配置」中关闭"启用桌宠"开关即可。

彻底移除

dsh plugin --profile web remove dsh-anime25d-pets
# 或手动删除：
# /root/.dsh/profiles/web/node_modules/dsh-anime25d-pets/
# 并从 /root/.dsh/profiles/web/package.json 中移除引用

快速开始

最小配置示例

安装插件（见上文）
启动 DSH，右下角出现默认宠物（内置 Anime2.5DRig 示例 PSD 模型）
添加自己的 PSD 模型：
- 打开 DSH 设置 →「桌宠配置」→「我的模型」
- 填写名称和 .psd 地址（支持 HTTP URL 或本地绝对路径）
- 点击保存
使用：
- 点击桌宠右下角 ⚙ 打开角色调节面板
- 拖动滑块实时调整头部/眼睛/眉毛/嘴巴/发型/身体参数
- 切换"随机开口说话"和"随机小动作"开关
- 拖动桌宠到任意位置（自动保存）

可复现示例

# settings.yaml 中 anime25d-pet 部分的参考配置
anime25d-pet:
  enabled: true
  size: 200
  model: sample            # 使用内置示例模型
  animeParams:
    angleX: 0.2            # 左右转头
    mouthOpen: 0.3         # 嘴巴张开
  talk: true               # 随机开口说话
  rand: false              # 随机小动作
  persona: tsundere

配置说明

settings.yaml 配置项

配置项	类型	默认值	说明
`enabled`	boolean	`true`	插件总开关
`size`	number	`160`	宠物尺寸（40~400 px）
`model`	string	`sample`	模型 ID（内置 preset 或自定义模型 ID）
`animeParams`	object	`{}`	Anime2.5D 参数滑块（34 个参数）
`talk`	boolean	`false`	随机开口说话
`rand`	boolean	`false`	随机小动作
`persona`	string	`tsundere`	人设 ID
`developerMode`	boolean	`false`	开发者模式
`debug`	boolean	`false`	调试面板
`showTapZones`	boolean	`false`	显示点击分区

Anime2.5D 参数（34 个）

分组	参数	范围	默认
头部姿态	`angleX` / `angleY` / `angleZ`	-1 ~ 1	0
眼睛	`eyeOpenL` / `eyeOpenR`	0 ~ 1	1
眼睛	`eyeX` / `eyeY`	-1 ~ 1	0
眼睛	`irisScale`	0.5 ~ 1.3	1
眼睛	`eyeScaleL` / `eyeScaleR`	0.5 ~ 1.5	1
眼睛	`eyeEase`	0 ~ 1	0.3
眼睛	`eyeCY` / `eyeCAng`	-1 ~ 1	0
眉毛	`brow`	-1 ~ 1	0
眉毛	`browAngSym` / `browAngL` / `browAngR`	-1 ~ 1	0
嘴巴	`mouthOpen`	0 ~ 1	0
嘴巴	`mouthForm`	-1 ~ 1	0
嘴巴	`mouthCY` / `mouthCAng`	-1 ~ 1	0
嘴巴	`mouthEase`	0 ~ 1	0.45
嘴巴	`mouthScale`	0.5 ~ 1.5	1
发型	`fhAmp`	0 ~ 3	2
发型	`fhSoft`	0 ~ 2	0.4
发型	`bangL` / `bangC` / `bangR`	-1 ~ 1	0
身体物理	`body`	-1 ~ 1	0
身体物理	`armY` / `armPos`	-1 ~ 1	0
身体物理	`bust`	0 ~ 5	2.5
身体物理	`bustY`	-1 ~ 3	1
身体物理	`physAmp`	0 ~ 3	2
身体物理	`soft`	0 ~ 2	2

环境变量

变量	说明
`DSH_HOME`	DSH 配置目录（默认 `~/.dsh`）

敏感项

无。本插件不存储凭据、不访问用户敏感数据。

权限与数据

数据/资源	访问方式	说明
本地 PSD 文件	`node:fs` 读取	仅在用户配置了本地模型路径时读取
设置配置	DSH settings API	读写 `settings.yaml`
自定义模型配置	`~/.dsh/anime25d-pet/custom-models.jsonc`	JSONC 格式
静态资源	HTTP 同源路由	`/pet-assets/`、`/pet-local-models/`
网络访问	无	不发起外部网络请求（除非用户配置了远程 PSD URL）
摄像头	无	不访问摄像头

常见问题排查

常见错误

现象	原因	解决
紫色 🐾 方块	模型加载失败	检查模型路径是否正确；检查 `assets/lib/` 是否存在
空白画面	WebGL 渲染问题	检查浏览器是否支持 WebGL；检查 canvas 尺寸
参数不生效	自动动画覆盖	手动设置参数后自动动画会跳过；开启自动动画会释放手动锁定
重启后参数丢失	持久化失败	检查 `settings.yaml` 中 `anime25d-pet` 配置是否存在
点击分区不准确	坐标系不匹配	确认 `getBounds()` 使用 CSS 坐标系

日志位置

DSH Host 日志：/var/log/dsh/dsh-web.log

回滚

# 通过 DSH 插件系统移除
dsh plugin --profile web remove dsh-anime25d-pets

# 或手动删除插件目录
rm -rf /root/.dsh/profiles/web/node_modules/dsh-anime25d-pets/

开发指南

# 克隆仓库
git clone https://github.com/coldfish486/dsh-anime25d-pets.git
cd dsh-anime25d-pets

# 安装依赖
pnpm install

# 类型检查
pnpm run typecheck

# 测试
pnpm test

# 构建
pnpm build

# 构建产物在 lib/ 目录

项目结构

dsh-anime25d-pets/
├── src/
│   ├── index.ts           # Host 入口（插件 Config / 生命周期）
│   ├── service.ts         # 宠物状态机 / SSE 推送
│   ├── routes.ts          # HTTP 路由 / 静态资源
│   ├── models.ts          # 模型类型定义
│   ├── models-host.ts     # 模型 URL 解析
│   ├── local-models.ts    # 本地 PSD 路径映射
│   ├── presets/           # 内置模型清单
│   └── client/
│       ├── index.ts       # 桌宠主逻辑（加载/交互/面板）
│       ├── anime25d.ts    # Anime2.5D 渲染引擎适配
│       ├── settings.ts    # DSH 设置面板
│       └── personas.ts    # 人设台词
├── assets/
│   ├── vendor/            # ag-psd 等第三方库
│   ├── lib/               # rigger 等 Anime2.5DRig 资源
│   ├── models/            # 示例模型
│   ├── icons/             # 图标
│   └── demo.gif           # 效果演示图
├── lib/                   # 构建产物（pnpm build 生成）
├── shared/                # DSH 构建配置
├── package.json
└── tsconfig.json

贡献

欢迎提交 PR！请确保：

pnpm run typecheck 通过
pnpm test 通过
修改用户可感知行为时更新 README

许可证与安全

许可证

本项目采用 MIT License（见 LICENSE）。

第三方组件许可

组件	用途	许可证
Anime2.5DRig	WebGL 渲染引擎 / 自动装配	MIT
ag-psd	PSD 解析器	MIT
dsh-live2d-pets	桌宠插件框架	MIT

版权声明

PSD 模型资产：assets/lib/eye_close.psd、assets/lib/mouth_close.psd、assets/models/sample.psd 来自 Anime2.5DRig 仓库（MIT License），但 PSD 内的美术作品版权归各原作者所有。发布或分发前请确认版权。
Live2D 官方模型：原 dsh-live2d-pets 内置的 Hiyori/Haru 等模型不再分发。

安全

如发现安全问题，请通过 GitHub Issues 私密报告（不要公开漏洞详情）。

dsh-anime25d-pets 🐾

Anime2.5DRig × DSH 桌宠：用 Anime2.5DRig 的 WebGL PSD 自动装配渲染引擎，为 DeepSeek Harness 提供 2.5D 桌面宠物。

只需准备一张分图层 PSD，即可获得带自动装配、发丝物理、表情动画和状态镜像的桌宠。

Demo

项目介绍

解决什么问题？

原 dsh-live2d-pets 需要 Live2D 模型（.model3.json），模型制作门槛高、成本大
Anime2.5DRig 只需一张分图层 PSD 即可自动装配 WebGL 2.5D 动画
本项目将两者结合：用 PSD 自动装配替代 Live2D 渲染，保留完整的桌宠交互框架

适合谁？

已有分图层 PSD 角色立绘、想把它变成 DSH 桌宠的用户
不想使用 Live2D、偏好开源 WebGL 渲染的用户
希望桌面宠物反映 agent 状态的 DSH 用户

兼容性

项目	要求
DeepSeek Harness (DSH)	需支持 DSH 插件 API（`dsh.profile.bundles` 机制）
Node.js	`^22.19.0
包管理器	pnpm / npm / bun
浏览器	Chrome / Edge / Firefox / Safari（需支持 WebGL）
最后验证日期	2026-08-23

安装与卸载

安装（源码构建）

# 方式一：克隆后构建安装
git clone https://github.com/coldfish486/dsh-anime25d-pets.git
cd dsh-anime25d-pets
pnpm install
pnpm build
dsh plugin --profile web add /path/to/dsh-anime25d-pets

# 方式二：手动复制
# 构建后把整个项目（含 lib/）复制到 DSH profile 的 node_modules 下：
cp -r dsh-anime25d-pets /root/.dsh/profiles/web/node_modules/
# 然后在 /root/.dsh/profiles/web/package.json 的
# dependencies 和 dsh.profile.bundles 中添加 dsh-anime25d-pets

升级

cd dsh-anime25d-pets
git pull
pnpm install
pnpm build
# 重新安装/重启 DSH

禁用

在 DSH 设置 →「桌宠配置」中关闭"启用桌宠"开关即可。

彻底移除

dsh plugin --profile web remove dsh-anime25d-pets
# 或手动删除：
# /root/.dsh/profiles/web/node_modules/dsh-anime25d-pets/
# 并从 /root/.dsh/profiles/web/package.json 中移除引用

快速开始

最小配置示例

安装插件（见上文）
启动 DSH，右下角出现默认宠物（内置 Anime2.5DRig 示例 PSD 模型）
添加自己的 PSD 模型：
- 打开 DSH 设置 →「桌宠配置」→「我的模型」
- 填写名称和 .psd 地址（支持 HTTP URL 或本地绝对路径）
- 点击保存
使用：
- 点击桌宠右下角 ⚙ 打开角色调节面板
- 拖动滑块实时调整头部/眼睛/眉毛/嘴巴/发型/身体参数
- 切换"随机开口说话"和"随机小动作"开关
- 拖动桌宠到任意位置（自动保存）

可复现示例

# settings.yaml 中 anime25d-pet 部分的参考配置
anime25d-pet:
  enabled: true
  size: 200
  model: sample            # 使用内置示例模型
  animeParams:
    angleX: 0.2            # 左右转头
    mouthOpen: 0.3         # 嘴巴张开
  talk: true               # 随机开口说话
  rand: false              # 随机小动作
  persona: tsundere

配置说明

settings.yaml 配置项

配置项	类型	默认值	说明
`enabled`	boolean	`true`	插件总开关
`size`	number	`160`	宠物尺寸（40~400 px）
`model`	string	`sample`	模型 ID（内置 preset 或自定义模型 ID）
`animeParams`	object	`{}`	Anime2.5D 参数滑块（34 个参数）
`talk`	boolean	`false`	随机开口说话
`rand`	boolean	`false`	随机小动作
`persona`	string	`tsundere`	人设 ID
`developerMode`	boolean	`false`	开发者模式
`debug`	boolean	`false`	调试面板
`showTapZones`	boolean	`false`	显示点击分区

Anime2.5D 参数（34 个）

分组	参数	范围	默认
头部姿态	`angleX` / `angleY` / `angleZ`	-1 ~ 1	0
眼睛	`eyeOpenL` / `eyeOpenR`	0 ~ 1	1
眼睛	`eyeX` / `eyeY`	-1 ~ 1	0
眼睛	`irisScale`	0.5 ~ 1.3	1
眼睛	`eyeScaleL` / `eyeScaleR`	0.5 ~ 1.5	1
眼睛	`eyeEase`	0 ~ 1	0.3
眼睛	`eyeCY` / `eyeCAng`	-1 ~ 1	0
眉毛	`brow`	-1 ~ 1	0
眉毛	`browAngSym` / `browAngL` / `browAngR`	-1 ~ 1	0
嘴巴	`mouthOpen`	0 ~ 1	0
嘴巴	`mouthForm`	-1 ~ 1	0
嘴巴	`mouthCY` / `mouthCAng`	-1 ~ 1	0
嘴巴	`mouthEase`	0 ~ 1	0.45
嘴巴	`mouthScale`	0.5 ~ 1.5	1
发型	`fhAmp`	0 ~ 3	2
发型	`fhSoft`	0 ~ 2	0.4
发型	`bangL` / `bangC` / `bangR`	-1 ~ 1	0
身体物理	`body`	-1 ~ 1	0
身体物理	`armY` / `armPos`	-1 ~ 1	0
身体物理	`bust`	0 ~ 5	2.5
身体物理	`bustY`	-1 ~ 3	1
身体物理	`physAmp`	0 ~ 3	2
身体物理	`soft`	0 ~ 2	2

环境变量

变量	说明
`DSH_HOME`	DSH 配置目录（默认 `~/.dsh`）

敏感项

无。本插件不存储凭据、不访问用户敏感数据。

权限与数据

数据/资源	访问方式	说明
本地 PSD 文件	`node:fs` 读取	仅在用户配置了本地模型路径时读取
设置配置	DSH settings API	读写 `settings.yaml`
自定义模型配置	`~/.dsh/anime25d-pet/custom-models.jsonc`	JSONC 格式
静态资源	HTTP 同源路由	`/pet-assets/`、`/pet-local-models/`
网络访问	无	不发起外部网络请求（除非用户配置了远程 PSD URL）
摄像头	无	不访问摄像头

常见问题排查

常见错误

现象	原因	解决
紫色 🐾 方块	模型加载失败	检查模型路径是否正确；检查 `assets/lib/` 是否存在
空白画面	WebGL 渲染问题	检查浏览器是否支持 WebGL；检查 canvas 尺寸
参数不生效	自动动画覆盖	手动设置参数后自动动画会跳过；开启自动动画会释放手动锁定
重启后参数丢失	持久化失败	检查 `settings.yaml` 中 `anime25d-pet` 配置是否存在
点击分区不准确	坐标系不匹配	确认 `getBounds()` 使用 CSS 坐标系

日志位置

DSH Host 日志：/var/log/dsh/dsh-web.log

回滚

# 通过 DSH 插件系统移除
dsh plugin --profile web remove dsh-anime25d-pets

# 或手动删除插件目录
rm -rf /root/.dsh/profiles/web/node_modules/dsh-anime25d-pets/

开发指南

# 克隆仓库
git clone https://github.com/coldfish486/dsh-anime25d-pets.git
cd dsh-anime25d-pets

# 安装依赖
pnpm install

# 类型检查
pnpm run typecheck

# 测试
pnpm test

# 构建
pnpm build

# 构建产物在 lib/ 目录

项目结构

dsh-anime25d-pets/
├── src/
│   ├── index.ts           # Host 入口（插件 Config / 生命周期）
│   ├── service.ts         # 宠物状态机 / SSE 推送
│   ├── routes.ts          # HTTP 路由 / 静态资源
│   ├── models.ts          # 模型类型定义
│   ├── models-host.ts     # 模型 URL 解析
│   ├── local-models.ts    # 本地 PSD 路径映射
│   ├── presets/           # 内置模型清单
│   └── client/
│       ├── index.ts       # 桌宠主逻辑（加载/交互/面板）
│       ├── anime25d.ts    # Anime2.5D 渲染引擎适配
│       ├── settings.ts    # DSH 设置面板
│       └── personas.ts    # 人设台词
├── assets/
│   ├── vendor/            # ag-psd 等第三方库
│   ├── lib/               # rigger 等 Anime2.5DRig 资源
│   ├── models/            # 示例模型
│   ├── icons/             # 图标
│   └── demo.gif           # 效果演示图
├── lib/                   # 构建产物（pnpm build 生成）
├── shared/                # DSH 构建配置
├── package.json
└── tsconfig.json

贡献

欢迎提交 PR！请确保：

pnpm run typecheck 通过
pnpm test 通过
修改用户可感知行为时更新 README

许可证与安全

许可证

本项目采用 MIT License（见 LICENSE）。

第三方组件许可

组件	用途	许可证
Anime2.5DRig	WebGL 渲染引擎 / 自动装配	MIT
ag-psd	PSD 解析器	MIT
dsh-live2d-pets	桌宠插件框架	MIT

版权声明

PSD 模型资产：assets/lib/eye_close.psd、assets/lib/mouth_close.psd、assets/models/sample.psd 来自 Anime2.5DRig 仓库（MIT License），但 PSD 内的美术作品版权归各原作者所有。发布或分发前请确认版权。
Live2D 官方模型：原 dsh-live2d-pets 内置的 Hiyori/Haru 等模型不再分发。

安全

如发现安全问题，请通过 GitHub Issues 私密报告（不要公开漏洞详情）。

coldfish486/dsh-anime25d-pets

dsh-anime25d-pets 🐾

项目介绍

兼容性

安装与卸载

安装（源码构建）

升级

禁用

彻底移除

快速开始

最小配置示例

可复现示例

配置说明

settings.yaml 配置项

Anime2.5D 参数（34 个）

环境变量

敏感项

权限与数据

常见问题排查

常见错误

日志位置

回滚

开发指南

项目结构

贡献

许可证与安全

许可证

第三方组件许可

版权声明

安全

社区评论

coldfish486/dsh-anime25d-pets

dsh-anime25d-pets 🐾

项目介绍

兼容性

安装与卸载

安装（源码构建）

升级

禁用

彻底移除

快速开始

最小配置示例

可复现示例

配置说明

settings.yaml 配置项

Anime2.5D 参数（34 个）

环境变量

敏感项

权限与数据

常见问题排查

常见错误

日志位置

回滚

开发指南

项目结构

贡献

许可证与安全

许可证

第三方组件许可

版权声明

安全

社区评论