The input section is empty — no chunk content was provided to translate. Please supply the source text for chunk 3 of 73, and I’ll translate it into Chinese following all the formatting rules.```text
Scanning 118 file(s)...

── claude-code ──────────────────────────────────────────────
/home/ross/.claude/history.jsonl  (13 finding(s))
[CRITICAL] Anthropic API key (anthropic)
    /home/ross/.claude/history.jsonl:1005:13
    sk-ant-api03***...***
[CRITICAL] PyPI API token (pypi)
    /home/ross/.claude/history.jsonl:125:94
    pypi-AgEIc***...***
[CRITICAL] GitHub fine-grained PAT (github)
    /home/ross/.claude/history.jsonl:2306:13
    github_pat_11A***...***
[HIGH]     HuggingFace token (huggingface)
    /home/ross/.claude/history.jsonl:3387:13
    hf_JOi***...***
...

Total: 13 credentials across 1 file(s).
Report:  /home/ross/.medusa/secrets-scan/secrets-20260519-074452.json

The input content appears to be empty — no source text was provided after "INPUT:". Please supply the actual Markdown chunk you'd like translated.```text
[CRITICAL] PyPI API token  (pypi)
    /home/ross/.claude/history.jsonl:125:94
    pypi-AgEIc***...***
  redact?  [y/n/s/a/q/?]: y

[CRITICAL] Anthropic API key  (anthropic)
    /home/ross/.claude/history.jsonl:1005:13
    sk-ant-api03***...***
  redact?  [y/n/s/a/q/?]: y
...

✓ /home/ross/.claude/history.jsonl  (13 redacted)
    backup → /home/ross/.medusa/secrets-scan/backups/20260519-074452/home/ross/.claude/history.jsonl

### 检测内容（21 个签发方）

**AI 提供商**：Anthropic、OpenAI、HuggingFace、Replicate、Cohere
**软件包注册表**：PyPI、npm
**代码托管平台**：GitHub PAT（经典 + 细粒度 + OAuth + App）、GitLab PAT
**云服务**：AWS 访问密钥、GCP 服务账号 JSON
**支付 / 通信**：Stripe 在线/受限密钥、Slack 机器人/用户令牌、SendGrid、Twilio、Discord Webhook
**加密**：PEM 编码的私钥（RSA、DSA、EC、OpenSSH、PGP）

### 安全特性

- **仅本地运行。** 报告保存在 `~/.medusa/secrets-scan/` 目录下，权限为 `0o600`。无网络、无遥测、绝不写入项目目录树。
- **写入前备份。** 每次脱敏操作前都会创建字节级完全相同的备份。`cp` 命令可恢复。
- **JSONL 安全。** 脱敏标记不包含任何 JSON 不安全字符；写入后受影响的行会重新解析。
- **漂移时拒绝操作。** 如果源文件在扫描和清除之间发生了变化，清除工具将拒绝操作，而不是冒险覆盖编辑内容。
- **原子写入。** 临时文件 + `os.replace` 替换。要么重写生效，要么保留原文件。

[**📖 完整 secrets-scanner 指南 →**](https://github.com/pantheon-security/medusa/blob/main/docs/SECRETS_SCANNER.md)

---

## 🚀 快速开始

### 安装```bash
# Install MEDUSA (works on Windows, macOS, Linux)
pip install medusa-security

# Run your first scan - that's it!
medusa scan .

**平台说明：**
- **Windows**：如果找不到 `medusa` 命令，请使用 `py -m medusa`
- **macOS/Linux**：开箱即用

### 扫描任意 GitHub 仓库```bash
# Scan a remote repo for AI supply chain attacks
medusa scan --git https://github.com/org/repo

# Shorthand - just user/repo
medusa scan --git org/repo

# Scan a specific branch
medusa scan --git https://github.com/org/repo/tree/main

### 可选：外部 Linter

MEDUSA 会自动检测是否安装了外部 Linter（如 bandit、eslint、shellcheck 等），并自动使用它们来增强扫描覆盖率。

**[查看安装指南 →](https://github.com/pantheon-security/medusa/blob/main/docs/OPTIONAL_TOOLS.md)** 以获取特定平台的说明。

> **注意：** 外部 Linter 是可选的。MEDUSA 内置的 40,000+ 条规则无需它们也能正常工作。如需安装支持，请参阅各工具供应商的文档。

### 演示

<div align="center">

![MEDUSA 运行演示](https://assets.kitploit.com/production/public/readmes/49181/80281d742fbec3c1bf5c3cb62999af22a9fcfb2bdb89ba79eec5d27b80716e7a.gif)

</div>

### 📊 报告格式

MEDUSA 会生成多种格式的精美报告：

**JSON** - 机器可读，适合 CI/CD 集成```bash
medusa scan . --format json

**Markdown** - 适合 GitHub/wikis 的文档友好格式```bash
medusa scan . --format markdown

---

## 📚 语言支持

MEDUSA 支持 **79 种扫描器类型**，涵盖 AI/ML 安全、所有主流编程语言和文件格式：

### 后端语言（9 种）
| 语言 | 扫描器 | 扩展名 |
|----------|---------|------------|
| Python | Bandit | `.py` |
| JavaScript/TypeScript | ESLint | `.js`, `.jsx`, `.ts`, `.tsx` |
| Go | golangci-lint | `.go` |
| Ruby | RuboCop | `.rb`, `.rake`, `.gemspec` |
| PHP | Native rules (+ PHPStan optional) | `.php` |
| Rust | Native rules (+ Clippy optional) | `.rs` |
| Java | Checkstyle | `.java` |
| C/C++ | cppcheck | `.c`, `.cpp`, `.cc`, `.cxx`, `.h`, `.hpp` |
| C# | Roslynator | `.cs` |

### JVM 语言（3 种）
| 语言 | 扫描器 | 扩展名 |
|----------|---------|------------|
| Kotlin | ktlint | `.kt`, `.kts` |
| Scala | Scalastyle | `.scala` |
| Groovy | CodeNarc | `.groovy`, `.gradle` |

### 函数式语言（5 种）
| 语言 | 扫描器 | 扩展名 |
|----------|---------|------------|
| Haskell | HLint | `.hs`, `.lhs` |
| Elixir | Credo | `.ex`, `.exs` |
| Erlang | Elvis | `.erl`, `.hrl` |
| F# | FSharpLint | `.fs`, `.fsx` |
| Clojure | clj-kondo | `.clj`, `.cljs`, `.cljc` |

### 移动开发（2 种）
| 语言 | 扫描器 | 扩展名 |
|----------|---------|------------|
| Swift | SwiftLint | `.swift` |
| Objective-C | OCLint | `.m`, `.mm` |

### 前端与样式（3 种）
| 语言 | 扫描器 | 扩展名 |
|----------|---------|------------|
| CSS/SCSS/Sass/Less | Stylelint | `.css`, `.scss`, `.sass`, `.less` |
| HTML | HTMLHint | `.html`, `.htm` |
| Vue.js | ESLint | `.vue` |

### 基础设施即代码（4 种）
| 语言 | 扫描器 | 扩展名 |
|----------|---------|------------|
| Terraform | tflint | `.tf`, `.tfvars` |
| Ansible | ansible-lint | `.yml` (playbooks) |
| Kubernetes | kubeval | `.yml`, `.yaml` (manifests) |
| CloudFormation | cfn-lint | `.yml`, `.yaml`, `.json` (templates) |

### 配置文件（4 种）
| 语言 | 扫描器 | 扩展名 |
|----------|---------|------------|
| JSON | built-in | `.json` |
| TOML | taplo | `.toml` |
| XML | xmllint | `.xml` |
| Protobuf | buf lint | `.proto` |

### Shell 与脚本（4 种）
| 语言 | 扫描器 | 扩展名 |
|----------|---------|------------|
| Bash/Shell | ShellCheck | `.sh`, `.bash` |
| PowerShell | PSScriptAnalyzer | `.ps1`, `.psm1` |
| Lua | luacheck | `.lua` |
| Perl | perlcritic | `.pl`, `.pm` |

### 文档（2 种）
| 语言 | 扫描器 | 扩展名 |
|----------|---------|------------|
| Markdown | markdownlint | `.md` |
| reStructuredText | rst-lint | `.rst` |

### 其他语言（5 种）
| 语言 | 扫描器 | 扩展名 |
|----------|---------|------------|
| SQL | SQLFluff | `.sql` |
| R | lintr | `.r`, `.R` |
| Dart | dart analyze | `.dart` |
| Solidity | solhint | `.sol` |
| Docker | hadolint | `Dockerfile*` |

**总计：79 种扫描器类型 — 41 种语言/工具扫描器 + 38 种 AI/ML 安全扫描器 — 覆盖 100+ 种文件扩展名**

---

## 🚨 React2Shell CVE 检测（v2025.8 新增）

MEDUSA 现在可检测 **CVE-2025-55182 "React2Shell"** —— 一个影响 React Server Components 和 Next.js 的 CVSS 10.0 RCE 漏洞。```bash
# Check if your project is vulnerable
medusa scan .

# Vulnerable versions detected:
# - React 19.0.0 - 19.2.0 (Server Components)
# - Next.js 15.0.0 - 15.0.4 (App Router)
# - Various canary/rc releases

### 快速 AI 安全扫描```bash
# Scan AI configuration files
medusa scan . --ai-only

# Example output:
# 🔍 AI Security Scan Results
# ├── .cursorrules: 3 issues (1 CRITICAL, 2 HIGH)
# │   └── AIC001: Prompt injection - ignore previous instructions (line 15)
# │   └── AIC011: Tool shadowing - override default tools (line 23)
# ├── mcp-config.json: 2 issues (2 HIGH)
# │   └── MCP003: Dangerous path - home directory access (line 8)
# └── rag_config.json: 1 issue (1 CRITICAL)
#     └── AIR010: Knowledge base injection pattern detected (line 45)

### 安装命令```bash
# Check tool status
medusa install --check

# Install AI tools (modelscan for ML model scanning)
medusa install --ai-tools

# Show detailed output
medusa install --ai-tools --debug

### 附加命令```bash
# Uninstall modelscan
medusa uninstall modelscan

# Check for updates
medusa version --check-updates

# Show current configuration
medusa config

# Override scanner for specific file
medusa override path/to/file.yaml YAMLScanner

# List available scanners
medusa override --list

# Show current overrides
medusa override --show

# Remove override
medusa override path/to/file.yaml --remove

### 生成默认配置```bash
medusa init

### Claude Code

**它会创建：**
- `CLAUDE.md` - 项目上下文文件
- `.claude/agents/medusa/agent.json` - Agent 配置
- `.claude/commands/medusa-scan.md` - 扫描斜杠命令
- `.claude/commands/medusa-install.md` - 安装斜杠命令

**用法：**```
Type: /medusa-scan
Claude: *runs security scan*
Results: Displayed in terminal + chat

### OpenAI Codex

**它创建的内容：**
- `AGENTS.md` - 项目上下文（根级别）

**用法：**```
Ask: "Run a security scan"
Codex: *executes medusa scan .*

### 智能缓存

基于哈希的缓存会跳过未更改的文件：```bash
# First scan
📂 Files scanned: 145
⏱️  Total time: 47.28s

# Second scan (no changes)
📂 Files scanned: 0
⚡ Files cached: 145
⏱️  Total time: 2.15s  # 22× faster!

---

## 📊 示例工作流

### 新项目设置```bash
# 1. Initialize
cd my-awesome-project
medusa init

🐍 MEDUSA Initialization Wizard

✅ Step 1: Project Analysis
   Found 15 language types
   Primary: PythonScanner (44 files)

✅ Step 2: Scanner Availability
   Available: 6/79 scanners
   Missing: 73 tools

✅ Step 3: Configuration
   Created .medusa.yml
   Auto-detected IDE: Claude Code

✅ Step 4: IDE Integration
   Created .claude/agents/medusa/agent.json
   Created .claude/commands/medusa-scan.md

✅ MEDUSA Initialized Successfully!

# 2. First scan
medusa scan .

🔍 Issues found: 23
   CRITICAL: 0
   HIGH: 2
   MEDIUM: 18
   LOW: 3

# 3. Fix issues and rescan
medusa scan . --quick

⚡ Files cached: 142
🔍 Issues found: 12  # Progress!

  - name: Set up Python
    uses: actions/setup-python@v4
    with:
      python-version: '3.11'

  - name: Install MEDUSA
    run: pip install medusa-security

  - name: Run security scan
    run: medusa scan . --fail-on high

> **注意**：无需工具安装步骤 - MEDUSA 的 40,000+ 条内置规则可立即生效。

---

## 🏗️ 架构

### 扫描器模式

所有扫描器都遵循一致的模式：```python
class PythonScanner(BaseScanner):
    """Scanner for Python files using Bandit"""

    def get_tool_name(self) -> str:
        return "bandit"

    def get_file_extensions(self) -> List[str]:
        return [".py"]

    def scan_file(self, file_path: Path) -> ScannerResult:
        # Run bandit on file
        # Parse JSON output
        # Map severity levels
        # Return structured issues
        return ScannerResult(...)

### 严重性映射

所有工具统一使用的严重性级别：

- **CRITICAL** - 安全漏洞、致命错误
- **HIGH** - 错误、安全警告
- **MEDIUM** - 警告、代码质量问题
- **LOW** - 风格问题、约定
- **INFO** - 建议、重构机会

---

## 🧪 测试与质量

### 自用测试结果

MEDUSA 会扫描自身——以及实际项目：```
Self-scan (473 files):
  ✅ Issues found: 114 (pre-filter) → 0 (post-filter)
  ✅ FP reduction: 100% on own codebase
  ⏱️  Time: 8.2s

OpenClaw benchmark (4,124 files, 751K LOC):
  🔍 Issues found: 825 (post-filter)
  ✅ FPs filtered: 11,436 (93.9% reduction)
  ⏱️  Time: 3.3 hours (79 scanners)

### 添加新扫描器

请参阅 `docs/development/adding-scanners.md`，了解添加新语言支持的指南。

---

## 📜 许可证

AGPL-3.0-or-later - 参见 [LICENSE](https://github.com/pantheon-security/medusa/blob/main/LICENSE) 文件

MEDUSA 是免费开源软件。您可以自由使用、修改和分发它，但任何修改或衍生作品（包括 SaaS 部署）也必须以 AGPL-3.0 许可证发布。

如需商业许可选项，请联系：[email protected]

---

## 即将推出

MEDUSA Professional 为生产环境中的 LLM 应用新增了**运行时保护**功能，可在提示注入、越狱和数据外泄尝试到达您的模型之前实时拦截。

| 功能 | 开源版 | 专业版 | 企业版 |
|---------|-------------|--------------|------------|
| 静态扫描（40,000+ 模式） | 是 | 是 | 是 |
| 运行时代理过滤器（1,100+） | - | 是 | 是 |
| REST API 与 Webhooks | - | 是 | 是 |
| 自定义规则与 SSO | - | - | 是 |
| **价格** | 免费 | $99/开发者/月 | $499/50 开发者/月 |

运行时代理目前处于内测阶段。如果您正在保护生产环境中的 LLM 应用并希望获得提前访问权限，请联系 **[email protected]**。

---

## 🙏 致谢

**开发：**
- Pantheon Security
- Claude AI（Anthropic）- AI 辅助开发

**技术栈：**
- Python 3.10+
- Click - CLI 框架
- Rich - 终端格式化
- Bandit、ESLint、ShellCheck 及其他 39+ 开源安全工具

**灵感来源：**
- Bandit（Python 安全）
- SonarQube（多语言分析）
- Semgrep（基于模式的安全）
- Mega-Linter（全面 linting）

---

## 📖 指南

- **[快速入门](https://github.com/pantheon-security/medusa/blob/main/docs/guides/quick-start.md)** - 5 分钟内开始使用
- **[AI 安全扫描](https://github.com/pantheon-security/medusa/blob/main/docs/AI_SECURITY.md)** - AI/LLM 安全完整指南（OWASP 2025、MCP、RAG）
- **[处理误报](https://github.com/pantheon-security/medusa/blob/main/docs/guides/handling-false-positives.md)** - 减少噪音，发现真正的问题
- **[IDE 集成](https://github.com/pantheon-security/medusa/blob/main/docs/guides/ide-integration.md)** - 配置 Claude Code、Gemini、Copilot

---

## 📞 支持

- **GitHub Issues**：[报告 Bug 或请求功能](https://github.com/Pantheon-Security/medusa/issues)
- **邮箱**：[email protected]
- **文档**：https://docs.pantheonsecurity.io
- **Discord**：https://discord.gg/medusa（即将上线）

---

## 📈 统计数据

**版本**：2026.5.5
**发布日期**：2026-04-03
**检测模式**：40,000+ AI 安全规则
**分析器**：79 个专业扫描器
**误报过滤模式**：514 个智能过滤器（误报率降低 96.8%）
**CVE 覆盖**：200 个严重漏洞（37+ AI 编辑器 CVE）
**仓库投毒**：可检测 28+ 种 AI 编辑器配置文件类型
**语言覆盖**：46+ 种文件类型
**平台支持**：Linux、macOS、Windows
**AI 集成**：Claude Code、Gemini CLI、GitHub Copilot、Cursor、OpenAI Codex
**标准**：OWASP Top 10 for LLM 2025、MITRE ATLAS
**下载量**：PyPI 上 11,500+

---

## 🌟 为什么选择 MEDUSA？

### 与 Bandit 对比
- ✅ 40,000+ 模式（不仅仅是 Python 安全）
- ✅ AI/ML 安全覆盖
- ✅ 零配置要求
- ✅ IDE 集成

### 与 SonarQube 对比
- ✅ 更简单的安装（`pip install && scan`）
- ✅ 无需服务器
- ✅ AI 优先的安全重点
- ✅ 免费且开源

### 与 Semgrep 对比
- ✅ 内置 AI/ML 专用规则
- ✅ MCP、RAG、Agent 安全
- ✅ 更优秀的 IDE 集成
- ✅ 无需规则配置

### 与传统 SAST 对比
- ✅ 立即可用（无需安装工具）
- ✅ 包含 AI 安全模式
- ✅ 并行处理
- ✅ 智能缓存

---

**🐍🐍🐍 MEDUSA - 多语言安全扫描器 🐍🐍🐍**

**一条命令。全面安全。**```bash
medusa init && medusa scan .