juliantanx/aiusage-site

AIUsage镜像描述

镜像概述

AIUsage是一个本地优先的AI编码助手使用跟踪工具，可在单个本地仪表盘中集中跟踪20+AI编码工具的令牌消耗、成本、会话、模型、项目等数据。本地使用无需账户，不发送遥测数据，支持可选的跨设备同步和公开排行榜功能。

核心功能

• 单一本地仪表盘：整合展示令牌、成本、会话、模型、项目等多维度数据；
• 广泛工具支持：兼容Claude Code、Copilot、Cursor、Gemini CLI等20+主流AI编码工具；
• 可选数据同步：支持通过GitHub、S3、R2或MinIO实现跨设备数据同步；
• 隐私优先设计：本地解析和仪表盘不上传提示词、代码、文件路径等敏感信息；
• 可选公开排行榜：仅上传聚合令牌数据参与排名，保护用户隐私。

使用场景

• 个人开发者：跟踪自身AI编码助手的使用情况，优化成本和效率；
• 团队管理：统计团队成员AI工具的使用数据，进行成本管控和资源分配；
• AI工具爱好者：分析不同AI编码工具的使用习惯，对比性能和成本。

配置说明

1. 数据持久化：通过挂载~/.aiusage目录保存AIUsage的解析数据和配置；
2. 日志目录挂载：若需解析主机上的AI工具日志，需挂载对应工具的日志目录，并通过环境变量指定路径（如AIUSAGE_COPILOT_PATH）；
3. 仪表盘密码保护：设置AIUSAGE_DASHBOARD_PASSWORD环境变量，防止未授权访问仪表盘API。

Docker部署示例

基本运行命令

bash
docker run -d \
  -p 3847:3847 \
  -v ~/.aiusage:/root/.aiusage \
  juliantanx/aiusage-site

访问http://localhost:3847即可使用本地仪表盘。

挂载AI工具日志目录（以Copilot为例）

bash
docker run -d \
  -p 3847:3847 \
  -v ~/.aiusage:/root/.aiusage \
  -v ~/.config/github-copilot:/root/.config/github-copilot \
  -e AIUSAGE_COPILOT_PATH=/root/.config/github-copilot \
  juliantanx/aiusage-site

设置仪表盘密码

bash
docker run -d \
  -p 3847:3847 \
  -v ~/.aiusage:/root/.aiusage \
  -e AIUSAGE_DASHBOARD_PASSWORD="your-secure-password" \
  juliantanx/aiusage-site