用途:本技能仅在 Claude Code 中生效(状态栏是 Claude Code 的概念,在其他 CLI 上不做任何事),把最新的 MSU Builder 通知放进状态栏,并把它接入用户自己的 settings.json。Claude Code 从 settings.json 读取 statusLine,而非插件配置,因此插件无法自行安装,需由本技能代写。
主要能力与写入位置(均在 CONFIG = ${CLAUDE_CONFIG_DIR:-$HOME/.claude} 下):$CONFIG/msu-statusline.sh 为启动脚本副本,settings.json 指向它;$CONFIG/msu-statusline.prev 保存此前的状态栏命令;$CONFIG/msu-statusline.conf 为 msu-statusline-config 编辑的配置;$CONFIG/msu-statusline.cache 及旁的 .lock、.attempted、.failures 保存最近读取的通知。settings.json 指向副本而非插件,是因为插件缓存带版本号;启动器在每次渲染时自行解析最新安装的副本。
使用方式要点:写入 settings.json 前检查 bash、jq、curl 是否可用;缺失或空文件按 {} 处理,格式错误、根非对象或 command 非字符串时停止且不替换文件;以 JSON 而非文本编辑,保留现有 statusLine 的兄弟字段。备份旧命令时用 jq -j 解码保存且不留尾随换行;若当前命令已提及 msu-statusline 则视为修复或重装,保持 .prev 不变,避免启动器自我递归。匹配用 msu-statusline 而非 msu-statusline.sh。设置 .statusLine.type 与 .statusLine.command 两个字段,命令按字面写入 bash "${CLAUDE_CONFIG_DIR:-$HOME/.claude}/msu-statusline.sh",不设 refreshInterval。conf 不存在时通过脚本 --config 生成,绝不覆盖已有文件。
验证与限制:可用示例 JSON 管道运行启动器查看真实输出,注意空输出不等于接线失败(NOTICE=off 或冷缓存合法地不打印)。出现 “plugin not found” 可用 MSU_STATUSLINE_ROOT 指向插件目录,或正确安装插件;仅 shell 覆盖只影响该 shell 的渲染。移除请用 msu-statusline-uninstall,且需先于卸载插件。症状排查见 references/troubleshooting.md。分段与轮询频率由 msu-statusline-config 负责。