ccusage 的项目扩展与二次开发

项目的基础介绍

ccusage 是一个命令行界面（CLI）工具，用于分析本地 JSONL 文件中的 Claude Code 使用情况。该工具旨在帮助用户了解他们在使用 Claude Code 时的令牌使用情况和成本，特别是对于那些在 Max 计划下无限使用 Claude Code 的用户，它可以帮助他们计算如果按使用量付费将会产生的费用。

项目的核心功能

• 日常报告：按照日期汇总令牌使用情况和成本。
• 会话报告：按照会话分组显示使用情况，按成本排序。
• 日期过滤：支持通过 --since 和 --until 选项按日期范围筛选报告。
• 自定义路径：支持自定义 Claude 数据目录位置。
• 输出格式：提供彩色的表格输出以及结构化的 JSON 格式输出。
• 成本跟踪：为每天或每个会话显示以美元为单位的成本。
• 缓存令牌支持：单独跟踪和显示缓存创建和缓存读取令牌。

项目使用了哪些框架或库？

该项目主要使用了以下框架和库：

• Node.js：作为运行环境。
• bun：一个 JavaScript 运行时和包管理器，用于安装和运行项目。

项目的代码目录及介绍

项目的代码目录结构如下：

ccusage/
├── .github/            # GitHub 工作流程和配置文件
├── commands/           # 存放命令相关的代码
├── docs/               # 项目文档
├── .gitignore          # Git 忽略文件列表
├── CLAUDE.md           # 关于 Claude 的信息文件
├── LICENSE             # 项目许可证文件
├── README.md           # 项目说明文件
├── biome.json          # 数据文件
├── bun.lock            # bun 包管理器的锁文件
├── calculate-cost.test.ts  # 计算成本的测试文件
├── calculate-cost.ts    # 计算成本的代码文件
├── data-loader.test.ts  # 数据加载器的测试文件
├── data-loader.ts      # 数据加载器的代码文件
├── index.ts            # 项目入口文件
├── logger.ts           # 日志记录器的代码文件
├── package.json        # 项目包描述文件
├── shared-args.ts      # 公共参数处理的代码文件
├── tsconfig.json       # TypeScript 配置文件
├── types.ts            # 类型定义文件
├── typos.toml          # 类型检查配置文件
├── utils.test.ts       # 工具函数的测试文件
└── utils.ts            # 工具函数的代码文件

对项目进行扩展或者二次开发的方向

1. 增强报告功能：可以增加更多的报告类型，例如按月或按年汇总的报告。
2. 支持更多数据源：目前工具只支持本地 JSONL 文件，可以扩展支持从远程服务器获取数据。
3. 集成到其他工具或平台：可以将 ccusage 集成到其他项目管理或分析工具中，为用户提供更全面的服务。
4. 优化性能：对于大型数据集，可以考虑优化数据处理算法，提高工具的运行效率。
5. 用户界面：可以开发一个基于 Web 的用户界面，让用户在浏览器中查看和分析报告。