前言¶
在 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。
