# @eduwork/dsh-desktop-pet 中文文档 规范地址：https://npmcn.com/package/%40eduwork/dsh-desktop-pet/ 版本：0\.1\.4 npm 元数据更新时间：2026-11-05T01:20:10.050Z 中文译文更新时间：2026-11-14T15:43:10.535Z 软件包许可：MulanPSL-2\.0 AND MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40eduwork/dsh-desktop-pet 原文对照：https://npmcn.com/package/%40eduwork/dsh-desktop-pet/?lang=original 项目主页：https://github.com/ECNU/EduWork/tree/main/packages/dsh-desktop-pet#readme 源码仓库：https://github.com/ECNU/EduWork ## 关键信息（来自 npm 元数据） - 包体积（解压后）：4.2 MB，117 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - Node.js 要求：\>=24\.18\.0 - 运行依赖：0 个 - peer 依赖：zod ^4\.4\.3，react ^18\.2\.0，@deepseek-ai/cordis ^4\.0\.2，@deepseek-ai/schemastery \>=3\.18\.0 \<3\.19\.0 \|\| 3\.19\.0，@deepseek-ai/dsh-api-remotes \>=0\.2\.0-rc\.2 \<0\.3\.0-0 \|\| 0\.2\.2-rc\.1，@deepseek-ai/dsh-client-locale \>=0\.2\.0-rc\.2 \<0\.3\.0-0 \|\| 0\.2\.2-rc\.1，@deepseek-ai/dsh-typert-protocol \>=0\.2\.0-rc\.2 \<0\.3\.0-0 \|\| 0\.2\.2-rc\.1，@deepseek-ai/dsh-client-ui-renderer \>=0\.2\.0-rc\.2 \<0\.3\.0-0 \|\| 0\.2\.2-rc\.1，@deepseek-ai/dsh-client-ui-settings \>=0\.2\.0-rc\.2 \<0\.3\.0-0 \|\| 0\.2\.2-rc\.1 - 首次发布：2026-10-16T02:22:09.120Z - 最新版本发布：2026-11-05T01:20:09.723Z - 近 30 天下载量：1999（2026-10-13 至 2026-11-11，npm 官方下载统计） - 已发布版本数：5（近 12 个月 5 个） ## 中文简介 使用 EduWork Electron 桌面桥的 DSH 应用程序桌面宠物 ## 安装 ```sh npm install @eduwork/dsh-desktop-pet ``` 也可以使用：`pnpm add @eduwork/dsh-desktop-pet`、`yarn add @eduwork/dsh-desktop-pet`、`bun add @eduwork/dsh-desktop-pet` ## README # 桌面宠物 [English](https://npmcn.com/package/%40eduwork/dsh-desktop-pet/README_EN.md) `@eduwork/dsh-desktop-pet` 是独立维护、独立版本的 DSH 桌宠插件。内置小页（红、蓝）、大肥鱼、小花狮和花狮娘，提供形象选择、大小、状态气泡和空闲打盹。它与托盘、系统通知共用宿主的事项数据；点击桌宠可打开需要处理或已完成的会话。 ![小页](https://npmcn.com/package/%40eduwork/dsh-desktop-pet/skins/eduwork-page/idle.svg) ## 使用 EduWork 桌面客户端随包提供插件，在“设置 → 桌面宠物”中开启即可，默认关闭。现有用户的开关、形象、大小和位置保持原有存储方式，拆分不会重置这些设置。 其他发行版可安装这个 npm 包并集成到兼容的桌面宿主： ```sh npm install @eduwork/dsh-desktop-pet ``` **宿主要求：兼容的 DSH 0.2 API 与 EduWork Electron 桌面桥接。** 插件包含设置、动画和形象；透明悬浮窗口、点击穿透、拖拽和位置记忆由桌面壳提供。普通 Web 页面或尚未接入该桥接的 DSH 客户端，安装包本身不会获得桌面悬浮窗口能力。 使用方法和形象说明见[桌面宠物指南](https://github.com/ecnu/EduWork/blob/main/docs/DESKTOP_PET.md)。代码许可见 [LICENSING.md](https://npmcn.com/package/%40eduwork/dsh-desktop-pet/LICENSING.md)（木兰 PSL v2 与历史 MIT）；各款美术素材的来源与许可见 [skins/LICENSE](https://npmcn.com/package/%40eduwork/dsh-desktop-pet/skins/LICENSE)。 ## 宿主集成 - Host 注册 Cordis 服务 `desktopServices`，提供 `pet(request)`；这是运行时注入的服务，不是插件需要从 npm 下载的依赖。 - 将包的 bundle 加入 DSH 组合。它使用稳定入口 `eduwork-desktop-pet`，默认 `enabled: false`；已有 EduWork 产品配置会插入同一入口，无需重复添加。 - 桌面壳从安装后的包加载 `lib/page/` 和 `skins/`，继续使用原有通知事项及打开会话回调。设置页的“隐藏/显示”与壳菜单通过现有事件接线。 - 普通托盘和系统通知独立于桌宠开关，授权操作仍在应用内完成。 - 支持[插件通知协议](https://github.com/ECNU/EduWork/blob/main/docs/PLUGIN_NOTIFICATIONS.md)的通用提醒性质、待办状态和标签；业务插件通过通知服务接入，不直接控制桌宠。需要配套支持协议 1 的桌面壳。 服务接受两种请求： ```js { action: 'configure', enabled, skin, frame, size, bubbles, sleep } { action: 'reset-position' } ``` 返回对象包含 `supported`；宿主不支持时返回 `{ supported: false }`。插件停用会发送关闭请求。接口实现与窗口约束见 [desktop-services](https://github.com/ecnu/EduWork/blob/main/dsh-plugins/desktop-services/lib/index.js) 和 [Electron 桌宠窗口](https://github.com/ecnu/EduWork/blob/main/dsh-electron/src/desktop-pet.mjs)。 ## 开发 在本包目录运行： ```sh npm ci npm run check npm pack --ignore-scripts ``` 构建仅生成设置页 `lib/client.js`，Host 模块与形象随包提供。测试默认使用本包锁定的真实 DSH 依赖；设置 `EDUWORK_TEST_RUNTIME` 为产品的 `d` 目录可检查装配后的 Runtime。 小页和小花狮由 `scripts/build-page-skins.mjs` 与 `scripts/build-huashi-skin.mjs` 生成；修改脚本后执行 `npm run build:skins`。大肥鱼使用 whale-girl 的 PNG 立绘。花狮娘由 **Emily** 创作，采用 [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/)；JunieXD 使用 ChatGPT 生图适配的 WebP 精灵图沿用该许可，完整署名与改编说明见 [素材许可](https://npmcn.com/package/%40eduwork/dsh-desktop-pet/skins/LICENSE)。新形象通过 PR 内置，不提供形象包导入功能。 [包维护与发布](https://github.com/ecnu/EduWork/blob/main/docs/PACKAGES.md) · [变更记录](https://npmcn.com/package/%40eduwork/dsh-desktop-pet/CHANGELOG.md) · [代码许可](https://npmcn.com/package/%40eduwork/dsh-desktop-pet/LICENSE) ## 常见问题 ### @eduwork/dsh-desktop-pet 是什么？ 使用 EduWork Electron 桌面桥的 DSH 应用程序桌面宠物 ### 如何安装 @eduwork/dsh-desktop-pet？ 在项目目录运行 npm install @eduwork/dsh-desktop-pet，或使用 pnpm add / yarn add / bun add。 ### @eduwork/dsh-desktop-pet 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/eduwork\_\_dsh-desktop-pet 是否存在。 ### @eduwork/dsh-desktop-pet 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @eduwork/dsh-desktop-pet 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=24\.18\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @eduwork/dsh-desktop-pet 可以商用吗？ @eduwork/dsh-desktop-pet 使用 MulanPSL-2\.0 AND MIT 许可。声明的许可为 MulanPSL-2\.0 AND MIT，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。 ### @eduwork/dsh-desktop-pet 的下载量有多少？ 根据 npm 官方下载统计，@eduwork/dsh-desktop-pet 在 2026/10/13 – 2026/11/11 这 30 天内被下载 1,999 次，日均约 67 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @eduwork/dsh-desktop-pet 还在维护吗？ 最新版本 0\.1\.4 发布于 2026/11/05（9 天前）；至今共发布 5 个版本，其中过去 12 个月发布了 5 个；首次发布于 2026/10/16。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。