@zhou05/dsh-whale-appearance 0.2.3 · 大肥鱼外观

0.2.3 修复 0.2.2 遗漏的设置面板注册，沿用 DSH 原生配置保存和版本检查。下述设置界面实现已通过本机实际保存及重启保留验收。

DSH Desktop 0.2.0-rc.2 原生侧栏外观插件。包括空闲/工作/等待动画、12 套空闲动作轮播、16 方向鼠标跟随和带冷却的眩晕反应；真实任务状态优先。所有图像已嵌入，运行时不依赖原机器路径或外部图片网站。

0.2.2：眩晕放宽到约两秒转一圈，保留防误触、冷却和持续转圈不重复触发。空闲动作包括拿电脑、伸懒腰、打瞌睡、玩球、照镜子、玩魔方、打游戏、吃零食、吃冰淇淋、撸猫、拆礼物、害羞；随机洗牌，每轮不重复。无鼠标互动且空闲约 4.5 秒后开始（鼠标跟随归位另需约 3.2 秒），动作间歇 5–9 秒。工作、等待确认和启用的鼠标反应优先；关闭动画或系统减少动态效果时不轮播。

在 DSH“插件 → 添加插件”中填写 @zhou05/[email protected]，安装源可选 npm 官方源；也可填写已下载 .tgz 的完整绝对路径。当前 DSH 0.2.0-rc.2 尚不支持自动更新或同名覆盖安装：升级时先备份配置、卸载旧版，再安装新版并按提示重启。

设置入口：“插件 → @zhou05/dsh-whale-appearance → 包含的组件”，点击组件名称旁的箭头。可调整显示名称、宽度（72–144 像素）、动画、鼠标跟随、眩晕和状态文字；点击“保存”后生效，离开页面会放弃未保存的修改。默认维持原有“大肥鱼”、128 像素与全部交互。使用 DSH 原生设置表单、持久化和版本检查，不另建配置存储。

如果已有旧名 dsh-whale-sidebar，先备份配置，在插件管理中停用/移除旧包并按提示重启，再安装本包。 新包名不是同名升级，不要同时启用两者。内部 whale-sidebar 配置 ID 保持不变；对照备份核对原有设置。

占用侧栏品牌图标/名称槽位，并注册本插件组件的配置面板；覆盖仅限官方品牌组件。卸载后由宿主重新显示官方组件，必要时正常重启。保留点击品牌新建会话的原有行为。

没有模型调用、聊天读取、记忆写入、自定义工具或安装脚本。安装此插件不修改系统图标或应用文件；本 npm 包内附 WINDOWS.md 和 windows/Set-DSHWhaleIcons.ps1。Windows 图标替换与恢复必须手动运行，默认仅检查，明确加 -Apply 才修改已核验资源。无需该功能时不要运行工具。

仅验证当前宿主版本。升级宿主前应检查原生槽位、配置镜像及侧栏结构兼容性。素材由 Codex 的 imagegen 技能生成；分发范围与非官方声明见 ASSET-NOTICE.md。