LNG.cool

有关 LNG 贸易与市场的网站（VitePress）。

环境

• Node.js 18+
• npm

安装

npm install

本地开发

npm run docs:dev

更新数据

npm run update:data

按模块增量更新（更快）：

npm run update:data:market
npm run update:data:history
npm run update:data:news

也可以直接传参：

node scripts/update-datasources.js --only market,news
node scripts/update-datasources.js --only market --if-stale-minutes 60

构建

npm run docs:build（等价于 docs:build:full）会先执行数据更新，再执行 VitePress 构建。

npm run docs:build

快速构建（不更新数据）：

npm run docs:build:fast

预览

npm run docs:preview

GitHub Pages 部署说明（Traffic API）

如果 Actions 日志出现 GitHub traffic API failed: 403 Resource not accessible by integration，说明默认 GITHUB_TOKEN 无法访问 Traffic API。

请在仓库 Settings -> Secrets and variables -> Actions 新增 secret：

• GH_TRAFFIC_TOKEN：建议使用 PAT（classic token 需含 repo scope；public 仓库至少需具备对应仓库读取/统计权限）

工作流会优先使用 GH_TRAFFIC_TOKEN 拉取访问量；若缺失或失败，会自动写入 fallback 数据，不阻断 Pages 部署。

双语广告位策略

• 中文首页（/）: 使用 LocaleAdSlot 的中文模式，默认展示中国区广告位说明与占位提示，适合后续接入百度联盟/腾讯广告/行业赞助脚本。
• 英文首页（/en/）: 使用 LocaleAdSlot 的英文模式，默认预留 Google AdSense 位置。

英文广告位启用方式（构建环境变量）：

• VITE_ADSENSE_CLIENT（示例：ca-pub-xxxxxxxxxxxxxxxx）
• VITE_ADSENSE_SLOT_HOME_EN（示例：1234567890）

未设置变量时，英文首页只显示占位说明，不会加载广告请求。

内容生产流水线

统一模板入口（支持 essay 与 report）：

npm run content:new -- --type essay --slug ey260328 --title "示例标题"

常用可选参数：

• --author "作者名"
• --source "来源链接或来源说明"
• --desc "页面 description"
• --keywords "LNG,天然气,贸易"
• --lang zh|en
• --no-index（仅 essay 默认会自动追加到 essay/index.md）

生成结果：

• 新文稿包含统一字段：摘要、关键词、数据与图表、结论、英文同步状态（enSyncStatus）
• essay 类型默认自动更新索引

建议发布节奏

• 每日快讯：1 篇（200-400 字，关注价格、政策、船期、供应中断）
• 每周深度：1 篇（1200-2500 字，含图表、结论、英文同步计划）

执行建议：

1. 周一确定选题（快讯 5 个、深度 1 个）
2. 周三完成深度稿初稿与图表
3. 周五完成发布与英文同步状态更新

已采用数据源

向维护这些数据源的供应商表示感谢:

实时价格

• Brent：Barchart 公共页面抓取的 ICE Brent 活跃近月合约价格
• JKM：Barchart 公共页面抓取的 NYMEX JKM 近月活跃合约价格（基于 Platts JKM）
• TTF：Barchart 公共页面抓取的 ENDEX Dutch TTF Gas 活跃近月合约价格
• Henry Hub：Barchart 公共页面抓取的 NYMEX Henry Hub Gas 活跃近月合约价格

历史价格

• Brent：FRED DCOILBRENTEU 日频历史序列
• JKM：主源为 NASDAQ Data Link CHRIS/CME_JKM1 连续合约日频结算价
• JKM：当 NASDAQ Data Link 不可用时，自动回退到 Yahoo Finance JKM=F 连续合约日频收盘价
• JKM：仅在显式设置 JKM_HISTORY_ALLOW_PROXY=true 时，才允许进一步回退到 FRED PNGASJPUSDM 月频代理序列并展开为自然日
• TTF：主源为 Yahoo Finance TTF=F 连续合约日频收盘价
• TTF：当 Yahoo Finance 不可用时，尝试从 Barchart 历史页抓取日频合约数据并统一换算为 USD/MMBtu（保留 originvalue）
• TTF：当 Yahoo 与 Barchart 均不可用时，沿用最近一次历史缓存（不再回退到 FRED PNGASEUUSDM 月频代理序列）
• Henry Hub：FRED DHHNGSP 日频历史序列

运行说明

• 项目会自动加载根目录 .env
• 当前使用到的环境变量：NASDAQ_DATA_LINK_API_KEY、FRED_API_KEY
• NASDAQ_DATA_LINK_API_KEY 用于 JKM 官方连续合约历史源
• 若希望 JKM 在官方源与 Yahoo 源都失败时继续使用月频代理兜底，可设置 JKM_HISTORY_ALLOW_PROXY=true

新闻源

• https://www.giignl.org/