前言¶
在 DeepSeek Harness（DSH）里挂一个桌面或网页 overlay 桌宠，常见诉求不只是「看着可爱」：有人希望到点用同一条气泡出口提醒喝水、休息；有人希望宠物不要一直占屏，但又不想每次隐藏都卸载组件、丢位置。上游 dsh-pet 已经提供完整桌宠能力；若你还需要自定义时刻的提醒语和可调的随机出现/隐藏节奏，且希望和原版同时安装、互不影响，下面介绍社区插件 dsh-pet-jt（维护者 jtsinlio）。
这是什么¶
dsh-pet-jt 是 dsh-pet 的个性化增强分支：基于上游 0.3.8 的源码与动画素材（MIT），不改上游已有行为语义，只做加法——新增「定时提醒」与「随机出现/隐藏频率」两段配置、对应设置卡片，以及宿主定时器与客户端显隐调度。npm 包名 dsh-pet-jt，当前版本 0.2.0；社区目录分类为「趣味换装」。
核心功能¶
定时提醒¶
在设置页 「桌宠配置 JT」→「定时提醒」 维护任务列表。每条任务包含：
| 字段 | 说明 |
|---|---|
| 时刻 | HH:MM（24 小时制），每天触发一次 |
| 提示语句 | 显示在气泡里，上限 120 字 |
| 启用 | 单条开关（另有总开关） |
到点后由宿主写入 pets.<id>.say，与碎碎念、对话回复、第三方 /broadcast 同一出口：气泡外观、12 秒显示时长、说话动画均复用对话气泡。同一分钟同一条任务只触发一次；DSH 未运行而错过的时刻不补发。提醒投给「当前交互桌宠」（与 /chatjt 目标一致）；宠物不存在则跳过。触发提醒也会立刻把正在隐藏的宠物叫回桌面。
任务上限 40 条；只有「每天一个时刻」，没有工作日或每 N 小时规则——需要多次提醒就建多条。
随机出现 / 隐藏频率¶
在 「桌宠配置 JT」 中配置四项（单位：分钟，各自 1–120，且最短不得大于最长）：
- 出现后最短 / 最长停留：出现后在该区间内随机某一时刻隐藏。
- 隐藏后最短 / 最长：隐藏后在该区间内随机某一时刻重新出现。
网页 overlay 侧隐藏为 opacity: 0 等样式，组件不卸载，位置与动画状态保留，带 0.45s 淡入淡出。桌面透明窗口侧由主进程 win.hide()，回来时 showInactive() 并重新置顶。任何一次说话（碎碎念 / 对话 / 定时提醒）会立刻现身，并从现在重新随机下一次隐藏时间。关闭该功能开关则一直显示，等价原版行为。
双击查看余额¶
双击宠物等价右键「查看余额」：POST /dsh-pet-jt-7340/balance，余额由 /state 推送；拖拽中或飞行中被按住的那一下不算双击。与「余额功能」自动轮询开关无关。
与原版 dsh-pet 的隔离¶
两个插件可同时启用，路径、命令、配置互不重叠。例如：用户数据在 ~/.dsh/dsh-pet-jt/，HTTP 前缀 /dsh-pet-jt-7340/，斜杠命令 /petjt、/chatjt、/balancejt，overlay 插槽 pet-jt，设置分区 「桌宠配置 JT」。原版仍用 /pet、/chat 等与 ~/.dsh/dsh-pet/。
安装与启用¶
插件以 DSH bundle 形式安装（机制与 dsh-pet 相同）。react / react-dom / @deepseek-ai/* 由 DSH 宿主提供，无需在本包内重复安装。
方式一：命令行挂到某个 profile（将 <profile> 换成你的，如 desktop；路径改成本地 clone 或解压后的目录）：
dsh plugin --profile <profile> add "D:/path/to/dsh-pet-jt"
方式二： 在 DSH 插件管理中选择「安装本地 bundle」，指向本仓库目录。
装完刷新页面，设置面板会出现 「桌宠配置 JT」（Q 版小鲸鱼图标）。安装前应自行查看仓库源码与 MIT 许可证；插件以当前 DSH 进程权限运行，与任何社区插件一样，目录站 skillhub.cn 与 DeepSeek / 幻方无官方从属关系。
典型用法¶
在设置页配置¶
- 打开 桌宠配置 JT，在「定时提醒」里添加时刻与提示语，打开总开关与单条启用。
- 在「随机出现/隐藏」里填写四个分钟数并启用；关闭开关则宠物常驻。
- 点击保存，写入
~/.dsh/dsh-pet-jt/main-config.jsonc（JSONC，可手改）。
手改配置文件示例¶
保存时设置页只提交它管理的字段；文件中其它高级字段（如 animations、memes）会原样透传。
{
"reminders": {
"enabled": true,
"tasks": [
{ "id": "r1", "time": "10:30", "text": "该喝水啦，起来动一动～", "enabled": true },
{ "id": "r2", "time": "15:00", "text": "盯屏幕太久啦，看看窗外吧", "enabled": true }
]
},
"visibilityCycle": {
"enabled": true,
"visibleMin": 5,
"visibleMax": 20,
"hiddenMin": 10,
"hiddenMax": 30
}
}
非法值（时刻格式错误、语句为空、时长越界或 min > max）会触发宿主告警并回落内置默认，不会让插件无法启动。
斜杠命令（JT 后缀）¶
与桌宠交互可使用 /petjt、/chatjt、/balancejt（全局命令表需与原版区分，故带 jt 后缀）。
适用场景与注意¶
适合： 已在用或打算用 DSH 桌宠，且需要到点气泡提醒、或希望宠物按分钟级随机显隐而不丢 overlay 状态；需要与原版 dsh-pet 各养一只、两套设置并行的情况。
注意：
- 提醒精度为「分钟」，宿主约每 15 秒对表；未运行期间不补发。
- 桌面端隐藏是窗口级；若从托盘强制唤醒，下一次到点仍按配置继续循环。
- 社区目录页星标等元数据以站点展示为准；功能细节以 GitHub README 为准。
结尾¶
dsh-pet-jt 在保留上游桌宠全套能力的前提下，用同一套对话气泡做定时提醒，并用可配置的随机显隐减轻长期占屏感；与原版命名与数据目录完全隔离，可共存。进一步了解可访问社区目录 jtsinlio/dsh-pet-jt 与源码仓库 github.com/jtsinlio/dsh-pet-jt。
