# Project Indicator

**Repository Path**: wasfjh/project-indicator

## Basic Information

- **Project Name**: Project Indicator
- **Description**:  Claude Code 状态栏插件 - 显示项目名称、Token 使用量和会话时长。
     ## 功能
     - 📁 **项目徽章** - 每个项目显示独特的颜色，方便区分多个窗口
     - 📊 **Token 统计** - 显示今日累计使用的 Token 数量
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-19
- **Last Updated**: 2026-03-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Project Indicator

Claude Code 状态栏插件 - 显示项目名称、Token 使用量和会话时长。

## 功能

- 📁 **项目徽章** - 每个项目显示独特的颜色，方便区分多个窗口
- 📊 **双层 Token 进度**（智谱 AI 机制）
  - **5小时配额** (540.9M) - 每5小时重置一次
  - **周配额** (2.16B) - 从昨天开始往后7天
  - 🟢 绿色 `< 50%` | 🟡 黄色 `50-80%` | 🟠 橙色 `80-95%` | 🔴 红色 `≥ 95%`
- 🤖 **模型名称** - 显示当前使用的模型
- ⏱️ **会话时长** - 显示今日工作时长

## 效果预览

```
📁 my-project | 📊 5h:[████░░░░░]20% 周:[█░░░░░░░]5% | claude-sonnet-4-6 | ⏱️ 25分钟
```

**说明：**
- `5h:[████░░░░░]20%` - 当前5小时时段已用 540.9M 配额的 20%
- `周:[█░░░░░░░]5%` - 本周已用 2.16B 配额的 5%
- 每5小时重置时间：00:00, 05:00, 10:00, 15:00, 20:00

## 安装

### 方法一：直接使用（推荐）

1. 将整个 `project-indicator` 文件夹复制到你的机器上，例如：
   ```
   C:\Users\<用户名>\.claude\plugins\project-indicator\
   ```

2. 编辑 Claude Code 全局配置文件：
   - Windows: `C:\Users\<用户名>\.claude\settings.json`
   - macOS/Linux: `~/.claude/settings.json`

3. 在配置文件中添加 `statusLine` 配置：

   ```json
   {
     "statusLine": {
       "type": "command",
       "command": "node C:/Users/<用户名>/.claude/plugins/project-indicator/dist/index.js"
     }
   }
   ```

   > **注意**：路径使用正斜杠 `/`，并将 `<用户名>` 替换为你的实际用户名。

4. 重启 Claude Code

### 方法二：从源码构建

如果你修改了源码，需要重新编译：

```bash
cd project-indicator
npm install
npm run build
```

## 配置说明

### 完整配置示例

```json
{
  "statusLine": {
    "type": "command",
    "command": "node /path/to/project-indicator/dist/index.js"
  }
}
```

### macOS/Linux 路径示例

```json
{
  "statusLine": {
    "type": "command",
    "command": "node /home/username/.claude/plugins/project-indicator/dist/index.js"
  }
}
```

## 数据存储

Token 使用记录存储在：
- Windows: `C:\Users\<用户名>\.claude\token-logs\usage.json`
- macOS/Linux: `~/.claude/token-logs/usage.json`

数据保留最近 30 天的记录。

## 常见问题

### Q: 状态栏没有显示？

1. 确认 Node.js 已安装（运行 `node --version` 检查）
2. 确认路径配置正确（使用正斜杠 `/`）
3. 确认 `dist/index.js` 文件存在
4. 完全退出并重启 Claude Code

### Q: 如何验证插件是否工作？

手动运行测试：
```bash
echo '{"cwd": "/path/to/test"}' | node /path/to/project-indicator/dist/index.js
```

应该看到类似输出：
```
📁 test | 📊 今日: 0 tokens | Unknown | ⏱️ -
```

### Q: 颜色显示不正常？

确保你的终端支持 ANSI 颜色：
- Windows: 使用 Windows Terminal 或 VS Code 终端
- macOS: 使用 Terminal.app 或 iTerm2
- Linux: 大多数现代终端都支持

## 文件结构

```
project-indicator/
├── dist/                    # 编译后的文件
│   ├── index.js            # 主入口
│   └── ...
├── src/                    # 源代码
│   ├── index.ts            # 主程序
│   ├── stdin.ts            # 读取 Claude Code 输入
│   ├── colors.ts           # 颜色处理
│   ├── transcript.ts       # 解析会话记录
│   └── types.ts            # 类型定义
├── package.json
├── tsconfig.json
└── README.md
```

## 系统要求

- Node.js 18+
- Claude Code CLI

## License

## 效果
![alt text](image.png)

MIT