What makes IELTS Reading Review 雅思阅读复盘 notable?

2K downloads. Trust evidence available

How should IELTS Reading Review 雅思阅读复盘 be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

IELTS Reading Review 雅思阅读复盘

IELTS Reading passage review, scoring, and progress tracking skill. Generates structured review data (JSON) and deploys to www.liuxue.online via saveReview A...

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

2.0k

Updated

Oct 9, 2026

Version

5.5.2

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 2K downloads reported by the source. Last updated 10/9/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 9, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 9, 2026
Adoption signal: 2K downloadsadoption · observed Oct 9, 2026
Latest release: 5.5.2release · observed Jun 23, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s171z5dmkr3hr6e5vrt1whgtt583m22s:ielts-reading-review

Install using `clawhub skill install s171z5dmkr3hr6e5vrt1whgtt583m22s:ielts-reading-review` 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-reading-review before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-dengjiawei1226-ielts-reading-review/snapshot"

Documentation

CLAWHUB

155,431 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: ielts-reading-review
description: "IELTS Reading passage review, scoring, and progress tracking skill. Generates structured review data (JSON) and deploys to www.liuxue.online via saveReview API. The server's review.html template renders JSON into unified pages. No standalone HTML generation needed. Supports batch import of legacy reviews with auto-discovery of review folders. Trigger phrases: 雅思复盘, 帮我复盘阅读, IELTS reading review, 分析错题, 阅读错题分析, 成绩单, 打分, 统计, 进步趋势, 批量导入历史复盘, 历史笔记转 JSON, 把文件夹里的复盘都生成 JSON, 扫一下我电脑里的复盘, 帮我找出所有历史笔记, 自动发现复盘, score, band, progress, batch import, auto scan."
---

# IELTS Reading Review Skill

## Purpose

帮用户把雅思阅读做题结果变成结构化数据（JSON），通过 saveReview API 入库后由后端 review.html 模板统一渲染页面。

## 🔴🔴🔴 最高铁律 (v5.5.2 — Cannot Be Skipped)

**只要主人在对话里发了雅思阅读题（截图 / 文字答案 / 错题列表 / 任何阅读相关材料），就必须一气呵成跑完以下闭环，不允许中途停在文字分析阶段：**

```
读截图 → 错题确认 → 写错题分析 → ★生成 v4.0 JSON★ → ★saveReview/upload 入库★ → ★getReviews 回查 ✅★ → 汇报线上链接
```

**判定"复盘完成"的唯一标准 = `getReviews` 回查显示该篇已入库（不是"我写完文字分析了"）。**

**绝对禁止的"假完成"模式（历史血泪）：**
- ❌ 写完错题分析就交卷，不生成 JSON → 主人在 www.liuxue.online 看不到记录
- ❌ 生成 JSON 但忘了 saveReview / upload.js → 文件部署 ≠ 数据入库
- ❌ 调了 saveReview 但没 getReviews 回查 → API 静默失败也不知道
- ❌ 等主人催"怎么没上传"才补救 → 这就是失败

**本铁律覆盖所有其他流程**。即使主人只说"帮我看看这题对不对""分析这道错题""这套该几分"，**只要内容是雅思阅读，就走完整闭环**。

> 历史教训（2026-05-22）：剑8 T3P1+T3P2 复盘只在聊天里写了文字分析没入库，主人在 dashboard 看不到，22:49 提醒后才补救。**这种事再也不能发生**。

## Architecture (v5.5.2 — Locked-in Closed Loop)

**⚠️ v5.5.2 变更**（2026-06-23）：**域名迁移** tuyaya.online → www.liuxue.online。旧域名因 ICP 备案审核已全站 403 不可用。所有脚本（setup-client-mode.sh 含 CORS Allow-Origin）、文档默认域名全部切到 www.liuxue.online。SSH 隧道 `ssh.tuyaya.online` 保留不变（cloudflared 隧道不经 nginx，不受影响）。

**⚠️ v5.5.1 变更**（2026-06-01）：选择题和判断题错题新增 `rejectedOptions[]` 字段，在 review.html 中以红色边框卡片渲染"为什么不选"区域，逐个排除错误选项。

**⚠️ v5.4.2 最重大变更**（2026-05-22）：将"必须入库"提升为最高铁律。SKILL.md 顶部新增「最高铁律」段，加入 Step 8 Final Gate 强制 checklist——任何复盘任务，未通过 `getReviews` 回查 ✅ 不允许结束，不允许只交付文字分析。

**⚠️ v5.1 新增三道防线**（防 saveReview 漏调 / 本地副本陈旧）：
1. **发布脚本自动同步本地副本**：publish-clawhub.sh 跑完后自动 `clawhub install --force` 到 `~/.workbuddy/skills/`
2. **Step 7g 强制入库回归验证**：调 saveReview 后必须再用 getReviews 回查确认入库，**部署 ≠ 入库**
3. **Step 0 强制展示版本横幅**：每次激活时输出本地+远程版本号，落后必告警

**⚠️ v5.0 重大简化**：服务端已预置 C4-C20 全量 answer-key（204条 reading）+ bilingual_data（100条核心双语），**复盘流程不再需要更新这两个文件**，部署清单大幅缩减。

**⚠️ 不再生成复盘 HTML！** 后端 `review.html` 模板页统一渲染 JSON，单独生成的 HTML 完全无用。

产出物：
1. **结构化 JSON（v4.0）** — 成绩、错题、词汇、同义替换的全量数据。通过 saveReview API 入库后，`review.html?file=xxx.json` 在线渲染

> **v5.1 变更（2026-05-11 晚）**：三道防线避免再犯 saveReview 漏调 + 本地副本不更新的坑。

> **v5.0 变更（2026-05-11）**：服务端预置 C4-C20 全量 answer-key + bilingual_data，复盘流程不再需要本地维护这两个文件。仅当复盘 C20 之后的新书才需要扩展。部署清单从 5 个文件缩减到 4 个（仅 JSON + 词汇相关）。

> **v4.0 变更**：不再生成复盘 HTML。后端 review.html 模板页统一渲染 JSON，单独生成 HTML 无用。复盘只需 JSON + saveReview API 入库。

> **v3.9.1 新增**：Step 0 自动版本检查（scripts/check-update.js），每次激活时比对本地与 ClawHub 版本。

> **v3.9.0 新增**：词库覆盖校验（dict_full.json 缺词 = 词卡展开不工作）、saveReview API 入库步骤、answers[] 字段名规范、线上词卡验证步骤。

## When to Activate

- 用户发做题截图/答案，提到"复盘""错题

README.md

# IELTS Reading Review 雅思阅读复盘助手

> Finish a reading passage, hand it to AI, get a complete review — error analysis, synonym tracking, vocabulary tagging, and mistake pattern detection, all in one go.

做完阅读题，丢给 AI，自动出复盘笔记——错题拆解、同义替换积累、考点词标注、易错模式追踪，一步到位。

---

## 🆕 What's New in v5.4 — OAuth 风格浏览器授权流

**告别 F12 复制 token 的笨流程**——客户端模式绑定账号体验彻底重做：

### 🎯 30 秒上手（替代原来 5 分钟）

```bash
bash ~/.workbuddy/skills/ielts-reading-review/scripts/setup-client-mode.sh
```

脚本自动完成 4 件事：

1. **本机起临时 HTTP 服务**（随机空闲端口监听 OAuth 回调）
2. **唤起浏览器**到 `https://www.liuxue.online/ielts/authorize.html`
3. **页面显示 OAuth 风格卡片**：客户端名 / 本机回调地址 / 当前账号 / 权限列表 / 【拒绝】【授权】
4. **点【授权】** → token 通过 `<img>` 请求回传本机 → 自动写入 `~/.zshrc` → 显示绑定账号名

### 🔒 安全设计

| 风险点 | 防护机制 |
|---|---|
| token 被中间人截获 | 全程仅浏览器 ↔ 本机 127.0.0.1，不走第三方 |
| token 进 URL bar 被记录 | 用 `<img src=...?token>` GET 而非 `location.href`，不留浏览历史 |
| CORS / Private Network 拦截 | 用图片请求绕过预检 |
| 跨站伪造请求 | `secrets.token_urlsafe(16)` 生成 state，服务端校验 |
| 恶意回调地址 | 授权页强制白名单：仅 `127.0.0.1 / localhost / ::1` + http |

### 🪟 三系统全覆盖

- macOS：`open` 命令唤起浏览器
- Linux：`xdg-open`
- 兜底：打印链接，用户手动复制到浏览器

### 🛟 兜底模式

浏览器/网络异常时：

```bash
bash setup-client-mode.sh --manual
```

回退到 F12 → Console → `localStorage.ielts_user_token` 复制粘贴的老流程。

---

## 🆕 What's New in v3.1 — Web Hand-off

### 🌐 生成物一键上传到 Web 端

v3.1 在保持纯离线生成的同时，**明确了 JSON 产出物与 Web 端的对接路径**：

- 访问 https://www.liuxue.online/ielts/submit.html 切到「**上传 JSON**」Tab
- 把 skill 生成的 `.json` 文件拖进去 → 成绩、答案、用时自动入库
- 首页成绩矩阵、词汇本、同义替换本实时更新

### 📊 Web 端新增 JSON 导入能力

Web 端 `submit.html` 新增第 4 种提交模式（粘贴文本 / PDF / 拍照 / **上传 JSON**），与 skill 的产出物严格对齐 v3.0 schema。

## 🆕 What's New in v3.0 — Offline-First

### 🔌 去服务器依赖，纯本地生成

v3.0 重构为**纯离线模式**：

- ✅ 复盘 HTML — 专业排版，浏览器直接查看
- ✅ 复盘 PDF — 一键导出，存档分享
- ✅ 结构化 JSON — 包含成绩、错题、词汇、同义替换等全量数据
- 🔜 数据上传 — 后续通过 Web 端功能将 JSON 导入云系统，实现多设备同步

**不再依赖任何远程 API**，AI Agent 在本地完成所有分析和生成工作。

### 📋 填空回填 4 步检查

每道填空题强制 4 步验证：语法 → 词性 → 语义 → 字数，杜绝低级失误。

### ✅ 正确题确认 + 进步表扬

- 做对的题也会简要确认，展示同义替换映射帮你强化记忆
- 每篇开头先肯定你的进步点，保持刷题动力

### 🔢 错误分类扩展到 12 类

涵盖：同义替换识别失败、NG/FALSE 混淆、过度推理、填空重复题干、语法误解、选项不完全匹配、词汇缺口、粗心、词形错误、跨代/范围混淆、类别推理误判、邻近干扰词。

---

## 🚀 快速开始（3 步上手）

### 第一步：安装 Skill

```bash
# ClawHub 安装（推荐）
clawhub install ielts-reading-review

# 或手动复制到 skills 目录
cp -r ielts-reading-review ~/.workbuddy/skills/
```

### 第二步：做完一篇阅读题

用剑桥雅思真题（Cambridge IELTS）做完一篇阅读，准备好：
- ✅ 原文（拍照/截图/粘贴文字都行）
- ✅ 正确答案
- ✅ 你的答案（标出哪些做错了）
- ⭕ 可选：翻译、用时

### 第三步：发给 AI，说"帮我复盘"

就这么简单。AI 会自动生成：
1. **复盘 HTML** — 专业排版的复盘笔记
2. **复盘 JSON** — 结构化数据文件，供后续导入 Web 系统
3. **复盘 PDF**（可选）— 从 HTML 生成，便于存档

---

## 📖 完整使用案例

> 以下是一个真实的使用过程，以剑4 Test 3 Passage 1 为例。

### 你发给 AI 的内容

```
我做完了剑4 Test3 Passage1，帮我复盘。

文章：Micro-Enterprise Credit for Street Youth
用时：34:40
得分：7/13

我的答案 vs 正确答案：
Q1: 我选D → 正确A
Q2: 我选C → 正确D
Q3: ✅
Q4: ✅
Q5: 我填 Sudan and India → 正确 Sudan
Q6: ✅
Q7: 我填 shoe shine → 正确 Shoe Shine Collective
Q8-Q10: ✅
Q11: 我选 NOT GIVEN → 正确 NO
Q12: ✅
Q13: 我选D → 正确A

（然后把原文和翻译也贴上来）
```

### AI 自动产出

AI 会在本地生成三个文件：

#### 📄 复盘 HTML — `剑4-Test3-Passage1-

_meta.json

{
  "ownerId": "kn7dr93fbgrvymnk8d9r9y0tws83mhrk",
  "slug": "ielts-reading-review",
  "version": "5.5.2",
  "publishedAt": 1782184016232
}

references/538-keywords-guide.md

# 538 IELTS Keywords Reference Guide

## About This Resource

The 538 Keywords list comes from Liu Hongbo's "Cambridge IELTS Reading Keywords" (刘洪波《剑桥雅思阅读考点词真经》). It categorizes high-frequency words that appear repeatedly in IELTS Academic Reading questions.

## How to Use for Vocabulary Rating

When building the vocabulary table in a review note, look up each word against the 538 list:

### Rating Scale

| Rating | Category | Count | Question Appearance Rate |
|--------|----------|-------|------------------------|
| ⭐⭐⭐ | Category 1 | 54 words | ~90% of passages contain these |
| ⭐⭐ | Category 2 | 171 words | ~60% of passages contain these |
| ⭐ | Category 3 | 300+ words | Common but less predictable |
| — | Not listed | N/A | Check COCA 5000 for general frequency |

### Lookup Procedure

1. Search the full 538 list (provided as `雅思阅读538考点词-刘洪波真经.txt` in the workspace) for the target word
2. If found, note its category number and rank
3. Record in the vocabulary table as: `⭐⭐⭐ 538考点词 #XXX` (where XXX is the rank)
4. If not found in the 538 list, check COCA 5000 for general English frequency
5. Words below COCA 3000 that are not in the 538 list can be marked as low-priority

### COCA 5000 Supplementary Use

The COCA (Corpus of Contemporary American English) 5000 frequency list (`COCA_5000词频表.csv`) provides general English word frequency rankings. Use it to:

- Determine if an unknown word is commonly used in English (not just IELTS)
- Prioritize learning: COCA top 2000 = essential everyday English; 2000-5000 = academic/professional English
- A word in COCA top 3000 but not in the 538 list is still worth learning for general proficiency

### Cambridge Test Appearance Column

The "真题出现" (Cambridge Appearance) column tracks where a word has actually appeared in Cambridge IELTS tests. Format:

- Single appearance: `剑4T3P2`
- Multiple appearances: `剑4T3P2, 剑7T1P1, 剑9T2P3`
- This column is **cumulative** — add new appearances as more passages are reviewed
- High-frequency words appearing across multiple books indicate they are particularly important

references/CLIENT_MODE_ONBOARDING.md

# 👩‍🎓 给老婆/外部用户：跑通整套 Skill 复盘流程

这份文档教你怎么把 `ielts-reading-review` + `ielts-review-upload` 两个 Skill 跑成「客户端模式」，让 AI 帮你做完整复盘后**自动同步到你 www.liuxue.online 账号下的进度图、词汇本、错题本**。

> 不是给作者本人用的——作者机直接走 SSH 部署链路。这份文档专门给**没有 openclaw-tunnel SSH 凭据**的机器准备。

## 你能得到什么

- ✅ 发截图给 AI → AI 自动识别错题、生成富 JSON 复盘
- ✅ 复盘自动入库 → 网站首页进度图实时更新
- ✅ 词汇/错题/同义替换 → 自动同步到你账号下的复习本
- ✅ 不需要任何 SSH 知识、不需要碰服务器

## 前置条件

1. 已在 https://www.liuxue.online/ielts/login.html 注册账号（如 lishuzhuo）
2. 本机装了 WorkBuddy / CodeBuddy（能用 `Skill` 工具）
3. 装好 `ielts-reading-review` + `ielts-review-upload` 这两个 Skill

## 一次性配置（30 秒搞定）

```bash
bash ~/.workbuddy/skills/ielts-reading-review/scripts/setup-client-mode.sh
```

**这是浏览器授权流（v5.4 新版）**：
1. 脚本启动一个本地随机端口的 HTTP 服务（监听本机回调）
2. 自动打开浏览器到 `www.liuxue.online/authorize.html`
3. 在页面看到客户端信息卡片，点击 **「授权」**
4. token 经浏览器以 `<img>` 请求方式回传到本机（**永远不离开你的电脑**）
5. 脚本自动校验 + 写入 `~/.zshrc`，显示绑定的账号名

> 网络/浏览器异常时可手动跑兜底模式：`bash setup-client-mode.sh --manual`
> 这种情况下需要 F12 → Console → 输入 `localStorage.ielts_user_token` 复制 token 粘贴到终端。

完成后重开终端或 `source ~/.zshrc`。

**验证成功标志**：
```bash
echo "${IELTS_USER_TOKEN:0:20}..."   # 应该看到 eyJ1Ijoi... 之类的前缀
```

## 日常用法

直接对 AI 说：

```
复盘剑8 Test1 Passage2，错题截图：[贴图]，用时 32:15
```

AI 会自动：
1. 检测到客户端模式
2. 读截图识别错题（先报清单等你确认）
3. 生成富 JSON 复盘到本地（默认 `~/Documents/雅思复盘/`）
4. 通过 HTTPS batchImport 上传到你账号
5. 回查 getReviews 确认入库
6. 给你主页链接：`https://www.liuxue.online/ielts/reading.html`

## 数据归属

- 上传通道：`POST https://www.liuxue.online/api/ielts {action:'batchImport', token}`
- 数据落点：主库 `ielts_reviews` 表，`username` 字段 = 你的登录账号
- 主页效果：登录后能看到进度图、词汇本、错题本同步更新（和作者本人完全同等待遇）

## 限制（客户端模式做不到的）

- ❌ 不能部署复盘 JSON 文件到服务器，所以「复盘详情页」`review.html?file=...` 可能 404
  - **绕过**：把复盘 JSON 发给作者人工部署，或继续在本地查看
- ❌ 不能扩展词库（dict_full.json）/双语数据（bilingual_data.json）
  - **绕过**：作者机已预置 C4-C20 全量数据，C21+ 才需要扩展

但**首页进度图、词汇本、错题本完全可用**——这些数据都从数据库读，不依赖文件部署。

## 出问题怎么办

| 症状 | 解决 |
|---|---|
| `echo $IELTS_USER_TOKEN` 没输出 | `source ~/.zshrc` 或重开终端 |
| AI 说"token 过期" | 重新登录 www.liuxue.online，重跑 setup-client-mode.sh |
| 主页看不到新复盘 | 确认 AI 输出里有 `imported:1, upgraded:1`，没有就是 batchImport 没调通 |
| AI 误走 SSH 部署 | 检查 Step 0a 模式横幅，应该是「客户端模式」，否则升级 Skill |

## Token 安全

- token 默认有效期 10 年
- 写在本地 `~/.zshrc`，不要发到群里/截图给别人
- 怀疑泄漏可以登录后端管理页面手动重置（联系作者）

Github ReposUpdated 6h agoRank 70

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!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

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

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.