usage-visualizer

TotalClaw 作者 totalclaw

OpenClaw 的高级使用统计和高保真可视化报告。 100%本地加工。经过审计验证的隐私（不存储凭据）。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw install totalclaw:totalclaw~vintlin-usage-visualizer

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~vintlin-usage-visualizer/file -o vintlin-usage-visualizer.md

# Usage Visualizer

**Usage Visualizer** is a high-fidelity analytics engine for OpenClaw that transforms raw session logs into professional, actionable visual reports.

## 🚀 Quick Start

```bash
# Generate today's visual report
python3 scripts/run_usage_report.py --mode image --period today
```

## 📈 Usage Guide

### Visual Reports
The visualizer syncs logs first, then generates the report image.
- `python3 scripts/run_usage_report.py --mode image --period today`
- `python3 scripts/run_usage_report.py --mode image --period week --json`

### Text Summaries
- `python3 scripts/run_usage_report.py --mode text --period today --json`

## 🛡 Delivery Protocol (MANDATORY FOR AGENTS)

1.  **Image Delivery**: Extract `image_path` from JSON and send as attachment using `message` tool's `filePath`. **NEVER** send the local path as a string.
2.  **Verification**: Verify the file exists and is a valid PNG before sending.
3.  **No Network**: This skill is 100% local. It has zero network dependencies.

## 📄 License
MIT

---

## 中文说明

# Usage Visualizer

**Usage Visualizer** 是面向 OpenClaw 的高保真分析引擎，可将原始会话日志转化为专业、可付诸行动的可视化报告。

## 🚀 快速开始

```bash
# Generate today's visual report
python3 scripts/run_usage_report.py --mode image --period today
```

## 📈 使用指南

### 可视化报告
可视化工具会先同步日志，然后生成报告图片。
- `python3 scripts/run_usage_report.py --mode image --period today`
- `python3 scripts/run_usage_report.py --mode image --period week --json`

### 文本摘要
- `python3 scripts/run_usage_report.py --mode text --period today --json`

## 🛡 交付协议（代理强制遵守）

1.  **图片交付**：从 JSON 中提取 `image_path`，并使用 `message` 工具的 `filePath` 作为附件发送。**绝不要** 将本地路径作为字符串发送。
2.  **验证**：发送前验证文件存在且为有效的 PNG。
3.  **无网络**：本技能 100% 本地运行。它没有任何网络依赖。

## 📄 许可证
MIT