下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/user_a4f793e8--lesson-resource-pack.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_a4f793e8/lesson-resource-pack。- 中小学教师备课资源检索、质量筛选与整合。给定教学课题,跨国家中小学智慧教育平台、学科网、飞象老师、讯飞星光、小红书、B站、微信公众号等渠道检索课件教案、核心概念与推导讲解、典型例题与分层练习、易错点与认知难点分析、多媒体动画素材、微课视频、教研文章与社区资源,按点击量/下载量/点赞等质量阈值剔除低质资源,最终产出一份可点击的 HTML 备课资源包,并主动引导…
- 帮我备课"
- "
- 检索某节课的教学资源"
- "
- 整理备课资源包"
- …(完整说明见下方「阅读全文」)
阅读全文 (展开查看完整说明)
概述
备课资源包检索与整理
目的
给定一个教学课题,跨多个平台检索、按客观数据筛选、按固定维度分类整理,产出一份可点击的 HTML 备课资源包。核心要求有四条:
- 先登录——开工前执行「第零步」,把需登录平台一次性登录掉;教师不登录则如实通报局限与可用平台(见第零步);
- 全——覆盖 8 个检索维度(见下),不只找课件;任何渠道不得静默弃用;
- 精——用点击量、下载量、点赞数、官方精选标识等客观数据作为质量凭证,主动剔除低质量资源;
- 可落地——HTML 生成后,主动引导教师把需要的资源真正下载到本地。
何时使用
教师提出备课类检索需求时触发,典型表述:"帮我为《XX》这节课备课""检索并整理 XX 的教学资源""做个备课资源包""找课件/教案/例题/动画/微课",或直接给出课题名索要资料。
产出物
一个 HTML 文件(默认命名 《课题名》_备课资源包.html),保存在当前工作目录,用 present_files 打开预览。
页面结构固定为四段:① 总览索引 → ② 八个维度正文 → ③ 一节课搭配方案 → ④ 可下载资源清单。① 总览必须存在且可点击跳转——教师第一眼要能看清「搜到了什么、分别在哪个章节、各个来源各有多少条、哪些能下」。全篇条目控制在 30—50 条(教师明确反馈过"内容太多"),宁少勿堆。
开工前先做「第零步」:一次性把需登录平台全部登录掉;教师若拒绝登录,按 0.3 如实通报局限与可用平台,不得静默砍渠道。
第零步(前置 · 务必最先执行):一次性完成全部登录
在做任何检索之前先执行本步。 本技能横跨 8 个渠道,其中若干渠道的完整能力依赖登录态;登录态保存在教师本机浏览器 profile 中,登录一次长期复用、token 轮换自动续期。集中先登录,远好过检索到一半才发现"能看不能下"。
0.1 先确认桥在线
调用 mcp__beike-bridge__bridge_status。智慧教育、学科网、新教育、飞象、讯飞星光的检索与下载都经桥出网,桥不在线时这些平台会整体失败。桥不在线 → 暂停检索、先引导教师启动桥。不要改用 web fetch 抓平台网页代替:平台是单页应用,只会拿到首页外壳,得不出任何结论。
0.2 需登录平台清单(逐一发起,尽量并行)
| 平台 | 登录动作 | 不登录的影响 |
|---|---|---|
| 新教育智能平台(xinjiaoyu) | xinjiaoyu_login_guide | 整个渠道不可用(检索与下载均需凭据) |
| 学科网(zxxk) | zxxk_login(扫码) | 搜索免登录可用;全部资源下载不可用 |
| 国家中小学智慧教育平台 | smartedu_login_guide | 搜索免登录可用;精品课课件/视频等 private 附件全部下不了(实测精品课附件几乎全为 private) |
| B站 | 已预置教师本人登录态,一般无需操作 | 若下载返回 403,再补 Referer 或提示重新登录 |
做法:开始检索前,把上表前 3 项各调用一次(可并行发起),随后给教师一张登录状态表(平台 / 状态 / 影响)。不要等检索完再处理登录。
0.3 若教师不登录:不得中止,但必须如实告知
继续用免登录渠道完成检索与资源包,但在回复中与 HTML 资源包中都要明确写出「当前局限」,下列四项缺一不可:
- 受影响的平台——逐条写明:因未登录,某平台的某项能力不可用。例:新教育整个渠道不可用;学科网可看不可下;智慧教育精品课附件不可下且多为 private。
- 当前可用平台清单——把免登录即可用的渠道完整列出,让教师清楚现在能拿到什么:
- 飞象老师(交互课件 / 教学动画,免登录直下)
- 讯飞星光(交互动画 / 课件,免登录直下;但历史等学科覆盖薄弱,返回 0 条属正常)
- B站(检索免登录,下载已配登录态)
- 微信公众号(免登录)
- 小红书(MCP 已配 cookie,免登录)
- 国家智慧教育平台 / 学科网(可检索、可在线查看,仅下载受限)
- 通用 WebSearch(教研文章、易错点、公开课案例)
- 补登录后能多拿到什么——量化说明,让教师自行判断值不值得登录。例:新教育登录后可拿到学校已购的正版课时课件 / 学案 / 教学设计 / 动画及已解密直链;学科网登录后可下载全部资源;智慧教育登录后可下精品课整套附件。
- 主动问一句是否现在登录;登录完成后可补跑并回填到资源包。
严禁:因未登录就静默删掉该渠道、不告知教师、或用"已弃用"带过(见第二步顶部「铁律 · 渠道不得静默弃用」)。
第一步:确认基本信息
先确认(缺失则按括号内默认值合理假设,并在 HTML 顶部标注假设):
| 项目 | 说明 | 默认 |
|---|---|---|
| 课题 | 课名,尽量精确到课时(如"椭圆及其标准方程(第1课时)") | 必填 |
| 教材版本 | 人教A版 / 北师大版 / 苏教版 / 沪教版 / 人教B版 | 人教A版 |
| 学段学科 | 如"高中数学" | 由课题推断 |
| 课型 | 新授课 / 复习课 / 习题课 / 公开课 | 新授课 |
| 班级层次 | 常规班 / 实验班 / 薄弱班 | 常规班 |
不要为这些信息反复追问,一次问清或直接按默认推进。
第二步:按 8 个维度检索
每个维度都在下方"渠道矩阵"中选择合适的工具,同一批检索尽量并行发起以节省时间。
| # | 维度 | 主要渠道 |
|---|---|---|
| 1 | 教学课件与教案设计 | 智慧教育平台、学科网、小红书 |
| 2 | 核心概念与推导过程讲解 | 智慧教育平台微课/精品课、学科网讲义、公众号 |
| 3 | 典型例题与课堂练习(基础题+提高题) | 智慧教育平台习题、学科网作业/试卷、讯飞星光练习卷 |
| 4 | 常见易错点与学生认知难点分析 | 联网检索教研文章、公众号、学科网易错专题 |
| 5 | 多媒体与动画演示素材 | 飞象老师、讯飞星光、智慧教育平台 |
| 6 | 微课视频与课堂实录 | B站、智慧教育平台精品课 |
| 7 | 教研文章、经验分享与社区资源 | 微信公众号、小红书、教研论文 |
| 8 | 课堂导入与小结设计思路 | 联网检索公开课案例、HPM 论文、教案中的导入设计 |
⛔ 铁律 · 渠道不得静默弃用(2026-10-09 教师明确要求;本条优先级高于本文档其余一切"可跳过 / 可整段跳过 / 可放弃 / 不必卡住流程"的表述,冲突时以本条为准)
- 每个渠道都必须实际发起至少一次检索,缺一不可,包括:国家中小学智慧教育平台、学科网、飞象老师、讯飞星光、新教育智能平台(xinjiaoyu)、B站、微信公众号、小红书、通用 WebSearch。任何渠道"没搜"=任务没做完,不得以"估计没货""要登录""以前搜不到""不是本学科覆盖范围"为由省略调用。
- "返回 0 条"与"我主动弃用"是两回事,交付时必须分开写:
- 渠道已调用但返回 0 条 / 结果跑偏 → 写"该渠道已检索,N 次均为 0 条 / 无关结果"。这是客观结论,可以接受。
- 未调用就跳过、或因"需要登录"而跳过 → 这是弃用,禁止。 必须先调用,拿到报错原文,再写"需登录,未获取到结果"并附报错。
- "需要登录"不是弃用理由。 凡"需登录 / 需扫码"的渠道(新教育、学科网私有资源、智慧教育
private文件等),正确动作是:先调一次 → 拿到登录指引或报错 → 在交付物中列明"需登录,登录后可获取" → 主动询问教师是否现在登录。不得把该渠道从清单里删掉。- 禁止使用"已弃用该渠道"这类表述。 改为"该渠道未获取到可用结果(附原因)"。弃用是教师的决定,不是助手的决定;助手只能如实报告,不能替教师砍渠道。
- 交付物(HTML 资源包)中若某维度为空,必须逐渠道列明各自结果(哪个渠道 0 条、哪个需登录、哪个结果跑偏),不得用一句"未检索到达到质量门槛的资源"带过。
- 检索日志须可复盘:交付回复中用表格给出每个渠道的命中量,未命中的渠道也要出现在表里。
渠道矩阵(工具与关键参数)
新增渠道(2026-10-09):新教育智能平台(金榜苑)=
mcp__beike__xinjiaoyu_*这是学校已购账号的正版课时资源库(课件 / 学案 / 教学设计 / 动画 + 已解密直链),必修渠道,不得跳过。
SOP:①
xinjiaoyu_login_guide(首次或凭据失效时,在本机桥浏览器打开登录页登录一次,登录态自动续期);②
xinjiaoyu_find_book(subject必填,phase/version/module模糊匹配)→ 取book_catalog_id;③
xinjiaoyu_search(keyword+book_catalog_id)→ 定位课时;④
xinjiaoyu_resources(catalog_id,可选type_id:19 课件 / 25 学案 / 24 教学设计 / 16 动画)→ 列该课时全部资源与直链。⚠️ 未登录时报"经桥读取凭据失败:浏览器中没有打开包含 xinjiaoyu.com 的标签页"——按上方铁律第 2、3 条处理:如实记录该渠道状态并保留在交付物中,不得删除。
平台资源类(beike MCP)
| 渠道 | 工具 | 关键参数 |
|---|---|---|
| 国家中小学智慧教育平台 | mcp__beike__search_smartedu | keyword + tab + limit。tab 取值:prepareLesson(备课课件/教案)、tchMaterial(电子教材)、qualityCourse(精品课)、questions(习题)、examinationPapers(试卷)、teachingKnMicroLesson(知识点微课)。⚠️ tab 的选择按学科而不同,务必先判断学科再决定优先搜哪个,否则会得出假阴性结论——① 语文:首选 qualityCourse(实测 prepareLesson 与 teachingKnMicroLesson 均返回 0);② 历史等文科:同样首选 qualityCourse(2026-10-08 实测《辛亥革命》prepareLesson 仅 9 条且全是初中八年级 + 高中习题,误判为"高中无课件";补搜 qualityCourse 拿到 33 条,含教师精品课完整资源包);③ 理化生:prepareLesson 为主。建议至少搜 qualityCourse + prepareLesson 两个 tab 再下结论。⚠️ 两个实测坑:① 结果里的「查看链接」是 /search?keyword=... 搜索页地址,不是资源页,不可直接放进 HTML——资源级链接必须用 resource_detail 取(见「已知坑」);② 该平台并非全学科各 tab 都有货,某 tab 返回 0 条属正常,不要反复重试 |
| 学科网 | mcp__beike__search_zxxk | keyword + stage(小学/初中/高中) + type(课件/教案/学案/作业/试卷) + limit。同一课题建议按 type 分别搜课件、教案、学案、作业。⚠️ 统编版等新教材资源多为近期重传,下载量普遍只有 0—5,下载量门槛对新教材基本失效 → 改按「页数(课件≥20 页)+ 机构出品(如学而思)+ 页数完整度」判断质量 |
| 飞象老师(交互课件/教学动画) | mcp__beike__search_feixiang | keyword + subject + square(resource/app/both) + limit。注意:该工具没有 phase 参数 |
| 飞象筛选树 | mcp__beike__feixiang_navigation | subject。先查筛选树再构造筛选参数,避免猜错版本/单元名 |
| 讯飞星光(交互动画/课件) | mcp__beike__search_sparklight | keyword + subject + phase(03小学/04初中/05高中) + category + limit。⚠️ 该平台并非全学科覆盖——实测高中语文搜「拿来主义」「鲁迅杂文」均 0 条。某学科返回 0 条属正常(但必须"实际调用过一次"才能下此结论),不要反复换词重试 |
| 星光筛选维度 | mcp__beike__sparklight_navigation | 无参数,返回 subject/phase/category 的 code 映射 |
| 小红书 | mcp__beike__search_feeds | keyword + filters.sort_by(综合/最新/最多点赞/最多评论/最多收藏)。已可直接使用——MCP 后台配置了 cookie,无需另行登录;偶发 context deadline exceeded 属服务端超时,换关键词重试即可。⚠️ 文科课题(语文/历史/政治等)价值远高于理科:试讲稿、逐字稿、公开课实录极为密集,是本技能最容易被低估的富矿 |
| 小红书笔记详情 | mcp__beike__get_feed_detail | feed_id + xsec_token(均从 search_feeds 结果取),返回正文与点赞/收藏/分享数 |
| B站视频信息 | mcp__beike__bili_video_info | bvid。MCP 只有 info 与 download,没有搜索功能;检索走下方【B站检索 SOP】(本机 curl/脚本直连接口拿 BV 号) |
| B站视频下载 | mcp__beike__bili_video_download | bvid + cid(分P) + quality(16/32/64/80) + merge。已配置登录态,最高 1080P |
| 微信公众号文章 | mcp__beike__wechat_article_fetch | url。MCP 没有搜索功能;检索走下方【微信公众号检索 SOP】(跑 scripts/wx_article_search.py 拿直链) |
非平台渠道检索(B站 / 微信公众号 / 通用检索)
⛔ 先记住这条铁律:内置 WebSearch 做不了 B站和微信公众号的检索,别在上面耗轮次。
- 加
site:bilibili.com/site:mp.weixin.qq.com均失效——后端不支持站点限定,实测返回 0 条或完全无关的站点。- 直接 fetch
search.bilibili.com也拿不到——B站搜索页是单页应用(SPA),返回空壳。- 微信主动关闭了站内搜索,并屏蔽了外部搜索引擎收录——所以不是工具问题,全网搜索引擎都搜不到公众号(百度/必应/谷歌同样为零)。
- 不要用
weixin.sogou.com(搜狗微信搜索):它看着最对口,实则结果里的<a href="/link?url=...">是加密跳转页,还原时会被重定向到图形验证码,走不通。B站与微信各有专用 SOP,见下。其余用途(教研文章、易错点、公开课案例)仍走 WebSearch,是够用的。
SOP 1 · B站检索(本机直连接口)
原理:B站 MCP 只有 bili_video_info / bili_video_download,没有搜索。而 B站搜索接口对云机房 IP 风控极严、对教师本机住宅 IP 宽松,所以必须在本机跑,不能用服务端代劳。
做法:直接跑技能自带脚本(零依赖,仅标准库):
"<托管版 python 绝对路径>" "<bilibili脚本>" "<课题>"
# 例:
# C:Users<用户名>.workbuddybinariespythonversions3.13.12python.exe
# <skill目录>/scripts/bili_search.py "拿来主义"脚本会输出 播放量 | BV号 | 时长 | UP主 | 标题 | 直链,并按播放量降序、自动标注达标/未达(门槛默认 1 万,可用 --min-play 调整)。
⚠️ 风控原理与对策(实测结论,务必先读)
B站 412 的主因不是频率,而是"缺少浏览器签发的 cookie(buvid3)"。实测对照:同一 IP、同一时刻,裸请求返回 412;先向官方指纹接口https://api.bilibili.com/x/frontend/finger/spi 取 buvid3,再带上Cookie: buvid3=... 与完整浏览器头(Referer / Origin / Sec-Fetch-*)请求,立刻恢复 code=0、正常返回结果。
scripts/bili_search.py 已内置这一步:每次运行先取 buvid3,再以完整浏览器头发起搜索,所以正常情况下不会吃到 412。在此基础上仍要守频率纪律:
| # | 对策 | 说明 |
|---|---|---|
| ① | 带 cookie(最关键) | 脚本已自动完成。若自己手写请求,必须先取 buvid3 并带上;缺 cookie 的裸请求极易 412 |
| ② | 一次拿够 | 默认只抓 1 页。B站一页 20 条通常已够用,优先只抓 1 页;--pages 上限 3 且页间强制 sleep |
| ③ | 不要翻页硬刷 | 同一课题不要反复重跑;批次数据一次用够 |
| ④ | 本机跑,不走服务端 | 教师住宅 IP 宽松;云机房 IP 会被直接拦掉 |
| ⑤ | 触发后停手 | 若仍吃到 412 或 HTML 验证页:停手等 15—30 分钟,或改请教师直接提供链接/BV 号。连续重试只会延长冷却 |
另:中文关键词须 URL 编码;URL 含 & 时写进文件再读,避免 shell 在 & 处截断。
拿到 BV 号后:调 mcp__beike__bili_video_info 核实(标题/时长/播放量/分P cid)→ 按需 mcp__beike__bili_video_download 下载。
内容甄别提醒(血泪经验):B站上旧教材版本的录像播放量往往远高于新教材(如语文旧人教版必修四 vs 统编版必修上册)。播放量高 ≠ 版本对口,务必核对版本标注,别看到高播放就直接用。
SOP 2 · 微信公众号检索(搜狗网页搜索)
原理:微信关了站内搜索,但搜狗早年拿过腾讯投资,保留了"网页搜索能搜到公众号内容"的通道。要走的是 www.sogou.com/web(搜狗网页搜索),从结果页里正则抠出 mp.weixin.qq.com/s?src=11... 直链——那是真实可直开的链接,不是跳转页。
做法:直接跑技能自带脚本:
"<托管版 python 绝对路径>" "<skill目录>/scripts/wx_article_search.py" "<课题> 教学设计 公众号" "<课题> 教学实录 公众号"脚本会:搜狗网页搜索 → 正则抠直链 → 逐条再抓一次验证可打开 → 输出「标题 / 直链 / 公众号名 / 日期 / 页面字节数」。
有效性判定(脚本已自动执行):
| 现象 | 含义 |
|---|---|
| 页面 > 1MB(实测约 340 万字符) | ✅ 正常正文页 |
能取到 og:title 与 id="js_name" | ✅ 标题与公众号名对得上 |
| 仅几百字节/出现「环境异常」「该内容已被发布者删除」「参数错误」 | ❌ 已失效,换一条 |
检索词写法(搜狗是传统关键词匹配,不是语义搜索,写法直接决定命中率):
- ✅ 关键词密 + 带"公众号"三字:
拿来主义 教学设计 公众号、拿来主义 教学实录 公众号、拿来主义 课件 统编版 必修上册 公众号 - ❌ 整句口语(
帮我找几篇讲拿来主义备课的公众号文章)、或只给课题名(太宽,返回一堆非公众号结果) - 一次传多个检索词,脚本自动按链接去重,覆盖更全。要课件/教案就带「课件」「教案」「统编版」;要课堂实录就带「实录」「公开课」「优质课」;要文本解读就带「精读」「解读」「比喻」。
拿到直链后:调 mcp__beike__wechat_article_fetch 抓正文+全部图片(带验活,死链会明确报错)。
局限(交付时必须如实告知教师):
src=11链接带timestamp/signature,时间久了会失效 → 交付时说明"失效了跟我说,重跑一遍即可"。- 搜狗只收录部分公众号,一个词通常只出 1—3 条,冷门号搜不到。
- 这是存量收录检索,不是全文检索。
概念必须分清(教师最容易混淆的地方):search(按关键词找链接)内置搜索做不到;fetch(打开一个已知链接)完全可以。所以策略是:用搜狗补 search,用
wechat_article_fetch做 fetch。若教师说"以前能搜到",多半当时是有人把链接递过来了——那是 fetch,不是 search。
其余用途(WebSearch 够用):
- 教研文章与易错点软文:
<课题> 易错点 认知难点 分析、<课题> 教学反思、<课题> 集体备课 学情分析。 - 公开课案例与教学史:
<课题> 公开课 导入设计、<课题> HPM 数学史 教学设计。
并行发起检索时,一次消息里可同时调多个 MCP 工具、多个 WebSearch 与 Bash,不要串行等待。
第三步:质量筛选(重点)
逐条判断,不合格的不进 HTML。 完整阈值见 references/quality-signals.md,速记版:
| 渠道 | 收录门槛 | 优先信号 |
|---|---|---|
| 智慧教育平台 | 有官方评选标识 | 精品课/部级优课 > 一师一课备课资源 > 普通习题 |
| 学科网 | 下载量 ≥ 10,或结构完整(课件≥20页 / 讲义≥30页) | 角标"免费/精品/特供"、下载量高、机构出品(学而思等) |
| 飞象老师 | 点赞 ≥ 100 或曝光 ≥ 1000 | 平台标注「官方精选」(必收) |
| 讯飞星光 | 浏览 ≥ 500 或 下载 ≥ 3 或 点赞 ≥ 10 | 下载/收藏数高 |
| 小红书 | 点赞 ≥ 500 | 收藏/点赞 > 0.5(实用性强)、教师垂类博主 |
| B站 | 播放量 ≥ 1 万 | 学科对口教学 UP 主、时长适配课型、教材版本与课题一致 |
| 微信公众号 | 专业期刊号 / 名校名师工作室号 | 有明确教学案例与可迁移经验 |
⚠️ 学科网的「下载量 ≥ 10」门槛对新教材失效:统编版等新教材 2026 年起大规模重传,课件/练习的下载量普遍只有 0—5,数字低不代表质量差。此时改按「页数达标(课件≥20 页)+ 机构出品 + 标题结构完整度」判断,并在卡片上如实标注真实下载量,不要因为数字低就整批剔除,也不要编造数字。
一律不收录:标题党且与课题无关;纯广告/引流/网盘拉新;只有封面缩略图的空壳资源;盗版合集与来源不明打包;无任何互动数据且无可信来源;版本或学段明显不符。
每条资源必须在 HTML 卡片上标注质量凭证,例如 下载量 174、点赞 560 · 官方精选、浏览 1367、播放 12.3万。没有质量凭证的资源不得进入"推荐"卡片;确有价值但数据缺失的,必须放在卡片上明确标注"数据未公开"并说明入选理由。
第四步:生成 HTML 资源包
- 用
Read读取assets/resource-pack-template.html(该模板包含完整 CSS、导航、总览索引区、卡片、质量标签、下载清单区,以及在何种结构下如何填充的注释)。 - 复制模板到工作目录,命名为
《课题名》_备课资源包.html。 - 先写「00 总览」(模板已内置骨架,必填)——两张表:
- 表一 · 按维度:
编号|维度名(用该维度的色,做成可点击链接,锚点直达 #s1—#s8)|条数|主要来源; - 表二 · 按来源平台:
平台|条数(降序)|获取方式(获取方式用下面第 9 条的标签体系)。 - 末尾用一行说明已实际调用但返回 0 条的渠道(例:"讯飞星光已实际调用并返回 0 条,属客观结果,非主动弃用")。
- 表一 · 按维度:
- 按 8 个维度填充卡片。每张卡片必须包含四要素:标题 / 来源与格式标签 / 一句话说明 / 使用建议,以及可点击链接(带
target="_blank")。卡片上必须写明来源平台,让总览里的"出处"能在正文中对上。- ⚠️ 链接必须逐条落实,不能直接抄检索结果里的「查看链接」。尤其是智慧教育平台:
search_smartedu给的是?keyword=搜索页链接,点开是平台搜索界面(当前版本渲染成 AI 智能搜索),不是那条资源。必须先调resource_detail,换成资源详情页链接再写进卡片:
- ⚠️ 链接必须逐条落实,不能直接抄检索结果里的「查看链接」。尤其是智慧教育平台:
https://basic.smartedu.cn/syncClassroom/prepare/detail?resourceId=<该资源的 resource_id>&classHourId=lesson_1
- 交付前自查(跑一遍正则即可,别省这步):① 全文不得残留
basic.smartedu.cn/search?keyword=;② 每条智慧教育平台卡片的链接里resourceId=应与该卡片的resource_id:一致(注意只取第一段 UUID——习题类链接还带一个containerId,别把它当成第二个 id 而误报);③ 每个<a>都带target="_blank"(<nav>内的页内锚点除外,本就不该开新窗口);④class="item"的实际计数必须与总览、页脚声称的条数完全一致(改过条目就要同步改这两处);⑤ 总览锚点#s1—#s8与 section id 逐一对应;⑥ 正文不得出现任何 emoji。
- 内容量控制(教师明确反馈过"内容太多")——按下面四条做减法,宁少勿堆:
- 全篇 30—50 条,单维度 3—9 条;超出时按质量凭证从尾部砍;
- 同源重复必删:同一 URL / 同一资源 ID / 同一篇公众号 / 同一张网页,只保留一处,其余内容并入该条的说明。不删的后果是教师在不同维度反复看到同一条东西;
- 低于质量门槛的一律不进正文;确有稀缺价值要收,必须在卡片上注明"低于门槛,因 XX 保留";
- 同一平台的"多版本"合并成一条:例如新教育 8 版同课异构课件写 1 条,把 8 版作为条目内的枚举说明,不要展开成 8 条。
- 每个维度开头写一句"该维度怎么用"的导语(
.sec-note)。 - 末尾添加两节:「一节课搭配方案」(按分钟给出导入→讲解→练习→小结的资源搭配)与「可下载资源清单」(见第五步)。搭配方案的交叉引用
.ref编号必须与正文条目编号对得上(删改条目后要同步更新)。 - 顶部
.callout说明标签体系;若第零步中有平台未登录,再加一条.callout写明「当前局限」:① 受影响平台及具体缺失的能力;② 当前可用平台清单;③ 补登录后能多拿到什么。不得只在聊天里说、不进 HTML。 - 可用性标签必须与第零步的登录结果联动(硬规则):
| 标签 | 类名 | 含义 |
|---|---|---|
| 已登录可下 | .av.authed | 第零步中已成功登录的平台(新教育/B站等),助手可直接代取回 |
| 免登录可下 | .av.free | 无需任何账号即可取回(飞象老师/讯飞星光等) |
| 需登录/需扫码 | .av.login | 该平台尚未登录,需先完成登录(智慧教育/学科网) |
| 仅在线 | .av.view | 无下载途径(微信公众号/小红书/文库站) |
⛔ 凡第零步登录成功的平台,一律标「已登录可下」,不得沿用「免登录可下」。 已登录 ≠ 免登录:前者意味着助手可直接代下,后者意味着谁都能下——教师据此决定要不要开口让你下。
排版要求(模板已内置全部样式与 10 组维度色,直接复制套用,不要另行发挥字号体系与用色逻辑)。风格定位:数理 · 日式简约 · 中国色分维标注。
- 底色用「生成纸」暖白
#faf9f6,叠一层极淡方眼格(26px 网格、透明度约 2.6%); - 字体三分工:衬线体(明朝体)做标题与副标题,黑体做正文,等宽字体做编号/数据/标签;
- 颜色即维度:每个 chapter/section 分配一种「低饱和中国色」,用内联
--c(深色,用于章节标题/编号/链接/建议小标)--cl(浅色,用于分隔线与左边框)--cf(最浅,用于编号底色块)三档覆盖。模板已给出 10 组(靛青#37597a/松绿#3f6b52/缃色#7a6626/赭石#96513c/青碧#2f6b6b/苔绿#6b7540/檀色#7d5f42/绛紫#7a4f6e,搭配方案=黛紫#55507a,下载清单=苍青#4f6b7a)。不同维度必须用不同颜色,一眼即可横向定位; - 高饱和色全篇最多 2 种,且只用于"标注":朱砂
#c3272b(最高质量/官方精选)、石青#0d6d99(已登录/免登录可直接获取)。其余一切颜色(含维度色)一律低饱和; - 文字颜色必须与底色清晰区分:正文四级由深到浅为
--ink:#1b1b19/--ink-2:#3d3d38/--ink-3:#5f5d55/--ink-4:#6f6c64,每一级对纸底的对比度均 ≥ 4.5:1(实测依次为 16.4 / 10.4 / 6.3 / 5.0),正文严禁用更浅的灰;维度色也须保证作正文色时对比 ≥ 4.5:1(若自选颜色偏浅,取更深一档); - 字号整体要偏大、易读(教师明确反馈过小字看不清):正文基准 16px、行高 1.85;标题 h1 41px/h2 25px;资源条目标题 16.5px;说明与建议 14.5px;最小的标注类文字也不低于 12px(编号、质量凭证、可用性标签、交叉引用等);
- 小字号(≤12px)但重要的信息,用「形状底色块」标注而非仅靠颜色区分:章节编号
.idx(维度色实底白字)、条目编号.ino(--cf底 +--c字)、质量凭证.iq(中性--chip底)、最高凭证.iq.top(朱砂底白字)、可用性标签.av.authed(石青实底白字,最强)/.av.free(浅青灰底白字)/.av.login/.av.view、总览索引.idxlink(维度色链接)+.dimdot(维度色方块)+.cnt(等宽条数)、搭配方案时段号.plan .tm i(朱砂底白字)、交叉引用.ref(--chip底); - 零阴影、无装饰性色彩渐变;分隔一律用 1px 发丝线;仅"形状标注块"允许 2px 圆角;
- 资源条目写成「索引式条目」而非卡片:顶部一条细线 + 等宽编号(如
01.1)+ 元数据 + 右侧质量凭证; - 禁止使用任何 emoji(状态一律写成文字);
- 数字统一
font-variant-numeric:tabular-nums;留白要足(正文行高 1.85); - 导航吸顶可跳转,导航项也用各自维度色着色;打印时隐藏导航并关闭网格底纹;不夹带任何外部 JS/字体依赖,保持单文件可离线打开。
若教师明确要求换风格(如更活泼、适合学生阅读),可调整配色与字体,但最低守住六条底线:无 emoji、无阴影与装饰性渐变、高饱和色 ≤ 2 种且只作标注、各维度用不同低饱和色、文字与底色对比 ≥ 4.5:1、小字号重要信息用底色块标注、编号与数据用等宽字体。
第五步:展示与下载引导
先用 present_files 展示 HTML。随后必须在同一轮回复里给出下载引导,说明哪些资源可以下载、怎么下,并询问教师需要下载哪些。对应关系:
| 平台 | 下载路径 | 前置条件 |
|---|---|---|
| 智慧教育平台 | mcp__beike__resource_detail 取文件清单 → mcp__beike__download_smartedu | 必先走 resource_detail(搜索结果里的「查看链接」是搜索页,不是资源页)。公开直链匿名可下;清单里标 private 的需要先登录(mcp__beike__smartedu_login_guide)。⚠️ 实测:精品课类资源的附件基本全部标 private(如某课件包 15 个文件全需登录),所以「免登录可下」在智慧教育平台其实较罕见,交付时别默认承诺 |
| 学科网 | mcp__beike__zxxk_login 扫码 → mcp__beike__zxxk_download | 需登录。默认只"侦察下载按钮"返回清单,教师确认后再传 confirm+buttonText 代点;免费/网校通资源登录后自动可下,付费资源必须先征得教师同意 |
| 飞象老师 | mcp__beike__download_feixiang 校验直链 → 用 Bash curl 落盘 | 免登录。多为自包含 .html 课件,双击即用 |
| 讯飞星光 | mcp__beike__sparklight_detail 取直链 → Bash curl 落盘 | 免登录 |
| B站视频 | mcp__beike__bili_video_info 查分P cid → mcp__beike__bili_video_download → 落盘 | 已配置登录态,最高 1080P。quality 16=360P/32=480P/64=720P/80=1080P;1080P 为分离流,需 merge:true 交由服务端合并。落盘须带 User-Agent,403 时补 Referer: https://www.bilibili.com/ |
| 小红书 | 无下载工具,只能在 HTML 中提供笔记链接与互动数据 | — |
下载引导要点:
- 在 HTML 的「可下载资源清单」中就用醒目标记区分 免登录可下 / 需登录 / 需扫码 / 仅在线查看;
- 引导语中明确告诉教师"直接说编号或课题,我来下载",不要把下载决策丢给教师自己想;
- 涉及登录的(学科网、智慧教育平台私有文件),先提示需要扫码/登录,不要贸然点击付费资源;
- 下载前必须确认:不要未经教师确认就下载付费资源;不要并发大量下载。
第六步:记录
在工作区 .workbuddy/memory/YYYY-MM-DD.md 追加一条简短记录(课题、产出文件名、各渠道命中量、本次发现的可用线索),便于同一课题二次检索时复用。
检索经验与已知坑(务必先读)
- ⚠️ 智慧教育平台的「查看链接」不是资源页,是搜索页——不可直接采用。
search_smartedu 返回的 https://basic.smartedu.cn/search?keyword=... 是用关键词现场拼出来的,平台打开后会落到它的搜索界面(当前版本默认渲染成 AI 智能搜索),而不是那一条资源。根因:basic.smartedu.cn 是纯前端 SPA,服务器对所有路由返回同一个壳(实测:搜索页与详情页返回的 body 字符数完全一致,均为 6402);界面完全由前端路由决定,而裸 keyword 参数不足以让 /search 渲染出结果列表,于是落到默认态。该 /search 路由直接请求还会返回 403。正解:要资源级链接必须调 resource_detail,它返回的才是真地址(已用多个资源验证格式一致):https://basic.smartedu.cn/syncClassroom/prepare/detail?resourceId=<id>&classHourId=lesson_1 → 凡是要写进 HTML 的智慧教育平台资源,都应先跑一次 resource_detail(顺带能拿到文件清单,一举两得)。不要把 ?keyword= 那个搜索页链接交给教师。
- ⚠️ 智慧教育平台搜错 tab 会得出假阴性结论(代价很大,本技能最重要的一条检索教训)
不同学科该平台的主库 tab 不同,下"某学科没资源"这个结论前必须先分清:
| 学科 | 主库 tab | 踩坑实录 |
|---|---|---|
| 语文 | qualityCourse | 只搜 prepareLesson → 0 条,误以为无资源 |
| 历史(文科) | qualityCourse | 只搜 prepareLesson → 9 条且全为初中八年级+高中习题,误判"高中历史《辛亥革命》无课件";补搜 qualityCourse → 33 条,含教师精品课完整资源包 |
| 理化生 | prepareLesson | — |
铁律:至少搜过 qualityCourse 与 prepareLesson 两个 tab,才能下"无资源"的结论。 教师精品课(视频+课件+习题全套)挂在 qualityCourse,prepareLesson 挂的是"一师一课"备课资源,两者内容几乎不重叠,少搜一个 tab,结论就是错的。精品课的典型形态:同一 resourceId 下同时挂 mp4 主讲视频 + pptx 课件包(含 pdf 与 superboard 教师端)+ 学习任务 + 课后习题,覆盖"讲—练—评"闭环,是该平台层级最高的资源。发现后立刻跑 resource_detail 拿文件清单。
- ⚠️ 交付前正则自查的三个常见假阳性(别被自己脚本误导)
① 导航锚点没有 target="_blank" 是正常的 —— #s1 这类页内跳转本就不该开新窗口,自查时应先排除 <nav> 内的 <a>。② 模板注释里的 {{占位符}} 不算残留 —— grep {{ 会命中模板顶部那段用法说明,要只看正文区域。③ 智慧教育平台的习题类链接每条都带一个固定 containerId(形如 .../questions/<resourceId>?containerId=elearning-library_ncet-xedu_080ae380-...)。校验"链接里的 id 是否等于该条目 resource_id"时,必须只取第一段 UUID,否则 containerId 会被当成第二个 id 而误报"不一致"。
- ⚠️ 用 Bash 跑 Python 正则的经典陷阱(会让人以为自己写错了正则)
python -c "..." 里的 s d ( { 会被 shell 逐层吃掉,正则静默失配(表现为"明明写对了却匹配到 0 个");bash 的单引号 heredoc(<< 'EOF')同样会吃。正解:含正则的 python 一律用 Write 工具落盘成 .py,再用托管版 python 绝对路径执行。 另:中文文件名传给 io.open 易出错,用 glob.glob('*.html') 挑文件。已验证可用的自查方式(脚本怎么改都不出结果时就用这招,diff 比正则可靠):
grep -o 'class="rid">resource_id: [^<]*' f.html | sed 's/.*resource_id: //' > ids.txt
grep -o 'basic.smartedu.cn/[^"]*' f.html | grep -o '[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}' > lnk.txt
diff ids.txt lnk.txt # 无输出即一致- 飞象老师的
search_feixiang没有phase参数,误传会直接报additional properties错误;学段筛选请用讯飞星光的phase。- 小红书search_feeds已可直接使用(MCP 后台配置了 cookie,无需另行登录)。优先用sort_by: 最多点赞保证质量。偶发的context deadline exceeded是服务端超时,换个关键词或稍后重试即可,不要据此判定渠道不可用(实测:"数学"类宽泛词可通,"椭圆"这类具体词首次可能超时)。 - B站与微信公众号的检索必须走专用 SOP,不要用内置 WebSearch(
site:站点限定失效、且完全不索引公众号)——见第二步的【SOP 1 · B站检索】与【SOP 2 · 微信公众号检索】。MCP 不具备搜索能力,它只负责:B站的bili_video_info(核实信息、取分P cid)与bili_video_download(下载)、公众号的wechat_article_fetch(按 URL 抓正文)。 - B站 412 的根因是缺 cookie(buvid3),不是频率:裸请求易 412,先取
buvid3并带Cookie+ 完整浏览器头即可恢复。scripts/bili_search.py已内置该步骤。仍要克制频率:一次拿够,不要翻页硬刷;万一吃到 412 就停手等 15—30 分钟,越重试冷却越久。B站检索必须在教师本机跑(住宅 IP 宽松),云机房 IP 会被直接拦掉。 - B站视频务必核对教材版本:旧教材录像的播放量常远高于新教材(语文旧人教版必修四 vs 统编版必修上册)。播放量高 ≠ 版本对口,别看到高播放就用。
- 公众号检索用
www.sogou.com/web(搜狗网页搜索),不要用weixin.sogou.com(搜狗微信搜索):后者结果里是加密跳转页,还原时会撞图形验证码,走不通。搜狗给的mp.weixin.qq.com/s?src=11直链带签名,时间久了会失效,重跑脚本即可;搜狗只收录部分公众号,一个词通常只出 1—3 条。 - B站下载已配置登录态(教师本人 SESSDATA,权益内最高 1080P /
quality=80)。落盘必须带User-Agent,返回 403 时补Referer: https://www.bilibili.com/;直链有效期约 1–2 小时,过期重新调用工具刷新即可。若只需单文件,优先用返回的"单文件直链";要 1080P 则用merge:true交服务端合并。 - 小红书笔记在 HTML 中要写成可点击链接,可用格式:
https://www.xiaohongshu.com/explore/{id}?xsec_token={xsecToken}&xsec_source=pc_search(部分笔记需登录后查看)。需要正文内容时再调get_feed_detail(传feed_id+xsec_token)。 - 新教育智能平台(xinjiaoyu)是必修渠道,不得跳过(2026-10-09 修正:原先写"可跳过"是错的,已废止)。它是学校已购账号的正版课时资源库,含课件/学案/教学设计/动画与已解密直链。首次使用先调
xinjiaoyu_login_guide在本机桥浏览器登录一次(之后登录态自动续期)。若确未登录:也必须先调用一次,拿到报错原文,然后在交付物中写明"需登录,登录后可获取",并主动问教师是否现在登录——严禁静默省略该渠道或用"已弃用"一笔带过。 - 智慧教育平台的电子教材
tab=tchMaterial用课题名常常搜不到(教材类资源命名不同),搜不到就换prepareLesson/qualityCourse,不要反复重试。 - 学科网
search_zxxk的level参数只有免费可靠(本地按角标过滤),其余等级站点参数不可靠,不要用 level 做精品筛选,改用结果里的下载量与页数判断。 - 学科网结果中"下载量:0 且发布时间在数小时内"的资源属于刚上传未经检验的,默认降权。
- 讯飞星光的结果里若出现
exam_paper类型,说明是练习卷,应归到第 3 维度而非第 5 维度。 - 同一平台同一课题的多个版本都要保留(人教A版/北师大版/苏教版/沪教版),并在标签上标明,方便教师按自己教材取用。
- 若某维度确实检索不到合格资源,如实写明"未检索到达到质量门槛的资源",不要用低质内容凑数。
版本记录
- v1.3.0(2026-10-09)· 产出规范迭代
教师在实战后提出三条,全部沉淀为硬规则:
- 新增「00 总览」为必填章节:两张表(按维度/按来源平台),维度名做成可点锚点,标注条数与出处;末尾说明已调用但 0 条的渠道。产出物结构固定为「总览 → 八维度 → 搭配方案 → 下载清单」。
- 新增内容量控制(第四步第 5 条):全篇 30—50 条、单维度 3—9 条;同源重复必删;低于门槛不进正文;同平台多版本合并成 1 条。(起因:某次产出 57 条、含 3 处同源重复 + 5 条低于门槛,教师反馈"内容太多"。)
- 可用性标签与登录状态联动(第四步第 9 条):新增
.av.authed「已登录可下」,凡第零步登录成功的平台不得再标「免登录可下」——已登录 ≠ 免登录。 - 交付前自查从 3 项扩到 6 项(加:条目计数与总览/页脚一致、锚点与 section id 对应、正文无 emoji)。
- 模板
assets/resource-pack-template.html同步内置总览区、.av.authed/.idxlink/.dimdot/.cnt样式与更新后的用法注释。
- v1.2.0(2026-10-09)· 登录前置
新增第零步(开工前一次性登录全部需登录平台:新教育/学科网/智慧教育)+ 教师不登录时的四项降级通报(受影响平台/当前可用平台/补登录能多拿什么/主动询问);修正"新教育可跳过"的错误表述,补全其调用 SOP;新增「渠道不得静默弃用」铁律("返回 0 条"≠"我弃用";"需要登录"不是弃用理由;禁用"已弃用"措辞)。
- v1.1.0(2026-10-08)· 实战校验版
基于高中语文《拿来主义》跑通全流程,修掉 v1.0.0 三处纸上谈兵的失效指引(B站检索、公众号检索、智慧教育链接),新增 scripts/bili_search.py/scripts/wx_article_search.py 两个零依赖脚本与两个检索 SOP,写入 B站 412 风控、教材版本核对等实战坑位。
- v1.0.0 · 首版:八维度检索、质量筛选、HTML 资源包。
参考文件
references/quality-signals.md—— 各渠道质量阈值、评分解读与不收录清单的完整说明。assets/resource-pack-template.html—— 可直接套用的 HTML 资源包模板(含全部样式与结构注释)。scripts/bili_search.py—— B站检索脚本(零依赖)。本机直连 B站搜索接口拿 BV 号+播放量,按播放量降序分档;自动先取 buvid3 cookie 规避 412 风控,并内置 412 / HTML 验证页的识别与停手指令。见第二步【SOP 1】。scripts/wx_article_search.py—— 微信公众号检索脚本(零依赖)。走搜狗网页搜索抠mp.weixin.qq.com/s?src=11直链,并逐条验活、输出公众号名与日期。见第二步【SOP 2】。
两个脚本都只用 Python 标准库(环境里没有
requests,别写import requests),直接用托管版 python 跑:>
C:Users<用户名>.workbuddybinariespythonversions3.13.12python.exe跨平台提示(Windows + Git Bash):脚本路径用绝对 Windows 路径;Git Bash 的
/tmp与 Windows Python 的/tmp不是同一处,别往那儿写临时文件。