dsh-bottom-info-bar 1.20.13 → 1.21.0

package/README.md

@@ -11,7 +11,7 @@ A DeepSeek Harness plugin that replaces the stats row under the composer with on
 
 ## What it shows
 
-The bar follows the active session and picks one of three readings per provider (mutually exclusive, nothing to switch by hand): **balance** shows the real balance from the provider's own API, **subscription quota** shows each quota window's remaining allowance with its reset countdown, and **cloud billing** shows this month's real spend from the official billing API. On top of that come four spend tallies — this session, today, last 30 days, all time — plus extras such as time and custom text.
+The bar follows the active session and picks one of three readings per provider (mutually exclusive, nothing to switch by hand): **balance** shows the real balance from the provider's own API, **subscription quota** shows each quota window's remaining allowance with its reset countdown, and **cloud billing** shows this month's real spend from the official billing API. On top of that come four spend tallies — this session, today, last 30 days, all time — plus extras such as time and custom text. In balance mode, hovering the balance expands it into topped-up and granted balances, so gifted credit is never conflated with the money you paid in.
 
 Click the bar to switch between **Full** and **Compact**. They differ in exactly one way: Full keeps DSH's native stats row, Compact collapses it. Whether a field appears is decided by that field's own switch alone, so the main row reads identically in both.
 
@@ -29,7 +29,7 @@ Prefer the terminal? This installs the same thing from npm:
 dsh plugin --profile web add dsh-bottom-info-bar
 ```
 
-Then **restart DSH** — plugins are composed when the host starts, so a page refresh is not enough. Use `--profile desktop` instead of `--profile web` on the desktop client. Other install methods (including Windows PowerShell) and troubleshooting: [docs/INSTALL.md](docs/INSTALL.md).
+Then **restart DSH** — plugins are composed when the host starts, so a page refresh is not enough. In the desktop app, use **Plugins → Add plugin**; its profile is managed by the app and cannot be installed into through the CLI. Other install methods (including Windows PowerShell) and troubleshooting: [docs/INSTALL.md](docs/INSTALL.md).
 
 The context usage ring keeps the native hover tooltip and opens a statistics panel when clicked. Both overlays render outside the bottom bar so they do not change its contents.
 
@@ -49,6 +49,10 @@ API keys go in DSH under **Settings → Models**; subscriptions (Codex, OpenCode
 
 Every model response records one entry (usage × unit price, locked the moment the response completes) and survives restarts. The plugin checks npm once per DSH start: **automatic updates** (default) download in the background and take effect after you restart, **manual updates** only notify; a bad release can be rolled back from settings. The ledger stores tokens and amounts, never conversation content; data stays under this end's `DSH_HOME` in `dsh-bottom-info-bar/` (default `~/.dsh/dsh-bottom-info-bar/`, overridable via `DSH_BOTTOM_INFO_BAR_DATA_DIR`) and survives uninstall — export or clear it from Billing data if you want a clean slate.
 
+## Languages
+
+The plugin includes English, Simplified and Traditional Chinese, Japanese, Korean, Spanish, Portuguese, French, German, Italian, Russian, Hindi and Indonesian. It follows DSH’s language by default. Choose **Language** on this plugin’s settings page to use a different language independently; the choice is saved in this browser. Regional variants such as Spanish (Mexico) and Portuguese (Brazil) use the corresponding built-in language. Unsupported languages fall back to English.
+
 ## Development
 
 - Build: `npm run build`
@@ -59,6 +63,6 @@ Every model response records one entry (usage × unit price, locked the moment t
 
 [MIT](LICENSE) © 2026 songoao25
 
-💬 Questions or ideas? Join our WeChat group **DeepThinking** — [QR code](assets/wechat-group.png).
+Questions or ideas? Join our WeChat group **DeepThinking** — [QR code](assets/wechat-group.png).
 
 Holiday pricing includes the official 2026 Chinese holiday leave ranges. Later calendars must be updated after the annual State Council notice; unlisted years use the weekday/weekend rule. Make-up working weekends remain off-peak. Frozen historical costs are unchanged.

package/README.zh-CN.md

@@ -11,7 +11,7 @@ DeepSeek Harness 插件：把输入框下方那行统计栏换成一行信息栏
 
 ## 它显示什么
 
-信息栏跟随当前会话，按服务商自动选择三种口径之一（互斥，不用手动切）：**余额制**显示官方接口的真实余额，**订阅制**显示各额度窗口剩余额度与重置倒计时，**云账单制**显示官方账单接口的本月真实花费。之外还有本会话/今天/近 30 天/累计四档花费，以及时间、自定义文字等通用项。
+信息栏跟随当前会话，按服务商自动选择三种口径之一（互斥，不用手动切）：**余额制**显示官方接口的真实余额，**订阅制**显示各额度窗口剩余额度与重置倒计时，**云账单制**显示官方账单接口的本月真实花费。之外还有本会话/今天/近 30 天/累计四档花费，以及时间、自定义文字等通用项。余额制下把鼠标停在余额上，会展开「充值余额 / 赠金余额」两行明细，赠送的那部分不再是糊涂账。
 
 点一下信息栏可以在**完整**与**简洁**之间切换，区别只有一处：完整保留 DSH 原生统计行，简洁把它收起。看哪个字段，只由该字段自己的开关决定，两种模式显示的主行逐字相同。
 
@@ -29,7 +29,7 @@ https://github.com/songoao25/dsh-bottom-info-bar
 dsh plugin --profile web add dsh-bottom-info-bar
 ```
 
-然后**重启 DSH**（插件在宿主启动时组合，只刷新页面不够）。桌面客户端把 `--profile web` 换成 `--profile desktop`。其他装法（含 Windows PowerShell）与排障见 [docs/INSTALL.md](docs/INSTALL.md)。
+然后**重启 DSH**（插件在宿主启动时组合，只刷新页面不够）。桌面客户端请使用**插件 → 添加插件**；它的配置由客户端管理，不能通过命令行安装。其他装法（含 Windows PowerShell）与排障见 [docs/INSTALL.md](docs/INSTALL.md)。
 
 上下文占用圆环保留原生悬浮提示，点击可打开统计面板。提示和面板都显示在底栏外层，避免出现时改动底栏内部。
 
@@ -49,6 +49,10 @@ dsh plugin --profile web add dsh-bottom-info-bar
 
 每次模型响应记一条（用量 × 单价，单价在响应完成时锁定），重启不丢。插件每次随 DSH 启动检查一次新版本：**全自动更新**（默认）下载好等你重启生效，**手动更新**只提示不下载；新版有问题可以在设置页回滚到上一版。账本只记 token 与金额，不记对话内容；数据存放在本端 `DSH_HOME` 下的 `dsh-bottom-info-bar/` 目录（默认 `~/.dsh/dsh-bottom-info-bar/`，可用 `DSH_BOTTOM_INFO_BAR_DATA_DIR` 覆盖），卸载不删——要清零去设置页的账单数据里导出或清除。
 
+## 语言
+
+插件内置简体中文、繁体中文、英语、日语、韩语、西班牙语、葡萄牙语、法语、德语、意大利语、俄语、印地语和印度尼西亚语。默认跟随 DSH 的语言；也可以在本插件设置页的**语言**中单独选择，选择会保存在当前浏览器。墨西哥西班牙语、巴西葡萄牙语等地区变体使用对应的内置语言；不支持的语言显示英语。
+
 ## 开发
 
 - 构建：`npm run build`
@@ -59,7 +63,7 @@ dsh plugin --profile web add dsh-bottom-info-bar
 
 [MIT](LICENSE) © 2026 songoao25
 
-💬 有问题或想法？扫码加入微信群 **DeepThinking**：
+有问题或想法？扫码加入微信群 **DeepThinking**：
 
 <img src="assets/wechat-group.png" width="180" alt="微信群 DeepThinking 二维码">
 

package/docs/INSTALL.md

@@ -2,9 +2,9 @@
 
 ## 前置条件
 
-- 已安装 DeepSeek Harness（`dsh` CLI 在 PATH 中；桌面客户端同样提供该 CLI）
+- 已安装 DeepSeek Harness（网页端命令行安装需要 `dsh` CLI 在 PATH 中）
 - 已安装 [pnpm](https://pnpm.io/)
-- 网页端用 `dsh web` 启动，桌面客户端（灰度测试中）用其自带的 profile（通常是 `desktop`）：下文命令里的 `--profile web` 在桌面端一律换成 `--profile desktop`
+- 网页端用 `dsh web` 启动。桌面客户端通过**插件 → 添加插件**安装；`desktop` 配置由客户端管理，命令行不允许修改。以下脚本和命令适用于 CLI 的网页端配置。
 
 ## 安装
 
@@ -36,8 +36,7 @@ macOS / Linux：
 git clone https://github.com/songoao25/dsh-bottom-info-bar.git
 cd dsh-bottom-info-bar
 ./install.sh
-# 默认安装到 web profile；桌面客户端：
-./install.sh --profile desktop
+# 默认安装到 web profile
 ```
 
 Windows（PowerShell，原生，无需 Git Bash）：
@@ -46,8 +45,7 @@ Windows（PowerShell，原生，无需 Git Bash）：
 git clone https://github.com/songoao25/dsh-bottom-info-bar.git
 cd dsh-bottom-info-bar
 .\install.ps1
-# 桌面客户端：
-.\install.ps1 -Profile desktop
+
 ```
 
 卸载对应为 `./uninstall.sh` / `.\uninstall.ps1`（同样支持 `--profile` / `-Profile`）。
@@ -91,7 +89,7 @@ dsh --profile web --dump-config | grep -A2 dsh-bottom-info-bar
 
 信息栏按当前服务商自动选择三种口径之一（互斥，无需手动切换）：**余额制**（DeepSeek 等）显示官方接口的真实余额，**订阅制**（Codex、OpenCode、小米 Token Plan、Command Code、MiniMax、智谱）显示各额度窗口剩余额度与重置倒计时，**云账单制**（Together、Fireworks 等）显示官方账单的本月真实花费。订阅额度数据源：
 
-- **Codex / ChatGPT**：信息栏**只读** `~/.codex/auth.json` 中的登录令牌，解析真实套餐与到期信息；token 仅在本机内存中使用，不落盘、不记录、不续期、不写回。令牌的**绑定 / 续期**由独立插件 [**dsh-chatgpt-sub**](https://github.com/songoao25)（独立仓库）负责——安装并绑定后，本信息栏即可显示订阅信息；令牌缺失时信息栏显示「未绑定」引导，相关字段缺失时只保留服务商和模型。
+- **Codex / ChatGPT**：信息栏**只读** `~/.codex/auth.json` 中的登录令牌，解析真实套餐与到期信息；token 仅在本机内存中使用，不落盘、不记录、不续期、不写回。令牌的**绑定 / 续期**由独立插件 [**dsh-chatgpt-sub**](https://github.com/songoao25/dsh-chatgpt-sub)（独立仓库）负责——安装并绑定后，本信息栏即可显示订阅信息；令牌缺失时信息栏显示「未绑定」引导，相关字段缺失时只保留服务商和模型。
 - **OpenCode Go**：在 **设置 → 模型** 配置 `OPENCODE_GO_API_KEY`（或先用 opencode CLI 登录其订阅，写入平台共享目录 `opencode/auth.json` 的 `opencode-go` 条目：macOS/Linux 为 `~/.local/share/opencode/auth.json`，Windows 为 `%LOCALAPPDATA%\opencode\auth.json`）。未配置时信息栏显示"未配置 OpenCode Go"引导，不报错。
 
 ## 更新版本
@@ -175,7 +173,7 @@ dsh plugin --profile web remove dsh-bottom-info-bar
 
 | 现象 | 原因与处理 |
 |---|---|
-| 信息栏不出现 | ① 没重启：需重启 DSH（网页端即重启 `dsh web`）；② 装错 profile：确认启动用的 profile 与安装目标一致（网页端 `web`、桌面端 `desktop`）；③ `dsh --profile <name> --dump-config` 里没有 dsh-bottom-info-bar：重新执行安装 |
+| 信息栏不出现 | ① 没重启：需重启 DSH（网页端即重启 `dsh web`）；② 装错 profile：确认启动用的 profile 与安装目标一致（CLI 网页端通常为 `web`；桌面端请在应用的插件页检查）；③ `dsh --profile <name> --dump-config` 里没有 dsh-bottom-info-bar：重新执行安装 |
 | 安装报 `pnpm not found` | 安装 pnpm：`npm i -g pnpm` 或 `corepack enable` |
 | 安装报 `dsh-bottom-info-bar` 找不到 | 确认包名拼写；本地目录安装时路径要指向**仓库根**（包在仓库根，不是子目录） |
 | 插件页报「这个包没有声明组合包」（英文界面：declares no bundle） | 装到的是一个「仓库根不是包」的仓库——那是包移到仓库根之前的本仓库。插件页里改填包名 `dsh-bottom-info-bar`，或用包含该修复的版本上的仓库地址 |