Starlight-bananice/dsh-status-bar

DeepSeek Harness 原生底部状态栏一条线塞下太多内容，窗口一窄就会被截断。本插件带来接近原生体验的可配置状态栏：17 个信息段任你挑选——会话状态、当前模型、上下文压力、Token 消耗、生成速度（TPS）、费用估算、任务与队列等，两下点击即可开关与排序；还提供换行显示、实时 TPS、逐模型费用估算等多项实用选项。替换内置统计行，卸载后原样恢复。

English · 中文

---

Overview（概览）

解决的问题： DSH 原生底部状态栏是一条超长的固定统计行——内容一多就被截断，窗口变窄时尤其明显；既看不到当前模型、上下文窗口还剩多少、Token 流式生成多快、这个会话花了多少钱，也没法按自己的习惯排列这些信息。

适合谁： 日常重度使用 DSH 的开发者与团队——希望不离开输入栏就能掌握会话实时状态，又不想额外开一个监视器的人。

核心能力：

• 接近原生体验 · 17 个可开关、可排序的信息段 —— 状态点、模型、标题、工作区、Agent 预设、轮次与步数、模型/工具耗时、TTFT 与解码速度、缓存命中率、Token、上下文占用、实时 TPS、会话时长、费用估算、后台任务、队列、错误
• 实时吞吐（TPS） —— host 侧投影逐块折叠 assistant/chunk 事件，流式生成期间速度随分块实时刷新；无需轮询，无需外部 live-stats 插件
• 费用估算 + 用户维护的模型价格手册 —— 每个模型独立的价格与峰/谷时段，每条消息/每一步按实际产出它的模型计费（输入、缓存命中、缓存写入、输出四类分别计价，峰谷按该步发生时刻取价）；「用量与费用」弹窗内置堆叠费用趋势图（日/周/月）、分页的逐步用量历史（含独立的缓存命中列）与总成本。
• 零配置开箱即用 —— 13 个信息段默认开启，其余勾选即得
• 多项实用选项 —— 换行显示（内容再多也不会被截断省略）、实时 TPS、逐模型费用估算（支持峰谷计价）、币种切换（CNY / USD）、齿轮快捷开关菜单与专属设置页、一键重置
• 干净的接管机制 —— 插件底栏以低优先级同 id 遮蔽内置 stats 单元格：加载期间由其渲染，卸载后内置统计行自动恢复，互不污染
• 双语界面 —— 客户端文案内置英文与中文，遵循 DSH locale 体系

界面预览

以接近原生的底栏体验替换内置统计行，实时呈现会话状态（状态 · 模型 · 轮次 · 上下文 · 缓存 · TPS · 会话时长 · 任务 · 队列 · 错误），通过专属设置页统一管理——含逐模型价格手册（支持峰谷计价）：

随时开关与排序（信息段列表）	用量与消耗弹窗（趋势图 · 统计卡 · 历史）

Compatibility（兼容性）

项目	说明
DSH 版本	0.1.0-rc.7（mainline master）——更早的 RC 可能可用但未经验证
最后验证日期	2026-08-19
运行环境	Node ≥ 22（host）+ 现代浏览器（client）；无外部服务依赖
共存关系	可与 @linxin666/dsh-live-stats 共存——双方都提供 liveTokenUsage 键，投影注册表只保留先注册者（同键单单元，不会重复显示）

Install / Uninstall（安装 / 卸载）

安装

# 从本地目录装配（profile 级；`web` 是 `--profile web` 的内置别名）
dsh plugin --profile web add ../dsh-status-bar

# 或从 GitHub 仓库安装
dsh plugin --profile web add github:Starlight-bananice/dsh-status-bar

# 或安装固定版本的 release tgz —— 不可变且带版本号（随每个 GitHub
# release 附带；适合不便直连 git 仓库的场景）
dsh plugin --profile web add https://github.com/Starlight-bananice/dsh-status-bar/releases/download/v0.1.6/starlight-bananice-dsh-status-bar-0.1.6.tgz

提示： pnpm 从 codeload.github.com 下载 GitHub 包，且不读取你的 git 代理配置。若安装卡住或报网络错误（如 error (23)），请先导出代理再重试：export HTTPS_PROXY=http://127.0.0.1:7890 HTTP_PROXY=http://127.0.0.1:7890。

自 v0.1.5 起： 构建产物 lib/ 已随仓库提交 —— git 安装后开箱即用，无需任何构建步骤；dsh plugin add 完成后重启 DSH Web 即可。（≤ v0.1.4 的安装不含 lib/，需要按 Development 一节手动构建。）

# 或免重启的运行时注入（开发流程）
#   dev_inject_plugin / dsh-super-injector → 指向本仓库

之后启动/重启 DSH Web 即可，无需任何配置——底栏会以默认设置出现。

升级

# pnpm 会把不带 ref 的 github: 依赖钉在首次安装时解析到的 commit ——
# `dsh plugin --profile web update github:...` 只会提示 "Already up to date"
# 并保留旧构建。升级请用重新 add：
dsh plugin --profile web remove @Starlight-bananice/dsh-status-bar
dsh plugin --profile web add github:Starlight-bananice/dsh-status-bar

# 或固定显式 ref（tag / 分支 / commit）
dsh plugin --profile web add github:Starlight-bananice/dsh-status-bar#v0.1.5

禁用

• 只隐藏底栏 —— 客户端总开关（设置 → 插件 → 状态栏，或齿轮快捷菜单）可立即隐藏底栏；host 侧的投影与用量账本仍继续运行。
• 完全停止插件 —— 从 profile 的 bundles 列表中移除（等价于下面的卸载）；重新 add 即可恢复。

卸载

dsh plugin --profile web remove @Starlight-bananice/dsh-status-bar

卸载后内置统计行自动恢复（遮蔽单元格被释放）。数据残留说明： 浏览器 localStorage（dsh.statusBar.v1）与 host 侧用量文件（见 Permissions & data）不会自动删除——需要彻底清除时请手动删除。

Quick start（快速上手）

1. 按上文安装并重启 DSH Web。

2. 开始一个会话——底栏默认显示：状态 · 模型 · 轮次 · 耗时 · 速度 · 缓存命中 · Token · 上下文 · TPS · 会话时长 · 任务 · 队列 · 错误。

3. 打开 设置 → 插件 → 状态栏 开关/排序信息段、开启换行，或一键重置。

4. 想要费用估算？把你在用的模型加入模型价格手册：

   # 设置 → 插件 → 状态栏 → 模型价格手册：
   # 模型 "deepseek-chat" → 输入 2 / 缓存读 0.5 / 缓存写 2 / 输出 8（CNY，每 1M tokens）
   # 可选：启用峰谷计价，默认使用 DeepSeek 官方时段 09:00–12:00、14:00–18:00
   

   底栏随即显示如 ≈¥0.0123 的当前会话费用；该数字为各模型用量 × 各自价格之和（会话中途切换模型时，各段按各自价格分别计费）。点击齿轮旁的图表按钮可打开「用量与费用」弹窗（统计卡、费率卡、分页的用量历史——每页 20 条、最多 10 页，含输入/缓存命中/输出/成本列，以及可 ‹ › 翻页、按模型分色的费用趋势图）。

Configuration（配置）

全部配置均在客户端，存于浏览器 localStorage 的 dsh.statusBar.v1 键下，通过设置页或输入栏齿轮菜单修改。

配置项	默认值	含义
enabled	true	总开关；false 时整条底栏隐藏
wrap	true	允许底栏在输入框宽度内换行多行显示而非截断省略（无论开关与否，底栏都不会超出输入框左右边界）
segments	13 开 / 4 关（见下）	已启用的信息段有序列表
cost.currency	CNY	费用显示币种（CNY / USD）
cost.models	{}	用户维护的模型价格手册（模型 id → 价格 + 峰谷时段）

默认信息段状态： 开启——状态、模型、轮次、耗时、速度、缓存命中、Token、上下文、TPS、会话时长、任务、队列、错误；关闭——标题、工作区、Agent 预设、费用。

模型价格手册条目（新增模型时的初始值）：输入 2、缓存读 0.5、缓存写 2、输出 8（每 1M tokens，按配置币种）；默认不启用峰谷；启用时默认采用 DeepSeek 官方时段 09:00–12:00、14:00–18:00，时区 local。

环境变量： DSH_HOME（host 侧）——插件本地数据目录的基准路径（默认 ~/.dsh）。无其他环境变量，无密钥，无 Token。

信息段速查（全部 17 个，均可开关/排序）：

段	内容	数据源
会话状态	● 运行中 / 空闲 / 出错（彩色状态点）	snapshot running / partial / lastAgentError
当前模型	最近一次响应的模型标识	sessionModel 投影（host 折叠 assistant/message 事件）
会话标题	标题或项目名（超长截断）	SessionSummary
工作区	工作区目录名	SessionSummary
Agent 预设	预设名	SessionSummary
轮次与步数	N 轮 · M 步	sessionStats 投影（无投影时窗口折叠回退）
模型与工具耗时	LLM 耗时 · 工具调用耗时	sessionStats
TTFT 与解码	平均首 Token · tok/s	sessionStats
缓存命中	提示词缓存命中占比（两位小数，上限 99.99%）	tokenUsage
Token	计费输入/输出总量	tokenUsage
上下文	上下文窗口占用 %	contextPressure
实时 TPS	当前生成速率（默认开启）	liveTokenUsage 投影——实时折叠 assistant/chunk；分块感知估算（约 4 字符/token + 块/角色框架开销，block-end 时按整块重定价，EWMA 抗突发冲刷），provider 上报用量后转为精确值；会话停止时显示 0
会话时长	挂钟时间，运行时走动	turnTimings
费用估算	≈¥0.0123（默认关闭）	sessionUsage 投影——每个模型的用量 × 其自身生效价格（平峰或峰谷，按当前时刻），跨模型求和
后台任务	运行中的后台任务	jobsBySession
队列	排队中的消息	snapshot queue
错误	失败/重试/超限计数（仅 >0 显示）	node 折叠

Permissions & data（权限与数据）

类别	插件会触及什么
文件	host 侧将用量账本写入 <DSH_HOME>/dsh-status-bar/usage.jsonl（默认 ~/.dsh/dsh-status-bar/usage.jsonl；每条 assistant 消息一条记录：时间戳、模型、input/cacheRead/cacheWrite/output 四类 token 数）。内存历史为 120 天滚动窗口。
网络	绝无出站请求。 唯一端点为本插件的本地 webserver 路由 /status-bar/api/usage（与 DSH Web 同源，127.0.0.1），用于向图表提供分桶数据。
凭据	无。 插件从不读取、存储或传输 API 密钥、Token 或 Cookie。
用户数据	客户端：localStorage["dsh.statusBar.v1"]（底栏配置 + 价格手册，不含任何对话内容）。host 侧：上述用量账本（仅 token 计数，不含提示词、消息、文件内容）。

Troubleshooting（故障排查）

现象	原因与处理
底栏不显示	总开关被关闭 → 在 设置 → 插件 → 状态栏 或齿轮菜单中开启。localStorage 被清空？配置已重置为默认。
TPS 段为 0 / 空白	尚无流式输出，或流处于重试间隔。每次 llm/retry 会重启测量窗口；首个流之后保留的速率不会再变空白。
TPS 与其他插件冲突	若同时加载 @linxin666/dsh-live-stats，注册表保留先注册者对 liveTokenUsage 键的占用——同键单单元，不会出现重复行。
费用估算缺失	会话所用模型都未在价格手册中（或价格全为 0）→ 在 设置 → 插件 → 状态栏 → 模型价格手册 中添加。费用按手册费率估算（逐模型、平峰或峰谷），非 provider 账单。
用量图表为空	该时段内还没有带 provider 用量上报的 assistant 消息，或 DSH_HOME 指向了别处（核对上面 usage.jsonl 的位置）。
升级后界面异常	硬刷新浏览器（客户端 bundle 可能过期），并在设置中核对插件版本。
不确定当前装的是哪个版本	在 profile 目录（macOS/Linux）执行：node -p "require(process.env.HOME + '/.dsh/profiles/web/node_modules/@Starlight-bananice/dsh-status-bar/package.json').version"。低于 v0.1.5？按上面的升级步骤重装——不带 ref 的 github: 安装会一直保留安装时解析到的 commit。

日志位置： 插件自身不写日志文件——host 侧诊断信息出现在 DSH web 进程输出（profile 日志）中；客户端问题可在浏览器 devtools 控制台查看。

回滚方式： 设置页提供一键重置（恢复全部默认值）。插件本体：卸载后用 dsh plugin --profile web add <pkg>@<旧版本> 重新安装旧版；移除插件后内置统计行始终自动恢复。

Development（开发）

pnpm install            # 仅安装 devDependencies（typescript/tsdown/@types）；npm peer 依赖由 DSH 运行时闭包提供，故不在 package.json 声明
npm run build:client    # tsdown → lib/client.js（ModuleLoader bundle）
npm run build           # junction 链接 + host tsc + 客户端类型检查（需要 DSH_CHECKOUT 指向 dsh 源码检出）

自 v0.1.5 起 lib/ 构建产物已提交入库，普通 git 安装开箱即用，无需构建；上面的命令用于发版前刷新产物。npm run build / typecheck:client 需要 DSH_CHECKOUT（或公共路径探测），客户端类型检查通过 junction 链接解析到检出目录的 lib/types。host 侧为纯 TypeScript（Cordis 插件），客户端为 React + DSH client UI slots。

保持 lib/ 与源码同步： 先执行 pnpm install --frozen-lockfile（重建必须用 pnpm-lock.yaml 钉住的精确工具链，可复现），再在推送前执行 npm run verify（scripts/verify.sh 会重新构建 host + client，并在提交的 lib/ 与 src/ 不一致时直接报错）。仓库还附带 pre-push hook，push 触及 src/ 或构建配置时自动执行该检查——启用一次即可：

git config core.hooksPath .githooks

lib-sync GitHub Actions 工作流在 CI 中施加同样的约束：每次 push/PR 跑快速产物完整性检查；触及 src/ 的 PR 与手动触发时跑完整"重建 vs lib/"漂移检查。

贡献方式： fork 本仓库，从 main 开分支，提交 PR——欢迎小而聚焦、描述清晰的改动。Bug 请在 Issues 中提交，附上 DSH 版本、浏览器与最小复现步骤。

License & security（许可证与安全）

• 许可证： MIT（© 2026 Starlight-bananice）。
• 安全： 本插件不持有任何凭据、不发起任何网络调用，攻击面即为 DSH host 进程本身。如需私下报告安全问题，请使用本仓库的 GitHub Security Advisories（https://github.com/Starlight-bananice/dsh-status-bar/security/advisories/new）——漏洞请勿公开发 Issue。