TokenToSea提示词广场
English 控制台

Claude Code 状态栏脚本

编程开发·任务模板

在聊天中使用

让模型编写 Claude Code 的单文件 Python 状态栏脚本，从标准输入读取会话 JSON，显示模型、目录与 git 状态。

# 任务：为 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、格式化）
* 所有函数必须包含类型提示
* 每个函数需提供 docstring 说明其用途

## 集成步骤

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 效率监控，用于成本敏感的开发
* 视觉密度，以实现每个字符最大信息量

相关推荐

更多