智能辅导错题本

解决的问题

当用户上传数学或物理题目图片后，单纯 OCR 或单轮问答往往不够：需要讲清楚知识点、生成可复习的错题本，并找到对应讲解视频。若把讲解、PDF 生成和视频搜索串行执行，等待时间会被拉长；而 xsd-mcp 的连接器配置、OAuth 与设备码流也容易让 Agent 卡在鉴权上。

工作方式

该技能把任务拆成三条并行路径。

• 路径 A（主线）：使用 WorkBuddy 多模态能力识别题号、科目和题型，确认目标题目后进行知识点定位、审题、分步解答和易错点提示；对几何、函数、力学等题目生成单文件 HTML 可视化页面，要求内联 SVG/CSS/JavaScript，零外部依赖。
• 路径 B（副线）：通过 mcp__xsd-mcp__check_auth_status、get_usage_summary、get_upload_ticket、batch_extract_and_pdf 和 get_task_status 完成鉴权、配额、图片和错题本 PDF 任务，轮询异步结果。
• 路径 C（副线）：在深度讲解完成后提取 1-3 个核心知识点，调用 search_knowledge_videos 搜索 B站讲解视频。

MCP 鉴权优先走 WorkBuddy 的 OAuth 连接器，失败时回退到设备码流；Agent 不主动写入 ~/.workbuddy/mcp.json，而是引导用户添加 xsd-mcp 连接器并缓存 30 天有效凭证。路径 A 不依赖 MCP，因此即使 PDF 或视频不可用，讲解仍会完成。

适用边界

支持数学、物理等科目，题目最多 2 页，题号需能确认；完整流程最多消耗 1 点 PDF 配额，视频搜索不消耗配额。B站搜索依赖外部 API，偶发限流会失败，但不应阻塞讲题和错题本生成。