前言¶
在 DeepSeek Harness（DSH）里做日常开发时，余额、用量和高峰时段往往分散在别处查看；若还想在客户端启动时有一点仪式感，又要兼顾交互气泡和记账类能力，通常得自己拼前端资源与路由。Cyrene Balance Widget 把开场动画、按时段问候语音、贴纸气泡和余额面板收进一个 DSH 插件包，并在 dsh-whale-widget 0.4.2 之上扩展角色与台词。下面介绍它是什么、能做什么，以及如何按官方说明安装与定制。
这是什么¶
Cyrene Balance Widget（npm 包名 dsh-cyrene-whale-widget，当前资料版本 2.1.0）由 sailina-afk 维护，在 SkillHub 目录中归类为 趣味换装。它面向 DSH 客户端：启动时播放全屏开场动画，淡出后延迟播放问候语音；界面内提供内置 Cyrene 精灵、随机台词、九张贴纸独立交互气泡，以及余额 / 消费 / 高峰时段等面板能力（记账、音效、吸附、气泡编辑等由上游 dsh-whale-widget 提供）。
核心功能¶
客户端启动流程（2.1 动画版）¶
| 环节 | 说明 |
|---|---|
| 开场动画 | 全屏 assets/loading.mp4（2560×1440，H.264，60fps，约 20 MB，时长约 13.9 s），object-fit: cover |
| 音频 | 原声轨满音量；动画最后 2.2 s 线性淡出，声画同长 |
| 退出 | 遮罩 900 ms 淡出，页面自然显现 |
| 问候 | 淡出结束后 2.5 s 播放一条问候语音（见下表），每次启动仅一条 |
| 交互约束 | 无跳过按钮、不请求全屏、不隐藏窗口按钮 |
| 降级 | 有声自动播放被拦则静音重试；2.6 s 内未播放则跳过；20 s 硬结束 |
问候语音规则（资料原文，互斥，只播一条）：
- 05:00–09:59：早晨档
- 11:00–13:59：中午档
- 18:00–03:59：傍晚档（该时段内 50% 播傍晚、50% 随机）
- 其余时间：三条随机问候之一
常驻组件行为¶
- 角色：内置 Cyrene 精灵（610×610，透明底，底对齐）
- 台词：25 条随机展示，字号 6/7/8/9
- 点击：第一次打开 balance 面板；再次点击随机台词，或约 1/3 概率出现独立 贴纸气泡（9 张
meme-01~09.png） - 与无动画版共用
/dsh-whale/*路由及$DSH_HOME/.dshw-*.json，同一时刻只能启用其中一个（无动画包：../no-animation/，包名dsh-cyrene-whale-widget-noanim）
安装与启用¶
官方 README 未给出 dsh plugin add github:... 一类命令，安装方式为通过 plugin_manager 的 install_bundle，并将 target 设为该插件目录的绝对路径。
操作含义：在 DSH 插件管理流程中安装 bundle，指向本仓库（或解压后的）cyrene-balance-widget 目录根路径。具体菜单或 CLI 字段名以你当前 DSH 版本的 plugin_manager 文档为准。
安装前建议：插件以 当前 DSH 进程权限 运行，应自行阅读仓库源码与 MIT 许可证（上游说明见 LICENSE、README.upstream.md）。
典型用法与定制¶
日常使用¶
- 启用插件后正常启动 DSH 客户端，观看全屏开场（若环境阻止有声播放，会按上述降级逻辑处理）。
- 动画结束后等待约 2.5 s，听取当次选中的问候语音。
- 点击 Cyrene 精灵：先查看余额相关面板；继续点击切换随机台词或贴纸气泡。
可复制定制路径（来自 README）¶
台词：右键组件 → 气泡设置；或改 assets/whale-widget.js 中的 BUBBLE_DEFAULT_ITEMS；批量可用 tools/set-lines.py。
字号：编辑 tools/resize-lines.py 的 SIZE_MAP 后重新运行。
问候音频：替换 assets/morning.mp3、noon.mp3、evening.mp3、rand1-3.mp3。
贴纸：替换 assets/meme-01~09.png；ID 在 lib/index.js 的 DEFAULT_BUBBLE_IMGS 注册。
开场视频：替换 assets/loading.mp4（建议 H.264 以兼容更多环境）。
适用场景与注意¶
- 适合：希望在 DSH 里常驻 DeepSeek 余额/消费/高峰信息，并接受 Cyrene 主题开场与气泡互动的开发者或个人环境。
- 不适合：需要可跳过开场、或必须与另一 Cyrene/Whale 动画包同时启用的场景（路由与状态文件冲突）。
- 资源体积：开场视频约 20 MB，弱网或容器镜像需自行权衡。
- 归属说明：SkillHub 等为社区目录，与 DeepSeek / 幻方无官方从属关系；星标与版本以仓库与目录页为准（资料中 GitHub 星标为 0）。
结尾¶
Cyrene Balance Widget 2.1 把全屏开场、时段问候、九张贴纸气泡和 whale 系余额面板绑在一个 DSH bundle 里，定制入口集中在 assets 与 tools/ 脚本。进一步了解可访问目录页与 GitHub 仓库：
- 目录页：https://www.skillhub.cn/plugins/sailina-afk/cyrene-balance-widget
- GitHub：https://github.com/sailina-afk/cyrene-balance-widget
