Veto

面向Android的开源VirusTotal客户端

免费开源。自带VirusTotal API密钥，可扫描文件、链接和已安装应用，覆盖超过70个引擎，采用Material 3界面设计。无账户、无追踪、无广告。

Veto是什么？

Veto是VirusTotal的Android客户端。提交文件、链接或已安装应用以查看实时分析结果。应用显示清晰的报告，从单一统一判定到服务返回的完整字段集。

项目免费开源，不含用户账户、追踪系统或广告。由于用户提供自己的VirusTotal API密钥，所有扫描直接在其个人账户下运行，无需经过第三方中间服务器。

截图

功能特性

• 扫描能力： 扫描已安装应用、本地文件或目标URL。
• 多引擎聚合： 整合超过70个反病毒引擎的诊断结果。
• 双报告模式： 快速模式提供快速验证摘要，详细模式用于深度检查。
• 上下文解释： 每个部分都有说明文本，并可根据需要隐藏说明。
• 高保真报告： 显示文件哈希、威胁分类、历史记录、社区投票、沙箱行为、YARA匹配、Android应用内部信息以及所有额外的API负载字段。
• 后台执行： 实时上传和分析进度跟踪，在后台服务中持续运行。
• 离线访问： 将报告保存到本地，以便即使没有网络连接也能稍后查看。
• 速率限制警告： 当本地API密钥达到速率限制时显示清晰通知。
• 主题： 完全支持Material 3动态系统颜色，支持浅色和深色主题。

核心架构实现细节

• 状态同步： 应用范围的ScanManager作为所有扫描状态的集中真相源。这确保用户界面无论应用是否在前台激活、在后台暂停或被操作系统销毁，都能保持同步。
• 弹性轮询： 应用使用六分钟墙壁时钟上限轮询/analyses/{id}端点。如果遇到速率限制响应，则等待而非失败。持续重新获取报告直到结果填充，若达到超时限制则返回结构化失败状态。
• 进程生命周期： ScanState驻留在ScanManager中以在Activity销毁后存活，而ScanService在活动操作期间维护进程生命周期，并管理进行中和完成通知。
• 完整保真解析： 常见字段使用类型化模型捕获，同时通过自定义序列化器保留完整的原始attributes JSON。这使得详细报告视图能够渲染所有返回的字段，包括随着时间推移添加到API负载中的任何新字段。

技术栈

项目结构

└── app/src/main/java/com/quantum_prof/vtscansuite/
    ├── data/          # 模型、远程API和仓库实现
    ├── domain/        # 仓库接口和业务用例
    ├── di/            # Hilt依赖注入模块
    ├── scan/          # ScanManager、ScanService和系统通知
    └── ui/            # UI组件和表示层
        ├── intro/     # 启动画面和API密钥配置
        ├── dashboard/ # 导航中心：链接、文件和应用扫描模块
        ├── results/   # 快速和详细报告可视化器
        ├── components/# 可复用的UI元素和布局
        ├── theme/     # 颜色、形状、字体和动效配置
        └── util/      # 触觉反馈、手势和深层链接工具

• 商店列表资源和文本资源位于fastlane/metadata/android/en-US/。
• 可编辑的模拟图SVG位于docs/store/svg/。
• 模拟图可使用docs/store/export.html导出为PNG格式。

开始使用

前提条件

• Android Studio（最新稳定版）
• JDK 17
• 免费的VirusTotal API密钥，可在此获取：https://www.virustotal.com/gui/my-apikey

构建和运行

克隆仓库并使用命令行编译调试构建：

git clone https://github.com/ProfessorQuantumUniverse/VTScan.git
cd VTScan
./gradlew :app:assembleDebug

或者在Android Studio中打开根目录并选择运行配置。

首次启动时，在介绍设置界面输入您的VirusTotal API密钥。该密钥存储在本地设备上。免费API密钥通常每分钟限制四次查询。

隐私政策

该应用仅使用您提供的凭据与VirusTotal API通信。上传的文件、提交的URL和动态结果直接发送到VirusTotal的服务器。API密钥存储在您的本地设备上。Veto不收集分析数据且不包含广告SDK。

许可证

本项目根据GNU通用公共许可证v3.0条款许可。

GPLv3关键条款：

• 商业使用： 允许
• 修改： 允许
• 分发： 允许
• 源代码披露： 分发时要求
• 相同许可证： 修改后的代码也必须使用GPLv3
• 责任与担保： 作者不提供任何担保

更多详情请参阅仓库中的LICENSE文件。