如果你已经通过 pipx 安装了 `orewatch`，并且之后想添加 macOS 菜单栏应用，请将 Cocoa 绑定注入到同一个 pipx 环境中：```bash
pipx inject orewatch pyobjc-framework-Cocoa

**卸载：**```bash
pipx uninstall orewatch

**升级:**```bash
brew update && brew upgrade orewatch

> **注意：** Homebrew 配方包含了 `orewatch monitor menubar` 所需的 Cocoa 绑定。如果较旧的 Homebrew 安装报告 `ModuleNotFoundError: No module named 'AppKit'`，请运行 `brew update && brew reinstall rapticore/tap/orewatch`，以便配方重建其隔离的 Python 环境并支持菜单栏。

#### 选项 3 — pip

对于 CI 管道、Docker 镜像或自行管理虚拟环境（virtualenv）的情况，请使用 `pip`：```bash
# Install into an active Python 3.14 virtualenv or user site
python3.14 -m pip install orewatch

# Pin a version for reproducible CI builds
python3.14 -m pip install orewatch==1.3.0

# If you want the macOS menu bar app on a fresh install, use this instead:
# python3.14 -m pip install 'orewatch[mac-menubar]'

# Verify
orewatch --help

#### 选项 4 — 源码检出（贡献者）```bash
# Clone the repository
git clone https://github.com/rapticore/ore-mal-pkg-inspector.git
cd ore-mal-pkg-inspector

# Create and activate a Python 3.14 virtual environment (recommended)
python3.14 -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install in editable mode for development
python -m pip install -e .

# Verify
orewatch --help

#### 平台说明

| 平台 | Python 来源 | 备注 |
|---|---|---|
| **macOS** (Homebrew Python) | `brew install [email protected]` | 推荐 Homebrew 用户使用 |
| **macOS** (pyenv) | `pyenv install 3.14` | 适合多版本管理 |
| **Ubuntu / Debian** | `sudo apt install python3.14` 或 pyenv | 请确认你的发行版提供了 3.14+ |
| **Fedora / RHEL** | `sudo dnf install python3.14` 或 pyenv | — |
| **Windows (WSL)** | pyenv 或系统包 | 原生 Windows 未经测试 |

> **需要 Python 3.14。** OreWatch 使用了 Python 3.14 引入的语言特性。旧版本在导入时会失败。

#### 安装故障排除

| 症状 | 修复方法 |
|---|---|
| `command not found: orewatch` | 确保安装位置在你的 `PATH` 中。对于 pipx：运行 `pipx ensurepath` 并重启 shell。 |
| 导入时出现 `ModuleNotFoundError` | 可能存在多个 Python 版本。确认 `orewatch` 运行环境为 Python 3.14+，并使用对应的解释器重新安装。 |
| pipx 安装因解析器错误失败 | 升级 pipx：`python3.14 -m pip install --upgrade pipx` |
| Homebrew 安装后找不到 `orewatch` | 先运行 `brew tap rapticore/tap`，然后重试安装。 |
| pip 安装时权限被拒绝 | 使用 `pip install --user orewatch` 或在虚拟环境中安装。 |

_注意：如果本地威胁数据缺失或过期，包扫描会暂存一个实时更新候选，并仅在异常检测通过后才将其激活。如果候选数据看起来可疑，OreWatch 会保持最近已知良好的数据集有效。_

_已安装 CLI：_ `orewatch`
_兼容别名：_ `ore-mal-pkg-inspector`

### 首次扫描

**扫描一个项目目录：**```bash
# Auto-detect ecosystem and scan current directory
orewatch .

# Scan specific project path
orewatch /path/to/your/project

# With verbose output to see progress
orewatch /path/to/your/project --verbose

如果你希望 OreWatch 在初次扫描后持续监控该项目，请继续阅读[后台监控](#background-monitoring)或直接跳转到 [docs/adoption-guide.md](https://github.com/rapticore/ore-mal-pkg-inspector/blob/HEAD/docs/adoption-guide.md)。

---

## 使用方法

### 基本命令

**扫描目录（自动检测生态系统）：**```bash
# Current directory
orewatch .

# Specific directory
orewatch /home/user/projects/my-app

# With an absolute path
orewatch /home/user/projects/backend-api

**强制特定生态系统：**```bash
# Override auto-detection
orewatch /path/to/project --ecosystem npm
orewatch /path/to/project --ecosystem pypi
orewatch /path/to/project --ecosystem maven
orewatch /path/to/project --ecosystem rubygems
orewatch /path/to/project --ecosystem go
orewatch /path/to/project --ecosystem cargo

### 高级用法

**自定义输出路径：**```bash
# Save to custom location
orewatch /path/to/project --output /tmp/scan_report.json

# Save to specific subdirectory
orewatch /path/to/project --output reports/security/$(date +%Y%m%d).json

**静默模式：**```bash
# Generate report without console summary (useful for scripts)
orewatch /path/to/project --no-summary

**批量扫描：**```bash
# Scan multiple projects
for dir in ~/projects/*/; do
    echo "Scanning $dir"
    orewatch "$dir" --output "reports/$(basename $dir).json"
done

`monitor quickstart` 是推荐的首运行流程。它将：

- 安装或刷新单例监控服务
- 在需要时启动监控
- 将目标项目添加到监视列表
- 打印所选客户端的引导块

如果您倾向于先安装监控，之后再连接客户端：```bash
orewatch monitor install
orewatch monitor install --ide-bootstrap
orewatch monitor install --service-manager launchd --no-start

用这些命令处理略微不同的任务：

- `monitor status` 显示单例守护进程和 API 是否在运行
- `monitor connection-info` 打印回环 API URL、令牌路径、监视器主目录和支持的引导客户端
- `monitor doctor` 打印确切的配置、状态数据库、日志和共享威胁数据路径

**3. 添加你想要单例监视的每个项目**```bash
orewatch monitor watch add /path/to/project-a
orewatch monitor watch add /path/to/project-b
orewatch monitor watch list
orewatch monitor watch remove /path/to/project-b

当 `orewatch monitor ide-bootstrap --client <client>` 可以解析本地控制台脚本时，现在会输出该绝对路径，而不是裸的 `orewatch`。如果你有旧的 MCP 配置仍然写着 `"command": "orewatch"`，请重新生成并替换旧条目。```json
{
  "orewatch": {
    "baseUrl": "http://127.0.0.1:48736",
    "tokenPath": "/path/to/api.token"
  }
}

推荐设置：

1. 运行 `orewatch monitor quickstart /path/to/project --client <cursor|claude_code|codex>` 一次。
2. 将打印出的 MCP 块复制到相应的 MCP 客户端中。
3. 在该客户端中打开一个受监控的项目。
4. 让客户端通过 MCP 调用 OreWatch：
   - `orewatch_health`
   - `orewatch_check_dependency_add`
   - `orewatch_check_manifest`
   - `orewatch_override_dependency_add`
   - `orewatch_list_active_findings`
   - `orewatch_list_notifications`

注意：

- `monitor mcp` 是一个 stdio 服务器。如果你手动启动它，它在等待 MCP 客户端时会显示为空闲状态。
- MCP 桥接在启动时检查本地 API，并且在启用 `auto_start_on_client` 时可以自动启动单例监视器一次。
- 为了可靠的 IDE 启动，请使用 `monitor install` 安装后台监视器一次，这样在 MCP 桥接启动之前守护进程就已经可用。

##### VS Code

VS Code 集成应使用单例 localhost API，而不是 MCP 桥接。

推荐设置：

1. 运行 `orewatch monitor quickstart /path/to/project --client vscode`。
2. 从 `orewatch monitor ide-bootstrap --client vscode` 复制 `baseUrl` 和 `tokenPath`。
3. 将这些值接入你的本地 VS Code 扩展、任务或辅助工具中。
4. 在依赖添加、清单保存和警报刷新事件时调用 API。

VS Code 集成的推荐 API 用法：

- 在包管理器安装/添加流程之前调用 `POST /v1/check/dependency-add`
- 当支持的清单文件被保存或显式重新检查时调用 `POST /v1/check/manifest`
- 轮询 `GET /v1/findings/active` 和 `GET /v1/notifications` 以显示后台检测结果

##### JetBrains / PyCharm

JetBrains 和 PyCharm 使用与 VS Code 相同的 localhost API 约定。

推荐设置：

1. 运行 `orewatch monitor quickstart /path/to/project --client jetbrains`。
2. 从 `orewatch monitor ide-bootstrap --client jetbrains` 复制 API 块。
3. 在 JetBrains 插件、外部工具或本地辅助工具中使用返回的 `baseUrl` 和 `tokenPath`。
4. 在 IDE 中显示同步的依赖决策和存储的后台警报。

JetBrains 集成的推荐 API 用法：

- 使用 `POST /v1/check/dependency-add` 检查依赖添加
- 使用 `POST /v1/check/manifest` 重新检查 `package.json`、`requirements.txt`、`pyproject.toml`、`pom.xml`、`Gemfile`、`go.mod`、`Cargo.toml` 及相关支持的清单文件
- 获取 `GET /v1/findings/active` 和 `GET /v1/notifications` 用于持久警报面板或工具窗口

##### Xcode

Xcode 集成也应使用单例 localhost API，但有一个重要的范围边界：OreWatch 尚不解析原生的 Apple 依赖清单文件，如 `Package.resolved`、`Podfile.lock` 或 `Cartfile`。目前，Xcode 集成最适合用于：

- 在辅助工具、脚本或配套应用中显示后台发现和通知
- 在 Xcode 中打开的多语言仓库，其中也包含支持的清单文件，如 `package.json`、`pyproject.toml` 或 `Cargo.toml`
- 希望在 Xcode 工作时使用 macOS 菜单栏应用和通知中心警报的团队

推荐设置：

1. 运行 `orewatch monitor quickstart /path/to/project --client xcode`。
2. 从 `orewatch monitor ide-bootstrap --client xcode` 复制 API 块。
3. 在构建阶段脚本、辅助进程或自定义 Xcode 集成中使用返回的 `baseUrl` 和 `tokenPath`。
4. 轮询 `GET /v1/findings/active` 和 `GET /v1/notifications` 以获取用户可见的警报。
5. 如果 Xcode 工作区包含支持的非 Apple 清单文件，请在工作流程中调用 `POST /v1/check/manifest` 检查这些文件。

当前集成状态：

- Claude Code、Codex 和 Cursor：本仓库中包含一流的 MCP 桥接
- VS Code：本地 API 约定已有文档，但尚未提供第一方扩展
- JetBrains / PyCharm：本地 API 约定已有文档，但尚未提供第一方插件
- Xcode：本地 API 和菜单栏集成已有文档，但尚未提供第一方 Xcode 扩展，也没有原生的 Apple 清单文件解析器

#### 当 OreWatch 发现异常时

当后台监视器在受监控的项目中检测到受损包或 IoC 时，OreWatch：

- 在单例监视器的 `reports/` 目录下写入由监视器管理的 JSON 和 HTML 报告
- 将当前发现结果存储在监视器状态数据库中
- 存储带有可操作消息的通知条目
- 如果启用了终端通知，则发出终端警告
- 在 macOS 上，优先使用正在运行的单例菜单栏应用作为弹出通道
- 将最新的值得关注的警报固定在菜单栏下拉菜单顶部，以便快速查看
- 否则，如果启用了桌面通知，则回退到尽力而为的直接桌面通知
- 可以为远程或无头环境发送可选的 webhook 通知

使用内置的 CLI 审查界面来检查这些警报：```bash
orewatch monitor findings
orewatch monitor findings --project /path/to/project --min-severity high
orewatch monitor notifications
orewatch monitor notifications --project /path/to/project
orewatch monitor package-updates
orewatch monitor package-updates --check

然后启动菜单栏应用：```bash
orewatch monitor menubar

**手动快照与签名操作：**```bash
# Generate a signing keypair
orewatch monitor snapshot keygen /tmp/ore-keys

# Build and apply local threat-data snapshots
orewatch monitor snapshot build /tmp/ore-snapshot \
  --private-key /tmp/ore-keys/snapshot_signing_private.pem \
  --public-key /tmp/ore-keys/snapshot_signing_public.pem
orewatch monitor snapshot apply /tmp/ore-snapshot/manifest.json \
  --public-key /tmp/ore-keys/snapshot_signing_public.pem

# Publish a hosted snapshot channel
orewatch monitor snapshot publish /tmp/ore-snapshots \
  --base-url https://example.com/ore-snapshots \
  --channel stable \
  --private-key /tmp/ore-keys/snapshot_signing_private.pem \
  --public-key /tmp/ore-keys/snapshot_signing_public.pem

关键行为：
- 实时候选数据首先在暂存区构建；它们在收集期间不会覆盖活跃数据库。
- 大规模数据丢失、生态系统回归、空生态系统以及批量移除会阻止推广。
- 核心数据源中断在开源实时刷新中默认仅作为警告；生态系统级的数据丢失和移除仍会阻止不良推广。
- 仅警告的异常会被记录在状态和报告中，但不会阻止推广。
- 当已存在最后已知良好的数据集时，被拒绝的候选数据会保持该数据集活跃。
- 如果至少一个核心数据源成功，并且候选数据产生可用的生态系统数据，则允许首次运行从实时数据源引导。

**可选的通知Webhook配置：**```yaml
notifications:
  desktop: true
  terminal: true
  webhook_url: https://hooks.example.com/orewatch
  webhook_format: generic
  webhook_timeout_ms: 5000
  webhook_headers:
    Authorization: Bearer change-me

Homebrew 依然是已发布的 PyPI 版本的便捷层，而非主要发布工件。

**对贡献者的最佳建议：** 保持当前的源码检出流程：```bash
git clone https://github.com/rapticore/ore-mal-pkg-inspector.git
cd ore-mal-pkg-inspector
python3.14 -m venv .venv
source .venv/bin/activate
python -m pip install -e .

**输出包括：**
- 生态系统检测结果
- 文件解析进度
- 包提取计数
- 数据库查询详情
- IoC 扫描进度

**示例：**```
INFO: Detected ecosystems: npm, pypi
INFO: Loaded database for npm: 15234 malicious packages
INFO: Loaded database for pypi: 8421 malicious packages
INFO: Extracted 45 packages from 3 files
INFO: Checking 30 npm packages against database...
INFO: Checking 15 pypi packages against database...
INFO: IoC scan complete: 0 indicators found

**Output includes:**
- 所有 INFO 级别消息
- 扫描中的文件路径
- SQL 查询执行详情
- 哈希计算
- 模式匹配结果
- 内部状态信息

**Use cases:**
- 调查为什么未检测到某个包
- 调试生态系统自动检测问题
- 报告带有详细上下文的问题
- 审计扫描器行为

### 收集器的日志记录

威胁情报收集器也支持 verbose 和 debug 模式：```bash
cd collectors

# See collection progress
python3 orchestrator.py --verbose

# Debug data source issues
python3 orchestrator.py --debug

**威胁数据字段：**
- `data_status`：`complete`、`partial`、`failed` 或 `not_applicable`
- `sources_used`：为请求的生态系统贡献了可用威胁数据的来源
- `experimental_sources_used`：扫描数据中包含的实验性来源
- `missing_ecosystems`：没有可用包威胁数据库的请求生态系统
- `promotion_decision`：对于现有数据扫描为空，否则为 `promoted`、`bootstrapped` 或 `rejected`
- `kept_last_known_good`：当实时候选被拒绝但先前的活动数据集仍然可用时为 `true`
- `anomalies`：实时刷新尝试期间引发的警告/阻止异常

---

### 理解结果

**严重性级别：**
- **CRITICAL:** 已知的恶意代码，带有活跃的漏洞利用或数据泄露
- **HIGH:** 恶意意图或域名抢注的强烈指标
- **MEDIUM:** 可疑模式或潜在漏洞
- **LOW:** 次要问题或信息性发现

**推荐操作：**
1. **严重/高危发现：** 立即移除受影响的包并调查影响
2. **查看IoC：** 检查恶意代码是否已执行（日志、网络活动）
3. **更新依赖项：** 用合法的替代品替换恶意包
4. **重新扫描：** 通过后续扫描验证修复
5. **报告：** 考虑向包注册表维护者报告

---

## CI/CD 集成

### GitHub Actions

**基本安全扫描：**```yaml
name: Security Scan - Malicious Packages
on: [push, pull_request]

jobs:
  malicious-package-scan:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: '3.14'

      - name: Install OreWatch
        run: |
          git clone https://github.com/rapticore/ore-mal-pkg-inspector.git scanner
          cd scanner
          pip install .

      - name: Scan for malicious packages
        run: |
          cd scanner
          orewatch ${{ github.workspace }} --latest-data

      - name: Upload scan report
        uses: actions/upload-artifact@v4
        if: always()
        with:
          name: security-scan-report
          path: scanner/scan-output/

      # Check if malicious packages were found
      MALICIOUS_COUNT=$(jq '.malicious_packages_found' report.json)
      IOC_COUNT=$(jq '.iocs_found' report.json)

      if [ "$MALICIOUS_COUNT" -gt 0 ] || [ "$IOC_COUNT" -gt 0 ]; then
        echo "🚨 SECURITY ALERT: Malicious packages or IoCs detected!"
        echo "Malicious packages: $MALICIOUS_COUNT"
        echo "IoCs found: $IOC_COUNT"
        exit 1
      fi

### GitLab CI```yaml
malicious-package-scan:
  image: python:3.14
  stage: security
  before_script:
    - git clone https://github.com/rapticore/ore-mal-pkg-inspector.git scanner
    - cd scanner && pip install .
  script:
    - orewatch $CI_PROJECT_DIR --latest-data --strict-data --output scan-report.json
  artifacts:
    paths:
      - scan-report.json
    when: always
  allow_failure: false

stages {
    stage('Setup Scanner') {
        steps {
            sh '''
                git clone https://github.com/rapticore/ore-mal-pkg-inspector.git scanner
                cd scanner
                python3.14 -m pip install .
            '''
        }
    }

    stage('Security Scan') {
        steps {
            sh '''
                cd scanner
                orewatch ${WORKSPACE} --latest-data
            '''
        }
    }
}

post {
    always {
        archiveArtifacts artifacts: 'scanner/scan-output/*.json', fingerprint: true
    }
}

### 预提交钩子

添加到 `.git/hooks/pre-commit`:```bash
#!/bin/bash

echo "Running malicious package scan..."

cd /path/to/ore-mal-pkg-inspector
orewatch $PROJECT_DIR --no-summary

if [ $? -ne 0 ]; then
    echo "❌ Malicious packages or IoCs detected! Commit blocked."
    echo "Review the scan report in scan-output/"
    exit 1
fi

echo "✅ Security scan passed"

**原因：** 威胁数据收集失败，元数据不完整，或者请求的生态系统尚无可用的本地数据库。

**解决方案：**```bash
# Force recollection and require a complete result for the requested ecosystems
orewatch /path/to/project --latest-data --strict-data

**可能的原因和解决方案：**

1. **错误的目录：** 确保你扫描的是正确的项目目录   ```bash
   ls /path/to/project  # Verify package.json or requirements.txt exists

**解决方案：**

1. **检查互联网连接：**   ```bash
   ping google.com

**解决方案:**```bash
# Ensure proper ownership
sudo chown -R $USER:$USER /path/to/ore-mal-pkg-inspector

# Or run from user-writable location
cd ~/
git clone https://github.com/rapticore/ore-mal-pkg-inspector.git
cd ore-mal-pkg-inspector

orewatch clean```bash

#### 误报

**症状：** 合法软件包被标记为恶意。

**步骤：**

1. **验证发现：** 查看报告详情，包括严重性和描述

2. **检查版本：** 被标记的版本可能特定：   ```bash
   orewatch /path/to/project --verbose

**审查日志：** 检查 `debug.log` 以获取详细的执行跟踪，包括：
- 扫描的文件路径
- 执行的 SQL 查询
- 模式匹配结果
- 错误堆栈跟踪

---

## 常见问题解答

### 我应该多久更新一次威胁情报？

**建议：**
- **生产/CI 环境：** 每日自动更新
- **开发工作站：** 至少每周更新
- **安全新闻发布后：** 当新威胁被宣布时立即更新

恶意软件包持续发布。每日更新确保最新的防护。

### 如何更新威胁情报数据？

使用 `--latest-data` 标志运行扫描器以强制更新：```bash
orewatch /path/to/project --latest-data

**离线更新：** ❌ 否，威胁情报收集需要互联网访问以从安全来源获取数据。

**隔离环境：** 您可以：
1. 在联网机器上下载数据库
2. 将SQLite文件传输到由 `orewatch monitor doctor` 显示的单个 `final_data_dir` 中
3. 使用可能过时的数据离线运行扫描

### 与 npm audit 或 pip-audit 相比如何？

**不同目的：**

**npm audit / pip-audit：**
- 专注于已知的CVE漏洞
- 根据公告数据库检查包版本
- 由包注册表团队维护

**OreWatch：**
- 专注于恶意包（不仅仅是存在漏洞的包）
- 检测域名抢注、恶意软件、供应链攻击
- 跨生态系统的覆盖
- 针对活跃威胁的IoC检测

**最佳实践：** 同时使用**两者**：```bash
# Check for vulnerabilities
npm audit
pip-audit

# Check for malicious packages
orewatch /path/to/project

---

## 贡献

我们欢迎各类贡献！无论是报告错误、提出功能建议还是贡献代码，您的帮助都能让 OreWatch 变得更好。

**报告错误或请求功能：**
- GitHub Issues：https://github.com/rapticore/ore-mal-pkg-inspector/issues

**贡献代码：**
- 有关开发环境搭建、代码风格、测试及拉取请求流程的详细指南，请参阅 [CONTRIBUTING.md](https://github.com/rapticore/ore-mal-pkg-inspector/blob/HEAD/CONTRIBUTING.md)

**问题或讨论：**
- GitHub Discussions：https://github.com/rapticore/ore-mal-pkg-inspector/discussions

---

## 安全策略

安全是我们的首要任务。OreWatch 是一款安全工具，我们非常重视漏洞。

### 报告安全漏洞

**请勿为安全漏洞公开创建 GitHub Issue。**

请私下报告：

**电子邮件：** [email protected]

**请包含：**
- 漏洞描述
- 复现步骤
- 潜在影响
- 建议修复方案（如适用）
- 您的联系方式以便跟进

### 响应时间线

- **确认：** 48 小时内
- **初步评估：** 7 天内
- **修复时间线：** 视严重性而定
  - 严重：7-14 天
  - 高：14-30 天
  - 中/低：30-60 天

### 安全最佳实践

使用 OreWatch 时：

**应当：**
- ✅ 以最小权限运行（无需 root/管理员）
- ✅ 定期更新威胁情报
- ✅ 及时审查扫描报告
- ✅ 集成到 CI/CD 中以实现持续保护
- ✅ 保持工具更新至最新版本

**不应：**
- ❌ 未经调查就忽略扫描结果
- ❌ 在生产环境中禁用 IoC 扫描
- ❌ 共享来自不受信任源的数据库文件
- ❌ 不必要地使用提升的权限运行

### 漏洞披露

我们遵循协调披露流程：
1. 漏洞私下报告
2. 开发并测试修复方案
3. 发布安全公告
4. 修复方案可用后公开披露

### 安全名人堂

我们感谢负责任披露漏洞的安全研究人员：

*名单将在收到报告后持续维护*

---

### 社区请求

对功能进行投票或提出建议：
- **GitHub Discussions：** https://github.com/rapticore/ore-mal-pkg-inspector/discussions
- **功能请求：** https://github.com/rapticore/ore-mal-pkg-inspector/issues

### 贡献路线图

我们根据以下因素确定功能优先级：
- 安全影响
- 社区需求
- 维护可持续性
- 与项目目标一致

要影响路线图：
1. 提出包含详细用例的功能请求
2. 参与讨论
3. 贡献实现代码（欢迎 PR！）

---

## 路线图

OreWatch 当前可用于：

- 在 npm、PyPI、Maven、RubyGems、Go 及 Cargo 上执行本地 CLI 扫描
- 为多个项目运行一个每用户后台监控器
- 支持 Cursor、Claude Code 和 Codex 的 MCP 集成
- 支持 VS Code、JetBrains / PyCharm 和 Xcode 辅助工具的 localhost API 集成
- macOS 菜单栏审查和弹窗通知

近期优先事项：

- 第一方 VS Code 和 JetBrains / PyCharm 集成示例或轻量插件
- 比本地弹窗更强的面向用户的通知工作流
- 通过 CLI 和 UI 实现更清晰的项目策略管理
- 更丰富的监控器报告和采用文档

中期优先事项：

- 从监控器和 MCP 界面实现更广泛的项目扫描工作流
- 更好的组织级推广指南
- 更稳健的外部告警传递和升级渠道
- 更深入的 IDE 专属用户体验，而非仅提供 API 集成指南

当前已知边界：

- Xcode 集成目前最适合告警可见性和多语言仓库。OreWatch 尚不支持解析 Apple 原生命清单，例如 `Package.resolved`、`Podfile.lock` 或 `Cartfile`。

长期方向：

- 原生 Apple 生态系统清单支持
- 更强的第一方编辑器集成
- 在现有 macOS 菜单栏路径之外，实现更广泛的操作系统用户体验一致性

请参阅 [docs/roadmap.md](https://github.com/rapticore/ore-mal-pkg-inspector/blob/HEAD/docs/roadmap.md) 获取更偏重采用的路线图视图。

---

## 许可证

MIT 许可证

版权所有 (c) 2025 Rapticore

特此免费授予任何获得本软件副本及相关文档文件（以下简称“软件”）的人不受限制地处理本软件的权利，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售本软件副本的权利，并允许获得本软件的人在满足以下条件的情况下这样做：

上述版权声明和本许可声明应包含在本软件的所有副本或实质部分中。

本软件按“原样”提供，不做任何形式的明示或默示保证，包括但不限于对适销性、特定用途的适用性和非侵权的保证。在任何情况下，作者或版权持有人均不对任何索赔、损害或其他责任负责，无论这些责任是基于合同、侵权或其他原因，均与本软件或其使用或其他交易有关。

---

## 支持

### 获取帮助

**文档：** 您正在阅读它！大多数问题都可以从这里开始。

**GitHub Discussions：** 用于提问、想法和社区互动：
- https://github.com/rapticore/ore-mal-pkg-inspector/discussions

**GitHub Issues：** 用于错误报告和功能请求：
- https://github.com/rapticore/ore-mal-pkg-inspector/issues

**电子邮件：** 用于安全漏洞和私人咨询：
- [email protected]

### 专业支持

对于需要以下服务的组织：
- 自定义集成
- 基于 SLA 的支持
- 私有部署协助
- 自定义威胁情报源

联系：[email protected]

---

## 致谢

### 项目起源

本项目是从 [OreNPMGuard](https://github.com/rapticore/OreNPMGuard) 仓库中提取出来的，以在扩展能力的同时保持项目聚焦。

**OreNPMGuard**（2025年12月）专注于 Shai-Hulud npm 攻击检测，涵盖 738 多个受影响包及深度 IoC 分析。在其开发过程中，我们认识到需要更广泛的多生态系统保护，因此创建了 OreWatch 作为一个独立工具，为所有主要包生态系统的更广泛开发者社区服务。

### 相关项目

- **[OreNPMGuard](https://github.com/rapticore/OreNPMGuard)** - 专门的 Shai-Hulud npm 扫描器
---

**由 Rapticore 安全研究团队构建**

*保护软件供应链，一次扫描一步。*