SuperAPI AI 工具集

hud

通用与其它

查看项目

更新于 10-16 07:22

技能介绍

用途:配置 oh-my-claudecode 的 OMC HUD 状态栏(statusline),采用 Claude Code 斜杠命令 /oh-my-claudecode:hud 完成安装、修复与显示切换。指南中 ~/.claude 路径在设置 CLAUDE_CONFIG_DIR 时以其为准。

主要命令:/oh-my-claudecode:hud 查看并自动安装;hud setup 安装或修复;hud minimal、hud focused(默认)、hud full 切换预设;hud status 查看详细状态。自动安装会检查 ~/.claude/hud/omc-hud.mjs 与 ~/.claude/settings.json 中的 statusLine,缺失则创建包装脚本并配置,需要重启 Claude Code 生效。

显示元素:模式标识、仓库与分支、ralph 循环进度、PRD 故事 ID、技能、effort、上下文占用、子智能体、后台任务槽、todos 等;颜色表示健康、警告(上下文超 70%、ralph 超 7)与严重(超 85%、ralph 达上限)。agentsFormat 支持 count、codes、codes-duration、detailed、descriptions、tasks、multiline。

配置:HUD 配置存放在 ~/.claude/settings.json 的 omcHud 键下,旧位置 ~/.claude/.omc/hud-config.json 已废弃。可手动编辑 preset、elements、thresholds、callCountsFormat、safeMode 等,未设置的项使用默认值。safeMode 默认开启,会剥离 ANSI 码并只用 ASCII 输出。

安装要点:先从规范模板复制包装脚本与依赖: HUD_DIR="${CLAUDE_CONFIG_DIR:-$HOME/.claude}/hud" mkdir -p "$HUD_DIR/lib" cp "${CLAUDE_PLUGIN_ROOT}/scripts/lib/hud-wrapper-template.txt" "$HUD_DIR/omc-hud.mjs" cp "${CLAUDE_PLUGIN_ROOT}/scripts/lib/config-dir.mjs" "$HUD_DIR/lib/config-dir.mjs" 然后设置可执行权限并更新 statusLine(Windows 路径需用正斜杠),清理旧 omc-hud.js。

限制:若 HUD 不显示可运行 setup 或 /oh-my-claudecode:omc-doctor;旧字符串格式 statusLine 会被自动迁移为对象格式;Node 24+ 若出现 homedir 导出错误需重跑安装器。HUD 活跃会话中约每 300ms 自动更新。