前言¶
在 DeepSeek Harness（DSH）里长时间跑 Web UI 或 dsh web 时，界面往往只剩对话、配置和日志，缺少一点「人在旁边」的反馈。社区里已有桌宠类插件；若你更在意碎碎念不耗模型、气泡交互和拖拽边界等行为细节，@tuweizhi/dsh-pet 是在上游 PC2005-cloud/dsh-pet v0.3.8 之上的增强 fork，可与上游包名 dsh-pet 并存、互不覆盖。下面介绍它是什么、相对上游改了什么，以及如何安装与日常使用。
这是什么¶
@tuweizhi/dsh-pet 是面向 DSH Web 的客户端类插件：在浏览器 overlay 或透明置顶桌面小窗里展示透明动画桌宠（待机、随机动作、漫游、拖拽物理、右键点播动作等），可选余额展示、系统通知、碎碎念与主动对话。维护者为 TuWeiZhi；npm 包当前版本为 0.4.4（见 package.json）。本 fork 只发布构建产物与素材，相对上游的增强点包括：
- 碎碎念改为全本地语句池（不调用模型、零 token）
- 碎碎念气泡点击即可收起，停留时长与文字倍率可在设置页调整
- 随机动作之间可通过
eventsRefreshSec.action留白（自动行为间隔） - 拖拽、甩抛、存档落点限制在视口内（按角色
HIT_BOX，透明留白可出屏） - 贴角边距只算角色本体，不再把画布透明留白算进
marginX/marginY
逐条变更见仓库 CHANGELOG.md；若只要原版行为，可安装上游 dsh-pet。
核心功能（已文档说明部分）¶
动画与交互¶
桌宠提供待机呼吸、97 类透明动画链（打瞌睡、玩魔方、写代码等）、屏幕漫游、点击 Q 弹回应、过阻尼拖拽跟手与甩抛反弹物理；物理参数可在配置 physics 段或设置页图形化编辑。多开、pet pack 扩展种类、浏览器与桌面双端显示（默认 display: "both"）均在 README 中有说明。
碎碎念与对话¶
- 碎碎念：按
eventsRefreshSec.whisper周期（默认 300 秒，设置页可改，最小 60 秒）从本地whisperLines随机抽取；池空则用内置 40 句保底。whisperBubbleSec、whisperTextScale控制气泡时长与字号；气泡出现后点一下即收起。右键「碎碎念」可立即触发（绕过节流）。默认开启，可按宠物关闭pets[].whisperEnabled。 - 对话：右键「对话」或
/chat会走模型（插件文档明确：除主动对话外，运行时其余功能零 LLM/API；碎碎念永远零模型成本）。记忆保存在$DSH_HOME/dsh-pet/memory.json。
显示位置¶
安装并重开 DSH 后，默认浏览器与桌面各可能出现一只（共用配置）。若只留一处：设置页「显示位置」或宠物右键「显示位置」选择仅浏览器 / 仅桌面 / 两者 / 都不显示。本机无 Electron 时，宿主可能自动下载桌面运行时到 ~/.dsh/electron（仅影响桌面模式，浏览器端不受影响）。
macOS Safari 透明素材¶
Safari/WKWebView 对 webm alpha 支持不足时，可将 .mov（HEVC-with-Alpha）放入 $DSH_HOME/dsh-pet/main-animation/mov/（素材来源见上游 assets-mov）。桌面模式（Electron）仍用 webm。
安装与启用¶
桌面应用（Electron 版）：在应用内「插件管理」安装框填写包名，无需开终端；若要用 CLI，使用桌面应用自带的那份。
dsh web：在终端执行：
dsh plugin --profile web add @tuweizhi/dsh-pet
装完后重开桌面应用或重启 dsh web 才生效。宠物默认出现在界面右上角（角落可在设置页修改），透明动画开箱即用，无需生成流程。
典型用法¶
- 安装后确认双端：先见浏览器 overlay，桌面 Helper 就绪后可能出现透明窗；不想双开则改「显示位置」。
- 调碎碎念节奏：设置页「自动行为间隔」改
whisper与action；在「碎碎念语句池」编辑whisperLines，可用「随机试一条」「让宠物说这句」预览（仍走本地/whisper，零模型）。 - 物理与边界：在设置页「物理」区改重力、恢复系数等；本 fork 已保证拖甩落点不出视口，老配置越界坐标渲染时也会被夹回。
- 不打开 DSH 仅跑桌宠：README 提到
npx dsh-pet-standalone独立运行，详见仓库「独立运行」章节。 - 主动聊天：选中
/pet目标宠物后，右键「对话」或发送/chat <消息>；留空/chat可催一句碎碎念（行为以文档为准）。
适用场景与注意¶
适合：希望在 DSH 工作或调试 Agent 时有一个轻量、可配置的桌面伴侣；尤其希望碎碎念完全本地化、不占用 token 的用户。
注意：
- 插件在当前 DSH 进程权限下运行；安装前请自行查看 GitHub 源码 与 LICENSE（fork 说明见 NOTICE.md）。
- 对话功能会调用模型并可能附带表情包清单（
chatImageEnabled会增加上下文体积）；碎碎念配图whisperImageEnabled为本地随机，文档说明为零 token。 - 社区目录 SkillHub 插件页 为独立站点，与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，本文事实以仓库 README 与 package.json 为准。
结尾¶
@tuweizhi/dsh-pet 在上游桌宠能力之上，把碎碎念做成全本地语句池、气泡可点收起、动作间隔与视口/边距行为做了可感知的增强，安装命令明确、与上游包可并存。需要详情与配置字段完整列表，请读 GitHub README 与 目录页。
