Privacy Scanner 是一款专为开发者设计的发布前隐私扫描工具，旨在帮助开发者在将代码或技能推送到 ClawHub 平台或任何公开仓库之前，自动检测并识别潜在的敏感信息泄露风险。该工具通过深度扫描项目目录中的源代码、配置文件及文本文件，能够有效发现如 Webhook URL、API Key、Token、SSH 私钥等高危敏感数据，从而避免因误提交导致的安全事故。其核心设计理念是‘预防优于修复’，通过在发布流程中嵌入安全检查环节，显著降低隐私数据外泄的可能性。Privacy Scanner 不仅适用于个人开发者，也适合团队协作场景，可作为 CI/CD 流程中的一环，确保每次发布都符合安全规范。 该工具支持灵活的命令行操作，用户可通过简单脚本调用对当前目录或指定路径进行扫描。同时提供严格模式选项，一旦发现任何敏感项即返回非零退出码，便于集成到自动化部署流程中强制拦截问题代码。扫描结果以清晰的三色标识呈现：✅ 表示通过，⚠️ 提示需人工复核的疑似占位符内容，❌ 则明确标记出确认为真实敏感数据的风险项。这种直观的反馈机制让开发者能快速定位问题所在，提升排查效率。此外，工具内置了智能跳过规则，自动忽略 node_modules、.git、logs 等无关目录和二进制文件，减少噪音干扰，使扫描过程更高效精准。 Privacy Scanner 覆盖了现代软件开发中常见的 20 类敏感信息类型，包括各类第三方服务密钥（如 OpenAI、Stripe）、通信平台 Token（Discord/Slack/Telegram）、数据库连接字符串、JWT 令牌以及系统级信息如内网 IP、主机名等。对于中国大陆手机号、邮箱地址等个人信息，工具也设置了相应检测规则，兼顾合规性要求。尽管部分低风险项（如公网 IP 或主机名）仅标记为警告级别，但整体仍强调对高风险凭证类信息的零容忍策略。结合 AGENTS.md 中推荐的发布公约，该工具已成为保障开源项目与私有部署环境安全的重要前置防线。
核心功能特点
- 自动扫描代码目录，检测 20 类敏感信息泄露风险
- 支持严格模式，发现敏感项立即终止并返回错误码
- 智能跳过无关目录（如 node_modules/.git/logs），聚焦关键文件
- 高亮显示三类结果：✅ 通过、⚠️ 警告、❌ 失败，便于快速判断
- 覆盖主流平台凭证：Webhook、API Key、Token、SSH 私钥等
- 可集成至 CI/CD 流程，实现发布前的强制安全检查
适用场景
Privacy Scanner 最典型的应用场景是在软件发布或开源项目托管前的最后一道安全关卡。无论是将自定义技能上传至 ClawHub 平台，还是将代码推送至 GitHub、GitLab 等公共仓库，开发者都可能无意中携带包含 API 密钥、数据库密码或内部网络信息的配置文件。使用 Privacy Scanner 可在提交前自动拦截这些高危内容，避免因配置错误导致的服务中断或数据泄露。例如，一个开发者可能在 .env 文件中临时存储了 Stripe 支付接口密钥用于本地测试，若未清理便直接提交，极可能造成资金安全风险。借助该工具，此类问题将在发布阶段被精准识别并阻止。 在企业级开发环境中，Privacy Scanner 更适合作为标准化发布流程的一部分。团队可以将其嵌入 Jenkins、GitHub Actions 或 GitLab CI 等自动化流水线中，设置‘扫描通过后才能合并 MR’的规则，从制度上杜绝敏感信息流入生产分支。尤其对于涉及金融、医疗等高合规要求的行业，此类前置检查不仅是技术手段，更是满足审计要求的必要措施。此外，在多人协作项目中，新成员可能不了解哪些文件不应公开，统一使用 Privacy Scanner 能减少人为疏忽，提升整体代码安全性。 对于独立开发者而言，该工具同样具有实用价值。许多小型项目虽不涉及复杂架构，但仍可能依赖第三方服务（如飞书机器人、OpenAI API），若未妥善管理相关凭证，轻则功能异常，重则账号被封禁。Privacy Scanner 提供的本地化扫描能力，无需联网即可运行，保护了开发者的隐私同时确保本地环境安全。无论是日常开发还是紧急修复，只需执行一条命令即可完成全面检查，大幅降低了安全运维成本。