@aizigao/pi-vibeguard
在LLM请求前脱敏敏感信息保护隐私
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:@aizigao/pi-vibeguard。 它的用途是:在LLM请求前脱敏敏感信息保护隐私 完整的 Skill 内容见:https://321skill.com/skills/aizigao-pi-vibeguard/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我配置pi-vibeguard,保护项目中的OpenAI API密钥和GitHub令牌不被发送给LLM。',它会自动读取vibeguard.config.json,将sk-开头的字符串替换为__VG_OPENAI_KEY_xxxxxx__,将ghp_开头的替换为__VG_GITHUB_TOKEN_xxxxxx__,确保LLM永远看不到原始值。
介绍
这个Skill解决了在使用AI编码助手时,开发者不慎将API密钥、密码、令牌等敏感信息发送给大模型提供商,导致隐私泄露的问题。在实际开发中,许多开发者会直接复制包含密钥的配置或代码片段,而LLM服务端可能记录或存储这些数据,带来安全风险。
使用方式很简单,你只需要通过npm全局安装或手动复制扩展文件,然后在项目根目录创建vibeguard.config.json配置文件,定义需要替换的关键词、正则模式或启用内置类型(如邮箱、手机号、IP地址等)。之后所有经过pi的LLM请求都会自动将匹配的敏感字符串替换为__VG_格式的占位符,等模型输出完成后再恢复原文,同时还会在工具执行(如bash、write)前还原,确保本地操作正常进行。
它非常适合需要保护API密钥、数据库密码、个人身份信息的团队或个人开发者。尤其是那些使用AI编码助手处理生产环境配置、涉及合规审计(如GDPR、等保)的项目,以及多人协作中需要统一管理敏感信息暴露风险的场景。
建议在配置文件中启用debug: true先验证替换效果,确认所有敏感字段都被正确遮盖后再正式使用。需要注意的是,占位符基于HMAC-SHA256哈希,但长度固定为12位,在极端情况下LLM可能通过模式学习猜测部分信息,因此建议配合最小权限原则使用。
常见问题
是否支持正则表达式匹配敏感信息?
支持,可以在patterns.regex数组中配置正则表达式,并为每个模式指定分类名称。
替换后会影响代码执行结果吗?
不会,占位符在工具执行(如bash、write)前会自动恢复为原始值,保证本地操作正常,只有LLM请求阶段看到的是占位符。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/aizigao-pi-vibeguard/raw/index.md 读取 @aizigao/pi-vibeguard 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/aizigao-pi-vibeguard/raw/index.md(查看排版版本)