# 更新日志

本文件记录每个版本的变更。版本号遵循语义化版本（`主.次.修订`）。

## [1.0.0] - 2026-10-21

首个公开版本。

### 新增

- **三种状态的提醒**：完成 / 异常 / 等待回答，各有独立的开关、文案、音频。
- **屏幕级通知**：走系统通知，窗口最小化或你在别的应用里时也能看到。刻意不使用页面内浮层——那种浮层最小化时恰好看不见，而这正是提醒最该出现的场景。
- **任务栏角标**：显示"有几个对话完成但你还没看"，仅当该对话在屏幕上且窗口聚焦时才消一个。
- **声音三选一**：内置提示音（开箱可用）/ 文字转语音 / 自定义音频片段，音频可按角色分组、按状态分别指定。
- **10 类错误分类**：认证、额度、限流、服务端、连接、地址或模型、返回异常、上下文超限、请求被拒、其他。每类可自定义朗读文字，并带独立试听按钮。
- **异常原因取自会话自身**：读会话的 `turn/end` 记录，与你在会话里看到的是同一句话，而不是插件另行猜测。转发事件仅用于判定"是否失败"。
- **中英双语**：界面文字与朗读语言都跟随 DSH 的界面语言；朗读文字与语言留空即自动跟随。
- **打包元数据**：`icon.svg`、`locale/*.json` 的标题与描述、`repository`/`homepage`/`bugs`。
- **兼容性门**：`peerDependencies` 声明 DSH `>=0.2.0-rc.2 <0.3.0`，不匹配时 DSH 会明确提示并给出豁免入口，而不是静默失效。
- **CI**：GitHub Actions 在 Node 20 / 22 上跑语法检查、打包审计与行为测试。

### 修复

- **登录过期被误报为"已完成"**：`aborted` + `hook` + `deepseek-account/signed-out` 这个中止原因，会话本身会渲染为失败行，插件原先却报成完成。该分支不触发 `api-session/error`，原先无法被发现。
- **零延迟朗读时新提示无法取消旧提示**：`ttsLeadMs=0` 分支用 `setTimeout` 却没有记录句柄，连续两次提醒会先后念出两句。
- **可能把上一轮的旧错误当成这次失败**：日志读取现在按事件时间戳约束，滞后送达的旧 `turn/end` 不再被采信。

### 变更

- 朗读的默认文字与默认语言改为"跟随界面语言"，不再写死中文。已保存的旧配置**不受影响**（有测试覆盖）。

### 说明

- `private: true` 与 `@local/` 作用域是 DSH bundle 的本地约定，因此本包不发布到 npm 注册表，通过 Git 仓库分发。