IELTS Review Upload Skill

Purpose

上传已有的雅思阅读复盘数据（JSON）到云端服务器，并在个人仪表板上查看所有复盘记录和进步趋势。

⚠️ 重要提示：告知用户查看结果的入口

上传完成后，必须明确告知用户去哪里看复盘结果：

🔗 在线阅读复盘首页：https://tuyaya.online/ielts/reading.html

在这里可以：

• 查看所有历史复盘记录（按时间排列）
• 查看进步趋势图表
• 跨设备访问（手机/电脑都能看）

每次上传完成后，回复中必须包含仪表板链接。

When to Activate

• 用户说"上传复盘"、"上传复盘文件"
• 用户说"sync review"、"upload review"
• 用户想查看个人复盘仪表板
• 用户说"查看我的复盘记录"、"我的仪表板"

Workflow

Step 1: Collect Input

询问用户要上传的 JSON 数据文件路径。

JSON 文件格式要求：

{
  "book": 5,
  "test": 4,
  "passage": 1,
  "score": 11,
  "total": 13,
  "date": "2026-04-09",
  "band": "6.5-7.0",
  "timeSpent": "34:10",
  "wrongQuestions": [3, 7, 12],
  "errorCategories": ["synonym_failure", "over_inference"]
}

Step 2: Run Upload Script

运行上传脚本：

bash scripts/sync-review.sh <path-to-data.json>

脚本功能：

• 自动生成稳定的匿名用户 ID（基于机器的 hostname + username 的 SHA256 哈希）
• 上传数据到私有后端（需要 API key 认证）
• 打印个性化仪表板 URL

如果脚本不存在：

从当前 Skill 目录复制，或者从 GitHub 下载：

curl -o scripts/sync-review.sh https://raw.githubusercontent.com/dengjiawei1226/ielts-reading-review/main/scripts/sync-review.sh
chmod +x scripts/sync-review.sh

Step 3: Return Dashboard URL

上传完成后，告诉用户他们的仪表板 URL：

首次用户：

✅ 上传成功！

你的个人复盘仪表板：
https://tuyaya.online/ielts/reading.html?user=xxx&key=xxx

建议收藏这个链接，方便随时查看你的进步趋势。

返回用户：

✅ 上传成功！已同步到你的仪表板。

查看所有复盘记录：
https://tuyaya.online/ielts/reading.html?user=xxx&key=xxx

Step 4: View Dashboard (Optional)

如果用户想立即查看仪表板，可以：

1. 打开浏览器访问仪表板 URL
2. 或者生成二维码方便手机访问

Configuration

API Key

脚本中已内置默认的 API key：ielts_8b0832b3cfd38884e44ab26ee68acaeed294623ef8da9b201871a7768b072606

如果需要更换 API key，编辑 scripts/sync-review.sh 文件，修改 API_KEY 变量。

Backend URL

默认后端 URL：https://tuyaya.online/ielts-api

如果需要更换，编辑 scripts/sync-review.sh 文件，修改 API_BASE 变量。

User ID Generation

用户 ID 是自动生成的，基于：

• 机器的 hostname
• 当前用户名

生成算法：

echo -n "$(hostname)-$(whoami)" | shasum -a 256 | cut -c1-16

同样的机器总是生成同样的用户 ID。

Reference Files

Troubleshooting

"file not found" Error

确保你提供的 JSON 文件路径是正确的。

"Upload failed" Error

检查：

1. 网络连接是否正常
2. API key 是否有效
3. 后端服务器是否可访问

"JSON file must contain..." Error

确保你的 JSON 文件包含必要的字段：book, test, passage, score, total

Style Guidelines

• 简洁直接 — 不要多余的解释
• 功能导向 — 每个句子都应该帮助用户完成上传
• 中文是主要语言，英文术语保留原样
• 上传完成后，总是提供仪表板 URL