# dsh-ui-cost

[English](README.md) | 中文

自带估算费用的完整统计条，以纯 DSH 浏览器插件形式提供——**不改动 ui-conversation 核心**，因此 DSH / DSH Desktop 升级把核心恢复成官方原版也不会失效。

这是社区插件，与 DeepSeek AI 官方无隶属关系。

插件注册在 `conversation.composer.dock` 上与核心统计条相同的单元格（`id: 'stats'`），用更低的 shadowing 优先级整体接管这一行：轮次/步数、LLM 与工具墙钟时间、首 token 延迟与解码吞吐、缓存命中率、计费 token，以及费用。若插件崩溃，单元格的 shadowing 会将其退役，原版核心统计条自动回退渲染。把该插件从 cordis.yml 组合中移除，整行替换即消失，恢复原版统计条。

费用把持久化的 `tokenUsage` 投影按官方费率计价（未缓存输入与缓存写入按缓存未命中价、缓存读取按缓存命中价、输出按输出价），模型取会话**当前**的模型选择（实时读取自 ui-model-selection 的模型目录）——切换模型立即重新计价。费率来自官方 [模型 & 价格](https://api-docs.deepseek.com/zh-cn/quick_start/pricing) 页（元/百万 tokens，`deepseek-v4-flash` / `deepseek-v4-pro`），并随其公布的峰谷定价自动切换——高峰时段为北京时间 09:00–12:00 与 14:00–18:00，其余为空闲半价时段（2026-08-17 00:00 起生效；此前按页面的平价表计费）。

## 示例

![dsh-ui-cost 示例](assets/ui-cost-preview.png)

## 安装

该包声明了 `dsh.bundle`（其 `cordis.patch.yml` 插入 `ui-cost` 行）和 `dsh.client`（浏览器 bundle）。仓库已包含构建好的 `lib/` 产物，因此从 GitHub 安装时不需要执行安装期构建脚本：

```sh
dsh plugin --profile web add github:uaapple/dsh-ui-cost
```

为保证可复现，实际使用时应把命令固定到完整 commit SHA。如果以后发布到 npm，对应命令是 `dsh plugin --profile web add dsh-ui-cost`。

如果不使用 bundle manifest，也可以手动挂载该行：

```yaml
- insert:
    - id: ui-cost
      name: dsh-ui-cost
```

GitHub 仓库应添加 `dsh-plugin` 话题，这样插件才能进入 DSH 社区目录和搜索页面。

## 开发

```sh
npm install
npm run check
npm test
```

支持 Node.js 22 及以上版本。DSH 目前仍处于开发预览阶段，兼容性以 `package.json` 中声明的 DSH client 包版本为准。