# 变更记录

本项目的所有值得注意的变更都记在这里。格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，
版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。

[English](CHANGELOG.md)

## [0.2.1] — 2026-10-17

### 修复

- **npm 包页显示的是中文 README**。npm 按 glob 取第一个 `README.*` 匹配，而 `README.zh.md`
  排序在 `README.md` 之前，于是中文版被选中。中文版改名 `README_zh.md` 后不再匹配
  `{README,README.*}`，npm 必然选到英文的 `README.md`。取代 `0.2.0`，无代码改动。

## [0.2.0] — 2026-10-17

### 新增

- **`↻` 换一条**：输入框建议右侧新增按钮，点一下让模型给出不同的建议
- **`Alt+→` 逐段采纳**：一次填一小段（中文 2 字 / 英文 1 词），剩下的继续浮动，随时可停
- **设置页「高级」新增两项**：上下文预算（`maxChars`，1000–20000 字符）与输出上限（`maxTokens`，16–512 token）
- **设置页新增「上次预测」状态行**：时间、所用模型、耗时，以及是否自动降级了思考档位 / 换过一条，失败时直接显示原因
- **界面中英双语**：跟随 DSH 的「设置 → 语言」**即时切换**，无需刷新。覆盖客户端全部文案（设置页、ghost 上的提示）与 **Host 端返回的校验错误 / 预测失败原因**
- `GET /status` 支持 `?sessionId=`，回传该会话实际使用的模型
- 接口新增可选请求头 **`x-dsh-locale`**（`zh` / `en`），决定错误原因用哪种语言返回
- 客户端渲染冒烟测试（`test/client-render.mjs`，18 项）：用极简 React 替身把组件树展开后断言

### 变更

- 设置页「思考深度」下拉改为按**会话实际使用的模型**生成（此前按全局默认模型，两者不同时用户可能选到不被支持的档位）
- 每轮辅助调用次数：默认仍为 **1 次**，仅在「档位需降级」或「建议撞车需换一条」时多试一次，**极端情况上限 3 次**且共享同一超时预算
- 打字隐藏建议后，**把草稿删空会重新显示**（此前一旦开始打字就隐藏到本轮结束）

### 修复

- **思考档位与真实模型不兼容时静默失败**——表现为「设置都对，但永远没有建议」。现在会自动去掉档位重试一次
- **建议复读**：连续两轮给出同一条时，要求模型换一条（一次为限，失败则保留原建议）
- **逐段采纳后删掉已采纳的那段**，建议会显示从中间截断的残句（按 `Tab` 只插入半句）。改为完整重新展示

### 文档

- 英文版升为主 `README.md`（中文移到 `README_zh.md`，两侧 11 节逐节对应并互链）
- README 补充「在 DSH 里安装」、npm 安装方式与徽章、四种交互说明、新设置项
- 演示素材重录为含 `↻` / `Alt+→` 的新界面：`docs/demo.gif`、`docs/screenshot.png`、`docs/social-preview.png`
- 本文件（`CHANGELOG.md` / `CHANGELOG_zh.md`）

## [0.1.0] — 2026-10-17

首个公开版本。

### 新增

- **回复结束即出建议**：在输入框首字符处浮出灰色 ghost text，光标位置、字号、行高对齐当前编辑器
- **三种交互**：`Tab` 采纳 · `Esc` 忽略 · 开始输入自动消失；采纳前建议不属于会话内容
- **默认跟随当前会话模型**：不向辅助调用写死任何提供商
- **轻量上下文**：只取最近若干条 user/assistant 的纯文本，工具结果、附件、系统提示一律不进入辅助调用
- **设置页**：开关、提供商 / 模型、响应超时、上下文规模、思考深度；保存后立即生效，无需重启 DSH
- 同源 HTTP 接口：`/status`、`/catalog`、`/efforts`、`/settings`、`/suggest`
- MIT 许可；Host 端与客户端均无第三方运行时依赖