Lucas-Maingi/Aletheia

# Aletheia — 防御性 OSINT 与数字暴露平台 Aletheia 是一个**代理型开源情报 (OSINT) 平台**，可自动收集、关联并利用 AI 辅助综合*公开可获取的*信息。它专为**防御性和经授权的使用场景**而构建——帮助组织和个人在攻击者利用之前了解并减少自身的数字暴露。 ## 🛡️ 用途 安全和风险团队经常需要回答一些手动研究既繁琐又缓慢的问题： - **“我们有哪些信息已经暴露？”** — 哪些公司邮箱出现在已知的公开数据泄露中？关于我们的基础设施，有哪些可公开发现的子域名、服务和元数据？ - **“是否有人在冒充我们？”** — 相似域名、虚假社交资料和品牌滥用。 - **“我们即将与之合作的对象是谁？”** — 基于公共记录和制裁名单，在获得同意的情况下对供应商或交易对手进行尽职调查。 Aletheia 将这些调查作为**自动化代理工作流**在可插拔的 connector 上运行，然后使用 LLM 将原始调查结果综合成结构化、可引用的报告——将数小时的手动交叉比对缩短至几分钟。 ## 🧩 架构 Aletheia 是一个基于 **Next.js (App Router) + TypeScript** 的应用程序，以 **PostgreSQL via Prisma** 作为后端支撑，并配备了模块化的 connector 引擎和可选的 LLM 综合层。 ``` Next.js UI ──► Investigation API ──► Connector Engine (registry) (App Router) (route handlers) │ ├─ Breach intelligence (e.g. XposedOrNot) ├─ Infrastructure / attack surface (e.g. Shodan InternetDB) ├─ Public records & sanctions screening ├─ Archive / historical footprint (Wayback) └─ Knowledge graph enrichment (Wikidata) ▼ LLM synthesis ──► Structured, cited report ──► PostgreSQL (case store) ``` **Connector 引擎。** 每个数据源都是一个隔离的、强类型的 connector，返回标准化的 `ConnectorResult`，并注册在中央注册表中，以便调查可以跨数据源并行展开。在可能的情况下，connector 优先使用免费、无需密钥的公共 API。 **案例管理。** 调查以案例的形式持久化存储，以便随着时间的推移对调查结果进行审查、共享和重新运行。 ## ⚙️ 快速开始（自托管） ### 前置条件 - Node.js 18.x 或更高版本 - 一个 PostgreSQL 数据库 - 用于综合层的 LLM API 密钥 — **Google Gemini**（在 [aistudio.google.com](https://aistudio.google.com) 提供免费额度）是默认选项；支持将 OpenRouter、Groq 或 OpenAI 作为自动备用方案。如果没有密钥，扫描仍会运行并存储证据；仅会跳过由 AI 编写的报告。 ### 安装说明 ``` git clone https://github.com/Lucas-Maingi/Aletheia.git cd Aletheia npm install # 配置 environment cp .env.example .env.local # fill in DATABASE_URL and optional API keys # 初始化 database schema npx prisma db push # 运行 development server npm run dev ``` 应用程序将在 `http://localhost:3000` 运行。 ## 🔒 负责任的使用 Aletheia 仅查询**公开可获取的**信息源，旨在用于合法的防御性和调查性工作：保护您自己的资产、监控您自身的暴露情况、经授权的渗透测试、新闻报道以及合规/尽职调查研究。 **请勿**在缺乏合法依据和适当授权的情况下，使用 Aletheia 跟踪、骚扰、对个人进行特征分析或监视。用户有责任遵守其所在司法管辖区的所有适用法律（包括数据保护和反跟踪法）。Aletheia 是一款研究工具，并不对第三方数据的准确性具有权威性——在做出任何决定之前，应对调查结果进行独立验证。 ## 📄 许可证 核心引擎采用 [MIT 许可证](LICENSE) 授权。

标签：ESC4, GitHub, OSINT, TypeScript, 威胁情报, 安全插件, 实时处理, 开发者工具, 数字风险保护, 测试用例, 自动化攻击