Agent Skills
返回列表
feicui电子课本下载助手

feicui电子课本下载助手

教育学习 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装规范技能 @user_4271610f/feicui-download-smartedu-textbooks,完成后即可使用 feicui|下载电子课本。

技能介绍

起点:找本电子课本为什么这么麻烦

国家中小学智慧教育平台等目录里收录了不少公开教材,但要真的拿到一本 PDF,往往需要先选对学段、学科、版本,再选年级、册次,然后跳到多个页面里翻找。对普通用户来说,这一步卡住就很容易放弃;对开发者和自动化流程来说,手工点链接等于把“查询 + 下载”变成重复劳动,而且关键词稍微拼错就查不到目标。

技能做了什么

feicui|下载电子课本 并不是把教材内容塞进 skill 包里,而是提供一组用 Python 标准库实现的脚本,用来访问平台公开目录,完成“条件提取 → 目录查询 → 结果选择 → 单本下载”的闭环。运行入口放在 SKILL_DIR 下:

  • 若 python 不存在,Windows 会依次尝试 py -3,macOS/Linux 会尝试 python3;
  • 只要求 Python 3.10 或更高版本,不安装任何第三方依赖;
  • 默认保存到 Downloads/电子课本(Windows 常见为 下载/电子课本),用户显式指定目录时用 --output-dir "目录"。

交互层面,它会先从用户原话中提取学段、学科、版本、年级、册次等字段。完全没有有效条件时,只问一次:“请告诉我学科、年级、上/下册;如果知道教材版本也请一起说。”随后进行搜索,上限为 10 条:

  • 结果为 0:提示缺少版本、年级或册次等条件;
  • 结果为 1:若用户已经明确说“下载”且字段全部一致,直接下载;若只说“找/查”,先展示结果再等确认;
  • 结果 2 条及以上:逐项列出版本、年级、册次、出版社,让用户回复序号,不替用户猜。

下载时先写入 .part 临时文件,校验文件大小与 %PDF- 文件头后再改名为 .pdf。已有同名文件不会被覆盖,会自动保存为 书名 (2).pdf,避免误替换。成功后会返回完整书名、文件大小和文件路径,并原样转发脚本返回的 copyright_notice。

适用边界与注意点

  • 只访问 basic.smartedu.cn 和 *.ykt.cbern.com.cn 的 HTTPS 地址;平台返回其他地址时会停止访问;
  • 不收集使用数据,不上传本地文件,不包含遥测功能;本地仅保存目录缓存和用户主动下载的 PDF;
  • 不需要用户提供 Access Token,遇到 401/403 只会提示匿名下载当前不可用;
  • 不显示、不传播解析出的私有下载直链,也不会替用户上传、转发或公开分享下载到的教材;
  • 当前版本只支持单本电子课本 PDF,不承诺批量下载、PDF 书签或教材配套音频;
  • 只在用户明确提出下载意图后写入 PDF,搜索和列出候选项不会触发下载。

常见报错速记

  • command not found / not recognized:上一节已给出 Python 兜底顺序,仍失败时说明本机没有可用解释器;
  • 下载中断并提示 401/403:以匿名身份暂时拿不到资源,属于平台侧限制,不是脚本缺参数;
  • 清单为空:通常因为版本、年级或册次没写清,把缺失字段补上再触发一次搜索即可。

许可与定位

接口分析和工作流参考了开源项目 happycola233/tchMaterial-parser,原项目采用 MIT License。本技能是独立的非官方工具,与国家中小学智慧教育平台、教育行政部门及出版社没有隶属、授权或合作关系;教材版权归原平台、出版社及相关权利人所有。

使用场景

  • 小学语文老师要拿到人教版五年级上册PDF,用于备课和设计课后练习。
  • 学生在家用电脑复习,只记得高中物理必修第一册,希望先查候选再下载一本。
  • 教师核对教材目录时,需要用出版社、年级、册次确认目标后再取回单本PDF。
  • 老师准备离线课件素材,明确指定输出目录,要求把单本教材保存到指定文件夹。

适合人员

  • 中小学教师:需要在备课前确认版本年级册次,并把单本教材PDF放到本地备课文件夹。
  • 学生和家长:想在家完成预习或作业,能按学科年级册次查到并下载目标教材。
  • 教育内容编辑:整理课程资源包时,需要核对出版社和版本信息后取一份PDF作素材。
  • 学校信息化人员:为离线教室准备资源,希望指定输出目录并避免覆盖已有教材文件。