AtomicGlance/straitsignal
GitHub: AtomicGlance/straitsignal
StraitSignal 通过整合油轮动向、能源价格、选举民调、预测市场和冲突信号等多源 OSINT 数据，为原油期货研究提供可解释、可审计的预测分析平台。
Stars: 0 | Forks: 0
# StraitSignal
[](https://github.com/AtomicGlance/straitsignal/actions/workflows/ci.yml)
**通过油轮动向、美国燃料价格、选举民调和预测市场，提供可解释的原油期货情报。**
StraitSignal 是一个 OSINT 和数据科学系统，旨在研究物理原油流动、消费者价格传导、政治风险情景以及市场隐含概率如何为可审计的 WTI 预测做出贡献。它是一个研究系统，而不是交易机器人。
**实时仪表板：** https://straitsignal.amiralimoradnia07.workers.dev
**托管镜像：** https://straitsignal-osint.negar-chem.chatgpt.site
## 当前验证证据
2026-07-26 从公开部署中捕获的源健康快照报告称**处于混合模式，5 个 adapter 中有 1 个响应**。Fintraffic 区域 AIS 数据源处于活跃状态，包含 134 个船舶位置，且网关快照延迟不到两分钟。能源、民调、预测市场和冲突输入不可用、已降级或处于演示状态。因此，显示的 WTI 路径仍被明确标记为 `demo`，并非经过验证的市场预测。
| 模块 | 观察到的状态 |
|---|---|
| 区域 AIS 数据源 | 实时；覆盖芬兰/波罗的海 |
| 油轮分析 | 演示 |
| 能源序列 | 演示回退 |
| 民调 | 演示快照 |
| 预测市场 | 已降级；演示先验 |
| 冲突强度 | 演示情景 |
| 预测观察类型 | 演示 |
请参阅[验证结果](docs/VALIDATION_RESULTS.md)和[机器可读的源健康快照](docs/source_health_snapshot.json)。
## 与众不同之处
- 真正的 MapLibre/OpenStreetMap 世界地图绘制提供商提供的油轮坐标，并公开上游位置时间戳；过时的公开数据绝不会被标记为实时。
- 油轮流动层将咽喉要道吞吐量、拥堵情况、AIS 信号盲区、港口挂靠和估计的满载状态视为物理市场特征。
- 能源层拉取当前基于 EIA 的 WTI 和五个地区的汽油观测数据，然后使用 8 周的 ridge 分布式滞后泵价预测和区域分散带扩展 32 周的历史数据。
- 可选的 Nasdaq Data Link adapter 使用精确的前月结算价；否则 UI 会明确说明使用的是 WTI 现货代理。
- 政治层结合了经过时间戳验证的民调 adapter、两个公开的预测市场场所，以及针对 2026 年美国中期选举明确区分的石油/冲突压力预测。
- GDELT 提供近期冲突媒体强度信号，其方法明确指出这并不是对事件的统计。
- 预测实验室比较了正则化回归、梯度提升、贝叶斯回归、VAR/领先-滞后诊断、共形区间和蒙特卡洛情景。
- UI 公开源健康状况、演示/实时状态、特征贡献、模型分歧和不确定性，而不是将它们隐藏在单个数字背后。
## 系统映射
```
flowchart LR
EIA["EIA API v2 / FRED
WTI + gasoline"] --> G["Normalized gateway"] AIS["Tanker / AIS provider
positions + port events"] --> G POLL["Polling feed
2026 midterms"] --> G PM["Polymarket + Kalshi
public read APIs"] --> G CONFLICT["GDELT DOC 2.0
media intensity"] --> G G --> V["Validation
schema + freshness + provenance"] V --> F["Feature store
lags + flows + regimes + priors"] F --> M["Walk-forward ensemble
ElasticNet + GBT + Bayesian"] M --> C["Conformal calibration
scenario simulation"] C --> UI["OSINT workbench
forecast + evidence + API health"] ``` ## 快速开始 需要 Node.js 22+ 和 pnpm。 ``` pnpm install copy .env.example .env.local pnpm dev ``` 打开 `http://localhost:3000`。在未提供任何密钥的情况下，网关将检索当前的公开能源序列、公开的预测市场数据、冲突媒体信号以及最新可用的公开油轮坐标。经过授权的民调、精确的期货结算价和提供商分析在配置完成之前，将保持明确标记为演示或不可用状态。 ``` pnpm run lint pnpm run build node --test tests/rendered-html.test.mjs ``` ## API 配置 复制 `.env.example` 并仅配置您拥有的提供商： ``` EIA_API_KEY= NASDAQ_DATA_LINK_API_KEY= TANKER_API_URL= TANKER_API_KEY= DATALASTIC_API_KEY= DATALASTIC_LOCATIONS_JSON= POLLING_API_URL= ``` 浏览器绝不会接收这些凭据。请参阅 [docs/API.md](docs/API.md) 了解规范化契约和提供商 adapter 指南，并参阅 [docs/FRESHNESS.md](docs/FRESHNESS.md) 了解防止将过时或合成数据呈现为实时数据的规则。 ## 可重现的分析 ``` python -m venv .venv python -m pip install -r requirements.txt python analysis/train.py python analysis/diagnostics.py ``` 默认运行使用确定性合成数据，以便 CI 可以执行完整的步进式 pipeline，而无需假装它是市场预测。提供规范化的 CSV 或 parquet 表格以使用授权数据进行训练。请参阅 [docs/METHODOLOGY.md](docs/METHODOLOGY.md)。 ## 数据来源与灵感 - 用于能源数据的 [U.S. EIA API v2](https://www.eia.gov/opendata/documentation.php) 和 [EIA 每周零售汽油方法论](https://www.eia.gov/petroleum/gasdiesel/gas_proc-methods.php)。 - 用于只读市场发现和定价的 [Polymarket 公共 API](https://docs.polymarket.com/api-reference/introduction) 和 [Kalshi 市场数据 API](https://docs.kalshi.com/getting_started/quick_start_market_data)。 - 用于 EIA 序列零密钥分发的 [FRED](https://fred.stlouisfed.org/)，以及用于可选前月结算 adapter 的 [Nasdaq Data Link](https://docs.data.nasdaq.com/docs/in-depth-usage)。 - 用于冲突媒体强度序列的 [GDELT DOC 2.0](https://blog.gdeltproject.org/gdelt-doc-2-0-api-debuts/)。 - 可配置的商业油轮/AIS adapter，对 [Datalastic Location Traffic](https://docs.datalastic.com/) 的显式署名选择加入，来自 [Fintraffic Digitraffic](https://www.digitraffic.fi/en/marine-traffic/) 的零密钥实时区域回退，以及更广泛最新可用的 [VesselTrack](https://www.vesseltrack.net/api-docs) 回退。 - [OpenFreeMap](https://openfreemap.org/) 和 [MapLibre GL JS](https://maplibre.org/maplibre-gl-js/docs/) 在无需暴露浏览器 token 的情况下提供了真实世界的地图。 - 提供的 32 周 WTI/PADD 参考分析为滚动汽油分散视图提供了参考。 - 民调被配置为可替换的数据流，因为发布条款和可用的 API 各不相同；包含的 2026 年 7 月的值被标记为说明性快照，而不是实时的民调平均值。 ## 分析注意事项 - AIS 静默可能是良性的；目的地和货物字段可能出错。 - 民调和预测市场充满噪声、具有相关性，且并非导致油价变化的因果变量。 - 选举压力预测是一个有界的敏感性模型，不能替代民调平均值，也不能作为关于选民行为的因果论断。 - WTI 现货数据不是经过展期调整的连续期货序列；除非精确结算 adapter 响应，否则仪表板会将其标记为代理。 - 步进式表现在新市场机制下可能会衰退。 - 校准区间并不能提供保证。 - 此处的任何内容均不构成财务建议或交易要约。 ## 仓库指南 | 路径 | 用途 | |---|---| | `app/page.tsx` | 交互式 OSINT 仪表板和情景工作台。 | | `app/api/intel/route.ts` | 密钥安全的提供商编排和标记的回退。 | | `lib/intel.ts` | 规范化的情报契约和确定性演示快照。 | | `analysis/` | 特征工程、步进式训练、共形校准和诊断。 | | `docs/API.md` | Adapter 契约和 API 管理指南。 | | `docs/METHODOLOGY.md` | 建模假设、评估和局限性。 | | `PRODUCT.md` / `DESIGN.md` | 持久的产品和视觉系统决策。 | ## 许可证 MIT。提供商数据仍受其自身的许可证和再分发条款约束。
WTI + gasoline"] --> G["Normalized gateway"] AIS["Tanker / AIS provider
positions + port events"] --> G POLL["Polling feed
2026 midterms"] --> G PM["Polymarket + Kalshi
public read APIs"] --> G CONFLICT["GDELT DOC 2.0
media intensity"] --> G G --> V["Validation
schema + freshness + provenance"] V --> F["Feature store
lags + flows + regimes + priors"] F --> M["Walk-forward ensemble
ElasticNet + GBT + Bayesian"] M --> C["Conformal calibration
scenario simulation"] C --> UI["OSINT workbench
forecast + evidence + API health"] ``` ## 快速开始 需要 Node.js 22+ 和 pnpm。 ``` pnpm install copy .env.example .env.local pnpm dev ``` 打开 `http://localhost:3000`。在未提供任何密钥的情况下，网关将检索当前的公开能源序列、公开的预测市场数据、冲突媒体信号以及最新可用的公开油轮坐标。经过授权的民调、精确的期货结算价和提供商分析在配置完成之前，将保持明确标记为演示或不可用状态。 ``` pnpm run lint pnpm run build node --test tests/rendered-html.test.mjs ``` ## API 配置 复制 `.env.example` 并仅配置您拥有的提供商： ``` EIA_API_KEY= NASDAQ_DATA_LINK_API_KEY= TANKER_API_URL= TANKER_API_KEY= DATALASTIC_API_KEY= DATALASTIC_LOCATIONS_JSON= POLLING_API_URL= ``` 浏览器绝不会接收这些凭据。请参阅 [docs/API.md](docs/API.md) 了解规范化契约和提供商 adapter 指南，并参阅 [docs/FRESHNESS.md](docs/FRESHNESS.md) 了解防止将过时或合成数据呈现为实时数据的规则。 ## 可重现的分析 ``` python -m venv .venv python -m pip install -r requirements.txt python analysis/train.py python analysis/diagnostics.py ``` 默认运行使用确定性合成数据，以便 CI 可以执行完整的步进式 pipeline，而无需假装它是市场预测。提供规范化的 CSV 或 parquet 表格以使用授权数据进行训练。请参阅 [docs/METHODOLOGY.md](docs/METHODOLOGY.md)。 ## 数据来源与灵感 - 用于能源数据的 [U.S. EIA API v2](https://www.eia.gov/opendata/documentation.php) 和 [EIA 每周零售汽油方法论](https://www.eia.gov/petroleum/gasdiesel/gas_proc-methods.php)。 - 用于只读市场发现和定价的 [Polymarket 公共 API](https://docs.polymarket.com/api-reference/introduction) 和 [Kalshi 市场数据 API](https://docs.kalshi.com/getting_started/quick_start_market_data)。 - 用于 EIA 序列零密钥分发的 [FRED](https://fred.stlouisfed.org/)，以及用于可选前月结算 adapter 的 [Nasdaq Data Link](https://docs.data.nasdaq.com/docs/in-depth-usage)。 - 用于冲突媒体强度序列的 [GDELT DOC 2.0](https://blog.gdeltproject.org/gdelt-doc-2-0-api-debuts/)。 - 可配置的商业油轮/AIS adapter，对 [Datalastic Location Traffic](https://docs.datalastic.com/) 的显式署名选择加入，来自 [Fintraffic Digitraffic](https://www.digitraffic.fi/en/marine-traffic/) 的零密钥实时区域回退，以及更广泛最新可用的 [VesselTrack](https://www.vesseltrack.net/api-docs) 回退。 - [OpenFreeMap](https://openfreemap.org/) 和 [MapLibre GL JS](https://maplibre.org/maplibre-gl-js/docs/) 在无需暴露浏览器 token 的情况下提供了真实世界的地图。 - 提供的 32 周 WTI/PADD 参考分析为滚动汽油分散视图提供了参考。 - 民调被配置为可替换的数据流，因为发布条款和可用的 API 各不相同；包含的 2026 年 7 月的值被标记为说明性快照，而不是实时的民调平均值。 ## 分析注意事项 - AIS 静默可能是良性的；目的地和货物字段可能出错。 - 民调和预测市场充满噪声、具有相关性，且并非导致油价变化的因果变量。 - 选举压力预测是一个有界的敏感性模型，不能替代民调平均值，也不能作为关于选民行为的因果论断。 - WTI 现货数据不是经过展期调整的连续期货序列；除非精确结算 adapter 响应，否则仪表板会将其标记为代理。 - 步进式表现在新市场机制下可能会衰退。 - 校准区间并不能提供保证。 - 此处的任何内容均不构成财务建议或交易要约。 ## 仓库指南 | 路径 | 用途 | |---|---| | `app/page.tsx` | 交互式 OSINT 仪表板和情景工作台。 | | `app/api/intel/route.ts` | 密钥安全的提供商编排和标记的回退。 | | `lib/intel.ts` | 规范化的情报契约和确定性演示快照。 | | `analysis/` | 特征工程、步进式训练、共形校准和诊断。 | | `docs/API.md` | Adapter 契约和 API 管理指南。 | | `docs/METHODOLOGY.md` | 建模假设、评估和局限性。 | | `PRODUCT.md` / `DESIGN.md` | 持久的产品和视觉系统决策。 | ## 许可证 MIT。提供商数据仍受其自身的许可证和再分发条款约束。
标签：ESC4, MITM代理, OSINT, 代码示例, 数据分析, 数据科学, 石油期货, 程序员工具, 自动化攻击, 资源验证, 逆向工具, 金融量化, 预测市场