为开发者构建专业的 Claude Code 自定义状态栏。
# 任务：为 Claude Code 创建专业的开发者状态栏
## 角色
你是一名系统程序员，正在为 Claude Code 创建一个高度优化的状态栏脚本。
## 交付物
一个单文件 Python 脚本（`~/.claude/statusline.py`），在 Claude Code 的状态栏中显示对开发者至关重要的信息。
## 输入规范
从 stdin 读取具有以下结构的 JSON：
```json
{
"model": {"display_name": "Opus|Sonnet|Haiku"},
"workspace": {"current_dir": "/path/to/workspace", "project_dir": "/path/to/project"},
"output_style": {"name": "explanatory|default|concise"},
"cost": {
"total_cost_usd": 0.0,
"total_duration_ms": 0,
"total_api_duration_ms": 0,
"total_lines_added": 0,
"total_lines_removed": 0
}
}
```
## 输出要求
### 格式
* 向 stdout 精确打印一行
* 使用 ANSI 256 色代码：\033[38;5;Nm，采用针对高对比度优化的调色板
* 智能截断：可见文本宽度 ≤ 80 个字符（ANSI 转义码不计入限制）
* 使用 unicode 符号：●（干净）、+（新增）、~（修改）
* 调色板：橙色 208、蓝色 33、绿色 154、黄色 229、红色 196、灰色 245（已在深色/浅色终端中测试）
### 信息架构（从左到右优先级）
1. 核心：模型名称（橙色）
2. 上下文：项目目录的基名（蓝色）
3. Git 状态：
* 分支名称（绿色）
* 干净：●（暗灰色）
* 已修改：~N（黄色，N = 文件数）
* 已新增：+N（黄色，N = 文件数）
4. 元数据（暗灰色）：
* 未提交文件：!N（红色，N = 来自 git status --porcelain 的数量）
* API 比率：A:N%（N = api_duration / total_duration * 100）
### 示例输出
\033[38;5;208mOpus\033[0m \033[38;5;33mIsaacLab\033[0m \033[38;5;154mmain\033[0m \033[38;5;245m●\033[0m \033[38;5;245mA:12%\033[0m
## 技术约束
### 性能（关键）
* 执行时间：< 100ms（每 300ms 调用一次）
* 缓存持久化：将 Git 状态缓存存储在 /tmp/claude_statusline_cache.json（脚本每次运行后退出，因此缓存必须持久化到磁盘）
* 缓存 TTL：仅当缓存年龄 > 5 秒或 .git/index 的 mtime 发生变化时，才刷新 Git 文件计数
* Git 逻辑优化：
* 分支名称：直接读取 .git/HEAD（不使用子进程）
* 文件计数：仅在缓存过期时调用 subprocess.run(['git', 'status', '--porcelain'])
* 仅使用标准库：无外部依赖（仅使用 sys、json、os、pathlib、subprocess、time）
### 错误处理
* JSON 解析错误 → 返回空字符串 ""
* 缺失字段 → 省略该部分（不要崩溃）
* 未找到 Git 目录 → 完全省略 Git 部分
* 任何异常 → 返回空字符串 ""
## 代码结构
* 单文件，< 100 行
* 处理 UTF-8 编码以实现稳健的 unicode 输出
* 每个关注点最多一个函数（解析、git、格式化）
* 所有函数都需要类型提示
* 每个函数都有说明其用途的文档字符串
## 集成步骤
1. 将脚本保存到 ~/.claude/statusline.py
2. 运行 chmod +x ~/.claude/statusline.py
3. 添加到 ~/.claude/settings.json：
```json
{
"statusLine": {
"type": "command",
"command": "~/.claude/statusline.py",
"padding": 0
}
}
```
4. 手动测试：echo '{"model":{"display_name":"Test"},"workspace":{"current_dir":"/tmp"}}' | ~/.claude/statusline.py
## 验证清单
* 脚本执行无需外部依赖（缓存时仅调用一次 git status --porcelain）
* 可见文本宽度 ≤ 80 个字符（ANSI 代码不计入计算）
* 颜色在深色和浅色终端背景下均能正确渲染
* 在典型工作区中执行时间 < 100ms（缓存调用应 < 20ms）
* 优雅处理缺失的 Git 仓库
* 缓存文件创建在 /tmp 中并遵守 TTL
* 当 .git/index 的 mtime 变化或经过 5 秒时，Git 文件计数会刷新
## 决策背景
这是一个“开发者专业”风格的状态栏。它优先考虑：
* 详细的 Git 信息，以便感知分支切换
* API 效率监控，以实现注重成本的开发
* 视觉密度，以最大化每字符的信息量