IELTS Tuyaya Upload 雅思成绩一键上传
上传雅思阅读复盘文件到服务器,支持 token 模式(进个人主页)和匿名模式。当用户想要上传已有的复盘 JSON、查看个人复盘仪表板时使用。触发词:上传复盘、上传复盘文件、sync review、upload review、查看我的复盘记录、我的仪表板、dashboard、tuyaya 上传、批量同步。
Rank
62
Safety
84
Downloads
1.2k
Updated
Oct 11, 2026
Version
1.3.2
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.2K downloads reported by the source. Last updated 10/11/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 11, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 11, 2026
- Adoption signal
- 1.2K downloadsadoption · observed Oct 11, 2026
- Latest release
- 1.3.2release · observed Jun 23, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s171z5dmkr3hr6e5vrt1whgtt583m22s:ielts-tuyaya-upload- Install using `clawhub skill install s171z5dmkr3hr6e5vrt1whgtt583m22s:ielts-tuyaya-upload` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/dengjiawei1226/ielts-tuyaya-upload before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-dengjiawei1226-ielts-tuyaya-upload/snapshot"
Documentation
CLAWHUB
65,572 characters of source documentation, loaded on request.
Extracted files
4 files captured from the source.
SKILL.md
---
name: ielts-tuyaya-upload
description: "上传雅思阅读复盘文件到服务器,支持 token 模式(进个人主页)和匿名模式。当用户想要上传已有的复盘 JSON、查看个人复盘仪表板时使用。触发词:上传复盘、上传复盘文件、sync review、upload review、查看我的复盘记录、我的仪表板、dashboard、tuyaya 上传、批量同步。"
---
# IELTS Review Upload Skill
## Purpose
把已有的雅思阅读复盘 JSON 上传到 www.liuxue.online。支持两种通道:
| 模式 | 触发条件 | 通道 | 数据落点 | 适用 |
|---|---|---|---|---|
| **Token 模式(推荐)** | 设置了 `IELTS_USER_TOKEN` 环境变量 | `POST /api/ielts {action:'batchImport', token}` | 主库 + **进个人主页进度图/词汇本** | 登录用户(dengjiawei / lishuzhuo / 其他注册账号) |
| **匿名模式(兜底)** | 没有 token | `POST /ielts-api/skill-review` (x-api-key) | 匿名 dashboard 表 | 访客试用、未注册账号 |
**默认走 token 模式**。脚本会自动检测 `IELTS_USER_TOKEN`,没设置时 v1.3.0 起会**直接弹起浏览器授权页**让用户一键完成绑定(OAuth 风格),完全无需 F12。
## What's New in v1.3.2 — 域名迁移到 liuxue.online
**⚠️ v1.3.2(2026-06-23)**:旧域名 `tuyaya.online` 因 ICP 备案审核已全站 403 不可用,所有默认 API/授权/登录地址迁移到 `www.liuxue.online`。`sync-review.sh` / `upload.js` / `setup-client-mode.sh`(含 CORS Allow-Origin)默认值全部更新。**老用户必须 `clawhub install ielts-tuyaya-upload --force` 更新**,否则上传会撞旧域名 403 失败。已存的 token 仍有效,无需重新授权。
## What's New in v1.3.0 — 浏览器授权流
跟随 ielts-reading-review v5.4.0 升级:
- ❌ **告别 F12 复制 token**:不再需要打开 DevTools → Console 手动 `localStorage.ielts_user_token`
- ✅ **一键浏览器授权**:缺 token 时 `sync-review.sh` 自动调起 `setup-client-mode.sh` → 浏览器弹 `www.liuxue.online/authorize.html` → 点【授权】完事
- 🔒 **token 全程在本机**:通过 `<img src=http://127.0.0.1:port/cb?token=...>` 回传,不进 URL bar,不走第三方
- 🛡️ **CSRF 防护**:state 随机串 + 回调白名单(仅 127.0.0.1/localhost)
- 🪟 **三系统支持**:macOS `open` / Linux `xdg-open` / 兜底打印链接手动粘贴
## When to Activate
- 用户说"上传复盘"、"上传复盘文件"
- 用户说 "sync review"、"upload review"
- 用户想查看个人复盘仪表板
- 用户说"查看我的复盘记录"、"我的仪表板"
## Workflow
### Step 0: 确认 token 是否就位
第一步先检查 `IELTS_USER_TOKEN`:
```bash
echo "${IELTS_USER_TOKEN:0:20}..." # 只显示前 20 位避免泄漏
```
- **有输出** → 走 token 模式,数据进个人主页 ✅
- **没输出** → 走 v1.3.0 浏览器授权流(OAuth 风格,30 秒搞定):
```
你还没配置 IELTS_USER_TOKEN,上传后数据不会进个人主页进度图。
🔧 一键授权(推荐):
bash ~/.workbuddy/skills/ielts-reading-review/scripts/setup-client-mode.sh
脚本会:
1. 在本机起一个随机端口的 HTTP 服务监听回调
2. 自动唤起浏览器到 www.liuxue.online/authorize.html
3. 你在网页点【授权】按钮,token 通过 <img> 请求回传到本机
4. 校验通过后写入 ~/.zshrc 并 source 生效
5. token 永远不离开你的电脑(不进 URL bar、不走第三方)
兜底(浏览器/网络异常时):
bash setup-client-mode.sh --manual # 走 F12 复制 token 老流程
要不要现在跑一下,还是先走匿名模式?
```
**v1.3.0 起 sync-review.sh 自动检测 token,没设置时直接调起 setup-client-mode.sh,全程不用手动复制。**
### Step 1: 收集 JSON 文件路径
询问用户要上传的 JSON 文件路径。
**JSON 格式支持两种**:
**扁平格式(最简)**:
```json
{
"book": 5,
"test": 4,
"passage": 1,
"score": 11,
"total": 13,
"date": "2026-04-09",
"duration": 2050,
"wrongQuestions": [3, 7, 12]
}
```
**v4.0 富格式(推荐,复盘 skill 直接产出)**:
```json
{
"version": "4.0.0",
"source": {"book": 5, "test": 4, "passage": 1, "title": "...", "titleCN": "..."},
"score": {"correct": 11, "total": 13, "band": "6.5-7.0"},
"timing": {"minutes": 34.2, "formatted": "34:10"},
"date": "2026-04-09",
"wrongQuestions": [...],
"synonyms": [...],
"vocabulary": [...]
}
```
服务端 schemaUpgrader 会自动识README.md
# IELTS Tuyaya Upload
把本地雅思阅读复盘 JSON 一键上传到 [www.liuxue.online](https://www.liuxue.online/ielts/),告别手动拖文件。
## 🆕 v1.3.0 — 浏览器一键授权(告别 F12)
跟随 `ielts-reading-review` v5.4.0 同步升级,**绑定账号体验彻底重做**:
| 旧流程 (≤v1.2) | 新流程 (v1.3+) |
|---|---|
| 打开 www.liuxue.online 登录 | 同左 |
| F12 → Console → `localStorage.ielts_user_token` | ❌ 不再需要 |
| 手动复制 token 字符串 | ❌ 不再需要 |
| 打开 ~/.zshrc 手动 `export IELTS_USER_TOKEN=...` | ❌ 不再需要 |
| `source ~/.zshrc` | ❌ 不再需要 |
| —— | ✅ 浏览器弹授权页,点一下【授权】完事 |
**触发方式**:跑任何上传命令(如 `node scripts/upload.js --batch xxx`),脚本检测到没设 `IELTS_USER_TOKEN` 就会自动调起 `setup-client-mode.sh`,几秒后浏览器弹出 OAuth 风格的授权卡片。
**安全保障**:
- token 通过 `<img src=http://127.0.0.1:随机端口/cb?token=...>` 回传到本机,永远不离开你的电脑
- 回调地址白名单:仅接受 `127.0.0.1 / localhost / ::1`
- CSRF state 校验:每次启动随机生成 16 字节,防止跨站攻击
- token 不进浏览器 URL bar、不走第三方服务器
如果浏览器异常,可手动跑 `bash setup-client-mode.sh --manual` 走 F12 老流程兜底。
---
## 适合谁用?
- 用 `ielts-reading-review` skill 生成了一堆 JSON 复盘文件
- 想把成绩同步到 www.liuxue.online 云端,在任何设备打开网页查看
- 不想手动一个个拖到 submit 页面
- 有一堆旧笔记(HTML/Markdown/截图)想一次性导入成绩看趋势图
## 🚀 端到端一条龙(推荐)
如果你的复盘还是散在文件夹里的旧笔记,推荐配合 `ielts-reading-review` v3.4.0+ 一起用:**自动扫 → 生成 JSON → 自动上传**,一条 prompt 搞定。
### Step 1:装两个 skill(只做一次)
```bash
clawhub install ielts-reading-review
clawhub install ielts-tuyaya-upload
```
### Step 2:把下面这段 prompt 整段发给你的 AI Buddy
**不用改任何内容,复制粘贴直接发就行。**
```
帮我一条龙处理我的历史雅思复盘。
流程:
【A. 自动找复盘文件夹】
1. 用 ielts-reading-review skill 的 scan-legacy-reviews.js --auto 扫我电脑常见位置
2. 把推荐目录和其他候选报给我,让我确认用哪个
【B. 生成 JSON】
3. 对确认后的目录做深扫(--deep),列出识别到的篇目清单,让我再确认一次
4. 逐篇生成 v3.0 schema 的 JSON,输出到 ./batch-output/
5. 字段缺失的地方不要瞎编,缺就置空
6. 汇报成功几篇、数据缺失几篇
【C. 上传到 www.liuxue.online】
7. 用 ielts-tuyaya-upload skill 检查登录状态(--whoami)
- 如果我还没账号:引导我 --register 注册(我会自己输入用户名密码)
- 如果已登录:继续
8. 先跑 --diff ./batch-output/ 给我看差量(哪些是新的、哪些服务器已有)
9. 我确认后,跑 --batch ./batch-output/ 批量上传
10. 上传完告诉我成功几条,给我 https://www.liuxue.online/ielts/ 的链接让我去看成绩
规则:
- 每一步之间要停下来等我确认,别一口气全跑完
- 注册/登录时让我自己在终端输入密码,你不要替我生成
- 上传过程中有失败的,列出来让我决定要不要重试
```
### Step 3:按 Buddy 提示逐步确认
AI 会每一步停下来让你确认:路径对不对 → 篇目清单对不对 → 上传差量对不对 → 最后给你成绩链接。
### 全流程示意
```
你 ─▶ 我发 prompt
│
▼
Buddy ─▶ 🔍 auto 扫电脑
│
▼
你 ─▶ 确认"用这个目录"
│
▼
Buddy ─▶ 📂 深扫列出所有篇目
│
▼
你 ─▶ 确认"篇目没错"
│
▼
Buddy ─▶ ✍️ 逐篇生成 JSON 到 batch-output/
│
▼
Buddy ─▶ 🔑 检查 tuyaya 账号
│
▼
你 ─▶ (首次)注册账号 / 已有直接登录
│
▼
Buddy ─▶ 📊 diff 差量给你看
│
▼
你 ─▶ "上传吧"
│
▼
Buddy ─▶ 🚀 批量上传
│
▼
你 ─▶ 🎯 去 www.liuxue.online 看成绩
```
### 各阶段预计耗时
| 阶段 | 时间 |
|------|------|
| 🔍 自动发现 | 3-5 秒 |
| 📂 深扫 + 确认篇目 | 10-30 秒 |
| ✍️ 生成 JSON(每篇) | 1-3 分钟 |
| 🔑 注册/登录(首次) | 30 秒 |
| 📊 diff | 5 秒 |
| 🚀 批量上传 | 每篇 1-2 秒_meta.json
{
"ownerId": "kn7dr93fbgrvymnk8d9r9y0tws83mhrk",
"slug": "ielts-tuyaya-upload",
"version": "1.3.2",
"publishedAt": 1782184030308
}skill-card.md
## Description: Uploads local IELTS reading review JSON files to www.liuxue.online, with token-based account sync and an anonymous fallback mode. This skill is ready for commercial/non-commercial use. ## Publisher: [dengjiawei1226](https://clawhub.ai/user/dengjiawei1226) ### License/Terms of Use: MIT-0 ## Use Case: Learners and agents use this skill to upload existing IELTS reading review JSON files, compare local and server records, and view synchronized review progress on www.liuxue.online. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: The skill uploads IELTS review data to www.liuxue.online and uses local account tokens for token mode. Mitigation: Install and run it only after accepting that data flow, and review local token storage before using account sync. Risk: Anonymous mode can send a persistent local identifier and OS username. Mitigation: Prefer token mode for normal use, or set explicit anonymous identifiers only after deciding that disclosure is acceptable. Risk: The publishing helper can modify local skill installations and is intended for maintainers. Mitigation: Do not run publish-clawhub.sh unless maintaining the package and prepared for its local install changes. ## Reference(s): - [ClawHub skill page](https://clawhub.ai/dengjiawei1226/skills/ielts-tuyaya-upload) - [www.liuxue.online IELTS dashboard](https://www.liuxue.online/ielts/) ## Skill Output: **Output Type(s):** [text, markdown, shell commands, configuration, guidance] **Output Format:** [Markdown guidance with shell commands and JSON examples] **Output Parameters:** [1D] **Other Properties Related to Output:** [May guide execution of local shell or Node.js upload commands that send JSON review data to www.liuxue.online.] ## Skill Version(s): 1.3.2 (source: server release metadata) ## Ethical Considerations: Users 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.
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/dengjiawei1226/skills/ielts-tuyaya-upload",
"sourceUrl": "https://clawhub.ai/dengjiawei1226/skills/ielts-tuyaya-upload",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T02:59:24.035Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-dengjiawei1226-ielts-tuyaya-upload/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-dengjiawei1226-ielts-tuyaya-upload/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-11T02:59:24.035Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.2K downloads",
"href": "https://clawhub.ai/dengjiawei1226/ielts-tuyaya-upload",
"sourceUrl": "https://clawhub.ai/dengjiawei1226/ielts-tuyaya-upload",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T02:59:24.035Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.3.2",
"href": "https://clawhub.ai/dengjiawei1226/ielts-tuyaya-upload",
"sourceUrl": "https://clawhub.ai/dengjiawei1226/ielts-tuyaya-upload",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-06-23T03:07:10.308Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-dengjiawei1226-ielts-tuyaya-upload/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-dengjiawei1226-ielts-tuyaya-upload/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.3.2",
"description": "v1.3.2: 域名迁移 tuyaya.online → www.liuxue.online(旧域名因 ICP 备案审核已全站 403 不可用)。sync-review.sh/upload.js 默认 API 地址、所有提示文案、README/SKILL 文档全部切换。老用户必须 --force 更新,已存 token 仍有效。\\n\\nv1.3.1: 文档大改造,README/SKILL 全面阐释 v1.3.0 OAuth 风格浏览器授权流——新旧流程对比表 + 安全设计四大保障 + Q&A 答疑。同步推送 GitHub。\\n\\nv1.3.0: 跟随 ielts-reading-review v5.4.0 升级——sync-review.sh 在 IELTS_USER_TOKEN 缺失时,自动调用 setup-client-mode.sh 走浏览器授权流(不再要求用户 F12 手动复制 token)。",
"href": "https://clawhub.ai/dengjiawei1226/ielts-tuyaya-upload",
"sourceUrl": "https://clawhub.ai/dengjiawei1226/ielts-tuyaya-upload",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-06-23T03:07:10.308Z",
"isPublic": true
}
]
}Record generated Oct 11, 2026.
