deepseek-hud
在用 DeepSeek API 接入 Claude Code 时，在 statusline 底部显示本会话 tokens、缓存命中率、花费（¥）、账户余额。
三种模式（config.json 的 mode）：
auto（默认）按当前 API 自动二选一：DeepSeek 会话用本插件（自渲染模型/项目/git/上下文 + DeepSeek 行，不调用 claude-hud）；Claude 会话交给 claude-hud。overlay 叠加：始终用 claude-hud 基础行，DeepSeek 会话再追加 DeepSeek 行。standalone 独立：始终自渲染，从不调用 claude-hud（可不安装它）。
English
效果
auto（默认）— DeepSeek 会话：本插件自渲染，不调用 claude-hud
[DeepSeek V4 Pro] · my-project git:(main*) · ctx █████░░░░░ 45%
🐳 DeepSeek · tok 1.24M · 命中 78% · 花费 ¥0.42 · 余额 ¥48.50(2分钟前)
auto（默认）— Claude 会话：自动切到 claude-hud，无 DeepSeek 行
[Opus 4.8] │ my-project git:(main*)
上下文 █████░░░░░ 45% │ 使用率 ██░░░░░░░░ 25%（1小时30分 / 5小时）
overlay — DeepSeek 会话叠加：claude-hud 基础行 + DeepSeek 行
<claude-hud 原本的一行/多行：模型、上下文、git…>
🐳 DeepSeek · tok 1.24M · 命中 78% · 花费 ¥0.42 · 余额 ¥48.50(2分钟前)
standalone 模式与 auto 的 DeepSeek 会话显示一致，区别只是非 DeepSeek 会话也强制自渲染、从不调用 claude-hud。
DeepSeek 行各字段：
- tok：本会话累计 tokens（input + output + cache 创建 + cache 读取）。
- 命中：prompt cache 命中率 =
cache_read /(cache_read + cache_creation + input)，分母为 0 时自动隐藏。
- 花费：按本地 DeepSeek 计价表估算的本会话花费（人民币）。
- 余额：DeepSeek 账户余额，后台异步刷新、不阻塞渲染；括号内为上次刷新距今时间（
showBalanceAge）。
自渲染基础行各字段：模型徽章、项目目录名 + git 分支（*=有未提交改动）、上下文进度条（绿/黄/红按用量）。
工作原理
Claude Code ──stdin(JSON)──► statusline.js
1. 读 stdin
2. 识别是不是 DeepSeek（model.id / ANTHROPIC_BASE_URL / ANTHROPIC_MODEL）
3. 基础行（按 mode 决定）：
· auto → DeepSeek 会话自渲染；非 DeepSeek 会话调用 claude-hud
· overlay → 总是调用 claude-hud（缺失则自渲染）
· standalone → 总是自渲染，不调用 claude-hud
4. 若是 DeepSeek，追加一行：
· tokens / 命中率：解析 transcript JSONL 的 message.usage 累加
· 花费：本地计价表
· 余额：读 balance-cache.json；过期则后台派生
`node statusline.js --refresh-balance`
- 零第三方依赖，仅用 Node 内置模块；不强依赖 claude-hud（软依赖：装了就叠加，没装就自渲染）。
- statusline 渲染频繁，所以：transcript 解析按
mtime+size 缓存；余额走后台进程，主流程永不等待网络。
- 独立模式的 git 段在 cwd 跑
git（1s 超时、失败静默），非 git 仓库时自动省略。
基础层：claude-hud 界面与使用说明
deepseek-hud 渲染的「上面那一/几行」全部来自 claude-hud。这里摘录它的界面与常用配置，方便你看懂整条 statusline；完整选项以上游 README 为准。
它显示什么
| 内容 | 含义 |
|---|
模型徽章 [Opus] | 当前模型；正面识别到路由提供商时显示 Bedrock / Vertex |
项目路径 + git my-project git:(main*) | 当前项目（可配 1–3 级目录）与分支，* 表示有未提交改动 |
上下文进度条 █████░░░░░ 45% | 上下文窗口用量，绿 → 黄 → 红 |
使用率 ██░░ 25%（1小时30分 / 5小时） | Claude 订阅用户的额度消耗（API/DeepSeek 用户无此行） |
默认两行布局：
[Opus] │ my-project git:(main*)
上下文 █████░░░░░ 45% │ 使用率 ██░░░░░░░░ 25%（1小时30分 / 5小时）
可选行（默认隐藏，需启用）：
◐ Edit: auth.ts | ✓ Read ×3 | ✓ Grep ×2 ← 工具活动
◐ explore [haiku]: 查找认证代码（2分15秒） ← Agent 状态
▸ 修复认证漏洞（2/5） ← 待办进度
配置 claude-hud
/claude-hud:configure # 引导式：预设、语言、常用开关，保存前可预览
预设：完整 / 核心 / 极简。选完可再单独开关每个元素。
常用项（写在 ~/.claude/plugins/claude-hud/config.json，与本插件的 config.json 是两个不同文件）：
| 选项 | 默认 | 说明 |
|---|
language | en | 设 zh 启用中文标签 |
lineLayout | expanded | compact 可压成单行 |
pathLevels | 1 | 项目路径显示的目录层级 1–3 |
display.contextValue | percent | 改 tokens / remaining / both 切换上下文显示格式 |
display.showTools / showAgents / showTodos | false | 启用工具/Agent/待办行 |
display.showCost | false | claude-hud 自带的费用（基于 Claude 计价，对 DeepSeek 不准，故用本插件的花费行代替即可） |
colors.* | — | 支持颜色名 / 256 色数字 / #rrggbb |
注意：claude-hud 原生的 display.showCost 用的是 Claude/Anthropic 计价，不适用于 DeepSeek。DeepSeek 的花费请看本插件追加的 🐳 DeepSeek 行（按 DeepSeek 计价表估算），无需开 claude-hud 的费用。
claude-hud 运行环境：Claude Code v1.0.80+；macOS/Linux 需 Node 18+ 或 Bun，Windows 需 Node 18+。更多选项与排错见 claude-hud 官方 README。
前置：把 DeepSeek 接入 Claude Code
启动 Claude Code 前设置环境变量（DeepSeek 提供 Anthropic 兼容端点）：
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<你的 DeepSeek API Key>
export ANTHROPIC_MODEL=deepseek-v4-pro[1m] # 主力模型；实惠可选 deepseek-v4-flash[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-flash[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m]
uppinote20
wshobson
Lucklyric
xrf9268-hue
anthropics
thedotmack