taotao7/PurityDetector
GitHub: taotao7/PurityDetector
一款驻留 macOS 菜单栏的轻量级应用，基于 ipdata.co 威胁情报持续监控 IP 地址的纯净度评分与风险状态。
Stars: 0 | Forks: 0
# Purity Detector
一款轻量级 macOS 菜单栏应用，用于监控您的 IP 地址并评估其 **纯净度评分** —— 一项基于 [ipdata.co](https://ipdata.co) 威胁情报的健康评级。
## 功能特性
- **菜单栏仪表盘** —— IP 地址、纯净度评分和国旗直接显示在菜单栏中
- **风险指标** —— 可视化网格显示 VPN、Proxy、Tor、Datacenter、Attacker、Abuser、Anonymous、Bogon 状态
- **纯净度评分** —— 0-100 健康分，带颜色编码评级
- **IP 变更提醒** —— 当您的 IP 地址变更时发送桌面通知
- **可配置轮询** —— 刷新间隔从 5 分钟到 24 小时
- **登录时启动** —— 通过原生 `SMAppService` 随 macOS 自动启动
- **安全存储** —— API 密钥存储在 macOS Keychain 中
- **EU 端点** —— 可选择通过 EU 服务器（巴黎/爱尔兰/法兰克福）进行路由
- **复制 IP** —— 快速复制到剪贴板
## 纯净度评分
| 分数 | 评级 | 颜色 |
|-------|--------|-------|
| 90–100 | Pure | Green |
| 70–89 | Clean | Blue |
| 50–69 | Moderate | Yellow |
| 25–49 | Suspicious | Orange |
| 0–24 | Dirty | Red |
**扣分项：** Tor (−30)、Known Attacker (−35)、Known Abuser (−25)、Proxy (−20)、VPN (−15)、Datacenter (−10)、Bogon (−40)、iCloud Relay (−5)、Blocklists (每项 −10，最多 −30)
## 安装
### Homebrew
```
brew install --cask taotao7/tap/purity-detector
```
### 手动安装
1. 从 [Releases](https://github.com/taotao7/PurityDetector/releases) 下载最新的 `.zip`
2. 解压并将 `PurityDetector.app` 拖拽到 `/Applications`
3. 启动应用 —— 它会出现在菜单栏中
## 设置
1. 从 [ipdata.co](https://ipdata.co) 获取免费的 API 密钥
2. 点击菜单栏图标 → **Settings...**
3. 输入您的 API 密钥并点击 **Save Key**
4. （可选）开启 **Launch at Login** 以随 macOS 自动启动
## 从源码构建
```
git clone https://github.com/taotao7/PurityDetector.git
cd PurityDetector
# 构建
make build
# 或在 Xcode 中打开
open PurityDetector.xcodeproj
```
**要求：** Xcode 15+, macOS 13+
## 许可证
MIT
标签：API集成, Homebrew, ipdata.co, IP信誉评分, IP地址监控, MacApp, macOS应用, Swift, Tor检测, VPN检测, 代理检测, 可观测性, 威胁情报, 开发者工具, 系统工具, 网络安全, 网络安全, 菜单栏工具, 隐私保护, 隐私保护, 风险识别