状态栏增强 overact/dsh-statusline-plus

dsh-statusline-plus

为 DeepSeek Harness（dsh web）打造的自适应状态栏。账户配额显示在页头；工作区和会话指标显示在输入框旁边。

截图

截图使用真实界面配合示例数据，不含账户或对话数据。

功能

- 余额与配额： DeepSeek、Kimi Code、Z.ai / Zhipu、Antigravity、Codex、OpenCode Go 和 OpenRouter。点击标签查看详情并刷新。
- DeepSeek 高峰时段： 状态、倒计时和每日时间轴，侧边栏另有指示器。在没有日历的年份里，落在高峰窗口内的工作日保持未知状态，周末和窗口外的小时仍算非高峰；官方规则措辞不再匹配时，日程照常生效，指示器会提示规则可能已变更。
- 工作区与会话： Git 分支与改动、上下文用量、流式 TPS、API 参考成本、直接子代理和工具活动。
- 布局： 组件开关、排序、预设和交互式预览。窄屏下分组自动换行；输入区宽度不超过 480px 时（包括侧边栏挤压导致的情况），可用开关关闭本插件底部状态栏。
- 自更新： npm 发布新版本后，设置页头显示更新按钮并标明版本号（打开页面时检查，缓存一分钟；悬停显示已安装版本和最新版本）。其余情况保持隐藏，链接式开发检出不会提供更新，点击一次即用 pnpm add 原地安装。随后 Host 通过 HMR 把新副本换进运行中的配置档，刷新即可；没有 HMR 的配置档则提示重启。

安装

要求 DSH 0.2.0-rc.2 或更高版本，不设上限，因此升级 DSH 不会让插件失效；已在 0.2.0-rc.2、0.2.1-rc.2 和 Windows 桌面版（0.2.1-rc.3）上测试。从 npm 安装：

dsh plugin --profile web add dsh-statusline-plus

同一版本也以 GitHub Release tarball 形式发布，供固定版本和离线安装使用：

dsh plugin --profile web add https://github.com/overact/dsh-statusline-plus/releases/latest/download/dsh-statusline-plus.tgz
开发时，用本地克隆安装：dsh plugin --profile web add file:/path/to/dsh-statusline-plus。这个 bundle 会注册自己的插件行，并自带预构建文件。开启 HMR 后，插件开关和设置即时生效；目录被监听时，链接的源码改动也会热重载。之后刷新浏览器。只有安装或升级提示 restart-required 时才重启 DSH，并等到没有活跃会话再重启。

如果之前手动安装过，先删掉 @local/dsh-statusline-plus 行和对应依赖，避免重复注册。已有的 statusline-plus 设置保持兼容。详见发布说明。

设置

打开 DSH Web → Settings → Statusline。设置保存在原生配置档的 statusline-plus 下。

显示开关、布局预设、排序、额度来源与刷新选项

| 设置 | 默认值 | 作用 |
| enabled | true | 控制插件的全部显示与刷新 |
| hideBottomOnNarrow | false | 输入区宽度 ≤480px 时，卸载本插件底部状态栏并停止其客户端活动；变宽后恢复。原生统计信息仍然可见 |
| showGit、showContext、showCost、showActivity、showTools | true | 各底部组件 |
| showTps | false | 流式速度 |
| componentOrder | Git、context、TPS、cost、activity、tools | 底部组件顺序 |
| showQuota、quotaAuto、quotaOnStep | true | 头部额度、服务商选择与共享步骤刷新 |
| showDeepseekPeak、deepseekPeakCountdown、showPeakDot | true | DeepSeek 高峰指示与倒计时 |
| cacheTtlMs | 60000 | 额度结果复用时长；界面按秒显示，实际最小 15s |
| fetchTimeoutMs | 10000 | 请求超时；界面按秒显示 |
| quotaSource | auto | 额度来源：auto 先读实时 Magpie 网关，再读 CPA；magpie/cpa 固定单一来源 |
| quotaShowAll | false | 显示所有已启用的订阅 chip（Codex / Antigravity / OpenCode），而不是按模型选一个 |
| providers | 内置来源 | 凭据引用、来源开关与端点覆盖 |

窄屏开关在 Bottom status line 里。它只影响本插件的底部组件；头部额度、高峰指示和原生输入区统计信息仍然可用。
DeepSeek 的 API-key 模型（deepseek、deepseek-official）复用 DEEPSEEK_API_KEY。DSH 已登录的 deepseek-account 服务商下的模型不走 API key，而是通过 Host 的 deepseekAccount 服务显示账户的充值余额和赠送余额。Kimi 用 KIMI_API_KEY；Z.ai 和 Zhipu 用 ZAI_API_KEY 和 ZAI_CODING_CN_API_KEY。其他来源用各自已有的 Host 凭据或账户集成。配置凭据引用，绝不写明文密钥。密钥始终留在 Host 上。

预设只改底部组件。重置会恢复显示、布局和刷新偏好，但保留凭据引用、账户文件、仓库路径和各来源开关。

限制

- 配额请求走插件自有的连接池，地址尝试窗口为 5 秒；请求超时仍然约束整个操作（Codex：15 秒），Host 网络默认值保持不变。查询成功后立即更新显示，不等连接窗口结束。配额刷新复用缓存结果；仅过期不会触发轮询。网络失败最多重试三次，间隔 15/30/60 秒；限流重试等待 60/120/240 秒。离线时暂停恢复；上线、变为可见、进入新步骤或手动刷新都会开启新的查询周期。重新获得焦点后，等当前重试周期结束，会恢复失败的重试一次。重试期间成功的数据保持可见；标签会说明网络错误和重试耗尽。凭据错误和响应无效错误需要修正。手动刷新绕过成功缓存，但错误/限流退避仍然生效。数据缺失或无效时保持未知。
- 费用是根据实际用量和模型厂商公开 API 价格估算的，已知时包含缓存费率。订阅也使用同一套参考价格。定价按模型 ID 最后一个 / 之后的部分匹配，与路由服务商、网关前缀或显示名无关；无法识别的模型后缀保持未知。USD 和 CNY 分开计算；缺少价格时保持未定价。它不含子会话、继承的 fork 历史和额外费用，也不代表账户扣费。
- TPS 区分字符估算和结算后的输出 token 速率。工具耗时包含审批和等待。子代理显示直接子级；已停止不代表成功。
- 服务商 API 和价格目录可能各自独立变化。DeepSeek 的日历内置 2025–2026 回退，如果抓取到 holiday-cn 日历且该年份已发布，则以抓取结果为准；除此之外，未覆盖年份里落在高峰窗口内的工作日不做猜测。官方定价页只用作变更检测器：如果它的规则句子不再匹配，定价和高峰指示器继续使用已持有的时间表，指示器会在指向官方页面的链接旁加一条「规则可能已变化」警告。

开发验证

npm run verify -- --files lib/client.js --ui responsivesh
npm run verify -- --files lib/client.js --ui cost
npm run verify -- --files lib/client.js --style-only --ui subagents
npm run verify:all
npm run screenshots

针对当前改动，用明确的路径。--style-only 只用于 CSS；--ui none 跳过浏览器检查；--plan 预览选中的范围。完成阶段跑一次 verify:all。也可以用 npm run check 和 npm test；DSH_PACKAGE_DIR 指定一个已安装的 DSH 运行时，供集成测试使用。

两项维护检查覆盖开发配置档与发布： sh
npm run dev:runtime # does the active profile HMR-watch this checkout's lib/?
npm run release:check # version, README badge, CHANGELOG, tag, npm dist-tag, assets and latest

dev:runtime 读取当前配置档的 cordis.patch.yml（DSH_PROFILE_DIR 可覆盖 ~/.dsh/profiles/web），报告宿主层改动是否会热重载；建议重启之前先跑它。release:check 核对当前包版本与 README 徽章、变更日志、git 标签、npm dist-tags、GitHub Release 资产和 releases/latest 是否一致；加 --offline 跳过 npm 与 GitHub 检查。

推送 v* 标签会通过发布工作流把版本发到 npm；发布步骤、npm 可信发布配置和发布后检查见 docs/RELEASING.md。

额度协议说明（客户端身份、百分比语义、已知的服务商不一致）见 docs/QUOTA_SOURCES.md。

浏览器检查使用真实 React 和客户端 bundle，配合离线 fixture。覆盖范围包括费用、子代理，以及响应式设置与资源清理。浏览器工具缺失时才需安装： sh
npm run ui:install
node tools/ui/node_modules/playwright/cli.js install chromium
npm run verify:ui -- --panel responsive

运行器使用已安装的 Chrome 或 Playwright Chromium；PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH 可覆盖可执行文件。报告与截图输出到已忽略的 output/playwright/。

可选的授权只读实时检查需要已有会话：npm run verify:ui -- --live --session SESSION_ID --panel all。它打开费用／子代理面板，不改设置、不提交提示词、不重启 DSH。本地登录信息来自 DSH_AUTH_URL 或用户服务日志；认证信息会脱敏。响应式设置检查只在离线运行。

DSH 网页端状态行：顶部显示账号余额与套餐额度，输入区显示 Git、上下文、TPS、API 参考金额、子代理和工具活动。支持 DeepSeek、Kimi Code、Z.ai／智谱、Antigravity、Codex、OpenCode Go、OpenRouter，以及 DeepSeek 峰谷时段指示。

截图： 总览（额度、峰谷、会话指标与详情面板）、设置选项。截图使用英文界面与演示数据，不包含真实账号或对话数据。

安装： 需要 DSH 0.2.0-rc.2 或更高版本，不设上限，升级 DSH 不会让插件被跳过；已在 0.2.0-rc.2、0.2.1-rc.2 与 Windows 桌面版（0.2.1-rc.3）上测试，使用上面的安装命令；插件自带预构建文件和注册配置。启用 HMR 后，插件启停与设置实时生效；本地源码目录纳入监听时也可热加载，之后刷新浏览器。安装或升级提示 restart-required 时，才需等待无活跃会话后重启。旧版手动安装请先移除 @local/dsh-statusline-plus 注册行和依赖，避免重复。
设置： 打开 DSH 网页端 → 设置 → 状态栏，调整显示、排序、预设、顶部额度、账号来源及缓存。有新版本时右上角出现更新按钮（打开设置页时检查，缓存一分钟；悬停显示当前与最新版本），点一次即用 pnpm add 原地覆盖安装，随后由宿主通过 HMR 把新副本换进运行中的 profile，刷新页面即可；没有 HMR 的 profile 才提示重启。link: 安装的本地副本不显示。密钥仅在宿主侧解析，设置里填写凭据引用。DeepSeek 有两种计费方式：deepseek／deepseek-official 使用 DEEPSEEK_API_KEY 查询按量余额；使用 DSH 登录账号（deepseek-account）时，状态栏通过宿主 deepseekAccount 服务读取登录账号的充值余额与赠送余额，不需要 API Key。

额度恢复： 额度请求使用插件自有连接池，每个地址的连接尝试窗口为 5 秒，完整请求仍受总超时限制（Codex 为 15 秒）；宿主网络默认值不变。查询成功即更新显示，不必等满 5 秒。网络失败每轮最多自动重试 3 次，分别等待 15／30／60 秒；限流时等待 60／120／240 秒。断网时暂停，网络恢复、页面重新可见、新步骤或手动刷新会开启新一轮查询；当前重试轮结束后，页面重新获得焦点也可恢复查询。重试期间保留已有的成功数据，并提示网络异常及重试已用完；凭据与响应格式错误不自动重试。

窄屏： 在“底部状态行”中开启“窄屏时隐藏底部状态行”（hideBottomOnNarrow，默认关闭）。输入区域宽度 ≤480px 时不挂载本插件的底部组件，停止相关客户端刷新与计时；侧栏挤窄输入区域也会触发，变宽后自动恢复。顶部额度、峰谷指示与原生输入区统计仍可使用。

说明： 费用按模型厂商 API 单价估算，不代表实际扣款，不含子代理与额外费用；人民币和美元分别累计。额度缓存到期本身不会轮询，失败保留上次结果，未知值不显示成零。工具耗时包含审批与等待；子代理停止不等于成功。峰谷指示：没有日历覆盖的年份，只有“峰段窗口内的工作日”保持未知（周末与窗口外仍为谷段）；官方规则措辞不再匹配时，仍按已有窗口与日历判断，并额外提示“规则可能已变更”，官方页面链接就在提示旁边。恢复默认保留凭据引用、账号、仓库路径和各来源开关。

MIT License