malware-check

pip install malware-check

pipx install malware-check

git clone https://github.com/momenbasel/malware-check.git
cd malware-check
pip install -e ".[dev]"

# 核心 + 二进制分析 + AI 文件检测 + YARA
pip install malware-check[full]

# 或仅安装所需部分
pip install malware-check[binary]
pip install malware-check[detect]
pip install malware-check[yara]

# 或手动安装附加功能
pip install pefile lief magika yara-python

pip install malware-check[detect]

# 需要 Docker – https://docs.docker.com/get-docker/
# 构建沙箱镜像（一次性设置）
malware-check build-sandbox

malware-check info

# 从 GitHub 安装技能
npx skills install momenbasel/malware-check --skill malware-check

# 或手动操作：将 skill/SKILL.md 复制到您的技能目录
cp -r skill/ ~/.claude/skills/malware-check/

pip install malware-check pefile lief yara-python

# 1. 安装 CLI
pip install malware-check pefile lief yara-python

# 2. 添加到您的 Codex 指令（codex.md 或系统提示）
echo '使用 `malware-check scan <路径> --verbose` 分析文件是否存在恶意软件。' >> AGENTS.md

# 3. 或安装为 Codex 技能
cp -r skill/ .codex/skills/malware-check/

# 1. 安装
pip install malware-check

# 2. 添加到智能体指令：
# “当要求检查代码/二进制文件是否存在恶意软件时，使用：malware-check scan <目标> --verbose”
# “对于报告：malware-check scan <目标> --format html -o report.html”
# “对于 CI/CD：malware-check scan <目标> --format sarif -o report.sarif --exit-code”

malware-check scan suspicious_file.py

# 安装 malware-check[detect] 时效果最佳
malware-check scan suspicious_payload --verbose

malware-check scan /path/to/project --verbose

# 首先构建沙箱（一次性的）
malware-check build-sandbox

# 执行行为分析扫描
malware-check scan malware.exe --dynamic

malware-check scan /Applications/SuspiciousApp.app --dynamic --verbose

# JSON 报告
malware-check scan target/ --format json -o report.json

# HTML 仪表盘
malware-check scan target/ --format html -o report.html

# SARIF 用于 CI/CD
malware-check scan target/ --format sarif -o results.sarif

# 发现问题时退出码非零（用于 CI 门禁）
malware-check scan . --format sarif -o results.sarif --exit-code

malware-check info

name: 安全扫描
on: [push, pull_request]

jobs:
  malware-check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: 设置 Python
        uses: actions/setup-python@v5
        with:
          python-version: "3.12"

      - name: 安装 malware-check
        run: pip install malware-check

      - name: 运行扫描
        run: malware-check scan . --format sarif -o results.sarif --exit-code

      - name: 上传 SARIF
        if: always()
        uses: github/codeql-action/upload-sarif@v3
        with:
          sarif_file: results.sarif

malware-check/
├── src/malware_check/
│   ├── cli.py                 # Click CLI 入口点
│   ├── scanner.py             # 编排器 + 基于 Magika 的可选文件检测
│   ├── models.py              # Finding, FileAnalysis, ScanResult 数据模型
│   ├── analyzers/
│   │   ├── code.py            # 源代码模式匹配（40+ 条规则）
│   │   ├── binary.py          # PE/Mach-O/ELF 分析
│   │   ├── privacy.py         # PII、跟踪、权限
│   │   ├── yara_engine.py     # YARA 规则编译和扫描
│   │   └── dynamic.py         # Docker 沙箱行为分析
│   └── reporters/
│       ├── console_reporter.py  # Rich 终端输出
│       ├── json_reporter.py     # JSON 导出
│       ├── html_reporter.py     # HTML 仪表盘（Jinja2）
│       └── sarif_reporter.py    # SARIF 2.1.0 用于 CI/CD
├── rules/yara/                # 内置 YARA 规则
├── tests/                     # pytest 测试套件
└── pyproject.toml             # 项目元数据

malware-check scan target/ --yara-rules /path/to/my/rules/

rule My_Custom_Rule {
    meta:
        description = "检测自定义恶意软件模式"
        severity = "critical"
        category = "backdoor"
        confidence = "0.90"
        mitre = "T1059"
        cwe = "CWE-94"
        recommendation = "移除恶意代码"

    strings:
        $pattern = "suspicious_string"

    condition:
        $pattern
}

# 克隆并安装开发依赖
git clone https://github.com/momenbasel/malware-check.git
cd malware-check
pip install -e ".[dev]"

# 可选：在开发时包含 Magika、YARA 和二进制扩展功能
pip install -e ".[dev,full]"

# 运行测试
pytest

# 代码检查
ruff check src/ tests/