# Changelog

All notable changes to **dsh-statusbar** are documented here. Format follows
[Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/) and this project adheres to
[Semantic Versioning](https://semver.org/lang/zh-CN/).

## [0.1.0] - 2026-08-15

### Added

- VSCode 风格底部状态条（`shell.overlay` 席位），应用主框架预留底部空间，页面内容不被遮挡。
- 会话用量项目：轮数/步数、LLM/工具调用耗时、首 token 平均、tok/s、缓存命中率、输入/输出 token（读取
  `sessionStats` / `tokenUsage` 投影）。
- 实时生成速率 `TPS`（读取 `liveTokenUsage` 投影，需安装 dsh-live-stats）。
- CPU / MEM 显示 + `[||||||||||]` Linux 风格字符进度条（绿 → 黄 → 红渐变）。
- 隐藏输入框下方原有的统计行与 TPS 行（避免重复显示）。
- 每项可配置：显示与否、左侧/右侧、顺序；配置持久化到 `dsh-statusbar-config.json`。
- 公共 `statusbar` Cordis 服务：`registerItem` / `updateItem` / `removeItem` / `list`。
- 公共 `registerDataSource` 接口：第三方插件注册自己的实时数据源（`provide()` 回调 + 独立刷新节奏）。
- HTTP 路由：`GET /dsh-statusbar/snapshot?session=<id>`、`POST /dsh-statusbar/config`。
- 设置页「状态栏」（`settings.section` 席位）。
- 简体中文与英文 README。

### Added (English)

- VSCode-style bottom status bar (`shell.overlay`) with reserved frame space.
- Conversation usage items: turns/steps, LLM/tool time, first-token avg, tok/s, cache hit,
  in/out tokens (`sessionStats` / `tokenUsage` projections).
- Live `TPS` (`liveTokenUsage` projection, requires dsh-live-stats).
- CPU / MEM with `[||||||||||]` colored char bars (green → yellow → red).
- Hides the original composer stats line + TPS row (no duplication).
- Per-item config: visibility, side, order — persisted to `dsh-statusbar-config.json`.
- Public `statusbar` service: `registerItem` / `updateItem` / `removeItem` / `list`.
- Public `registerDataSource` API for third-party live data providers.
- HTTP routes: `GET /dsh-statusbar/snapshot?session=<id>`, `POST /dsh-statusbar/config`.
- Settings section「状态栏」(`settings.section` seat).
- Simplified Chinese and English READMEs.