前言¶
在 DSH 裏跑 dsh-pet 桌寵時,角色素材是烘焙好的 webm 視頻,眼睛畫在像素裏,沒有單獨瞳孔圖層。若希望「看光標」而不是固定朝向,改素材或 fork 桌寵成本都偏高。dsh-bigfeiyu-focus 以獨立插件形式,在網頁側給大肥魚加一層帶透視的 3D 轉頭與視差位移,不修改 dsh-pet 倉庫裏的任何文件。下面介紹它做什麼、怎麼裝、以及使用前必須滿足的前提。
這是什麼¶
dsh-bigfeiyu-focus(社區目錄分類:趣味換裝)由維護者 panchalkmetkh249-alt 發佈,當前 package.json 版本爲 0.1.1,許可證 MIT。
一句話定位:鼠標在哪邊,魚頭就朝哪邊轉;鼠標長時間不動時,魚會緩慢、不同步地左右「東張西望」。卸載插件後桌寵行爲與未安裝時一致——插件只在頁面裏追加自己的樣式表,卸載時一併移除。
核心功能¶
效果與 README 中的對照表一致,要點如下:
| 操作 | 反應 |
|---|---|
| 鼠標在魚的左 / 右 | 整條魚繞 Y 軸轉向(帶透視,非平面翻轉) |
| 鼠標在魚的上方 / 下方 | 抬頭 / 低頭,並朝光標方向輕微位移 |
| 鼠標靜止 2.8 秒以上 | 進入「東張西望」 |
| 拖動魚 | 姿態立刻回正,鬆手後重新跟隨 |
| 系統開啓「減少動態效果」 | 自動關閉全部旋轉,保持靜止 |
跟隨帶阻尼:每幀朝目標角度追一段,停下時有輕微鬆弛感,不是硬貼光標。
實現上,引擎不修改 dsh-pet 的 inline style,只往 <head> 追加樣式,並對每個 .dsh-pet-root 寫入 CSS 變量(--bfy-rx、--bfy-ry、--bfy-tx、--bfy-ty),在根節點上疊加 perspective 與 rotateX / rotateY / translate3d,避免與 dsh-pet 在視頻元素上寫的 scaleX(-1) 等變換衝突。
依賴:必需已安裝 dsh-pet;未裝桌寵時插件不報錯,只是無效果。邏輯運行在 DSH 的 Web 界面(dsh web 或官方桌面客戶端的瀏覽器半區)。
安裝與啓用¶
前提(必讀)¶
大肥魚的「顯示位置」必須包含網頁。若爲「僅桌面」模式,寵物在獨立 Electron 窗口裏,網頁側拿不到它,本插件不會有任何效果。
做法:右鍵大肥魚 → 顯示位置 → 「僅瀏覽器」或「兩者都顯示」(改完立刻生效,無需刷新)。變成網頁裏的那隻之後,它只活在 DSH 窗口內,不再浮在桌面——這是 dsh-pet 兩種模式的固有區別,不是本插件單獨造成的。
Web 環境(dsh web,web profile)¶
從 GitHub 安裝:
dsh plugin --profile web add github:panchalkmetkh249-alt/dsh-bigfeiyu-focus
本地目錄安裝(改代碼後硬刷新即可驗證):
dsh plugin --profile web add link:D:\你的路徑\dsh-bigfeiyu-focus
裝完通常會觸發一次頁面刷新;若無反應,先 Ctrl+F5 硬刷新,仍無效再重啓宿主或完全退出桌面客戶端重開。瀏覽器半邊的代碼隨頁面加載,只重啓宿主而不刷新頁面不會生效。
官方桌面客戶端(desktop profile)¶
桌面端不要用 dsh plugin --profile web。在會話裏讓 DSH 用內置的 plugin_manager 安裝本地目錄 <本倉庫絕對路徑>,或安裝:
github:panchalkmetkh249-alt/dsh-bigfeiyu-focus
(具體話術以 README 爲準:請用 plugin_manager 安裝並告知結果及是否需要重啓。)
卸載¶
Web profile:
dsh plugin --profile web remove dsh-bigfeiyu-focus
桌面端在插件管理裏停用或移除本 bundle。
典型用法¶
安裝並完成「顯示位置」設置後,無需額外配置項:在含大肥魚的 DSH 網頁裏移動鼠標即可觀察轉頭與位移;靜止約 2.8 秒可看閒置動畫;拖魚時姿態回正。
若要更含蓄或更誇張,可改倉庫 client.js 頂部常量(README 寫明:最大偏航 9°、俯仰 6°、位移 4px、阻尼 0.16、閒置 2.8s)。改 client.js 後硬刷新頁面;改 package.json 或 patch 需重裝或重啓。
適用場景與注意¶
適合誰:已在 DSH 中使用 dsh-pet,且願意讓大肥魚出現在瀏覽器半區或「兩者都顯示」,希望增加鼠標跟隨與閒置環顧,又不想改桌寵本體代碼的開發者。
兼容性:插件認 dsh-pet 的穩定類名 .dsh-pet-root、.dsh-pet-hit.dragging。若 dsh-pet 大版本改了 DOM,跟隨會靜默失效,不影響桌寵本身。
安全與權限:插件以當前 DSH 進程權限在頁面中注入腳本與樣式;安裝前建議閱讀 GitHub 倉庫 源碼與 MIT 許可證。DSH 社區插件目錄爲獨立站點,與 DeepSeek / 幻方無官方從屬關係。
若你需要 Live2D 式「只動眼珠」,需要 dsh-pet 提供眼睛錨點或分層素材,不在本插件範圍內。
結尾¶
dsh-bigfeiyu-focus 用獨立 bundle 給大肥魚補上視線跟隨:3D 轉頭、視差位移、阻尼與閒置環顧,且與 dsh-pet 解耦。目錄頁:skillhub.cn/plugins/panchalkmetkh249-alt/dsh-bigfeiyu-focus;源碼與完整說明:github.com/panchalkmetkh249-alt/dsh-bigfeiyu-focus。