在线网站： https://www.crucix.live/ 先体验公共演示，然后克隆仓库即可在本地运行 Crucix。

Crucix 从 27 个开源情报数据源并行拉取卫星火情探测、航班追踪、辐射监测、卫星星座追踪、经济指标、实时市场价格、冲突数据、制裁清单和社交情绪——每 15 分钟更新一次——并将所有内容呈现在一个自成一体的 Jarvis 风格仪表盘上。

接入 LLM 后，它便成为双向情报助手——当有重要变化时向 Telegram 和 Discord 推送多级警报，响应来自手机的 /brief、/sweep 等命令，并生成基于真实跨领域数据的可执行交易思路。这就是你的私人分析师，在你睡觉时为你守望世界。

先在 https://www.crucix.live/ 体验在线演示，当你需要完整的本地环境时再克隆仓库。

无云端。无遥测。无订阅。只需 node server.mjs 即可运行。

代币 / 资产警告

[!WARNING] Crucix 尚未发布任何官方代币、币、NFT、空投、预售或其他基于区块链的资产。 任何使用 Crucix 名称、徽标或品牌的代币或数字资产均与 Crucix 无关，也未获得 Crucix 认可。 请勿根据第三方帖子、私信或网站购买、推广该代币，连接钱包领取，签署交易或转账。

---

为什么会有这个项目

世界上大部分实时情报——卫星图像、辐射水平、冲突事件、经济指标、航班追踪、海上活动——都是公开可获取的。它们只是分散在数十个政府 API、研究机构和开放数据源中，没有人有时间逐一查看。

Crucix 将这一切汇聚到一处。不设付费墙，不锁定在企业平台，也无需安全许可。只是开放数据，在你的机器上聚合与交叉关联，每 15 分钟更新一次。

它面向任何想要了解当下世界真实动态的人——研究人员、记者、交易员、OSINT 分析师，或只是相信信息获取不应取决于你预算的好奇人士。

---

快速开始```bash

1. Clone the repo

git clone https://github.com/calesthio/Crucix.git cd Crucix

2. Install dependencies (just Express)

npm install

3. Copy env template and add your API keys (see below)

cp .env.example .env

4. Start the dashboard

npm run dev

> **如果 `npm run dev` 静默失败**（无输出退出），请直接运行 Node：
> ```bash
> node --trace-warnings server.mjs
> ```
> 这会绕过 npm 的脚本运行器，它在某些系统（尤其是 Windows 上的 PowerShell）上可能会吞掉错误。你也可以运行 `node diag.mjs` 来诊断具体问题——它会检查你的 Node 版本、逐一测试每个模块的导入，并验证端口可用性。更多信息请参见 [故障排查](#troubleshooting)。

仪表盘会在 `http://localhost:3117` 自动打开，并立即开始首次情报扫描。这次初始扫描会并行查询全部 27 个数据源，通常需要 30–60 秒——在扫描完成并推送首次数据更新之前，仪表盘会显示为空。之后，它会通过 SSE（Server-Sent Events）每 15 分钟自动刷新一次。无需手动刷新页面。

**要求：** Node.js 22+（使用原生 `fetch`、顶层 `await`、ESM）

### Docker```bash
git clone https://github.com/calesthio/Crucix.git
cd Crucix
cp .env.example .env    # add your API keys
docker compose up -d

仪表板位于 http://localhost:3117。扫描数据通过卷挂载持久化存储在 ./runs/ 中。包含健康检查端点。

---

你将获得

实时仪表板

一个自带完整功能的 Jarvis 风格 HUD，包含：

• 3D WebGL 地球仪（Globe.gl），带大气辉光、星空背景和平滑旋转 — 另附经典平面地图切换
• 9 种标记类型 覆盖两种视图：火灾探测、空中交通、辐射站点、海上咽喉要道、SDR 接收器、OSINT 事件、健康警报、地理定位新闻、冲突事件
• 3D 飞行走廊动态弧线，连接空中交通热点与全球枢纽
• 区域过滤器（全球、美洲、欧洲、中东、亚太、非洲）— 旋转地球仪或缩放平面地图
• 实时市场数据 — 通过 Yahoo Finance 获取指数、加密货币、能源、大宗商品（无需 API 密钥）
• 风险仪表 — VIX、高收益利差、供应链压力指数
• OSINT 信息流 — 来自 17 个 Telegram 情报频道的英文帖子（可扩展）
• 新闻滚动条 — 合并 RSS + GDELT 头条 + Telegram 帖子，自动滚动
• 扫描增量 — 实时面板显示自上次扫描以来的变化（新信号、升级、降级，附带严重程度）
• 跨来源信号 — 跨卫星、经济、冲突和社交领域的关联情报
• 核辐射监测 — 来自 Safecast + EPA RadNet 的实时辐射读数
• 太空监测 — CelesTrak 卫星追踪：近期发射、国际空间站、军用星座、Starlink/OneWeb 数量
• 可执行思路 — AI 生成的交易思路（接入 LLM 时）或信号关联思路（未接入时）

性能模式

顶栏中的 VISUALS FULL / VISUALS LITE 按钮仅改变渲染行为 — 它不会移除数据源或减少扫描覆盖范围。

当切换到 VISUALS LITE 时，仪表板将：

• 禁用装饰性背景效果，如径向/网格叠加层和扫描线
• 移除面板和叠加层上开销较大的模糊/backdrop-filter 效果
• 停止非必要动画，如 Logo 圆环闪烁、冲突光环和走廊流动效果
• 禁用地球仪自动旋转，并关闭飞行弧线动画虚线
• 将横向新闻滚动条和 OSINT 信息流转换为静态可滚动列表，而非持续动画的跑马灯

移动端特定行为：

• 在移动端，VISUALS LITE 还会强制仪表板进入平面地图模式（如果你当前正使用地球仪视图）
• 启用低性能模式后，未来移动端加载将继续以平面视图启动

该偏好设置保存在浏览器本地存储中，因此界面会记住你的上次设置。

自动刷新

服务器每 15 分钟运行一次扫描周期（可配置）。每个周期：

1. 并行查询全部 27 个数据源（约 30 秒）
2. 将原始数据合成为仪表板格式
3. 计算与上次运行的增量（哪些变化、升级、降级）— 显示在仪表板的扫描增量面板中
4. 生成 LLM 交易思路（如已配置）
5. 评估突发新闻警报 — 多层级（FLASH / PRIORITY / ROUTINE）并带语义去重。如已配置，发送到 Telegram 和/或 Discord。支持 LLM 评估；当 LLM 不可用时回退到基于规则的警报。
6. 通过 SSE 向所有已连接的浏览器推送更新

Telegram 机器人（双向）

Crucix 兼作交互式 Telegram 机器人。除发送警报外，它还能直接响应你聊天中的命令：

命令	功能
/status	系统健康状态、上次扫描时间、数据源状态、LLM 状态
/sweep	触发手动扫描周期
/brief	最新情报的紧凑文本摘要（方向、关键指标、顶级 OSINT）
/portfolio	投资组合状态（如已连接 Alpaca）
/alerts	带层级的近期警报历史
/mute / /mute 2h	静默警报 1 小时（或自定义时长）
/unmute	恢复警报
/help	显示所有可用命令

这需要在 .env 中配置 TELEGRAM_BOT_TOKEN 和 TELEGRAM_CHAT_ID。机器人每 5 秒轮询一次消息（可通过 TELEGRAM_POLL_INTERVAL 配置）。

Discord 机器人（双向）

Crucix 同样支持 Discord，作为功能完整的机器人，提供斜杠命令和富嵌入警报。它以 Discord 原生格式镜像了 Telegram 机器人的各项功能。

命令	功能
/status	系统健康状态、上次扫描时间、数据源状态、LLM 状态
/sweep	触发手动扫描周期
/brief	最新情报的紧凑文本摘要
/portfolio	投资组合状态（如已连接 Alpaca）

警报以富嵌入形式发送，侧边栏颜色编码：FLASH 为红色，PRIORITY 为黄色，ROUTINE 为蓝色。每条嵌入包含信号详情、置信度评分和跨域关联。

配置要求： DISCORD_BOT_TOKEN、DISCORD_CHANNEL_ID，以及可选的 DISCORD_GUILD_ID（用于即时斜杠命令注册）。详见 API 密钥设置。

Webhook 回退： 如果你不想运行完整机器人，可改为设置 DISCORD_WEBHOOK_URL。这将启用零依赖的单向警报（无斜杠命令）— 无需 discord.js。

可选依赖： 完整机器人需要 discord.js。使用 npm install discord.js 安装。如果未安装，Crucix 会自动回退到仅 Webhook 模式。

可选 LLM 层

可连接 8 家 LLM 提供商中的任意一家以增强分析：

• AI 交易思路 — 量化分析师产出 5-8 条可执行思路，并引用具体数据
• 更智能的警报评估 — LLM 将信号分类为 FLASH/PRIORITY/ROUTINE 层级，附带跨域关联和置信度评分
• 提供商：Anthropic Claude、OpenAI、Google Gemini、OpenRouter（统一 API）、OpenAI Codex（ChatGPT 订阅）、MiniMax、Mistral、Grok
• 优雅回退 — 当 LLM 不可用时，基于规则的引擎接管警报评估。LLM 故障绝不会导致扫描周期崩溃。

---

API 密钥设置

将项目根目录下的 .env.example 复制为 .env：```bash cp .env.example .env

### 获得最佳结果所需（全部免费）

| 密钥 | 来源 | 获取方式 |
|-----|--------|------------|
| `FRED_API_KEY` | Federal Reserve Economic Data | [fred.stlouisfed.org](https://fred.stlouisfed.org/docs/api/api_key.html) — 即时，免费 |
| `FIRMS_MAP_KEY` | NASA FIRMS（卫星火点数据） | [firms.modaps.eosdis.nasa.gov](https://firms.modaps.eosdis.nasa.gov/api/area/) — 即时，免费 |
| `EIA_API_KEY` | US Energy Information Administration | [api.eia.gov](https://www.eia.gov/opendata/register.php) — 即时，免费 |

这三个密钥可解锁最有价值的经济与卫星数据。每个密钥注册大约只需 60 秒。

### 可选（启用额外的数据源）

| 密钥 | 来源 | 获取方式 |
|-----|--------|------------|
| `ACLED_EMAIL` + `ACLED_PASSWORD` | 武装冲突事件数据 | [acleddata.com/register](https://acleddata.com/register/) — 免费，OAuth2 |
| `AISSTREAM_API_KEY` | 海上 AIS 船舶跟踪 | [aisstream.io](https://aisstream.io/) — 免费 |
| `ADSB_API_KEY` | 原始航班跟踪 | [RapidAPI](https://rapidapi.com/adsbexchange/api/adsbexchange-com1) — 约 $10/月 |

### LLM 提供商（可选，用于 AI 增强的洞察）

将 `LLM_PROVIDER` 设置为以下之一：`anthropic`、`openai`、`gemini`、`codex`、`openrouter`、`minimax`、`mistral`、`grok`