\nUploads local IELTS reading review JSON to tuyaya.online in token mode for account-bound dashboards or anonymous mode for fallback dashboards.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[dengjiawei1226](https://clawhub.ai/user/dengjiawei1226)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nIELTS learners and agents that already have IELTS reading review JSON use this skill to upload single files or batches to tuyaya.online, compare local reviews with server records, and open account-bound or anonymous dashboards.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: IELTS review JSON and tuyaya authentication tokens are sent to tuyaya.online.
\nMitigation: Install only if comfortable with that data transfer, review files before batch upload, and avoid sharing tokens, terminal output, or chat logs that contain sensitive values.
\nRisk: Anonymous mode can link uploads to a stable local identifier and exposes dashboard links that include access parameters.
\nMitigation: Treat anonymous uploads as pseudonymous, do not share anonymous dashboard links, and prefer token mode for account-bound data.
\nRisk: Saved tokens and printed status output can expose account access if copied into logs or shared prompts.
\nMitigation: Keep token files and environment variables private, mask token values when checking configuration, and rotate or re-login if a token may have been exposed.
\n\n\n## Reference(s):
\n- [ClawHub release page](https://clawhub.ai/dengjiawei1226/ielts-tuyaya-upload)
\n- [Tuyaya IELTS](https://tuyaya.online/ielts/)
\n- [Tuyaya IELTS reading dashboard](https://tuyaya.online/ielts/reading.html)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]
\n**Output Format:** [Markdown guidance with inline shell commands and status output]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [May invoke local shell scripts that upload JSON files and print dashboard URLs, token status, diff results, or upload errors.]
\n\n## Skill Version(s):
\n1.3.1 (source: server release evidence)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
\n\nArchive v1.3.0: 6 files, 16973 bytes\n\nFiles: publish-clawhub.sh (2580b), README.md (7674b), scripts/sync-review.sh (7745b), scripts/upload.js (16590b), SKILL.md (6014b), _meta.json (138b)\n\nFile v1.3.0:SKILL.md\n\n---\nname: ielts-tuyaya-upload\ndescription: \"上传雅思阅读复盘文件到服务器，支持 token 模式（进个人主页）和匿名模式。当用户想要上传已有的复盘 JSON、查看个人复盘仪表板时使用。触发词：上传复盘、上传复盘文件、sync review、upload review、查看我的复盘记录、我的仪表板、dashboard、tuyaya 上传、批量同步。\"\n---\n\n# IELTS Review Upload Skill\n\n## Purpose\n\n把已有的雅思阅读复盘 JSON 上传到 tuyaya.online。支持两种通道：\n\n| 模式 | 触发条件 | 通道 | 数据落点 | 适用 |\n|---|---|---|---|---|\n| **Token 模式（推荐）** | 设置了 `IELTS_USER_TOKEN` 环境变量 | `POST /api/ielts {action:'batchImport', token}` | 主库 + **进个人主页进度图/词汇本** | 登录用户（dengjiawei / lishuzhuo / 其他注册账号） |\n| **匿名模式（兜底）** | 没有 token | `POST /ielts-api/skill-review` (x-api-key) | 匿名 dashboard 表 | 访客试用、未注册账号 |\n\n**默认走 token 模式**。脚本会自动检测 `IELTS_USER_TOKEN`，没设置才 fallback 到匿名。\n\n## When to Activate\n\n- 用户说\"上传复盘\"、\"上传复盘文件\"\n- 用户说 \"sync review\"、\"upload review\"\n- 用户想查看个人复盘仪表板\n- 用户说\"查看我的复盘记录\"、\"我的仪表板\"\n\n## Workflow\n\n### Step 0: 确认 token 是否就位\n\n第一步先检查 `IELTS_USER_TOKEN`：\n\n```bash\necho \"${IELTS_USER_TOKEN:0:20}...\" # 只显示前 20 位避免泄漏\n```\n\n- **有输出** → 走 token 模式，数据进个人主页 ✅\n- **没输出** → 提醒用户：\n\n```\n你还没配置 IELTS_USER_TOKEN，上传后数据不会进个人主页进度图。\n\n🔧 一次配置永久生效：\n1. 浏览器登录 https://tuyaya.online/ielts/login.html\n2. 打开 DevTools → Console，运行：localStorage.token\n3. 复制返回的字符串（一长串 base64）\n4. 在 ~/.zshrc 或 ~/.bashrc 末尾加一行：\n export IELTS_USER_TOKEN='粘贴token'\n5. source ~/.zshrc\n\n要不要先帮你配 token，还是直接走匿名模式？\n```\n\n### Step 1: 收集 JSON 文件路径\n\n询问用户要上传的 JSON 文件路径。\n\n**JSON 格式支持两种**：\n\n**扁平格式（最简）**：\n```json\n{\n \"book\": 5,\n \"test\": 4,\n \"passage\": 1,\n \"score\": 11,\n \"total\": 13,\n \"date\": \"2026-04-09\",\n \"duration\": 2050,\n \"wrongQuestions\": [3, 7, 12]\n}\n```\n\n**v4.0 富格式（推荐，复盘 skill 直接产出）**：\n```json\n{\n \"version\": \"4.0.0\",\n \"source\": {\"book\": 5, \"test\": 4, \"passage\": 1, \"title\": \"...\", \"titleCN\": \"...\"},\n \"score\": {\"correct\": 11, \"total\": 13, \"band\": \"6.5-7.0\"},\n \"timing\": {\"minutes\": 34.2, \"formatted\": \"34:10\"},\n \"date\": \"2026-04-09\",\n \"wrongQuestions\": [...],\n \"synonyms\": [...],\n \"vocabulary\": [...]\n}\n```\n\n服务端 schemaUpgrader 会自动识别富格式，无需手动转换。\n\n### Step 2: 跑上传脚本\n\n```bash\nbash ~/.workbuddy/skills/ielts-review-upload/scripts/sync-review.sh