SinakiDev/SentinelX

# SentinelX 一款轻量级的 Windows 桌面悬浮窗，用于实时监控 X (Twitter) 账号。专为追踪快速变动的新闻而打造——如地缘政治事件、冲突报道、突发状况——无需中断你的工作流程。 https://github.com/user-attachments/assets/44c1b8ff-01ce-433b-8b01-f7e6a44b87e6 ## 功能特性 - **实时动态** - 以可配置的间隔（1 分钟 - 10 分钟）轮询受监控的账号，最新推文优先 - **卡片式 UI** - 现代深色主题，带有彩色类型标签（POST, REPLY, RT）以及每条推文的 View 链接 - **置顶悬浮窗** - 悬浮于所有窗口之上，透明度可调（10% - 100%） - **无限自动滚动** - 无缝循环滚动效果；当内容较少时回退为原生滚动，可手动关闭 - **悬停暂停** - 鼠标悬停在信息流上可冻结以便阅读；移开鼠标即可恢复滚动 - **关键词提醒** - 匹配的推文会以琥珀色高亮显示，并带有关键词提示 - **最大推文时效** - 仅显示过去 30 分钟 / 45 分钟 / 1 小时 / 2 小时 / 4 小时内的推文，或显示全部 - **自适应轮询** - 在连续未拉取到新推文后，将轮询频率最多降低 5 倍以节省 API 额度；获取到新推文后立即重置 - **推文缓存** - 最近 300 条推文持久化到磁盘，启动时自动恢复并自动去重 - **安全密钥存储** - API 密钥通过 Electron 的 `safeStorage` 使用 Windows DPAPI 加密，绝不以明文形式存储 ## 下载 前往 [Releases](https://github.com/SinakiDev/SentinelX/releases) 下载最新的 `.zip` 压缩包。 ## 快速入门 1. 解压 zip 压缩包并运行 `SentinelX.exe` 2. 从 [twitterapi.io/dashboard](https://twitterapi.io/dashboard) 获取 API 密钥 3. 打开设置 - 粘贴你的密钥 - 点击 **Save Key** 4. 添加要监控的 X 账号（例如 `osint613`, `sentdefender`） 5. 关闭设置 - 轮询立即开始 **提示：** - 鼠标悬停在信息流上可暂停并阅读；移开鼠标即可恢复滚动 - 在 **Settings - Display** 中调整滚动速度和轮询间隔 - 使用 **Max tweet age** 过滤掉旧内容 - 非常适合全天候使用，保持信息流处于最新状态 ## 轮询机制原理 SentinelX 使用 `since_id` 追踪来最小化 API 额度消耗。每次轮询后，最新推文的 ID 会被保存。下一次轮询将包含 `since_id:`，因此 API 仅返回比你现有内容更新的推文——没有重复，也不会浪费额度扫描旧结果。 在首次轮询时（或者不存在先前推文 ID 时），它会回退到基于时间的 `since:` 查询，覆盖过去一小时的记录，并附带 2 分钟的重叠窗口以应对 API 的索引延迟。 分页被限制为每次轮询最多 10 页，作为额度消耗的安全保护。自适应退避机制会在连续 3-4 次拉取结果为空后触发，将轮询间隔乘以 5 倍（上限为 30 分钟）。当获取到新推文时会立即重置。 ## 从源码构建 ``` git clone https://github.com/SinakiDev/SentinelX.git cd SentinelX npm install npm run dev # development mode npm run dist # build Windows installer/zip ``` 需要 Node.js 18+ 版本 ## 技术栈 | | | |---|---| | Shell | Electron 30 | | UI | React 18 + Tailwind CSS | | 构建工具 | electron-vite + electron-builder | | X 数据 | twitterapi.io REST API | | 存储 | electron-store | | 密钥加密 | Electron `safeStorage` (Windows DPAPI) | ## 许可证 参见 [LICENSE](LICENSE)

标签：API密钥加密, API轮询, Electron, ESC4, MITM代理, OSINT, safeStorage, Twitter监控, Windows DPAPI, X监控, 冲突追踪, 地缘政治, 实时动态, 实时订阅, 桌面浮窗, 社交媒体监控, 突发新闻, 置顶悬浮窗, 自动化攻击, 舆情监控, 透明窗口