chengyingshe/dsh-desktop-pet

dsh-desktop-pet

一个可配置、可交互的桌面宠物，用于 DeepSeek Harness Web GUI。

本插件会在 dsh Web 页面右下角显示可互动的桌面宠物。当前内置三套宠物形象：

| 形象 | 资源目录 | 切换方式 |
| --- | --- | --- |
| 小新 | assets/characters/shinchan/ | 默认形象 |
| 橘猫 | assets/characters/orange-cat/ | 右键 → 切换宠物 |
| 阿尼亚风格 | assets/characters/anya/ | 右键 → 切换宠物 |

每套角色均遵循相同结构：manifest.json 描述角色，九种状态图片统一放在 sprites/ 目录中。

功能特性

- 待机、行走、奔跑、睡觉、思考、庆祝、惊讶、被拖拽和说话状态。
- 每种状态使用不同的图片，并以内置美术资源作为安全回退。
- 针对用户活动和 DSH 响应生成的情境化对话。
- 支持单击、双击、拖拽、键盘、减少动态效果以及移动端。
- 位置、可见性、声音和自定义角色图片均保存在本地。
- 右键点击宠物可替换当前状态的图片或恢复默认。
- 运行时事件 API，可在不修改核心代码的情况下切换整套角色包。
- 内置小新、橘猫和阿尼亚风格角色包，可通过宠物右键菜单切换。

角色包

参见 assets/characters/README.md 并复制 assets/characters/example/manifest.json。支持的状态有 idle、walk、run、sleep、think、celebrate、surprised、drag 和 talk。

内置的默认角色包是 assets/characters/shinchan/manifest.json。它的九张生成精灵图会在 pnpm build 期间嵌入到 lib/client.js 中，因此安装后的插件无需单独为美术资源搭建 Web 服务器。

以下是内置的小新桌面宠物精灵图集。各状态按从左到右、从上到下的顺序依次为 idle、walk、run、sleep、think、celebrate、surprised、drag 和 talk。

小新桌面宠物状态预览

宿主客户端可以在运行时切换角色：

window.dispatchEvent(new CustomEvent("dsh-desktop-pet:set-character", {
detail: {
name: "My Pet",
size: 150,
assets: {
idle: "/assets/my-pet/idle.png",
walk: "/assets/my-pet/walk.png"
}
}
}));

缺失的状态会回退到待机图片，然后回退到内置矢量美术资源。

右键点击宠物并选择 切换宠物，可在内置的小新、橘猫和阿尼亚角色包之间循环切换。所选宠物会保存在本地，并在重新打开 Web GUI 时恢复。

精灵图集工作流程

按以下顺序生成一张正方形的 3 乘 3 精灵图集：

idle, walk, run
sleep, think, celebrate
surprised, drag, talk

然后使用内置的裁剪脚本（使用明确的左上角坐标）将其拆分：

pnpm split:sprites /path/to/sprite-sheet.png assets/characters/my-pet

开发

pnpm install
pnpm build
dsh plugin --profile web add link:$PWD

从 GitHub 安装发布版本：

dsh plugin --profile web add github:chengyingshe/dsh-desktop-pet#main

Git 安装会通过 prepare 自动生成 lib/ 发布产物。

也可以从 npm 官方源安装：

dsh plugin --profile web add @maximeshe/dsh-desktop-pet
发布由 GitHub Actions 自动完成。先在仓库 Actions secrets 中添加具有发布权限的 NPM_TOKEN，再创建与 package.json 版本一致的 GitHub Release（例如版本 0.1.0 对应标签 v0.1.0）。

重启 dsh web，刷新位于 http://127.0.0.1:3080 的现有 GUI，然后查看右下角。

Coding Agent 自动安装

将以下脚本交给 Coding Agent 执行即可完成安装。脚本会克隆仓库、构建插件、安装到 dsh 的 web profile，并检查插件是否已登记：

set -euo pipefail
PLUGIN_DIR="${PLUGIN_DIR:-$PWD/dsh-desktop-pet}"
if [ ! -d "$PLUGIN_DIR/.git" ]; then
git clone https://github.com/chengyingshe/dsh-desktop-pet.git "$PLUGIN_DIR"
fi
cd "$PLUGIN_DIR"
pnpm install --frozen-lockfile
pnpm typecheck
pnpm build
dsh plugin --profile web add "link:$PWD"
dsh plugin --profile web list

安装后重启 dsh Web：

dsh web --no-open --port 3080

打开  后，宠物应显示在右下角。右键宠物可切换形象、切换动作图片或隐藏宠物。若 dsh 已在运行，必须先停止旧进程再启动，确保加载最新 Bundle。