SuperAPI AI 工具集

file-ingest-contracts

通用与其它

查看项目

更新于 10-16 06:44

技能介绍

用途:该技能针对“把文件带入页面”的导入路径,梳理浏览器契约链条——取消正确的拖放事件、从正确的 DataTransfer 表面读取、不轻信文件自报类型、及时回收预览 URL。适用于拖放区在子元素上高亮闪烁、拖入文件夹被静默丢弃、类型伪造、剪贴板粘贴、长时间会话等场景。

主要能力:1) 拖放事件:未取消 dragover 则 drop 不会触发,需同时取消 drop 以抑制浏览器默认处理;应在 window 级对 dragover 与 drop 做 preventDefault 或目标范围检查,避免误拖导致页面跳转或关闭。2) 高亮:用 dragenter/dragleave 整数计数器切换高亮,而不是原始事件开关;在 dragenter 切换而非 dragover。3) dropEffect:每次 dragover 都要重设 dataTransfer.dropEffect,用 none 明确拒绝。4) 目录读取:DataTransfer.files 无目录支持,需用 items + webkitGetAsEntry 或 getAsFileSystemHandle,且需特性检测、在 await 前同步捕获;点击选择文件夹用 input webkitdirectory multiple。5) 类型信任:accept 仅过滤系统选择器,file.type 易伪造且可能为空;客户端可用魔数字节做预筛,服务端才是信任边界。6) 粘贴:遍历 clipboardData.items,取 kind 为 file 或 type 以 image/ 开头的项调用 getAsFile,并在读取前限制数量与大小。7) 对象 URL:每次预览只创建一个,替换或卸载时 revoke,不要在 img 的 onload 中 revoke。

使用方式:技能内含一组 rg 快速探针命令,用于定位 drag 事件、files/items、accept/type/魔数、createObjectURL/revokeObjectURL 与 paste 相关代码。

限制与边界:与 download-export-safety(导出路径)、frontend-security-baseline(渲染 SVG/HTML 风险)、bff-proxy-security-contracts(服务端上传限流与 multipart)、i18n-copy-and-layout(文件名展示)互为边界。客户端魔数嗅探仅为预筛,头校验仍可被多态文件绕过。无子元素的拖放区不需要计数器,已有配套 revoke 的 createObjectURL 不是泄漏。具体安装与更多配置资料暂未提供。