# lyf-arkclaw-report

**Repository Path**: caoxingming/lyf-arkclaw-report

## Basic Information

- **Project Name**: lyf-arkclaw-report
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-03
- **Last Updated**: 2026-05-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# lyf-arkclaw-report

来伊份 arkclaw 坐席统计报表 CLI + Skills，从飞书多维表格读取数据并在终端展示。

## 安装

### 一键安装（推荐）

```bash
export REPO_URL="https://github.com/SpaceCao/lyf-arkclaw-report.git"
curl -sSL <repo-url>/install.sh | bash
```

或手动下载后执行：

```bash
chmod +x install.sh
REPO_URL="<仓库地址>" ./install.sh
```

### 手动安装

```bash
git clone https://github.com/SpaceCao/lyf-arkclaw-report.git ~/arkclaw
cd ~/arkclaw
npm install
npm run build
npm link

# 安装 Skills（OpenClaw / Hermes）
cp -r skills/arkclaw-* ~/.openclaw/skills/  # OpenClaw
cp -r skills/arkclaw-* ~/.hermes/skills/    # Hermes
```

### 环境变量配置

复制 `.env.example` 为 `.env` 并填入实际的 Base Token：

```bash
cp .env.example .env
# 编辑 .env 填入 ARKCLAW_BASE_TOKEN
```

### 卸载

```bash
./uninstall.sh
```

## 命令

### Token 消耗报表
```bash
arkclaw token daily --top 20          # 按天消耗排名
arkclaw token weekly --top 20         # 按周消耗排名
arkclaw token user <email>            # 查某人历史
```

### 部门 Token
```bash
arkclaw token dept-daily              # 部门每日排名（默认近7天）
arkclaw token dept-weekly             # 部门每周排名（默认近4周）
```

### 对账报表
```bash
arkclaw reconcile daily               # 对账日报
arkclaw reconcile trend --days 7      # 近7天趋势
```

### 龙虾开通
```bash
arkclaw lobster today                 # 今日新增
arkclaw lobster yesterday             # 昨日新增
arkclaw lobster list --dept CEO       # 开通明细
arkclaw lobster summary               # 开通统计
```

### 部门统计
```bash
arkclaw dept total --top 20           # 各部门开通情况
```

### 仪表盘总览
```bash
arkclaw dashboard show                # 所有关键指标
```

### 导出
```bash
arkclaw export token-daily --top 50   # 导出 CSV
arkclaw export reconcile              # 导出对账
arkclaw export token-dept-daily       # 导出部门日报
arkclaw export token-dept-weekly      # 导出部门周报
```

## 通用参数
- `--fresh` 强制刷新缓存
- `--format table|json|csv` 输出格式
- `--export <path>` 导出文件
- `--top N` 限制排名条数

## Skills 触发词
安装 Skills 后，在 OpenClaw / Hermes 对话中直接说：

| 触发词 | 执行命令 |
|--------|---------|
| "token消耗" "token排名" | `arkclaw token daily` |
| "上周token" "本周token" | `arkclaw token weekly` |
| "部门token" "部门消耗排名" | `arkclaw token dept-daily` |
| "龙虾开通" "开通情况" | `arkclaw lobster summary` |
| "开了多少个资源" | 多资源用户统计 |
| "对账" "差额" | `arkclaw reconcile daily` |
| "数据总览" "仪表盘" | `arkclaw dashboard show` |

## 定时推送
```cron
0 9 * * * cd ~/arkclaw && node dist/cli.js token daily --export /tmp/token-daily.csv
```