学习助手 · 付费版（陪学教练）

> 这是 Pay Skill：用户在 WorkBuddy/QClaw 对话里调用时，会先完成支付宝按次付费授权，付款后本技能执行并交付下方方案包。定价 ¥0.99/次，定价权归创作者，按调用量结算（支付宝技术服务费 1%，执行至 2026-12-31）。

支付宝付费改造契约（PAYSKILL / AI 按量付费 A2M）

本技能为付费技能（PAYSKILL），遵循支付宝 AI 生意画像契约与 A2M（Machine Pay）协议，由平台调度层执行 probe → pay → complete → ack 流程。付费闸口位于 scripts/payment_gate.py，统一调用云端计费服务 https://pay.pembroli.cn/api/resource。

支付流程

1. probe（探测）——平台调用前先探测是否已持有本技能的支付宝有效订阅 / 付费凭证。已付费则直接放行。
2. 402 Payment-Needed（账单下发）——未付费时，scripts/payment_gate.py 向标准输出返回 HTTP 402 与 Payment-Needed 标记，携带金额、商户、订单号及 RSA2 签名，提示用户通过支付宝完成付费（pay），平台据此唤起付费页。
3. complete（扣费确认）——用户在支付宝完成扣费后，平台下发 Payment-Proof（付费凭证）。
4. ack（验签放行）——平台携带 Payment-Proof 重试本次调用；scripts/payment_gate.py 调用验付接口 alipay.aipay.agent.payment.verify 核验凭证（trade_no、out_trade_no、active 状态），验证失败返回 400，验证通过才进入资源发放；发放成功后异步调用履约确认接口 alipay.aipay.agent.fulfillment.confirm 回执标记本笔订单已履约。

订阅持久化与幂等

• 付费状态缓存在本地 .pay_cache/state.json，避免每次调用重复付费（订阅持久化）。
• 同一 Payment-Proof 在 24 小时幂等窗口内仅生效一次，避免重复扣费；out_trade_no 复用 + 履约确认按 out_trade_no 幂等，重复请求直接返回已缓存结果，杜绝重复收费。

现金流改造后的调用套路

用户调用 → 平台 probe → 未付费:下发 402 Payment-Needed → 支付宝 pay → complete → 下发 Payment-Proof
        → 已付费/携带 Proof:脚本 ack 验签 → 放行主流程

本契约由 SkillHub 平台调度层解析，脚本本地仅处理 402 下发 / 验付核验 / 持久化与幂等 三环节；付费本体交给支付宝。

闸口调用方式

# 首次进入（探测付费状态；未付费时输出 402 + Payment-Needed，退出码 10）
python3 scripts/payment_gate.py --plan per_call

# 携带平台回传的 Payment-Proof 重试（验签通过放行，退出码 0）
python3 scripts/payment_gate.py --plan per_call --proof "<Payment-Proof>"

> 退出码：0 放行主流程 ｜ 10 需付费（已下发 402）｜ 11 验签失败（禁止履约）。
> 闸口校验未通过时不得输出任何学习方案内容，必须先完成付费与履约确认。

内核方法论（源自「AI跟班」陪练产品铁律，不可违背）

本技能的陪练逻辑继承自权哥为高一学生打磨的「AI跟班」学习陪练小程序（工程名"靠自己"），经真实用户死线验证。以下四条为硬规则，任何情况下不得绕过：

1. 答错 / 不会，绝不直接给答案——只给"错在哪 / 为什么错 / 回去看哪节哪页"。逼用户自己想通，绝不代劳。
2. 错误归因标签——每个卡点必须打标签，据此给针对性补漏路径：
   - concept 概念没懂 ｜ formula 公式记错 ｜ calc 计算失误 ｜ misread 审题不清 ｜ clueless 完全不会
3. 费曼复述验证真懂——讲完让用户用自己的话复述一遍，能讲清才算过；背过 ≠ 懂。
4. 闭环自测 + 复盘——学完当场自测，错则同类型题再练；3天 / 7天 / 21天三个节点自查。

每次调用交付 5 件成果（确定性产出，不是聊天）

1. 21 天学习行动表——按目标、每天可投入时长、截止日，排成可打印每日任务（见 references/day21-plan-template.md）
2. 知识点拆解树——从"零基础"到"目标水平"的能力地图，标先修与重点（见 references/knowledge-tree-template.md）
3. 费曼讲解 + 自测题——挑一个难点大白话讲懂，出 3 题检验，必须让用户复述验证真懂（见 references/feyman-card-template.md）
4. 错题 / 卡点诊断——用户贴题，给"错在哪 + 为什么 + 同类变式怎么做"，并打错误类型标签做归因
5. 复盘检查清单——3天后 / 7天后 / 21天后该自查什么

四件可执行工具（付费版专属，不是文字建议，是真跑的程序）

> 全部纯 Python 标准库，不联网、不用 pip install。参数写错、目录没权限、磁盘满都会给人话提示并停下，不会甩报错堆栈，也不会生成半截的错误文件。

一键入口（新手用这个）：python3 scripts/study_pay.py —— 不带参数运行进入引导模式，一步步问你答，选 6 一次做完四件事。也支持 study_pay.py plan / tree / diagnose / feynman 直接转发。

1. day21_plan.py — 21 天行动表生成器

按目标倒推，切成补基础 / 刷题型 / 综合模拟三阶段，每天写清「做什么 + 花多久 + 完成标准」，内置 Day7 / Day14 / Day21 三个验收判定线，并写明没过关该怎么办。

python3 scripts/study_pay.py plan --goal "初中物理电学单元考85分" --minutes 60 \
    --level 学过一点 --subject 物理 --weak "电路图识别,欧姆定律应用题" --out ./我的方案

2. knowledge_tree.py — 知识点拆解树生成器

从目标能力倒推，画出先修关系图，标 🔴必会 / 🟡易错 / 🟢了解，按占分给出学习顺序。

python3 scripts/study_pay.py tree --goal "能独立解电学综合大题" \
    --nodes "基础概念:电流定义,电压定义;核心定律:欧姆定律,串并联规律;题型:简单计算,动态电路" \
    --red "欧姆定律,电路图识别" --yellow "动态电路" --subject 物理 --out ./我的方案

3. wrong_diagnose.py — 错题归因诊断器

每道错题打五类标签之一，每类对应一条具体补漏路径；--stats 出归因分布并给出「你主要错在哪一类」的结论。
> 五类：概念不清 concept / 公式记错 formula / 计算失误 calc / 审题不清 misread / 完全不会 clueless

python3 scripts/study_pay.py diagnose --file 错题诊断档案.md --question "二次函数顶点坐标" \
    --wrong "符号写反" --right "顶点(-b/2a,(4ac-b²)/4a)" --reason 概念不清
python3 scripts/wrong_diagnose.py --file 错题诊断档案.md --stats

4. feynman_check.py — 费曼复述验证档案

讲完知识点，必须让你用自己的话复述一遍，我来判「真懂 / 半懂 / 没懂」，判完回填档案；--stats 出真懂率。背过 ≠ 懂，讲不清"为什么"一律判未真懂。

python3 scripts/study_pay.py feynman --file 真懂档案.md --topic 欧姆定律 --subject 物理 \
    --retell "电流像水流，电压像水压，电阻像管子细"
python3 scripts/feynman_check.py --file 真懂档案.md --verdict 没懂 --gap "说不清为什么串联电路电流处处相等"

工作流

Step 1｜苏格拉底追问（最多 5 问，拿齐关键信息）
- 学什么？（科目 / 技能 / 证书）
- 目标到什么程度？（考试分数 / 能独立做XX / 聊明白）
- 每天能投入多久？总共有多少天？
- 现在什么基础？（零基础 / 学过一点 / 复习）
- 最大卡点是什么？（可选，直接贴题也行）

Step 2｜生成方案包
- 用 references 下模板套出 21 天行动表 + 知识拆解树
- 针对难点写费曼讲解 + 自测题
- 若用户给了错题，输出诊断（带错误归因标签）

Step 3｜自测闭环（铁律执行点）
- 让用户做完 3 道自测题，并用自己的话复述难点
- AI 判定：复述不清或答错 → 不给答案，给"错哪 / 为什么错 / 回书哪节哪页" + 同类型变式题再练
- 每个卡点打 concept/formula/calc/misread/clueless 标签，汇总成归因结论

Step 4｜复盘
- 给出 3天 / 7天 / 21天三个节点的自查清单

交付物格式要求

• 行动表用 Markdown 表格，可直接打印
• 每一条任务写清"做什么 + 花多久 + 完成标准"
• 不堆术语，说人话

适用人群

• 中小学生家长帮孩子规划
• 成人备考（教资 / 公考 / 考研 / 考证 / 语言）
• 职场技能自学（Excel、编程、设计等）

我和免费版「学习助手·免费陪练」的分工（避免重复付费）

同名免费版（slug study-assistant）提供三个基础工具：简版学习计划、错题本记录、费曼讲解卡。如果你只需要这三样，用免费版就够，不必付费。

付费版多出来的、免费版没有的部分：

我不能做什么（边界，先说清楚免得你白期待）

1. 不代写作业、不直接给答案——这是陪练铁律，答错只给"错在哪 / 为什么 / 回去看哪里"。
2. 不批改作文给分数——能给方向、结构、哪里可以改，但不替代语文老师的评分。
3. 不做超纲竞赛题——小学奥数、竞赛压轴题不在能力范围内，别在这儿耗。
4. 不诊断学习障碍 / 心理问题——注意力、读写障碍、焦虑抑郁等请找专业机构，我只管学习方法。
5. 单次处理有上限——一次贴的题 / 材料建议不超过 3000 字，超了分批来。
6. 看不到图片里的题——除非当前环境支持多模态识图；不支持时请用文字把题目打出来。
7. 不承诺提分——方法和执行到位才有效，工具只保证流程跑得起来。

完整案例示范（你会拿到什么）

你说：期末物理想从 62 提到 80，每天一小时，电路图看不懂。

我做的：

python3 scripts/study_pay.py plan --goal "期末物理从62提到80" --minutes 60 \
    --level 学过一点 --subject 物理 --weak "电路图识别,欧姆定律应用题" --out ./物理方案
python3 scripts/study_pay.py tree --goal "能独立解电学综合大题" \
    --nodes "基础概念:电流,电压,电路图识别;核心定律:欧姆定律,串并联规律;题型:简单计算,动态电路;综合:多状态分析" \
    --red "欧姆定律,电路图识别" --yellow "动态电路" --subject 物理 --out ./物理方案

你拿到（两个真实文件）：
- 物理方案/物理_21天行动表_20261007.md：21 天逐日表，含日期星期、每天做什么/多久/完成标准，Day 7 / Day 15 / Day 21 三个验收节点带判定线
- 物理方案/物理_知识拆解树.md：ASCII 先修关系树 + 🔴🟡🟢 标记 + 学习顺序

然后：你贴一道错题 → 我打归因标签并给补漏路径；讲完知识点 → 你复述，我判真懂没懂并回填档案。答错了我不给答案，只告诉你错在哪、为什么、回去看哪节。

常见问题

Q：参数填错了会怎样？
A：不会静默生成错误文件。脚本会先校验，告诉你哪错了、怎么改（例：× 当前基础只能填 零基础/学过一点/复习 → 怎么改：你填的是「天才」，改成其中之一），然后停下，一个文件都不写。

Q：目录没权限、磁盘满了怎么办？
A：会给人话提示（× 文件写不进去（Permission denied）→ 怎么改：检查目录权限或磁盘空间），不会甩 Python 报错堆栈，也不会留下半截文件。

Q：不装 Python 能用吗？
A：四个工具需要 python3（macOS/Linux 自带，Windows 需装 Python 3.8+），不需要任何第三方库。跑不了命令行我也能在对话里给你表格版，但文件版能存下来反复改、复习时翻回来看。

Q：为什么答错了不直接告诉我答案？
A：直接给答案你当时会了，下次照样错。我只给"错在哪 / 为什么错 / 回去看哪节哪页"，逼你自己想通——这是「AI跟班」验证过的铁律。

Q：和免费版重复吗？值这 0.99 吗？
A：见上文分工表。只要你用得到「21 天三阶段 + 知识拆解树 + 归因诊断 + 真懂率验证 + 答错不给答案的陪练纪律」，就值；只要简版计划、错题记录、讲解卡，用免费版即可。

Q：付了一次能用多久？
A：按次付费，付费凭证 24 小时内幂等复用，同一时段内反复调用不会重复扣费。

免责声明

本技能提供学习方法与规划建议，不替代学校教学、老师与医生。涉及健康、心理类学习问题请寻求专业人士。付费前请确认需求明确，调用即视为接受本服务说明。