a-vip/sovereign-intel-engine
GitHub: a-vip/sovereign-intel-engine
一款自动化的开源威胁情报采集与地理编码系统，用于追踪地缘政治与技术治理风险并生成战术档案。
Stars: 1 | Forks: 0
# 📡 主权情报引擎
一款自主、高保真的威胁情报 (OSINT) 收集器、地理编码系统及战略周报编译器。该引擎会扫描 RSS 源和 GDELT 地缘政治信号，专门筛选高优先级的 AI 治理、致命性自主武器 (LAWS)、边境监控以及国家 IHL 合规性内容，通过 Gemini 3.5 Flash 对坐标进行地理编码，并无缝将结果同步至 **Sovereign Dashboard** 的云数据库中。
## ⚙️ 架构工作流
```
graph TD
A[RSS Feeds] --> D[intel_engine.py]
B[GDELT doc API] --> D
D --> E{AI Relevance Double-Filter}
E -- Rejected --> F[Discard]
E -- Match --> G[Geocoding Engine]
G --> H[Gemini 3.5 Flash Model Loop]
H --> I[Generate Obsidian Tactical Dossier]
H --> J[Draft Social Outbound Broadcast]
I --> K[Full Vault Sync Daemon]
K --> L[Sovereign Dashboard Cloud Database]
L --> M[Live Geo-Map Vis]
```
## 🛠️ 主要功能
* **双重遥测 OSINT 收集器**：结合高分辨率 RSS 源与深度的 GDELT 地缘政治文献数据，实现实时监控与稳健的历史回填。
* **双重过滤相关性检查器**：包含严格的屏蔽列表（拦截体育、名人八卦及一般性琐事），并采用精准的正向正则表达式检查器，以准确捕获技术治理、无人机系统以及生物识别/边境治安风险。
* **多重模型无感降级回退**：在地理编码和编制简报时，会循环使用多个 Gemini 模型（`gemini-3.5-flash`、`gemini-3.1-flash-lite`、`gemini-2.5-flash` 等）。如果某个模型触及 `429` 速率限制或发生超时，引擎会无缝调用下一个模型，从而保证绝对的执行稳定性。
* **自动化回填工具**：支持通过命令行历史参数覆盖，实现快速的历史追溯（例如 `python intel_engine.py 2026-05-25`）。
* **Mastodon 集成**：包含一个人机协同的验证与发布客户端，用于为倡议活动起草微型广播警报。
* **Obsidian 同步守护进程**：通过经过身份验证的同步 API，将威胁文件夹直接同步至 Vercel 托管的数据库。
## 📁 仓库结构
* `intel_engine.py`：自动化的核心。负责抓取 RSS/GDELT，处理 AI 相关性判定与地理编码，生成 Obsidian 威胁档案，起草广播内容并处理数据回填。
* `vault_sync.py`：将 Obsidian 情报库同步至在线的、由 Vercel 托管的 Sovereign Dashboard 数据库。
* `broadcast_manager.py`：人机协同的 Mastodon 客户端，用于审查、编辑和发送外发的 OSINT 广播草稿。
* `intel_sources.json`：集中式的配置目录，包含受追踪的 RSS 源及相关性关键词。
* `Run-OSINT-Crawler.ps1`：PowerShell 自动化加载器，用于针对选定的防务和法律实体启动更深度的定向搜索。
* `intel_backdate.py`：独立的历史测试爬虫。
* `compile_weekly.py`：独立的周报编译器。
## 🚀 安装与设置说明
1. **克隆仓库**：
git clone https://github.com/a-vip/sovereign-intel-engine.git
cd sovereign-intel-engine
2. **安装 Python 依赖**：
pip install -r requirements.txt
3. **环境设置 (`.env`)**：
在根目录下创建一个 `.env` 文件，并配置当前有效的 API 密钥：
GEMINI_API_KEY=your_gemini_api_key
DASHBOARD_API_TOKEN=your_dashboard_api_token
MASTODON_API_TOKEN=your_mastodon_token
4. **用法**：
* **日常战术运行**：
python intel_engine.py
* **历史回填**：
python intel_engine.py 2026-05-25
* **广播警报审查**：
python broadcast_manager.py
## ⚖️ 许可证
MIT 许可证。为 Sovereign Algorithms Campaign 而创建。
## 👨💻 关于作者
此爬虫与同步守护进程套件由 **Avi Perera** 设计并开发。
* 🌐 **个人网站**：[aviperera.com](https://aviperera.com)
* 🚀 **企业平台**：[sovdash.com](https://sovdash.com) (Sovereign Intel Platform)
标签：AI合规, BeEF, DLL 劫持, ESC4, OSINT, 地理编码, 大语言模型, 威胁情报, 实时处理, 开发者工具, 情报收集, 数据自动化, 漏洞研究, 爬虫, 逆向工具