# Changelog

本项目从本机自用版本一路演进到可发布形态，版本号按改动规模重定：`0.9.0` 视为「首个可对外安装的开发版」，仍属 0.x，接口与界面可能继续调整。

## 0.9.6 — 2026-11-03

- **修气泡被窗口顶部裁掉**：鲸鱼可以拖到最上面，播报气泡按实测高度判断朝向 —— 上方装不下就翻到鲸鱼下方，小尾巴与边框跟着翻；常驻小气泡改为垂直居中跟随；余额详情面板也改成按可用空间选上下并限高，不再顶出窗口。
- **发版脚本补 README 同步**：`release.mjs` / `bump-version.mjs` 现在会把 README 顶部的 `badge/version-x.y.z` 一起改（此前每次发版 README 徽章都会落后一版），有残留旧版本号时还会警告。
- [stable] 这一版按正式版发布（GitHub 的 Latest 会指向它）

## 0.9.5 — 2026-11-02

- [stable] 这一版按正式版发布（GitHub 的 Latest 指向它，仓库首页 Releases 卡片可见）
- **天气改成必须填城市**：实测多家 IP 定位服务都不稳（有的 403、有的只给英文城市名、有的直接超时），0.9.4 的「自动定位」等于不可用。现在：设置里没填「天气城市」时，点「今日天气」不会发任何请求，而是托腮思考地问你一句「先告诉我在哪座城市嘛～」，按钮「去填城市」直接跳到小鲸鱼设置分区；在设置里把城市存好后，这一行会给出回执「记好啦～再右键小鲸鱼点一次『今日天气』试试」。宿主 `getWeather` 不再有 IP 定位分支，缺城市时返回 `{ok:false, error:'need-city'}`，IP 定位相关的三个函数已删除。
- **两张新立绘入库**：`assets/whale-greet.png`（挥手打招呼）与 `assets/whale-think.png`（托腮思考），各带 `-128` 小尺寸，由 `tools/make-avatar.py` 去白底导出；`MOOD_FILES` 与 `GET /avatar.png?mood=` 同步支持 `greet` / `think`。
- **开机问候换挥手图**：问候气泡带 `mood:'greet'`，说话期间一直用挥手立绘（轻晃两下就停），气泡收起后回到平静。
- **天气播报换思考图**：点「今日天气」到气泡期间用托腮思考立绘（慢速浮动），失败告警仍走慌张脸。
- **右键菜单悬停反馈**：每个菜单项 hover / focus-visible 时背景变品牌蓝（14% 透明度）+ 文字转品牌色 + 内描边 + 右移 2px + 左侧竖条展开 + 图标放大 1.16 倍并微转，全部 150ms 过渡；`:active` 再加一点回弹缩放。之前只有一层极淡的背景色，深色主题下几乎看不出来。
- README 补：三种新动作对照表、六种立绘、天气必填城市说明、新增设置项与 `/weather` 路由、外部请求清单加入 Open-Meteo。

## 0.9.4 — 2026-11-02

- **左键点击即刷新余额**：点一下鲸鱼（或常驻气泡）直接回源刷新，带醒目刷新动画——脚下发光呼吸 + 外圈 conic-gradient 旋转进度环，右上角角标「刷新中…」带三点跳动，鲸鱼同时轻微放大。
- **防刷频**：新增设置项「点击刷新最小间隔（毫秒）」（2000 ~ 120000，默认 6000）；冷却期内点击只弹角标提示还差几秒，不打余额接口；请求本身还有 `refreshLock` 互斥 + 620ms 最短动画时长，连点不会叠请求。
- **右键菜单**：右键鲸鱼不再有受击动画，弹出菜单——立即刷新余额 / 查看余额详情 / 今日天气 / 打开小鲸鱼设置（底部标注「左键刷新余额 · 右键打开菜单」）。菜单坐标自动避开视口边缘，点空白、Esc、滚动、改窗口大小都会关掉。原「点击弹面板」改为菜单里的「查看余额详情」。
- **今日天气（零 token）**：宿主新增 `GET /api/dsh-ds-whale/weather`，直接走 Open-Meteo 免费接口（不经过模型，不消耗 token）；城市可留空（按出口 IP 自动定位，多源轮询兜底，最后退回系统时区城市），也可在设置里填固定城市 —— **该自动定位已在 0.9.5 移除，改为必须填城市**。10 分钟进程内缓存，只在过期或手动刷新时回源。气泡展示当前温度、今日高低温、降雨概率、未来三小时趋势和出行提示。
- **开机问候**：每次打开 DSH，按设定的昵称主动打招呼（六档时间段话术，中英各一套），复用每轮播报的同一套形象与提示音；设置里可关（「打开 DSH 时打招呼」）。
- **设置页新增三项**：点击刷新最小间隔、打开 DSH 时打招呼、天气城市。
- 打开设置面板走 `slots.entries('sidebar.settings')` 拿到设置 shell 的单例 store 句柄调用 `openSection('dsh-ds-whale')`，直达小鲸鱼分区；拿不到句柄时退回模拟点击侧边栏设置入口。

## 0.9.3 — 2026-10-31

- README 校订 + 两张立绘素材入库（试用发版流程）

## 0.9.2 — 2026-10-31

- 修复左边气泡被裁

## 0.9.1 — 2026-10-31

- 修复挂件吸附到左侧时播报气泡溢出屏幕左侧被裁（气泡改为按侧翻转到挂件内侧，宽度按视口兜底）

## 0.9.0 — 2026-10-31

发布准备版（首个公开可安装版本）。

- **双语界面**：新增「界面语言」设置（跟随系统 / 中文 / English）。英文模式下挂件、气泡、播报台词、设置页全部为英文；默认按浏览器/系统区域自动选择。
- **设置页**：插件设置正式挂进 DSH 设置左侧导航（`小鲸鱼 / Whale`，位于「喵记忆」下方），13 项配置全部由设置页管理，写入 profile 的 `cordis.patch.yml`。
- **拟人播报**：每轮结束后以角色口吻播报本轮消耗（按金额分 5 档文案），需点「知道啦~/Got it~」手动关闭；支持自定义昵称。
- **四状态立绘**：平静 / 气鼓鼓（点击受击）/ 脸红（说话）/ 慌张（余额告警），320ms 交叉淡入 + 各状态专属小动作。
- **余额告警**：低于预警线时换慌张立绘并播报，带「去充值 / 知道啦」按钮。
- 版本号、`repository` / `homepage` / `keywords` / `license` 等发布字段就位。

## 0.8.0 — 2026-10-31

- 设置从挂件面板整体搬到 DSH 设置页；挂件面板只留余额与记录。
- 受击动画改为 `pointerdown` 立即触发，连续点击可重放。
- 播报与告警改为可持久展示（不再自动消失）。

## 0.7.0 — 2026-10-31

- 接入 DeepSeek 官网用量接口（`/api/v0/usage/by_api_key/{amount,cost}`），今日用量的金额 / 请求数 / tokens 与官网用量页同源。
- 面板主数字改用官网口径，并保留「余额差观测 + 本机估算」作为对照。

## 0.6.0 — 2026-10-31

- 新增说话 / 告警两套立绘与情绪动画。
- 播报框重做（296px 卡片、右上角标签、胶囊按钮、指向尾巴）。

## 0.5.0 — 2026-10-31

- 形象改用 PNG 立绘（去白底），支持 `mood` 参数；静态资源加 ETag，换图即时生效。
- 拖拽吸附改为按页面中线判定左右。

## 0.4.0 — 2026-10-31

- 昵称、拟人播报、点击换表情首版。

## 0.3.0 — 2026-10-31

- 余额取数三层兜底（启动退避重试 / 20s 保活 / 请求时自愈），修掉宿主重启后常驻 `no-credentials-service` 的问题。

## 0.2.0 — 2026-10-31

- 常驻参数气泡、可自定义显示项、初始尺寸调整。

## 0.1.0 — 2026-10-31

- 首个能跑的版本：右下角浮动挂件、余额展示与刷新、今日已用、每轮消耗、峰谷定价与倒计时、拖拽吸附、用量记录。