@m4ss/pi-binary-file-guard
通过检测文件魔数，阻止AI读取二进制文件内容。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@m4ss/pi-binary-file-guard。 它的用途是：通过检测文件魔数，阻止AI读取二进制文件内容。 完整的 Skill 内容见：https://321skill.com/skills/m4ss-pi-binary-file-guard/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请帮我分析一下当前项目src目录下的所有文件。” 它会自动运行，如果src目录里混有PDF手册或.zip压缩包，这些文件将被跳过，AI只会处理文本格式的源代码文件，并给出清晰的分析结果。
介绍
该Skill旨在解决AI助手在处理文件时，可能误读或尝试解析二进制文件（如PDF、压缩包、可执行文件）内容，导致返回无意义信息或报错的问题。它通过检测文件开头的特定“魔数”（magic bytes）来识别二进制文件格式，并在AI读取前进行拦截。
使用时，用户只需正常请求AI读取或分析文件，该Skill会在后台自动工作。当AI工具（如Claude Desktop的“读取文件”功能）尝试读取文件时，它会先检查文件类型，若识别为受保护的二进制格式，则会阻止读取过程并给出友好提示，告知用户该文件为二进制格式，建议提供文本文件或直接描述需求。
它非常适合经常需要让AI助手处理本地项目文件，但项目中又包含大量二进制资源的开发者、技术写作者或研究人员。他们可以避免因AI误读二进制文件而产生的混乱输出，提升交互效率。
需要注意的是，此Skill依赖于文件魔数检测，对于没有标准魔数或魔数被修改的二进制文件可能失效。它主要作为一道安全护栏，用户仍需对AI处理敏感文件保持谨慎。
核心特点
与单纯基于文件扩展名过滤的工具不同，它通过检测文件内部的实际魔数进行识别，准确率更高，能有效应对伪装扩展名的文件。同时，它专为与AI文件读取工具集成设计，拦截动作发生在读取阶段，是无感知的自动化过程。
注意事项
不适合需要AI主动分析或提取二进制文件内部元信息（如PDF作者、图片尺寸）的场景。
常见问题
能防止AI读取图片吗？
可以，常见的图片格式（如PNG, JPEG）也通过魔数识别，会被拦截。
会影响AI读取文本文件（如.txt, .md）吗？
不会，它只拦截检测到的二进制文件，纯文本文件可正常读取。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/m4ss-pi-binary-file-guard/raw/index.md 读取 @m4ss/pi-binary-file-guard 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/m4ss-pi-binary-file-guard/raw/index.md（查看排版版本）