feicui电子课本下载助手
将以下提示词粘贴到你的 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作素材。
- 学校信息化人员:为离线教室准备资源,希望指定输出目录并避免覆盖已有教材文件。