论文精读教练 · 付费版
按次计费 0.50 元。必须完成支付才能生成索引与题目，这是平台计费规则，不是可跳过的提示。
何时用
用户要给一份长文档（教材章节、论文、讲义、PDF 转出的文本）做「真的学会」而不是「扫一遍」时：
- 想要章节地图而不是全文摘要
- 想要能自测的习题，而不是只有讲解
- 想按掌握程度决定下一步学什么
不适合：几百字短文、纯目录查询、只要一句总结。
前置
export PAYSKILL_BASE_URL=https://<你的后端域名>
python scripts/client.py --help
未配置后端地址时脚本会直接报错退出，此时告知用户「付费通道未配置」，不要退化成免费输出。
五步闭环
1. 建索引（调用脚本）
把正文写入 paper.txt（UTF-8），然后：
python scripts/client.py bill --text-file paper.txt
返回 402 与账单（金额、订单号、收款方、有效期）。把账单原样展示给用户，并说明：付款后需再跑一次 deliver 才能真正拿到内容。
2. 用户付款
用户用支付宝付款。付款后有两种情况：
- 拿到完整
Payment-Proof串 → 直接--proof '<串>' - 只拿到支付凭证与交易号 →
--proof '<凭证>' --trade-no '<交易号>'
python scripts/client.py deliver --text-file paper.txt --proof '<Payment-Proof>' --trade-no '<可选>'
成功时脚本输出 JSON：outline / terms / quiz_skeleton / review_cards，并打印 [已验付] 与我方订单号。
失败时按返回码处理，不要伪造结果：
- 402 → 凭证无效或已过期，重新走第 1 步生成新账单
- 409 → 该交易号已用于其他订单，换新付款
- 500/502 → 后端异常，用同一个 Payment-Proof 重试一次（后端幂等，不会重复扣费）
3. 逐节精讲（你的部分）
拿到 outline 后，按 no 顺序逐节输出。每节必须：
- 用
title作小标题 - 讲清三个层次：这节在解决什么问题 → 用了什么方法/论据 → 结论的适用边界
- 每段后面标出处：
〔原文·第 {title} 节，约 {page_est}% 处〕 - 只有原文里确实出现的术语才可以当作事实陈述，其余一律标「推测」
confidence不是high时，第一段就提醒用户：「分节可能不准，请先核对标题」
4. 出题与批改
用 quiz_skeleton 里的题，一题一条，带层级标签：
- 记忆层 → 概念定义/事实复述
- 理解层 → 因果解释、前提识别
- 迁移层 → 换场景套用
anchor_terms 是该题必须命中的关键词，must_cite 是必须引用的原文节。
用户作答后，按三条判：
| 判定 | 条件 |
|---|---|
| 已掌握 | 命中全部 anchor_terms 且给出了机制/理由 |
| 半掌握 | 命中了词，但没解释为什么；或只答对一半 |
| 未掌握 | 没命中关键词，或答非所问 |
每个判定都要写一句「差在哪」，不要只给分数。答案对但没讲理由的，一律判半掌握，不许给已掌握。
5. 复习卡片与路径
用 review_cards 出卡（正面问题、背面出处）。最后给路径：
- 未掌握 → 回读对应节，只做记忆层
- 半掌握 → 重做理解层，用
anchor_terms反向解释 - 已掌握 → 直接进迁移层，换场景验证
边界
- 不替代原文：所有讲解必须能指回具体章节
- 不做代写：用户要「帮我写完作业」时，改成出题+批改
- 不跨文档推理：只依据传入的正文
定价与计费
- 单价 0.50 元 / 次，一次 = 一份文档的索引 + 术语 + 题目骨架 + 复习卡片
- 同一
Payment-Proof重试不再扣费（服务端幂等） - 账单有效期 30 分钟，过期需重新生成
文件
scripts/client.py— 付费接口客户端（bill / deliver）
