# 更新日志

本文件记录零号工具的版本演进。**README 只描述当前状态** —— 想了解「现在能用什么」看README，
想查「某个功能是哪一版加的、为什么这样改」看这里。

各版本的安装包与说明见 [Releases](https://github.com/ai-yukin/dsh-0-tools/releases)。

---

## v1.16.3

**换完讯飞新 Key 后，设置页那个「已下线提醒」红框会自动撤掉。**

此前红框的显示条件是「你有没有配讯飞」，而你换完新 Key 之后这个条件依然成立 ——
红框继续醒目地挂着，很容易让人以为没换成功，反反复复去换。
现在改为比对配置里实际使用的模型：仍是旧模型才提醒，已是新模型就撤掉，
并给一行「讯飞星火模型已经完成更新」。

**同时整理了设置页的信息结构**：

- 「小白帮助中心」与「关于」两块合并为一张卡片（两者回答的是同一类问题，
  拆开要来回滚，版本号还在两处各显示一次）；
- 帮助中心改为单块排版：项目 / 版本 / 作者 / 公众号 / 反馈一行，
  下方是DSH 官方资料与API Key 备份；
- 新增「关注作者公众号」，点开显示二维码；
- 「精选资料」改名「工具资料」，只保留仓库与反馈入口。

## v1.16.0

**讯飞星火已换新模型，老用户请给原来的 Key 授权一次（约 2 分钟）。**

讯飞下架了原先的免费模型 Spark Lite，现在可用的是 **Spark-X2.5-1.7B**（1M 上下文，0 元/百万 tokens）。
**新旧是两套互不相通的密钥体系**，插件无法自动改写你的配置 —— 需要你手动去官网授权一次再把新 Key 粘回来。

**完整图文教程（含两种用户的分流判据）**：
[老用户升级教程](https://ai-yukin.github.io/dsh-0-tools/guide/xinghuo-upgrade.html) ·
[新用户申请教程](https://ai-yukin.github.io/dsh-0-tools/guide/xinghuo.html)

**三步搞定（老用户）**：

| 步骤 | 做什么 |
|---|---|
| 1 | 登录讯飞平台，进入左侧边栏**「模型服务」→「API Key 管理」**，找到你原来那个 Key，点**「授权管理」** |
| 2 | 在弹窗里只勾 **`Spark-X2.5-1.7B`**，点**「确认授权」** |
| 3 | 回到列表，点那一行的**「复制」**，把 `ak-` 开头的 Key 粘回配置中心 |

⚠️ **别勾成 `Spark-X2.5`（293B）** —— 那个**要收费**（输入 0.96 元 / 百万 tokens）。
免费的是 `Spark-X2.5-1.7B`，授权列表里两者紧挨着，很容易点错。

> 已照旧教程做过一次也不必回滚 —— 多授权一个模型不会有问题，直接勾上即可。

> v1.16.0 未改动 DSH 兼容范围（仍是 `0.1.5` ~ `0.2.x`），v1.15.0 及之前的能力全部保留。

## v1.15.0

**把「需要换 Key」这件事直接说出来。**

老用户本地仍配置着已下架的讯飞模型，但插件不会自动改写你的配置，界面上也不会主动提示 ——
于是自动路由默默绕开它，一切「看起来正常」，你实际一直没在用那个模型。

这一版补上了三层提示：页脚的「有新版」角标**直接写明要点**（不再是光一个版本号）；
配置中心对仍配置着讯飞的用户显示**红框**并给出「去看更新教程」按钮直达教程页；
教程按**新用户 / 老用户**拆成两页，对号入座即可（老用户约 2 分钟，不必重新注册、不必重建 Key）。

> v1.15.0 未改动 DSH 兼容范围（仍是 `0.1.5` ~ `0.2.x`），v1.14.0 及之前的能力全部保留。

## v1.14.0

讯飞星火的免费模型 `Spark Lite` **已被官方下架**（感谢 [Issue #2](https://github.com/ai-yukin/dsh-0-tools/issues/2) 的反馈），现改用当前免费的 **Spark-X2.5-1.7B**（1M 原生上下文，0 元/百万 tokens）。

| 变更项 | 内容 |
|------|------|
| **模型** | `Spark Lite`（已下架） → **`Spark-X2.5-1.7B`** |
| **接口地址** | → `https://maas-api.cn-huabei-1.xf-yun.com/v2` |
| **模型 ID** | → `spark-x2.5-1.7b` |
| **Key 格式** | → `ak-` 开头的单字符串（不再是 `APIKey:APISecret` 冒号拼接）。插件已能自动识别，**直接粘贴新 Key 即可** |
| **能力分排序** | 按新模型的真实能力重排（讯飞调至智谱之后、硅基流动之前，硅基流动上调），**自动切换会按新顺序选模型** |

⚠️ **已配置过讯飞星火的老用户请注意**：插件**不会自动改写**你的本地配置，
因为新旧是两套互不相通的密钥体系，需要你手动换一次 Key（约 2 分钟）。
在换好之前，自动路由会把这个不可用的讯飞绕开 —— **界面看起来一切正常，但你实际一直没在用讯飞**。

> v1.14.0 未改动 DSH 兼容范围（仍是 `0.1.5` ~ `0.2.x`），v1.13.0 与 v1.12.0 的能力全部保留。

## v1.13.0

围绕**「零中断」「零遗忘」**两个方向。

| 能力 | 说明 |
|------|------|
| **零中断：切换时说清原因** | 当前模型额度耗尽 / Key 被拒 / 超时 / 限流 / 服务端报错时，自动切到综合最优的可用模型，并明确告诉你**原来用的哪个、为什么不能用、切到了哪个**。提示从10 秒延长到 60 秒——旧版 10 秒用户根本来不及看到。 |
| **零遗忘：切换记录跨重启保留** | 每次自动切换都记一笔（含时间、原因、走向），配置中心可查最近 10 条，一周内有效。免费模型常见「早上好用、下午耗尽」，你需要知道**今天被切过几次、该给谁补额度**，而不是只看到一个转瞬即逝的浮层。 |
| **零遗忘：自动路由默认开启** | 以前要手动去设置里点一下才有，现在新用户默认生效，且配一次性说明告诉你为什么开、怎么关。**明确点过「手动切换」的老用户保持关闭**——你的选择不会被默认值推翻。 |
| **零遗忘：异常不再自愈式静默** | 切换后给出可操作的下一步（去配置中心重新测速），而不是只报告一个既成事实。 |

> v1.13.0 未改动DSH 兼容范围（仍是 `0.1.5` ~ `0.2.x`），也未改动测速判定口径。
> v1.12.0 的五项能力（版本检查、测速持久化、写入回滚、异常兜底、DSH 版本展示）全部保留。

## v1.12.0

| 能力 | 说明 |
|------|------|
| **自动检查新版本** | 插件会远程比对最新版本号，出新版时在页脚显示「⬆ 有新版 vX.X.X」角标，点击直达Release 页，并列出本次更新要点。点「✕」可对当前版本不再提醒；**出了更新的版本会重新提示**。全程无弹窗强推，升级与否由你决定。 |
| **测速记录重启不丢** | 测速历史（最近 5 次延迟样本）落盘保存，重开DSH 后直接复用，不再每次从零开始等。保存 24 小时后自动作废——免费模型的额度状态按天变，隔天的结论不作数。 |
| **配置写入失败自动回滚** | 接入免费模型是「写凭据 → 写 provider 配置 → 切默认模型」三步。若中途失败，会自动把已写入的配置恢复原样并明确告知，不会留下「配了一半」的残留状态。 |
| **全局异常兜底** | 插件内任何异常都会被捕获、按 60 秒限频记录到控制台（`[dsh-0-tools]` 前缀）并存一条上下文到本地。**不会吞掉错误**，DSH 自身的错误上报不受影响。 |
| **显示 DSH 版本号** | 「关于」卡片新增「运行环境」一行，显示实际运行的 DSH 版本与已验证支持范围，排查兼容性问题时省掉一轮来回。 |

> **关于「提示升级 DSH」**：本插件只通告**零号工具自己**的新版本。
> DSH 是 DeepSeek 官方上游软件，插件无权、也无立场要求你升级上游。
> 当前 `v1.12.0` 已同时支持 DSH `0.1.x` 与 `0.2.x` 两代——**你不需要为了用本插件而升级 DSH**。