在线网站: https://www.crucix.live/ 先探索公开演示，再克隆仓库以在本地运行Crucix。

Crucix从27个开源情报源并行、每15分钟拉取卫星火灾探测、航班跟踪、辐射监测、卫星星座跟踪、经济指标、实时市场价格、冲突数据、制裁名单以及社会情绪等信息，并将所有内容渲染到一个独立的Jarvis风格仪表盘上。

若接入大型语言模型，它便成为双向情报助手——当有重要变化时向Telegram和Discord推送多级警报，响应手机上的/brief和/sweep等指令，并基于真实的跨领域数据生成可操作的交易建议。这就像一位属于您的分析师，在您熟睡时时刻关注着全球动态。

请先在https://www.crucix.live/体验在线演示，待您准备好完整的本地环境后再克隆仓库。

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

代币/资产警告

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

---

为何存在

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

Crucix将这一切汇聚到一处。既不在付费墙后，也不被锁定在企业级平台中，更不需要安全许可。只是开放数据，在您的设备上聚合并交叉关联，每15分钟更新一次。

它专为那些希望了解当前世界真实状况的人而打造——研究人员、记者、交易员、开源情报分析师，或是仅仅相信信息获取不应受预算限制的好奇人士。

---

快速开始

# 1. 克隆仓库
git clone https://github.com/calesthio/Crucix.git
cd Crucix

# 2. 安装依赖（仅需Express）
npm install

# 3. 复制环境模板并添加您的API密钥（见下文）
cp .env.example .env

# 4. 启动仪表盘
npm run dev

如果npm run dev静默失败（无输出直接退出），请改用Node直接运行：

node --trace-warnings server.mjs

这样可以绕过npm的脚本运行器，因为它在某些系统上可能会吞掉错误（尤其是在Windows的PowerShell中）。您也可以运行node diag.mjs来诊断具体问题——它会检查您的Node版本、逐个测试每个模块的导入，并验证端口是否可用。更多信息请参阅故障排除。

仪表盘会自动在http://localhost:3117打开，并立即开始首次情报扫描。首次扫描会并行查询所有27个源，通常需要30–60秒——在此期间仪表盘会显示为空，直到扫描完成并推送第一条数据更新。之后，它将通过SSE（服务器发送事件）每15分钟自动刷新，无需手动刷新页面。

要求: Node.js 22+（使用原生fetch、顶级await、ESM）

Docker

git clone https://github.com/calesthio/Crucix.git
cd Crucix
cp .env.example .env    # 添加您的API密钥
docker compose up -d

仪表盘地址为http://localhost:3117。扫描数据通过卷挂载保存在./runs/目录中。包含健康检查端点。

---

您将获得

实时仪表盘

一个自包含的Jarvis风格HUD，具备：

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

性能模式

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

切换到“VISUALS LITE”时，仪表盘会：

• 禁用装饰性背景效果，如径向/网格叠加层和扫描线；
• 移除面板和叠加层上的高开销模糊/背景滤镜效果；
• 停止非必要的动画，例如标志环闪烁、冲突环以及走廊流动效果；
• 禁用地球仪自动旋转，并关闭飞行轨迹的动画虚线；
• 将水平新闻滚动条和OSINT信息流转换为静态可滚动列表，而非持续动画的跑马灯。

移动端特定行为：

• 在移动端，“VISUALS LITE”还会在当前显示地球仪视图时，强制将仪表盘切换至平面地图模式；
• 未来在启用低性能模式的情况下，移动端加载时将继续以平面地图模式启动。

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

自动刷新

服务器每15分钟（可配置）执行一次扫描周期。每个周期包括以下步骤：

1. 并发查询所有27个数据源（约30秒）；
2. 将原始数据整合为仪表盘格式；
3. 计算与上一次运行的差异（哪些内容发生变化、升级或降级），这些信息会在仪表盘的“扫描差异”面板中显示；
4. 生成LLM交易建议（若已配置）；
5. 评估突发新闻警报——采用多层级（紧急/优先/常规）机制，并进行语义去重处理。如果已配置，则通过Telegram和/或Discord发送警报。当LLM可用时，使用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机器人，具备斜杠命令和富嵌入式警报功能。其功能与Telegram机器人相同，但采用Discord原生格式。

命令	功能
/status	显示系统健康状况、上次扫描时间、数据源状态及LLM状态
/sweep	手动触发一次扫描周期
/brief	提供最新情报的简洁文本摘要
/portfolio	显示投资组合状态（若已连接Alpaca）

警报以富嵌入式消息形式发送，带有颜色编码的侧边栏：红色代表紧急，黄色代表优先，蓝色代表常规。每条嵌入消息包含信号详情、置信度评分以及跨领域关联信息。

设置要求： 需要配置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会将信号分类为紧急/优先/常规三个级别，并结合跨领域关联和置信度评分；
• 支持的提供商包括：Anthropic Claude、OpenAI、Google Gemini、OpenRouter（统一API）、OpenAI Codex（ChatGPT订阅用户）、MiniMax、Mistral、Grok；
• 好的回退机制——当LLM不可用时，基于规则的引擎将接管警报评估工作。LLM故障绝不会导致扫描周期崩溃。

---

API密钥设置

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

cp .env.example .env

为获得最佳效果所需（全部免费）

键	来源	获取方式
FRED_API_KEY	联邦储备经济数据	fred.stlouisfed.org — 即刻获取，免费
FIRMS_MAP_KEY	NASA FIRMS（卫星火灾数据）	firms.modaps.eosdis.nasa.gov — 即刻获取，免费
EIA_API_KEY	美国能源信息管理局	api.eia.gov — 即刻获取，免费

以上三项能够解锁最有价值的经济和卫星数据。每项注册大约需要60秒。

可选（用于启用更多数据源）

键	来源	获取方式
ACLED_EMAIL + ACLED_PASSWORD	武装冲突事件数据	acleddata.com/register — 免费，OAuth2认证
AISSTREAM_API_KEY	海事AIS船舶追踪	aisstream.io — 免费
ADSB_API_KEY	未过滤的航班追踪	RapidAPI — 大约10美元/月

LLM提供商（可选，用于AI增强型建议）

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

提供商	所需密钥	默认模型
anthropic	LLM_API_KEY	claude-sonnet-4-6
openai	LLM_API_KEY	gpt-5.4
gemini	LLM_API_KEY	gemini-3.1-pro
openrouter	LLM_API_KEY	openrouter/auto
codex	无需密钥（使用~/.codex/auth.json）	gpt-5.3-codex
minimax	LLM_API_KEY	MiniMax-M2.5
mistral	LLM_API_KEY	mistral-large-latest
grok	LLM_API_KEY	grok-4-latest

对于Codex，您需要运行npx @openai/codex login来通过您的ChatGPT订阅进行身份验证。

Telegram机器人+警报（可选）

键	获取方式
TELEGRAM_BOT_TOKEN	通过Telegram上的@BotFather创建
TELEGRAM_CHAT_ID	通过@userinfobot获取
TELEGRAM_CHANNELS	(可选) 除内置的17个频道外，额外监控的频道ID，用逗号分隔
TELEGRAM_POLL_INTERVAL	(可选) 机器人命令轮询间隔，单位为毫秒（默认值：5000）

Discord 机器人 + 警报（可选）

键	获取方式
DISCORD_BOT_TOKEN	在 Discord 开发者门户 → 机器人 → 令牌 中创建
DISCORD_CHANNEL_ID	在 Discord 中右键点击频道（启用开发者模式）→ 复制频道 ID
DISCORD_GUILD_ID	(可选) 右键点击服务器 → 复制服务器 ID。启用即时 slash 命令注册（否则全局命令可能需要长达 1 小时）
DISCORD_WEBHOOK_URL	(可选) 频道设置 → 集成 → Webhook → 新建 Webhook → 复制 URL。用于仅警报模式，无需机器人

Discord 机器人设置：

1. 前往 Discord 开发者门户，创建一个新的应用
2. 进入 机器人 → 点击 重置令牌 → 将令牌复制到 DISCORD_BOT_TOKEN
3. 在 特权网关意图 中，启用 消息内容意图
4. 进入 OAuth2 → URL 生成器 → 选择 bot 和 applications.commands 权限范围 → 选择 发送消息 和 嵌入链接 权限
5. 复制生成的 URL，在浏览器中打开以将机器人邀请到您的服务器
6. 安装依赖：npm install discord.js

警报功能在 Telegram 和 Discord 上均可使用，无论是否配备 LLM。配置了 LLM 后，信号评估会更加丰富且更具上下文感知能力。如果没有 LLM，则由确定性规则引擎根据严重性、跨领域相关性以及信号数量来评估信号。

无需任何密钥

Crucix 即使不使用任何 API 密钥也能正常运行。超过 18 个数据源完全不需要身份验证。而需要密钥的数据源则会返回结构化错误，其余部分的扫描仍会正常进行。

---

架构

crucix/
├── server.mjs                 # Express 开发服务器（SSE、自动刷新、LLM、机器人命令）
├── crucix.config.mjs          # 配置文件，支持环境变量覆盖及增量阈值
├── diag.mjs                   # 诊断脚本 — 如果服务器无法启动则运行
├── .env.example               # 所有已记录的环境变量
├── package.json               # 运行时：express | 可选：discord.js
├── docs/                      # README 的截图
│
├── apis/
│   ├── briefing.mjs           # 主调度器 — 并行运行所有 27 个数据源
│   ├── save-briefing.mjs      # CLI：保存带时间戳和最新 JSON 文件
│   ├── BRIEFING_PROMPT.md     # 情报整合协议
│   ├── BRIEFING_TEMPLATE.md   # 简报输出结构
│   ├── utils/
│   │   ├── fetch.mjs          # safeFetch() — 超时、重试、取消、自动解析 JSON
│   │   └── env.mjs            # .env 加载器（无需 dotenv 依赖）
│   └── sources/               # 27 个自包含的数据源模块
│       ├── gdelt.mjs          # 每个模块导出 briefing() → 结构化数据
│       ├── fred.mjs           # 可独立运行：node apis/sources/fred.mjs
│       ├── space.mjs          # CelesTrak 卫星跟踪
│       ├── yfinance.mjs       # Yahoo Finance — 免费实时市场数据
│       └── ...                # 另外 23 个
│
├── dashboard/
│   ├── inject.mjs             # 数据合成 + 独立 HTML 注入
│   └── public/
│       └── jarvis.html        # 自包含的 Jarvis HUD
│
├── lib/
│   ├── llm/                   # LLM 抽象层（8 家提供商，原生 fetch，无 SDK）
│   │   ├── provider.mjs       # 基类
│   │   ├── anthropic.mjs      # Claude
│   │   ├── openai.mjs         # GPT
│   │   ├── gemini.mjs         # Gemini
│   │   ├── grok.mjs           # Grok
│   │   ├── openrouter.mjs     # OpenRouter（统一 API）
│   │   ├── codex.mjs          # Codex（ChatGPT 订阅）
│   │   ├── minimax.mjs        # MiniMax（M2.5，204K 上下文）
│   │   ├── mistral.mjs        # Mistral AI
│   │   ├── ideas.mjs          # LLM 驱动的交易想法生成
│   │   └── index.mjs          # 工厂：createLLMProvider()
│   ├── delta/                 # 扫描之间的变化追踪
│   │   ├── engine.mjs         # 增量计算 — 语义去重、可配置阈值、严重性评分
│   │   ├── memory.mjs         # 热存储（3 次运行，原子写入）+ 冷存储（每日归档）
│   │   └── index.mjs          # 重新导出
│   └── alerts/
│       ├── telegram.mjs       # 多层级警报（紧急/优先/常规）+ 双向机器人命令
│       └── discord.mjs        # Discord 机器人（slash 命令、丰富嵌入）+ webhook 备用
│
└── runs/                      # 运行时数据（被 .gitignore 忽略）
    ├── latest.json            # 最新扫描输出
    └── memory/                # 增量内存（hot.json + cold/YYYY-MM-DD.json）

设计原则

• 纯 ESM — 每个文件都是 .mjs，并使用显式导入
• 最小依赖 — Express 是唯一的运行时依赖。discord.js 是可选的（用于 Discord 机器人）。LLM 提供商使用原生 fetch()，无需 SDK。
• 并行执行 — 使用 Promise.allSettled() 同时触发所有 27 个数据源
• 优雅降级 — 缺少密钥只会产生错误，不会导致崩溃。LLM 故障也不会中断整个扫描过程。
• 每个数据源独立运行 — 可以通过运行 node apis/sources/gdelt.mjs 来单独测试任意一个数据源
• 自包含仪表盘 — HTML 文件无论是否有服务器都能正常工作

---

数据源（27 个）

第一层：核心 OSINT 和地缘政治（11 个）

数据源	追踪内容	身份验证
GDELT	全球新闻事件、冲突地图（100 多种语言）	无
OpenSky	实时 ADS-B 飞行跟踪，覆盖 6 个热点地区	无
NASA FIRMS	卫星火灾/热异常检测（3 小时延迟）	免费密钥
Maritime/AIS	船舶跟踪、暗影船只、制裁规避	免费密钥
Safecast	公民科学辐射监测，靠近 6 个核设施	无
ACLED	武装冲突事件：战斗、爆炸、抗议活动	免费（OAuth2）
ReliefWeb	联合国人道主义危机追踪	无
WHO	疾病爆发和卫生紧急情况	无
OFAC	美国财政部制裁名单（SDN 名单）	无
OpenSanctions	全球制裁汇总（30 多个来源）	部分需要
ADS-B Exchange	未过滤的飞行跟踪，包括军用航班	收费

第二层：经济与金融（7 个）

数据源	追踪内容	身份验证
FRED	22 个关键指标：收益率曲线、CPI、VIX、联邦基金利率、M2	免费密钥
美国财政部	国家债务、收益率、财政数据	无
BLS	CPI、失业率、非农就业人数、PPI	无
EIA	WTI/Brent 原油、天然气、库存	免费密钥
GSCPI	纽约联储全球供应链压力指数	无
USAspending	联邦支出和国防合同	无
UN Comtrade	主要大国之间的战略商品贸易流动	无

第三层级：天气、环境、科技、社交、信号情报（7个）

来源	追踪内容	认证方式
NOAA/NWS	美国实时天气预警	无
EPA RadNet	美国政府辐射监测	无
USPTO专利	7个战略科技领域的专利申请	无
Bluesky	地缘政治/市场话题的社交情绪	无
Reddit	关键子版块的社交情绪	OAuth
Telegram	17个精选的开源情报/冲突/金融频道（网页抓取，可通过配置扩展）	无
KiwiSDR	全球短波无线电接收网络（约600台接收器）	无

第四层级：太空与卫星（1个）

来源	追踪内容	认证方式
CelesTrak	卫星发射、国际空间站跟踪、军事星座、Starlink/OneWeb数量	无

第五层级：实时市场数据（1个）

来源	追踪内容	认证方式
Yahoo Finance	实时行情：SPY、QQQ、BTC、黄金、WTI、VIX等9种	无

---

npm脚本

脚本	命令	描述
npm run dev	node --trace-warnings server.mjs	启动带自动刷新的仪表盘
npm run sweep	node apis/briefing.mjs	执行一次数据采集，将JSON输出到标准输出
npm run inject	node dashboard/inject.mjs	将最新数据注入静态HTML
npm run brief:save	node apis/save-briefing.mjs	执行数据采集并保存带时间戳的JSON文件
npm run diag	node diag.mjs	运行诊断程序（Node版本、模块导入、端口检查）

---

配置

所有设置均在.env文件中，默认值合理：

变量	默认值	描述
PORT	3117	仪表盘服务器端口
REFRESH_INTERVAL_MINUTES	15	自动刷新间隔
LLM_PROVIDER	已禁用	支持anthropic、openai、gemini、codex、openrouter、minimax、mistral或grok
LLM_API_KEY	—	API密钥（codex无需）
LLM_MODEL	各提供商默认	覆盖模型选择
TELEGRAM_BOT_TOKEN	已禁用	用于Telegram提醒及机器人命令
TELEGRAM_CHAT_ID	—	您的Telegram聊天ID
TELEGRAM_CHANNELS	—	需要监控的额外频道ID（逗号分隔）
TELEGRAM_POLL_INTERVAL	5000	机器人命令轮询间隔（毫秒）
DISCORD_BOT_TOKEN	已禁用	用于Discord提醒及slash命令
DISCORD_CHANNEL_ID	—	用于发送提醒的Discord频道
DISCORD_GUILD_ID	—	服务器ID（可即时注册slash命令）
DISCORD_WEBHOOK_URL	—	Webhook URL（仅用于提醒，无需机器人）

Delta引擎的阈值（系统对两次采集间变化的敏感度）可在crucix.config.mjs文件的delta.thresholds部分自定义。默认设置旨在过滤噪声，同时捕捉有意义的变化。

---

API端点

运行npm run dev时：

端点	描述
GET /	Jarvis HUD仪表盘
GET /api/data	当前合成的情报数据（JSON）
GET /api/health	服务器状态、运行时间、数据源数量、LLM状态
GET /events	SSE流，用于实时推送更新

---

故障排除

npm run dev静默退出（无输出，无错误）

这是已知问题，npm的脚本运行器可能会吞掉错误，尤其是在Windows PowerShell上。请按以下顺序尝试：

1. 直接运行Node（绕过npm）：

node --trace-warnings server.mjs

这与npm run dev功能相同，但会显示完整的错误信息。

2. 运行诊断脚本：

node diag.mjs

该脚本会逐一测试每个模块的导入情况，检查Node.js版本，并验证3117端口是否可用。它会明确指出具体失败原因。

3. 检查3117端口是否已被占用：

可能是之前的Crucix实例仍在后台运行。

# Windows PowerShell
netstat -ano | findstr 3117
taskkill /F /PID <上述PID>

# 或者直接终止所有Node进程
taskkill /F /IM node.exe

# macOS / Linux
lsof -ti:3117 | xargs kill

然后再次尝试启动。您也可以通过在.env文件中设置PORT=3118来更改端口。

4. 检查Node.js版本：

node --version

Crucix需要Node.js 22或更高版本。如果您的版本较旧，请从https://nodejs.org下载最新的LTS版本。

仪表盘首次启动后显示为空白面板

这是正常现象——首次采集需要30–60秒来查询所有27个数据源。一旦采集完成，仪表盘会自动填充。请查看终端中的采集进度日志。

部分数据源显示错误

这是预期行为。需要API密钥的数据源若未设置密钥，会返回结构化错误。其余数据源的采集仍会正常进行。请查看仪表盘中的“数据源完整性”部分（或服务器日志），以了解哪些数据源失败及其原因。最值得添加的三个免费密钥是FRED_API_KEY、FIRMS_MAP_KEY和EIA_API_KEY。

OpenSky在公共热点被过度查询时也可能返回HTTP 429错误。Crucix不会试图规避这一限制，而是会在数据源健康状况中显示限流/错误信息，并保留来自runs/目录的最近一次非空航空交通快照，以防止仪表盘飞行图层在被限流的采集中突然变为空白。

Telegram机器人不响应命令

请确保.env文件中已设置TELEGRAM_BOT_TOKEN和TELEGRAM_CHAT_ID。机器人仅响应来自配置聊天ID的消息（安全措施）。启动时，您应在服务器日志中看到[Crucix] Telegram提醒已启用和[Crucix] 机器人命令轮询已开始。如果没有，请使用curl https://api.telegram.org/bot<YOUR_TOKEN>/getMe再次确认您的令牌。

Discord机器人不响应slash命令

请按以下步骤检查：

1. 确保.env文件中已设置DISCORD_BOT_TOKEN和DISCORD_CHANNEL_ID。
2. 验证discord.js是否已安装：npm ls discord.js。若缺失，运行npm install discord.js。
3. 如果slash命令未出现，请设置DISCORD_GUILD_ID——没有它，全局命令可能需要长达1小时才能生效。而针对特定服务器的命令则会立即生效。
4. 确认机器人是以包含bot和applications.commands权限范围受邀加入，并且在目标频道中拥有发送消息和嵌入链接权限。
5. 查看服务器日志，确认启动时是否有[Discord] 机器人已登录为...。若出现[Discord] discord.js未安装，请安装后重启。
6. 仅使用Webhook作为备用方案： 如果您只希望接收提醒而不需要slash命令，可以设置DISCORD_WEBHOOK_URL，而非机器人令牌。这样就不需要discord.js了。

---

截图

docs/ 文件夹包含本 README 引用的仪表板截图：

文件	描述
https://oss.gittoolsai.com/images/calesthio_Crucix_readme_fa9cc960c245.png	完整仪表板 — 位于本 README 顶部的英雄图片
https://oss.gittoolsai.com/images/calesthio_Crucix_readme_57f7da3f506b.png	影视级启动动画
https://oss.gittoolsai.com/images/calesthio_Crucix_readme_ff600ea15d7b.png	带有标记类型和飞行弧线的 D3 世界地图
https://oss.gittoolsai.com/images/calesthio_Crucix_readme_acd305d6ff32.png	带有大气辉光和标记的 3D WebGL 地球仪视图

要更新这些截图：运行仪表板，等待一次扫描完成，然后使用浏览器的开发者工具（F12 → Ctrl+Shift+P → “捕获全尺寸截图”）或像 LICEcap 这样的工具来生成 GIF 动画。

---

贡献

发现 bug？想添加第 28 个数据源？欢迎提交 PR。每个数据源都是 apis/sources/ 中的一个独立模块——只需导出一个返回结构化数据的 briefing() 函数，并将其添加到 apis/briefing.mjs 中的编排器即可。

如果你觉得这个项目有用，请给它点个赞，这样其他人也能更容易找到它。

有关贡献指南、评审期望以及添加数据源的规则，请参阅 CONTRIBUTING.md。如需报告安全问题，请参阅 SECURITY.md。

联系方式

如需洽谈合作、集成或其他非问题相关的咨询，可通过 celesthioailabs@gmail.com 联系我。

对于 bug 和功能请求，请使用 GitHub Issues，以便讨论内容保持可见且可操作。

---

星标历史

---

许可证

AGPL-3.0

Crucix 快速上手指南

Crucix 是一个本地化的开源情报（OSINT）终端，能够聚合 27 个数据源（包括卫星火灾检测、航班追踪、辐射监测、经济指标、冲突数据等），并在一个自包含的 Jarvis 风格仪表盘中实时展示。它无需云端服务，完全在本地运行。

环境准备

系统要求

• Node.js: 版本 22+（必须，利用原生 fetch、顶层 await 和 ESM 特性）
• 操作系统: Windows, macOS, 或 Linux
• 网络: 需要能够访问全球公开数据源（部分数据源可能需要代理）

前置依赖

• Git
• npm (随 Node.js 安装)
• (可选) Docker 及 Docker Compose

安装步骤

方法一：直接使用 Node.js 运行（推荐）

1. 克隆仓库

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

2. 安装依赖

   npm install
   

   国内加速提示: 如果下载缓慢，可配置淘宝镜像源：

   npm config set registry https://registry.npmmirror.com
   npm install
   

3. 配置环境变量 复制示例配置文件并填入必要的 API 密钥（详见下文“关键配置”）：

   cp .env.example .env
   

   编辑 .env 文件，至少填入以下免费密钥以获得最佳效果：

   • FRED_API_KEY (美联储经济数据)
   • FIRMS_MAP_KEY (NASA 卫星火灾数据)
   • EIA_API_KEY (美国能源信息署)

4. 启动服务

   npm run dev
   

   注意: 如果命令执行后无输出直接退出（特别是在 Windows PowerShell 中），请改用以下命令直接运行以查看错误详情：

   node --trace-warnings server.mjs
   

方法二：使用 Docker 运行

git clone https://github.com/calesthio/Crucix.git
cd Crucix
cp .env.example .env    # 编辑此文件添加 API 密钥
docker compose up -d

基本使用

1. 访问仪表盘 启动成功后，在浏览器打开：

   http://localhost:3117
   

2. 初始数据加载

   • 页面加载后会自动开始第一次全量情报扫描（Sweep）。
   • 首次扫描并行查询所有 27 个数据源，通常耗时 30-60 秒。
   • 在此期间仪表盘可能显示为空，请耐心等待扫描完成并推送第一批数据。

3. 核心功能体验

   • 实时监控: 查看 3D 地球上的火灾、航班、辐射点及冲突事件标记。
   • 自动刷新: 系统每 15 分钟自动执行一次扫描并通过 SSE 推送更新，无需手动刷新页面。
   • 性能模式: 点击顶部 VISUALS LITE 按钮可关闭特效以提升低配设备或移动端的流畅度。
   • 消息通知: 若配置了 Telegram 或 Discord，系统将自动推送分级警报（FLASH/PRIORITY/ROUTINE）。

4. 交互式命令 (需配置 Bot) 如果在 .env 中配置了 TELEGRAM_BOT_TOKEN 或 Discord 相关密钥，您可以在聊天窗口中使用以下命令：

   • /brief: 获取最新情报摘要
   • /sweep: 手动触发一次扫描
   • /status: 查看系统健康状态

安全警告: Crucix 官方未发行任何代币、NFT 或进行空投。切勿相信任何借用 Crucix 名义进行的加密货币推广或钱包连接请求。