# 更新日志

本文件记录每一版的用户可见变化。格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，
版本号遵循[语义化版本](https://semver.org/lang/zh-CN/)。

## 0.3.1 — 2026-10-24

### 文档

- README 的「怎么装」补上两条真实路径：在 DSH 插件市场里安装（从 npm 拉预构建包），
  以及 `npm i dsh-progress-caption` 只是取回源码、不会自动注册成插件这一注意事项。
- 发布到 npm：`dsh-progress-caption` 0.3.1 起可在 npm 上直接取到，市场安装走 npm 会更快。

## 0.3.0 — 2026-10-24

### 新增

- 字幕条颜色四选一：跟随主题 / DS 蓝 / Claude 橙 / 自定义。选「自定义」会在下方展开一条
  渐变色带，直接在上面点选任意颜色。
- 两处细微动效：主文案换句时旧句上移淡出、新句自下淡入（90ms）；俏皮词换词时胶囊外壳不动，
  内部上下滚动（140ms）。两者都只动 `opacity` 和 `transform`，不改宽高，不会推挤布局。

### 改进

- 设置面板整体重做：毛玻璃浮层、分段胶囊、滑动开关；去掉分组标题与重复说明。
- 开关行改成「状态词在左、开关在右」，开关只保留轨道——点按时不再发生位置跳动。
- 删除没实际作用的项：跑成功/跑失败两个颜色、俏皮词的「素色」样式。

### 修复

- 静态预览页顶部被裁、说明文字与实际行为不一致。

## 0.2.0 — 2026-10-22

### 新增

- 「状态标记」设置：可选经典三点，或 Claude 三态（弹跳 / 斜线 / 绕圈，每 6 秒轮换一次）。
- 回合小结：每回合结束在动作行前显示「回合 · N 次工具 · 成功 X 失败 Y · 用时 Z」，全部由
  工具结果统计得出。
- 「思考原话」开关：打开后主文案下方多一行从思考内容里挑出来的句子。

### 改进

- 扫光改为只扫第一行、方向从左到右、光带收窄到 40%。
- 副行不再照抄「第一步」这类过场话，改从思考里挑一句有信息量的。
- 移除无效的「行数」设置（`-webkit-line-clamp` 在主文案长度下几乎不触发）。

### 修复

- 两步之间的空档不再说「正在准备下一步」，改为报刚跑完的工具和它的耗时。
- 只显示一行时，右侧俏皮词胶囊的底边被裁掉。
- 指令堆叠时，收起过程中的内容会溢出、压住上一条排队消息。

## 0.1.0 — 2026-10-22

### 新增

- 首版：输入框上方一行进度字幕，显示「第几步 / 在干什么 / 成没成 / 耗时」。
- 17 条关键词规则表 + 112 条中英俏皮词；内容优先级为 工具事实 > 规则表 > 阶段话术 > 俏皮词。
- 失败时给一句人话原因（如「命令执行失败（exit code 1）」），可展开查看原始报错行。
- 中英双语文案，样式统一 `pgc-` 前缀；带离线测试，不需要启动 DSH 就能验证。