前言¶
DeepSeek Harness（DSH）採用插件化架構，通過擴展組件豐富 Web GUI 的功能。dsh-pet-liangzi 是其中一款桌面寵物插件，它爲界面增加了一個擬人化的角色形象。該插件旨在通過交互式動畫和語音反饋，緩解長時間使用工具的視覺疲勞，同時提供一種輕量級的個性化體驗。
插件定位¶
- 名稱：dsh-pet-liangzi（樑子桌面寵物）
- 維護者：bauerelizabeth07139
- 分類：趣味換裝
- 許可證：MIT
- 定位：一個自包含的桌面寵物，無需網絡請求或外部服務即可運行。它包含 16 種繪製的角色狀態、物理交互效果、語音對話以及跨插件的聯動能力。
核心能力¶
該插件的核心價值體現在動畫細節、交互反饋與生態聯動三個方面。
1. 動畫與物理表現¶
- 16 種繪製的狀態：角色擁有包括待機、眨眼、行走（左右腳交替）、歡呼、說話、思考、比心、難過、生氣、驚訝、睡覺、揮手、「噓」手勢在內的 16 種獨立姿態。這些姿態通過圖像生成技術保留原作細節，僅改變動作。
- 三幀走動循環：實現了真實的角色走動效果，包含接觸、過步、接觸三個幀，地面速度由步頻決定，而非自由設定，確保雙腳與地面的貼合。
- 物理交互：支持重力、擠壓與拉伸等物理效果。被拖拽時，角色會跟隨拖拽方向；鬆開後會受重力下落，落地時伴隨擠壓和閃光粒子效果。
2. 交互與自主行爲¶
- 環境感知：角色會自動監測鼠標指針位置，靠近時轉頭注視。
- 自主微動作：在無人交互時，角色會隨機進行思考、「噓」手勢、歡呼、比心或生氣的自發性動作。
- 反應機制：點擊角色可喚醒並觸發對話；快速連續點擊 3 次會讓角色感到惱火。
3. 跨插件聯動¶
- 父女聯動：當同時安裝
dsh-pet-dafeiyu（大肥魚）插件時，兩者會產生互動。它們會互相問候、搭話，並在設定中開啓「父女小劇場」時共同演一段共享的交互場景。
4. 音頻與資源¶
- 語音對話：所有臺詞均包含預渲染的語音和字幕氣泡。
- 獨立音軌：對話語音、音效和背景音樂均設有獨立的開關和音量控制。
- 資源獨立性：所有素材（精靈圖、音頻文件）均打包在插件包內，不依賴 CDN 或外部網絡服務。
安裝與啓用¶
安裝過程需要使用 DSH 的命令行工具。請確保已安裝 DSH 並配置好 desktop profile。
安裝命令¶
在終端中執行以下命令以安裝插件：
dsh plugin --profile desktop add bauerelizabeth07139/dsh-pet-liangzi
啓用插件¶
- 安裝完成後，在 DSH 的插件管理頁面啓用
dsh-pet-liangzi。 - 進入 設置 → 桌寵 · 樑子。
- 根據需要調整角色大小、不透明度以及走動、小動作等開關。
無 Git 環境¶
如果在機器上未安裝 Git，直接運行上述命令可能會因 pnpm 無法解析遠程倉庫而失敗。此時需要將 Git 倉庫的 tarball 固定鏈接並使用 HTTPS 下載：
cd "$HOME/.dsh/profiles/desktop"
node /path/to/dsh/runtime/pnpm.mjs add \
"https://codeload.github.com/bauerelizabeth07139/dsh-pet-liangzi/tar.gz/<commit-sha>"
典型用法¶
安裝並啓用後，角色會出現在瀏覽器窗口的底部邊緣。
- 喚醒與對話：點擊角色，它會被喚醒並說出臺詞，同時顯示字幕氣泡。
- 移動與放置：按住角色可以拖拽到屏幕任意位置，鬆開後位置會被記憶。
- 工具欄控制：將鼠標懸停在角色上，會出現工具欄，可快速切換對話語音、音效、背景音樂和顯示開關。
- 閒置休眠：若長時間不與角色互動，它會自動進入睡眠狀態；再次點擊即可喚醒。
- 父女小劇場：在設置中開啓「父女小劇場」，並確保已安裝
dsh-pet-dafeiyu，即可觸發兩者的互動場景。
注意事項¶
- 瀏覽器音頻策略：現代瀏覽器禁止頁面自動播放音頻。在用戶首次點擊頁面或角色之前，界面上會出現 「點一下開啓聲音」 的提示，點擊任意位置後音頻播放纔會解鎖。
- 資源完整性：該插件不依賴任何網絡資源，所有資產均內置，確保離線環境也能正常使用。
結語¶
dsh-pet-liangzi 通過精細的動畫幀和物理反饋，爲 DeepSeek Harness 增添了生動的角色屬性。它不僅是一個視覺裝飾，更是一個具備自主行爲和跨插件聯動的交互組件。對於追求界面個性化或希望爲開發環境增加趣味性的用戶，這是一個實用的補充。
