核心用法
该Skill帮助用户将雅思阅读练习结果系统性地转化为结构化数据(JSON),并通过saveReview API入库,最终由后端review.html模板统一渲染成可视化复盘页面。流程涵盖:收集题目来源/答案/用时等核心信息 → 生成符合v4.0 Schema的JSON(含成绩、错题、词汇、同义替换、行动清单)→ API入库 → 线上查看。支持两种运行模式:「作者模式」(完整SSH部署链路)和「客户端模式」(仅HTTPS接口,无服务器权限)。
显著优点
架构精简高效:v5.0起服务端预置C4-C20全量答案库与双语数据,复盘流程无需本地维护这些文件,部署清单从5个缩减至3个。采用"JSON + 模板渲染"架构,告别HTML碎片化生成,数据与表现层彻底分离。
流程严谨防漏:v5.1新增三道防线——版本横幅强制展示、发布脚本自动同步本地副本、入库后强制getReviews回查验证,系统性避免"文件部署成功但数据未入库"的历史问题。
批量导入能力:独创自动发现机制(扫描常见目录)+ 智能聚合(按篇目分组多格式文件)+ 答案库兜底(401题全覆盖),可将散落的历史笔记(HTML/MD/截图)一键转为结构化JSON。
多端兼容性:支持雅思哥、小站雅思、新东方等主流App的截图识别,内置18类错误分类体系(如NG/FALSE混淆、过度推理、Summary未回原文等),错题分析专业化。
潜在局限
配置门槛较高:作者模式需要SSH密钥、Cloudflare Tunnel配置;客户端模式需手动提取localStorage token并配置环境变量,首次onboarding流程较复杂。
词库维护依赖作者:dict_full.json由作者机维护,若复盘词汇不在库中,客户端模式下词卡展开无响应(需回传作者补录)。
C20后新书需手动扩展:服务端预置数据仅覆盖C4-C20,复盘剑21+需手动追加answer-key.json并重启后端。
用时字段强制但易遗漏:Web端进步趋势图依赖timing.minutes,用户未计时需估算,否则数据点缺失。
适合人群
- 正在系统备考雅思、需要建立错题档案与进步追踪的学习者
- 已积累大量历史复盘笔记、希望结构化管理的用户
- 熟悉命令行操作、能接受一定技术配置的进阶用户
- 需要多设备同步复习数据的跨场景学习者
常规风险
数据丢失风险:若跳过Step 7g入库回查,可能出现"文件生成但数据库无记录"的幽灵状态,导致首页进度图缺失数据点。
词库覆盖漏洞:dict_full.json缺词将直接导致线上词卡点击无响应,需在部署前强制运行覆盖校验脚本。
模式混淆风险:作者模式与客户端模式行为差异极大,SSH操作在客户端模式下绝对禁止,误操作可能导致部署失败或权限错误。
大文件传输陷阱:dict_full.json(~6MB)若用SCP直接传输或split分块,易超时或顺序错乱,必须使用gzip流管道。
字段名混淆:answers[]中的my/correct/result与wrongQuestions[]中的myAnswer/correctAnswer命名不同,混用会导致模板渲染异常。