Hanter1/Sherlock
GitHub: Hanter1/Sherlock
一款 Android 端的本地 OSINT 工作台，支持通过用户名、电话、邮箱和姓名在公开数据源中进行多维度信息检索。
Stars: 0 | Forks: 0
Android OSINT 工作台 — 用户名 · 电话 · email · 姓名
仅限公开数据源 · 本地运行 · 无封闭数据库
下载 APK
·
文档
·
构建
## 缘由
Sherlock Bot 是一个暗色系的 console-UI，用于快速查询公开页面：在 40 多个平台上检索用户名，解析电话号码（BY/RU/UA/…），查询 email（MX/SPF/DMARC/Gravatar），以及通过姓名进行搜索。所有操作均在手机本地完成；站点目录无需重写 Kotlin 代码即可更新。
## 功能特性
| | |
|---|---|
| **用户名** | 基于 [sherlock-project](https://github.com/sherlock-project/sherlock) 的站点目录（约 480 个）：提供“快速 / Sherlock Full”预设方案、过滤条件、增量对比 (Δ) 以及“重试错误”功能 |
| **电话 / Email / 姓名** | 白俄罗斯 `+375`；MX + DNS；姓名 → 关联用户名 + 目录扫描 + Google/Yandex/VK 搜索 |
| **工作台** | 操作日志、历史记录搜索、固定报告、导出 MD/JSON |
| **可靠性** | 单域名 rate limit、对 429/5xx 错误进行 retry、HTTP 诊断、扫描结束通知 |
| **目录** | `osint_sites.json` v7（MIT upstream + 人工筛选）· 远程 HTTPS · ECDSA |
完整列表请参阅 [使用指南](docs/wiki/Usage.md)。
## 快速开始
1. 从 [Releases](https://github.com/Hanter1/Sherlock/releases/latest) 页面安装 APK（debug 版本会在说明中注明）。
2. 进入 **用户名** 模式 → 输入 `durov` 或使用命令 `/username durov`。
3. 停止 — 在扫描中途取消；扫描完成后后台会收到通知。
命令示例：`/compare a b` · `/username a b c`（队列最多支持 5 个） · `/clear` · `/about`。
## 技术栈
Kotlin · Jetpack Compose · OkHttp · Coroutines · EncryptedFile
## 构建
需要 JDK 17 和 Android SDK。
```
set JAVA_HOME=C:\Program Files\Microsoft\jdk-17.0.19.10-hotspot
set ANDROID_HOME=%LOCALAPPDATA%\Android\Sdk
gradlew.bat assembleDebug
```
APK 路径：`app\build\outputs\apk\debug\app-debug.apk`
Release 版本 (R8 + minify)：复制 `keystore.properties.example` → `keystore.properties`，填入你的 `.jks` 路径，然后执行 `gradlew.bat assembleRelease`。
详情请参阅：[构建说明](docs/wiki/Building.md)。
CI: [`.github/workflows/ci.yml`](.github/workflows/ci.yml) — 包含单元测试、`lintDebug` 以及 debug APK 构建。
目录更新（每周探测）：[`scripts/probe_catalog.py`](scripts/probe_catalog.py)。
## 文档
- [主页](docs/wiki/Home.md)
- [安装](docs/wiki/Installation.md)
- [使用指南](docs/wiki/Usage.md)
- [目录](docs/wiki/Catalog.md)
- [隐私与道德](docs/wiki/Privacy-and-Ethics.md)
- [构建说明](docs/wiki/Building.md)
GitHub Wiki：在[创建首个页面](https://github.com/Hanter1/Sherlock/wiki)后，可通过 `scripts/publish_wiki.ps1` 进行同步。
## 重要提示
本应用仅查询公开的 HTTP/DNS 数据源，并**不**连接任何封闭数据库。公开搜索可能会检索到已被公开搜索引擎索引的真实姓名及数据泄露痕迹。
标签：Android, DSL, ESC4, Kotlin, OSINT, 实时处理