前言¶
給作業或試卷拍照，希望 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
