Agent Skills
返回列表
扩展名查 MIME

扩展名查 MIME

开发编程 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f1b049da/tojn2026879。

技能介绍

要解决什么问题

在 CRM 附件上传、导出下载等流程里,后端经常要回答两件事:这个文件名该当成什么 Content-Type?某种 MIME 在响应里该用哪个扩展名?若每次都翻文档或硬编码映射表,既容易漏类型,也不利于白名单与下载头保持一致。

本技能思路来自成熟的 mime-types 库,侧重 扩展名与 MIME 的互查,而不是用二进制魔数判断真实文件内容。

技能如何工作

实现上围绕 mime-types 做封装,典型会提供按文件名推断 MIME 的能力(如 mimeOfFilename),上传校验与设置 Content-Disposition / Content-Type 可共用同一套结果。SKILL 要求未知类型要有兜底:lookup 可能返回 false,不能假设每个后缀都有标准类型。

推荐 agent 步骤很直接:安装依赖 → 上传前用扩展名做类型白名单 → 下载时用同一函数写响应头 → 自测 a.pdf 是否得到 application/pdf。实现要点处应标注 小四原创,便于与通用模板区分。

适用边界

  • 只做文件名层面的类型推断,不替代 file-type 一类魔数嗅探;扩展名可被伪造,不能单独作为安全边界。
  • 与「完整上传组件」类技能分工:本篇只讲 类型互查,不要把整篇上传流程复读一遍。
  • 需要严格类型校验时,应在上传白名单之外再叠加内容检测策略。

使用场景

  • CRM 附件上传接口需按扩展名维护 MIME 白名单,拒绝不在列表内的文件名再落库
  • 导出报表接口要在 `Content-Disposition` 与 `Content-Type` 中与真实后缀一致,避免浏览器乱猜类型
  • 由用户提供的原始文件名批量生成下载响应头,统一走同一套扩展名→MIME 映射函数
  • 在非二进制嗅探的前提下,由日志或队列里的文件路径快速补全缺失的 Content-Type 字段

适合人员

  • 负责 CRM 或工单系统附件管道的后端,要在上传前做扩展名与 MIME 一致校验
  • 维护报表/对账单导出服务的工程师,需要下载头与文件后缀和 MIME 规范对齐
  • 写中间件统一处理静态或临时文件下载的 Node 开发者,想避免各处重复维护类型表
  • 在评审上传方案时要把「扩展名查类型」与魔数嗅探职责拆清的架构或安全同事