前言¶
在 DeepSeek Harness（DSH）里跑智能体或写插件时，桌面往往只有终端和编辑器。若想在 Windows 上放一只不挡操作、不抢输入焦点的 Live2D 桌宠，常见做法是单独装桌宠软件：容易占任务栏、空白区域仍拦截点击，点一下还会打断当前窗口。社区插件 dsh-desktop-pet（维护者 AlaxonYegar，分类：客户端）把桌宠挂进 DSH 插件体系：DSH 启动时拉起独立 Electron 进程渲染 Live2D，宿主侧只做进程管理；包内不含任何模型文件，需自行选择已获授权的 *.model3.json 目录。下面介绍它做什么、怎么装、怎么用，以及和 DSH 运行环境相关的注意点。
这是什么¶
dsh-desktop-pet 是面向 DSH 的桌面 Live2D 桌宠插件：常驻桌面、始终置顶、按像素做鼠标穿透（仅不透明像素接收点击）、窗口不可聚焦、不占任务栏，支持多显示器拖动、五档尺寸与滚轮缩放、托盘里一键开机自启（VBS 静默）。当前版本在 package.json 中为 1.0.0，许可证 MIT，目标平台为 Windows x64（README 徽章与 keywords 一致）。
- 目录页：https://www.skillhub.cn/plugins/AlaxonYegar/dsh-desktop-pet
- 源码与说明：https://github.com/AlaxonYegar/dsh-desktop-pet
核心功能¶
README 中与「普通桌宠」对比的能力如下，均可在文档中核对：
| 能力 | 说明 |
|---|---|
| 鼠标穿透 | 空白区域穿透；只有压在模型不透明像素上才接收点击 |
| 不抢焦点 | focusable: false |
| 任务栏 | skipTaskbar: true，不多占图标 |
| 尺寸 | 五档 + 滚轮 + 快捷键 |
| 模型 | 首次启动选择文件夹，导入任意 .model3.json（需你已获授权） |
| 多显示器 | 可拖到任意屏 |
| 开机自启 | 托盘菜单；配置项 autostart 可控制是否在 DSH 启动时自动拉起 |
工作原理要点：宿主侧在 DSH 启动时 spawn Electron 载入 app/，然后 unref()；关闭 DSH 后桌宠进程仍可留在桌面。插件会去掉子进程环境中的 ELECTRON_RUN_AS_NODE=1，避免 Electron 以 Node 模式启动导致 app is undefined 崩溃。
安装与启用¶
在 DSH 插件市场搜索 dsh-desktop-pet，或执行官方命令：
dsh plugin --profile web add dsh-desktop-pet
装完后重开 DSH。桌面右下角会出现桌宠；首次为「选择模型」界面，指向本地 *.model3.json 所在文件夹。
可选配置（摘自 README）：
- id: desktop-pet
name: dsh-desktop-pet
config:
autostart: true # 设为 false 则只安装、不自动拉起
运行时依赖（Electron）¶
插件不打包 Electron（避免体积从约 240KB 涨到 100MB+），按顺序查找可执行文件：
| 顺序 | 位置 |
|---|---|
| 1 | <插件目录>/electron/electron.exe（自行放置） |
| 2 | %USERPROFILE%\.dsh\electron\electron.exe（DSH 自带，多数用户命中此项） |
| 3 | %LOCALAPPDATA%\.dsh\electron\electron.exe |
| 4 | %LOCALAPPDATA%\Programs\electron\electron.exe |
都找不到时仅在日志提示，不报错，也不影响 DSH 主进程。package.json 要求 Node >= 20。
典型用法¶
日常交互（来自 README 表格）：
| 操作 | 效果 |
|---|---|
| 左键按住拖动 | 移动（含任务栏区域、多显示器） |
| 右键单击 | 打开/关闭操作面板 |
| 滚轮 | 缩放 |
Ctrl+Alt+H |
隐藏 / 显示 |
Ctrl+Alt+L |
强制可交互（像素命中不准时） |
Ctrl+Alt+↑ / ↓ |
放大 / 缩小 |
Ctrl+Alt+Q |
退出 |
托盘菜单另有：大小档位、回到右下角、始终置顶、开机自启、退出。
适用场景与注意¶
适合已在 Windows 上使用 DSH、并希望桌宠与 Harness 同生态安装、且不想被桌宠打断输入的开发者。DSH 社区插件目录（如 skillhub.cn）为独立站点，与 DeepSeek / 幻方无官方从属关系；安装前建议阅读仓库 LICENSE、NOTICE.md 及源码——插件以当前 DSH 进程权限拉起子进程，模型版权需自行合规（Cubism Core 为 Live2D 专有许可，模型不在本包内）。
结尾¶
dsh-desktop-pet 把 Live2D 桌宠做成 DSH 客户端插件：穿透、不抢焦点、多屏与自启等能力在 README 中有明确说明，安装命令为 dsh plugin --profile web add dsh-desktop-pet。细节与更新见 GitHub 仓库与 CHANGELOG.md。
