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