kimi-code-hud-rs

自定义底部状态栏（HUD）for Kimi Code CLI —— kimi-code-hud（Node.js 版）的 Rust 移植，单一可执行文件，无 Node 运行时依赖。

在终端 TUI 底部显示：与原版 footer 完全一致的四个 slot（模式徽章 auto/yolo/plan/swarm、模型与思考强度、路径、Git 徽章 main [+3 -1 ↑2↓1] [PR#123]——PR 徽章带 OSC 8 超链接，支持的终端可 Cmd+Click 打开），外加 HUD 追加段：生成速度（TPS / TTFT / gen 计时）、/compact 压缩计时、会话缓存命中率、Kimi 托管订阅额度（5h / 7d 柱条 + 百分比 + 重置倒计时）。

与 Node 版的差异（有意为之）：

• 不含第三方 provider 支持 —— 没有 DeepSeek / OpenAI / Anthropic 的余额查询与会话成本估算，只有托管订阅（managed:kimi-code）额度；
• 不含 goal 徽章；后台任务徽章（[N tasks running] / [N agents running]）通过 wire 的 task.started / task.terminated 事件推断，与原版同款；
• 配置与缓存目录为 ~/.kimi-code-hud-rs/，与 Node 版的 ~/.kimi-code-hud/ 互不干扰，两者可以并存；
• 插件（/plugins）托管方式未移植，只支持手动安装。

构建

要求 Rust 1.85+（edition 2024）。

cargo build --release

产物为 target/release/kimi-code-hud-rs(.exe)。

安装

cargo build --release
./target/release/kimi-code-hud-rs --install

--install 会先备份再修改 ~/.kimi-code/tui.toml（幂等，保留其他设置）：在 [status_line] 段写入 command = "<可执行文件绝对路径>"。构建路径含空格时会把二进制复制到 ~/.kimi-code-hud-rs/bin/ 再引用该副本。若 ~/.kimi-code-hud-rs/config.json 尚不存在，会生成一份显式默认值（已存在则绝不改写）。

重启 Kimi Code 或运行 /reload-tui 生效。 如果 [status_line] 已配置了别的命令，--install 不会覆盖它。

宿主某些升级会重写 tui.toml、抹掉 [status_line] 条目——状态栏消失时重新跑一次 --install 并重启会话即可。

卸载

./target/release/kimi-code-hud-rs --uninstall   # 摘除 tui.toml 条目（先备份）

配置

• ~/.kimi-code-hud-rs/config.json（JSONC：支持 //、/* */ 注释与尾逗号；--install 时不存在则生成带注释的默认文件）：
  • "layout": "compact"|"normal"（默认 normal）；
  • "items": [...] —— slot 顺序，可任意排列、省略或重复，未知项忽略。默认 ["mode","model","tasks","cwd","git","speed","cache","quota"]；
  • "slots" —— 按 slot 合并的样式与格式配置，键为 slot 名（mode 徽章按 auto/yolo/plan/swarm 单独设键）：

    "slots": {
      "git": {
        "color": "text_dim",          // 平铺字段:两种布局都生效
        "normal":  { "format": "long" },    // 嵌套:仅该布局,字段级覆盖平铺值
        "compact": { "format": "short" }
      }
    }

    color 可为主题 token（text/text_dim/text_muted/primary/warning/accent/default）或 #RRGGBB；bold 为布尔；format 按 slot 取值——git/speed/cache/quota 为 long/short（短形态：git main*、speed ⚡ 47、cache C 92%、quota 无进度条），cwd 为 short（原版缩写，~ + 最多 3 层 + …/ 前缀，默认）/full（完整路径，long 为别名）/name（最后一层），compact 布局自动取次短形态（full→short→name），可用嵌套 compact.format 显式钉住；speed 另有 "ttft": false 可隐藏 TTFT 读数（默认显示，嵌套 normal/compact 里也可设）。都未配置时用内置缺省（normal 全长、compact 全短、原版 footer 配色）。--install 生成的默认文件把全部默认值预填进 slots，直接原地改即可；speed/cache/quota 的颜色刻意留空——设定后整段统一着色并取代阈值色与 stale 灰显；
• 环境变量 KIMI_HUD_RS_LAYOUT / KIMI_HUD_RS_CWD（覆盖 slots.cwd，两布局生效且 compact 仍自动降级）/ KIMI_HUD_RS_ITEMS（逗号分隔）优先于配置文件；
• NO_COLOR / KIMI_HUD_RS_NO_COLOR：禁用全部 ANSI 颜色；
• KIMI_HUD_RS_THEME=dark|light：手动固定配色主题；缺省跟随 tui.toml 顶层 theme，auto 经 COLORFGBG 判定、回退 dark；
• KIMI_CODE_HOME / KIMI_HUD_RS_HOME / KIMI_HUD_RS_TUI_TOML / KIMI_HUD_RS_CONFIG_TOML：路径覆盖（测试与沙箱用）。

slot 之间以原版 footer 的双空格分隔；前四个 slot（mode/model/cwd/git）的取色与文案与原版逐字一致。两档布局（超过 200 可见字符自动 normal → compact 降级，compact 下 full 路径降为 short、short 降为 name）：

normal:  auto  K3 thinking: high  …/RustProjects/kimi-code-hud-rs  main [+3 -1 ↑2]  ⚡ 47 t/s · TTFT 1.3s  Cache 92%  5h ███░░░░░░░ 31% ~2h18m · 7d ██░░░░░░░░ 25% ~3d2h
compact: auto  K3 thinking: high  kimi-code-hud-rs  main*  ⚡ 47  C 92%  5h 31% ~2h18m  7d 25% ~3d2h

原理

Kimi Code 的 ~/.kimi-code/tui.toml 支持 [status_line] 自定义命令：宿主每秒最多一次通过 stdin 传入 JSON 快照（model、cwd、gitBranch、permissionMode、sessionId 等），命令 stdout 的第一行接管 Footer 第一行，且必须在 300ms 内完成。本工具内部预算 220ms，所有错误静默降级、绝不打印诊断。

数据来源与 Node 版一致：

段	来源
PR 徽章	gh pr view --json number,url,state（PATH 解析防工作区投放、5s 超时、URL 白名单校验后进 OSC 8 链接；颜色随状态:OPEN 用 primary、MERGED 用紫 #AB7DF8、CLOSED 用红 #F85149(对齐 GitHub 自家配色)）。热路径只读 60 秒 TTL 缓存（按 cwd+分支），过期经文件锁去重后 spawn 分离的 --refresh-pr 刷新；无 PR / 无 gh 也缓存"缺席"60 秒
分支 / 脏 / ±计数 / ↑↓	stdin 快照（分支）+ 进程内 gix（gitoxide）探测：status 算脏与 ↑↓、HEAD blob 对工作区（经 CRLF/过滤器）逐行 diff 算 +N -N。不依赖 git 二进制、不 spawn 子进程；结果跨进程缓存 15 秒（cwd 只存 SHA-256）。±计数与 git diff --numstat HEAD 同为 Myers 差异算法族，个别仓库可能有 ±个位的算法性偏差
TPS / TTFT / gen / 压缩计时 / Cache / thinking / swarm	增量解析 ~/.kimi-code/sessions/*/session_<id>/agents/*/wire.jsonl（main + 全部 subagent）。每 agent 维护持久化字节游标（~/.kimi-code-hud-rs/metrics-<sessionId>.json），每帧只读新增字节（≤1MiB），半行 JSON 跨进程无损拼接，尾部指纹检测文件原地重写。速度样本带事件时间戳，多 agent 活跃时聚合为舰队总速 ⚡ 156 t/s (3 agents @52)
thinking 强度	wire 事件（llm.request / config.update / profile.bind）> 按会话固定的快照（thinking-<sessionId>.json，防止其他会话 /effort 改全局配置影响本会话）> config.toml 的 [thinking] 与模型表回退推断
配额（5h/7d）	官方 /usages 配额接口（api.kimi.com / api.kimi.ai，按 oauth host / base_url 判区，任何非官方地址一律回退默认）。热路径只读 60 秒 TTL 缓存，过期时经文件锁去重后 spawn 分离的 --refresh-quota 子进程刷新，绝不阻塞渲染。仅当前模型归因于 managed:kimi-code 时显示；/logout 后缓存自动删除

隐私与安全

Kimi access token 仅从 ~/.kimi-code/credentials/ 本地读取（只读不写，续期由 Kimi Code CLI 负责），且发送前经过双重白名单校验：只会发往 https://api.kimi.com/coding/v1/usages 或 https://api.kimi.ai/coding/v1/usages。持久化状态里只有字节偏移量、token 计数与速度样本，不含任何提示词、回复或工具输出。所有来自外部的动态显示文本在着色前都会剥除 OSC/CSI/ESC 终端控制序列。

开发

cargo test                # 单元测试（57 个）
cargo build --release     # 发布构建
echo '{"model":"K3","gitBranch":"main"}' | cargo run --quiet   # 烟雾测试

License

MIT