在 DSH 生态里，"插件"这个词通常意味着能力增强：接模型、加工具、改工作流。dsh-pet（仓库 PC2005-cloud/dsh-pet，星标 1,222，MIT 代码许可）是少数几个完全不打算增强生产力的插件——它的官方定位是"一只住在 DeepSeek Harness 里的桌面宠物"。但它值得写一篇实践记录，因为它的工程完成度和自我约束，比很多"实用工具"类插件更值得参考。
它到底做了什么
先看功能清单。桌宠有一百余个手绘风透明动画，待机呼吸、随机动作（打瞌睡、玩魔方、吃火锅之类）、左右转向、屏幕漫游、点击 Q 弹、拖拽甩抛反弹、右键菜单点播。
其中几个细节做得比预期认真：
- 动画链：每个动画（含待机）播完即按权重选下一个，默认 idle 10 / turn 5 / move 5 加分类权重，首尾相接，权重可在
config.jsonc里调。 - 屏幕漫游：朝朝向方向行走，先探测空间、不走出屏幕，多屏按各屏边界判定。
- 点击 / 拖拽 / 甩抛：拖拽过阻尼弹簧跟手；甩出即抛物线飞行、屏幕边缘反弹、落地摩擦停稳并 Q 弹一下。文档特别说明：浏览器端与桌面端共用同一套纯函数物理与挤压曲线（在
src/shared/physics.ts）。 - 流畅切换：双缓冲交叉淡入，切换无空白帧。
- 无障碍：支持
prefers-reduced-motion，减少动效时跳过 Q 弹挤压与淡入切换。
还有一层比"宠物"更实用的能力：工作状态联动。开启后，宠物跟随 DSH 会话事件切换"思考 / 工作 / 整理 / 等待 / 成功 / 出错"六档动画并挂常驻气泡，目标多轮任务只在真正收尾轮庆祝。加上"窗口失焦时弹系统通知"，它实际上成了一个低干扰的会话状态指示器。
边界划得很干净
这个插件最值得学的部分是它的自我约束，README 里写得很直接：
> 纯粹的桌宠：不做天气、监控等无关功能，不碰 DSH 内核；可选能力只有下面这些（余额 / 碎碎念 / 对话 / 工作状态 / 系统通知）。
"不碰 DSH 内核"这句话是有分量的——它的可选能力全部可逐项开关，balanceEnabled 是每只宠物的必填布尔字段，display 决定它出现在浏览器、桌面还是两者。不想用余额展示的，直接不配对应 provider 的 API key 就行。
另一个体现克制的地方是它对外只开一套本地接口：挂在 DSH 自己的 Web 服务上，前缀 /dsh-pet-7340，只监听本机、无鉴权。文档给出了三个文件供二次开发：API.md（接口一览）、openapi.yaml（OpenAPI 3.1，可直接导入 Swagger UI 或 Postman）、tools/api-tester.html（桌宠控制台示例）。作者对开放接口的理由写得也挺有想法：
> 桌宠不该只是个摆设——比如一个"女仆"插件巡检验完想说句话，就能让桌宠当它的"实体"开口。
需要明确的是，无鉴权 + 只监听本机是一个刻意的取舍：它假定调用方都在同一台机器上。如果本机有不受信任的进程，这个假设就不成立了。
三件套项目：它不只是个插件
这是 dsh-pet 最特别的地方。README 开头就写：
> 这不是一个普通插件，而是完整的三件套项目：
> ① 提示词（配方）→ ② 素材生成链（引擎）→ ③ 插件（成品）
> 任何人 clone 本仓库，都可以从零生成自己的桌面宠物——换角色、换动作、换风格，全流程可复现。
拆开看三段：
提示词部分提供了绿幕规范——prompts/桌面宠物 10 秒动作提示词.md 要求视频比例 16:9、背景纯绿幕（#00FF00）、人物位置固定（头顶约 20% 高度、脚底约 85% 高度）、动作全程在画幅内、首尾帧为标准正面站立。
素材链是一串 Python 脚本：水印遮罩填充 → 绿幕抠像转透明 → 归一化到 2160×1215 统一站立居中 → 转码 640×360 播放变体。依赖是 Python 3 + ffmpeg + numpy + scipy。
插件部分是 TS 源码，src/ 分 host（配置 / 路由 / 工作状态）、client（动画链）、shared（双端共用纯逻辑）三层。
实践中最需要提前知道的三件事
第一，装完必须重开应用。 官方原话是"装完重开桌面应用（dsh web 用户则重启 dsh web）才生效——运行中的进程持有内存里的旧插件"。这条几乎每个人都会撞一次。
第二，--profile 要填对。 桌面应用用 desktop，dsh web 用 web：
dsh plugin --profile desktop add dsh-pet第三，发版节奏是"攒批"。 README 明确写着：小修不单独发版，不影响使用的小 bug 与优化会累计到下一个版本一起发。所以 "main 上已经修了"不等于"你装的这版已经包含"——latest 没更新时，以 main 的提交记录为准。想立刻用上未发布的修复，可以走源码安装把插件指向本地仓库；注意宿主半侧的代码改动要重开 DSH 才生效，浏览器半侧刷新页面即可。
关于素材许可
这一点容易忽略，但对二次创作的人很重要。README 的许可段分三层：代码是 MIT；素材（动画 / 提示词 / 源视频）允许开源使用，禁止商用；二创约定是——基于本项目的衍生、改版、换皮作品，在任何介绍、展示、分发该作品的地方，须附上原作者 GitHub 地址。
也就是说，如果你想基于它的素材做一个自己的桌宠并对外发布，代码层面宽松，但素材不能商用、且必须署名。
总结
dsh-pet 的价值有两层。作为插件，它是一个完成度很高的桌宠，工作状态联动让它比预想的更有用；作为项目，它示范了"配方 + 引擎 + 成品"的三件套该怎么组织，以及一个娱乐类插件如何把边界划清楚（不碰内核、能力可选、接口只监听本机）。想对照其他 DSH 插件的中文清单与安装形态见 DeepSeek Harness Hub 插件清单。
适合与不适合
适合：想给长时间挂着 DSH 的工作桌面加一点反馈的人；需要一个低干扰的会话状态提示的人；想学"配方 + 引擎 + 成品"工程组织方式的开发者；打算基于素材链做自己角色、并接受非商用约束的二创作者。
不适合：追求生产力工具、觉得桌宠是干扰的用户；需要在无图形界面的服务器上看到它的场景（只有浏览器 overlay 可用，桌面模式会被跳过）；macOS 上使用 Safari 的人（不认 webm alpha，透明会渲染成黑底，需另换素材）；以及想拿它的动画素材商用的人——许可明确禁止。
标签：dsh-pet、DeepSeek Harness、桌面端、桌宠、三件套工程
本文由 DeepSeek Harness Hub 自动整理，数据来源于插件详情页。