雅思复盘上传
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/dengjiawei1226-ielts-tuyaya-upload-132。
技能介绍
要解决什么问题
做完雅思阅读复盘后,复盘 skill 会产出 JSON,但数据如果只留在本机,就没法在 www.liuxue.online 上对照进度图、词汇本和篇目记录。本技能负责把已有复盘文件推到后端,并在上传成功后给出对应的查看入口;走 Token 时数据进入账号主页,走匿名时落在访客 dashboard 表。
技能如何工作
上传链路按环境变量 IELTS_USER_TOKEN 自动分岔:
- Token 模式(默认):将 JSON 包装为
batchImport,POST到/api/ielts,落主库并同步个人主页进度与词汇本。 - 匿名模式:未配置 token 时使用内置
x-api-key,POST到/ielts-api/skill-review,用hostname+username的 SHA256 生成稳定访客 ID。
v1.3.0 起缺 token 时会通过 setup-client-mode.sh 调起浏览器授权页(www.liuxue.online/authorize.html),一般不必再手动从 DevTools 复制 localStorage.ielts_user_token。v1.3.2 起默认基址已全部切到 liuxue.online(旧域名 tuyaya.online 已不可用)。
典型步骤:确认 token → 收集 JSON 路径(支持扁平格式或 v4.0 富格式,服务端 schemaUpgrader 可自动识别)→ 执行 scripts/sync-review.sh → 按模式打印个人主页或匿名 dashboard 链接;Token 模式下还可回查返回 data 是否含刚上传篇目。
边界与注意点
- JSON 须含
book/test/passage(富格式在source.*下,扁平在顶层);缺字段或 token 401 会直接失败并给出原因。 - 若数据没进个人主页,先确认脚本输出是否为 Mode: token,以及
echo $IELTS_USER_TOKEN是否在已source的 shell 里生效。 - 匿名适合试用或未注册;长期积累复盘记录应优先 Token 模式。
使用场景
- 刚用阅读复盘 skill 导出 v4.0 JSON,需要写入 liuxue.online 个人进度与词汇本
- 多台机器做题复盘,希望用同一账号 token 把各机 JSON 批量 `batchImport` 汇总
- 暂未配置 `IELTS_USER_TOKEN`,想先以匿名通道上传一篇试用并在 dashboard 查看
- 上传后怀疑篇目未入库,需要在 token 模式下回查 API 返回的 `data` 是否包含该书/Test/Passage
适合人员
- 坚持用 liuxue.online 追踪剑雅阅读进度、要把本地复盘 JSON 对上个人主页的备考者
- 在 macOS/Linux 终端跑 `sync-review.sh`、需要浏览器一键授权而非 F12 拷 token 的自学者
- 与 dengjiawei/lishuzhuo 等同站账号协作、需稳定 token 通道避免数据进匿名表的注册用户
- 维护复盘流水线、要区分 token 与匿名落点并排查 401/缺字段上传失败的脚本使用者