前言¶
在 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 與 目錄頁。
