前言¶
DeepSeek Harness（DSH）采用「一切皆插件」的理念，官方桌面端基于 Electron 构建。在桌面端环境中运行上游桌宠 dsh-pet 需要适配层，这个插件就是为此准备的适配发行版。
插件定位¶
zhuge886/dsh-pet-deepseek-official-desktop 是 dsh-pet 在 DSH 官方桌面端的适配发行版。插件本身是二次创作，不包含原创内容，仅提供适配层与组合包声明，让上游桌宠能在桌面端安装、启用、管理。维护者为 zhuge886。
安装与启用¶
- 打开 DSH 官方桌面应用，进入「插件管理 → 添加插件」；
- 填入仓库地址：
https://github.com/zhuge886/DSH-pet-Deepseek-Official-Desktop
等价的 pnpm spec 为 github:zhuge886/DSH-pet-Deepseek-Official-Desktop；
3. 启用 dsh-pet 组合包，重开桌面应用。
默认配置只显示一只：窗口外透明置顶小窗（display: desktop）。如需在应用内显示、两只同时显示或隐藏，可在设置页「桌宠配置」中调整（详见 README 中的说明）。
验证适配层¶
桌宠加载后，DSH 的 Web 服务会新增一个只读接口：
GET http://127.0.0.1:<port>/dsh-pet-desktop/health
返回字段包含 status: active、host.kind: desktop、upstream.applied: true 即表示适配层与上游都已就绪。字段含义与详细排障见 README 中的说明。
插件结构¶
仓库根目录即插件包，免构建。主要目录如下：
adapter/ 适配层：宿主识别、运行时诊断、健康检查、失败降级
cordis.patch.yml 组合包声明（桌面端插件管理据此识别插件）
vendor/dsh-pet-0.3.7/ 上游已构建产物（免构建，SHA-256 逐文件校验）
dsh-pet/assets/ 运行时素材（webm、字体、表情包、默认配置）
animations/webm/ 额外收录的动作素材（文件名即动作名）
tests/ 清单、适配层纯逻辑、启动冒烟测试
DESKTOP.md 兼容矩阵、排障、版本记录
scripts/sync-vendor.mjs 上游产物同步与可审计补丁
代码与适配改动以 MIT 许可提供；上游内容归 PC2005-cloud 所有，不允许商用。
额外动作¶
除了上游自带的 106 段动画，本仓库额外收录的动作放在 animations/webm/ 目录。目录约定与上游一致：webm 子目录 + 文件名即动作名，VP9-alpha、640×360。例如 animations/webm/非洲之心.webm 为开保险箱、捧起钻石的 10 秒动作（用户自制，已去水印/去音频/抠成透明）。
功能与玩法¶
功能与配置、动画与 pet pack、HTTP API、问题反馈等，请前往上游仓库：https://github.com/PC2005-cloud/dsh-pet。本仓库仅提供适配与兼容性说明，不包含玩法与配置细节。
版本信息¶
当前版本为 0.3.7-desktop.5，基于上游 dsh-pet@0.3.7。变更记录见 README 中的说明。
适用场景与注意¶
适合需要在 DSH 官方桌面端运行桌宠的开发者与用户。插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。代码与适配改动以 MIT 许可提供；上游内容归 PC2005-cloud 所有，不允许商用。任何介绍、展示、分发本仓库的地方，请保留上游作者地址。
小结¶
这个插件解决了 dsh-pet 在 DSH 官方桌面端无法直接运行的问题，通过适配层将上游桌宠接入桌面端插件体系。无需构建、仓库根即插件包，安装与启用步骤简单直接。更多细节与问题反馈，可参考仓库 README 与上游文档。
