前言¶
给作业或试卷拍照，希望 AI 能逐题讲解、生成可交互的可视化动态讲解，同时自动整理一份 PDF 错题本，还能根据知识点推荐 B 站上的相关讲解视频。这类需求在 K12 辅导场景里很常见，但大多数方案只能做到其中一两件事，或者把三件事串行排队，等待时间长、体验割裂。下面介绍的这个 Skill 试图用三线并行的方式把这三个产物一次性产出。
这是什么¶
智能辅导(错题本) 是一个社区发布的 Skill，坐标 @user_36ddf2ef/xsd-smart-teacher，由 user_36ddf2ef 维护，当前版本 1.0.3。它解决的是「拍照讲题」场景下多产物生成的问题：用户上传作业或试卷照片后，多模态模型自动识别题目并讲解，生成交互式可视化动态讲解 HTML（主要面向数学、物理），同时异步调用 MCP 生成 PDF 错题本，并根据题目涉及的知识点搜索 B 站相关讲解视频。三个产物并行产出，一并呈现。
核心功能¶
1、多模态识别与讲题：上传作业或试卷照片，由多模态模型自动识别题目内容，对每道题进行讲解，输出交互式可视化动态讲解 HTML，主要覆盖数学和物理学科。
2、错题本 PDF（副线，异步）：讲题主线启动的同时，异步调用 MCP 生成 PDF 错题本。错题本与讲题过程并行进行，不阻塞主线的等待时间。
3、B站视频推荐（副线，异步）：根据题目涉及的知识点，搜索 B 站上相关的讲解视频，作为补充学习材料一并呈现。
4、触发关键词：错题、错题本、作业、试卷、讲题、讲解、这道题、拍照讲题、批改。用户在对话中提到这些关键词时，Skill 会被触发执行上述流程。
5、MCP 鉴权机制：Skill 按需检测 xsd-mcp 连接器的存在性。如果连接器不存在，引导用户手动添加，不会主动写入配置。鉴权优先走 OAuth 流程（WorkBuddy 自动握手，30 天免认证）；如果 OAuth 不可用，兜底走设备码流，签发 30 天 JWT，体验上与 OAuth 等价。
安装与启用¶
该 Skill 来自 community 来源，标签为 requires_api_key=false，意味着不需要用户预先配置 API Key 即可使用。
安装方式：通过 SkillHub 平台获取。SkillHub 页面地址为：
https://www.skillhub.cn/skills/user_36ddf2ef/xsd-smart-teacher
官方 API 地址为：
https://api.skillhub.cn/user_36ddf2ef/xsd-smart-teacher
在 SkillHub 中搜索「智能辅导(错题本)」或通过上述地址添加到工作区后，即可在对话中使用。触发关键词包括：错题、错题本、作业、试卷、讲题、讲解、这道题、拍照讲题、批改。
典型用法¶
一个典型的使用流程如下：
1、用户在对话中上传一张作业或试卷的照片，并提到「帮我讲讲这道题」或「这道题怎么做」。
2、Skill 被触发后，多模态模型识别照片中的题目内容，开始逐题讲解，同时生成交互式可视化动态讲解 HTML。这一步是主线，用户可以看到动态的解题过程。
3、在主线进行的同时，副线异步调用 MCP 生成 PDF 错题本。生成完成后，用户获得一份可以保存、打印或归档的错题文档。
4、另一条副线根据题目涉及的知识点，在 B 站上搜索相关讲解视频，将视频链接或推荐一并返回给用户。
5、三线并行完成后，三个产物（可视化讲解 HTML、PDF 错题本、B站视频推荐）一并呈现给用户。
适用场景与注意¶
适合的场景：
- K12 数学、物理学科的作业辅导和试卷讲解。
- 需要将错题整理成可归档的 PDF 文档的场景。
- 希望通过视频补充学习、查漏补缺的场景。
需要注意的地方：
- 讲题和可视化动态讲解主要面向数学和物理学科，其他学科的支持情况以实际识别和讲解效果为准。
- 错题本 PDF 和 B站视频推荐是异步副线，需要等待 MCP 连接器和搜索接口可用；如果 xsd-mcp 连接器不存在，需要先手动添加。
- MCP 鉴权优先走 OAuth，WorkBuddy 环境下自动握手可享 30 天免认证；非 WorkBuddy 环境下走设备码流兜底，同样签发 30 天 JWT。
- 该 Skill 来自 community 来源，由社区开发者维护，使用前建议在测试环境中验证识别准确性和讲解质量。
结尾¶
智能辅导(错题本) 把拍照讲题、错题本整理和视频推荐这三件事用三线并行的方式串了起来，减少了用户的等待时间，也让三个产物可以一次性交付。如果你需要在数学、物理辅导场景中做拍照讲题，这是一个值得尝试的 Skill。
官方地址：https://www.skillhub.cn/skills/user_36ddf2ef/xsd-smart-teacher
