name: monkeytype-tracker
description: 追踪并分析 Monkeytype 打字统计数据，提供改进建议。当用户提及 "monkeytype"、"typing stats"、"typing speed"、"WPM"、"typing practice"、"typing progress" 或想查看打字表现时使用。功能包括按需统计、测试历史分析、个人最佳记录、进度对比、排行榜查询以及可选的自动报告。需要用户的 Monkeytype ApeKey 以访问 API。

Monkeytype 追踪器

追踪您的 Monkeytype 打字统计数据，并获得个性化的改进建议。

前置检查（务必首先执行）

在运行任何命令之前，请检查设置是否已完成：

安全优先级：
1. 环境变量（最安全）：MONKEYTYPE_APE_KEY
2. 配置文件备用：~/.openclaw/workspace/config/monkeytype.json

# 首先检查环境变量
ape_key = os.getenv('MONKEYTYPE_APE_KEY')
if not ape_key:
    # 检查配置文件是否存在并包含有效密钥
    config_path = Path.home() / ".openclaw" / "workspace" / "config" / "monkeytype.json"

如果既无环境变量也无配置文件： → 运行设置流程（步骤 1）
如果 apeKey 存在但 API 返回 471 "inactive"： → 告知用户激活密钥（勾选复选框）
如果 apeKey 有效： → 继续执行命令

设置流程（3 个步骤）

步骤 1：获取 ApeKey

发送此消息：

你好！👋 看来你想追踪 Monkeytype 统计数据。我需要你的 API 密钥才能开始。

**🔑 如何获取：**
1.  访问 monkeytype.com → **账户设置**（点击你的个人资料图标）
2.  在左侧边栏选择 **"Ape Keys"**
3.  点击 **"Generate new key"**
4.  ⚠️ **激活它：** 勾选新密钥旁边的复选框（密钥默认处于非活动状态！）
5.  复制密钥并发送给我

你分享密钥后，我会询问自动化偏好设置 🤖

---

🔒 **想手动添加？** 没问题！

**选项 1：环境变量（推荐 - 最安全）**
在系统中设置：
- Windows (PowerShell): `$env:MONKEYTYPE_APE_KEY="你的密钥"`
- Linux/Mac: `export MONKEYTYPE_APE_KEY="你的密钥"`

**选项 2：配置文件**
创建此文件：`~/.openclaw/workspace/config/monkeytype.json`
内容如下：
{
  "apeKey": "你的密钥"
}

然后只需说 "monkeytype stats"，我会接手后续工作！

收到密钥后：
1. 保存到 ~/.openclaw/workspace/config/monkeytype.json：

{
  "apeKey": "用户密钥",
  "automations": {
    "dailyReport": false,
    "weeklyReport": false,
    "reportTime": "20:00"
  }
}

2. 立即测试密钥，运行 python scripts/monkeytype_stats.py stats
3. 如果出现 471 错误 → 密钥未激活，请用户勾选复选框
4. 如果成功 → 进入步骤 2

步骤 2：验证并询问自动化偏好

密钥验证成功后，发送：

收到！密钥已保存并验证通过 ✅

**📊 快速概览：**
• 已完成 {tests} 次测试（{hours} 小时）
• 🏆 个人最佳：{pb_15}WPM (15秒) | {pb_30}WPM (30秒) | {pb_60}WPM (60秒)
• 🔥 当前连续打卡：{streak} 天

现在，你想要自动报告吗？

**选项：**
1️⃣ **每日报告** — 当天练习总结
2️⃣ **每周报告** — 周度对比 + 建议
3️⃣ **两者都要**
4️⃣ **都不要** — 仅按需提供

⏰ 我应该在什么时间发送报告？（默认：晚上 8 点）

步骤 3：完成设置

用户选择选项后：
1. 使用偏好设置更新配置文件
2. 如果启用了自动化，则创建定时任务：
- 每日：0 {hour} * * *，名称为 monkeytype-daily-report
- 每周：0 {hour} * * 0，名称为 monkeytype-weekly-report
3. 发送完成消息：

🎉 **一切就绪！**

**✅ 配置已保存：**
• 每周报告：{状态}
• 每日报告：{状态}

**💡 随时可以尝试这些命令：**
• "显示我的打字统计数据"
• "我的打字进度如何"
• "对比我这周的打字情况"
• "monkeytype 排行榜"

打字愉快！愿你的每分钟字数（WPM）节节高升 🚀⌨️

错误处理

命令

获取统计数据

触发词："显示我的 monkeytype 统计数据"、"我的打字情况如何"、"打字统计数据"

1. 执行前置检查（见上文）
2. 运行：python scripts/monkeytype_stats.py stats
3. 使用表情符号美化输出格式

近期历史与分析

触发词："分析我近期的打字情况"、"我最近打字怎么样"

1. 执行前置检查
2. 运行：python scripts/monkeytype_stats.py history --limit 50
3. 分析输出并提供 2-3 条改进建议

进度对比

触发词："对比我的打字进度"、"我有进步吗"

1. 执行前置检查
2. 运行：python scripts/monkeytype_stats.py compare

排行榜查询

触发词："monkeytype 排行榜"、"我的排名如何"

1. 执行前置检查
2. 运行：python scripts/monkeytype_stats.py leaderboard [--mode time] [--mode2 60]

改进建议逻辑

获取统计数据后，根据以下情况分析并提供建议：

API 说明

• 基础 URL：https://api.monkeytype.com
• 认证头：Authorization: ApeKey {密钥}
• 速率限制：全局 30 次/分钟，结果端点 30 次/天
• 尽可能在本地缓存结果

文件

• ~/.openclaw/workspace/config/monkeytype.json：用户配置文件
• scripts/monkeytype_stats.py：主要统计数据获取脚本