Kumarpi3052/detektor

GitHub: Kumarpi3052/detektor

一款面向 AI Agent 的安全扫描工具,可在 CI 流水线中检测 Prompt 注入、工具权限等风险并生成 OpenPAKT 合规报告。

Stars: 0 | Forks: 0

# 🛡️ detektor - 快速扫描 AI Agent 安全 [![下载 detektor](https://img.shields.io/badge/Download-Detektor-1f6feb?style=for-the-badge&logo=github)](https://github.com/Kumarpi3052/detektor/releases) ## 🧭 detektor 的功能 detektor 是一款 Windows 应用程序,用于检查 AI agent 配置中的安全风险。 它可以帮助您发现: - Prompt 注入风险 - 不安全的工具访问 - 薄弱的 agent 权限 - CI 安全检查中的问题 - 缺少 OpenPAKT 报告详细信息 在 AI agent 发布之前或在构建 pipeline 中运行之前,使用它来对其进行审查。 ## 💻 前置条件 在安装 detektor 之前,请确保您的电脑具备以下条件: - Windows 10 或 Windows 11 - 用于下载的网络连接 - 至少 200 MB 的可用磁盘空间 - 标准用户帐户或管理员帐户 - 如果应用程序提示,则需要 .NET Desktop Runtime 如果您的系统阻止了该应用程序,请使用有权运行下载文件的工作帐户或个人帐户。 ## 📥 下载 detektor 访问此页面下载 Windows 版本: https://github.com/Kumarpi3052/detektor/releases 在该页面上,查找最新版本并下载 Windows 文件。大多数用户应选择 Assets 下方列出的 `.exe` 或 `.zip` 文件。 ## 🪟 在 Windows 上安装并打开 按照以下步骤操作: 1. 在浏览器中打开发布页面。 2. 在页面顶部找到最新版本。 3. 在 Assets 下,下载 Windows 文件。 4. 如果您下载的是 `.zip` 文件,请将其打开并解压缩内容。 5. 如果您下载的是 `.exe` 文件,请双击它以运行 detektor。 6. 如果 Windows 显示安全提示,请选择允许您打开该文件的选项。 7. 等待应用程序完成加载。 如果您解压了一个文件夹,请将文件保存在同一位置。 ## 🔍 如何使用 detektor 打开应用程序后,按以下步骤使用: 1. 启动 detektor。 2. 将其指向您的 AI agent 项目、构建文件夹或 CI 输出。 3. 如果应用程序询问,请选择扫描类型。 4. 运行扫描。 5. 查看以下各项的结果: - Prompt 注入警告 - 工具权限问题 - 不安全的访问模式 - CI 安全发现 6. 如果需要共享,请导出或保存报告。 如果您的项目使用了 agent、工具或 prompt 文件,请优先扫描它们。 ## 🧪 detektor 检查的内容 detektor 专注于 AI agent 工作中最常见的风险领域: - prompt 和 agent 输入中的 Prompt 注入路径 - 提供过多访问权限的工具权限 - 可能访问文件、网络或 shell 命令的不安全工具调用 - 可以在构建中运行的 CI 安全检查 - 用于审查和审计的 OpenPAKT 报告输出 这使其适用于本地审查和构建时检查。 ## 📄 OpenPAKT 报告 detektor 可以为您的扫描生成 OpenPAKT 报告。 在以下情况下使用这些报告: - 与团队共享结果 - 保留扫描记录 - 以标准格式审查问题 - 随时间推移跟踪变更 如果您使用 CI,请将报告保存为构建输出的一部分。 ## 🛠️ 常见设置提示 如果应用程序未启动: - 尝试以下载它的同一用户身份再次打开它 - 检查文件是否被 Windows 阻止 - 确保下载已完成 - 如果您使用了 ZIP 文件,请在运行应用程序之前解压缩所有文件 - 如果 Windows 要求提供 .NET,请安装它指定的 runtime,然后重试 如果扫描未找到您的文件: - 检查文件夹路径 - 确保项目文件未仍位于嵌套的 ZIP 文件夹中 - 使用项目的本地副本,而不是仅限云端的快捷方式 ## 🔐 最佳使用方式 为获得最佳效果,请扫描: - Agent prompt 文件 - 工具配置文件 - 构建脚本 - CI pipeline 文件 - 任何告知 agent 其可访问内容的文件 在发布、合并和部署之前运行 detektor。 ## 📁 典型用例 detektor 适用于: - AI agent 项目 - 带有工具的 LLM 应用程序 - DevSecOps 构建检查 - CI 中的安全测试 - Prompt 安全审查 - Agent 工具的权限审查 它适合希望在发布代码之前进行简单安全检查的团队。 ## 🧩 您可能会看到的文件类型 发布页面可能包含以下一种或多种文件: - `.exe` 用于在 Windows 上直接运行 - `.zip` 用于手动解压并运行 - 扫描结果的报告文件 - 应用程序使用的支持文件 如果您不确定使用哪个文件,请从最新版本中选择 Windows `.exe` 或主要的 `.zip` 包 ## ❓ 首次运行帮助 如果 Windows 显示智能屏幕或文件警告: 1. 检查文件是否来自 detektor 发布页面 2. 再次打开文件 3. 如果您信任该来源,请选择运行它的选项 如果应用程序打开后迅速关闭: - 再次运行它 - 检查是否输入了文件路径 - 查看是否需要先设置扫描设置 如果您想保留结果: - 每次扫描后保存报告 - 使用带有日期的清晰文件名 - 将报告存储在项目文件夹中 ## 📌 项目主题 detektor 涵盖与以下相关的工作: - agent 安全 - AI agent - AI 安全 - AI 安全 - CI 安全 - DevSecOps - .NET - LLM 安全 - OpenPAKT - prompt 注入 - 安全扫描器 - 安全测试
标签:AI安全, Chat Copilot, CISA项目, CI安全, DevSecOps, OpenPAKT, Streamlit, URL发现, Windows桌面应用, 上游代理, 合规报告, 多人体追踪, 安全检测, 工作流安全, 智能体安全, 访问控制