# 鲸鱼挂件完整功能验收

参考版本：MeteorNOX/DeepSeek-Balance-Whale-Widget `fce34e3abd1fe8b616e287b9864305c7f0be81a0`。目标宿主是 Codex++；DSH 的会话、凭据和账单数据接到 Codex++ 对应服务。

原版界面引擎保留独立原始文件，Codex 适配从生成脚本产出；关闭和重复注入的清理由宿主运行时负责。以下功能已接入。自动化覆盖生命周期、保存后读回、真实媒体资源、事件去重、定价、用量和账本；浏览器验证覆盖菜单、音效试听、波形裁剪、角色/GIF导入、泡泡编辑、吸附和历史翻页搜索。

| 功能 | 验收内容 | 状态 |
| --- | --- | --- |
| 原版角色与气泡 | 相同原图、气泡路径、比例、按压底部固定、回弹、镜像文字正向 | 已实现 |
| 主菜单 | 角色、尺寸、音效与提示、泡泡、滚动条避让、吸附、隐藏菜单、资源管理、版本 | 已实现 |
| 四边吸附 | 比例/像素区域、角落组合、自由摆放、翻转线、窗口缩放后恢复 | 已实现 |
| 触摸与快捷入口 | 触摸拖动、右键、长按约1.5秒、透明区域穿透 | 已实现 |
| 点击泡泡 | 首次/再次队列、排序、角色推进、加权并列、随机不连续重复 | 已实现 |
| 泡泡模块 | 文本/超链接、随机文本、图片/GIF/随机图、实际数据模块 | 已实现 |
| 泡泡排版 | 最多6行/行6模块、拖入/合并/拆分/排序、触屏长按 | 已实现 |
| 模块样式与库 | 字体、字号、粗斜线、颜色/渐变/背景、自定义字体、悬浮编辑、另存复用 | 已实现 |
| 按压/松开音 | 原版小黄鸭和音效1、同步预热解码、可调衔接、独立静音槽 | 已实现 |
| 任务/提问/授权音 | 原版经验球与A、独立事件开关/音量/试听、相同挂起去重 | 已实现 |
| 音效设置事务 | 保存生效、取消还原、恢复默认后取消仍还原、全局/事件音量 | 已实现 |
| 音频资源 | 导入、波形裁剪、试听、重命名、音效组自由组合、受保护内置资源 | 已实现 |
| 角色库 | 上传、裁剪/缩放/翻转、命名、固定角色、回退默认、资源删除 | 已实现 |
| 泡泡图库 | 原版petpet/money1、上传PNG/GIF、模块选图、随机图片 | 已实现 |
| 提醒内容 | 低余额、每日预算、每轮完成、提问、授权的模块化内容与自动关闭 | 已实现 |
| 降级提醒 | 关闭泡泡时居中卡片仍显示图片/随机模块，静音与显示独立 | 已实现 |
| Codex会话 | 当前轮真实token、模型、状态、会话名、当前窗口原生事件 | 已实现 |
| 全机用量 | 今日、7天、本月、累计、模型占比、逐日/逐轮记录、搜索、图表 | 已实现 |
| 本机费用估算 | 用户单价、缓存输入单独计价、币种/汇率，未知价格不冒充实际账单 | 已实现 |
| 订阅/资源包 | 日志真实5小时/周快照、来源时间、窗口倒计时、手动/自动额度基准 | 已实现 |
| 多供应商 | 原版模板及自定义HTTP、profile凭据复用、余额/quota多窗口、探活 | 已实现 |
| 账户记账 | 固定8位精度、余额下降/到账独立记录、跨日持久、近7天历史 | 已实现 |
| 余额校正 | 待核对、累计到账/非调用扣减、revision冲突保护、口径与本机费用分开 | 已实现 |
| 峰谷模块 | 保留配置与显示，只为有对应价目/时段的供应商使用，Codex不套用其他供应商价格 | 已实现 |
| 持久化与清理 | 配置/资源读写可见失败、旧偏好迁移、关闭无轮询/监听/音频残留、重复注入唯一实例 | 已实现 |

没有真实usage/订阅/余额或单价的数据以未观测/未配置显示；不使用测试数值作为产品数据。

验证材料：`whale-widget.test.ts`、`full_whale_contract.rs`、`whale_full` / `whale` 单元测试、`whale_history` 用量测试以及浏览器本地测试页。供应商协议使用合成 HTTP 响应校验，未连接用户账户；实际余额与额度取决于所选供应商提供的数据。

Codex 宿主适配：凭据通过已有供应商配置复用；原版 DSH 登录态由 Codex++ 的对应供应商配置代替。当前远程会话不读取相同 ID 的本地日志，全机统计明确为本机来源。