这个项目能做什么

Gold Ticker Live 是一个双语(英语和阿拉伯语,支持 RTL 布局)的静态多页网站,为阿联酋、GCC、更广泛的阿拉伯世界以及少数全球参考市场提供黄金定价及相关工具。 公共站点采用原生 ES 模块编写,配合手写 CSS,并使用 Vite 进行生产环境打包。可选的 Node/Express 部分(server.js 及 server 目录)支持管理区域——包括身份验证、商店/订单/内容管理和速率限制的 API 代理——但公共页面被描述为完全静态,不依赖于此部分。 定价与数据层 该平台提供每 90 秒刷新一次的 XAU/USD 现货联动价格,将其转换为支持市场的本地货币,并应用克拉纯度,以生成 24K、22K、21K、20K、18K、16K 和 14K 的视图。记录的数据源包括用于实时现货层的 Gold-API.com、用于货币转换的 ExchangeRate-API、用于阿联酋定价的硬编码 3.6725 AED/USD 挂钩汇率、用于历史基准的 DataHub 以及用于新闻标题的 GDELT DOC API。README 还记录了转换常数(1 金衡盎司 = 31.1034768 克)、每克和每盎司克拉价格的计算公式,并注明舍入仅在显示边界发生。文中明确指出,由于不包括工费、经销商溢价、增值税(VAT)和店铺加价,相关数字是现货联动的金锭等值估算值,而非最终零售价。数据通过用于获取、双层 localStorage 缓存、价格计算和格式化的共享库模块进行流动。 工作区与工具 Tracker 是一个多模式工作区,涵盖 Live、Compare、Archive、Alerts、Planner、Exports 和 Method 视图。计算器套件包括黄金价值、废金、 zakat(天课)、购买力以及重量单位转换(克、金衡盎司、tola、baht、mithqal)。其他页面包括可按国家、城市和市场浏览的商店目录;支持 1g-100g 各纯度金条的下单流程(含实时定价和阿联酋 VAT);价格历史和日期查询;双语搜索;投资回报和 zakat 计算器;可嵌入的 Ticker 小部件;指南;以及覆盖约 15 个国家和 45 个以上城市的国家页面。 输出与自动化 提供 CSV 和 JSON 导出、可分享的 URL 状态、基于浏览器的警报和保存的预设。该站点被描述为支持 PWA 且对离线友好,使用了 service worker 和本地优先存储。README 列出了 8 个用于社交发布及相关任务的自动化工作流,包括发布到 X/Twitter、Telegram 和 Discord、价格激增警报和运行时间监控,以及一个自动生成的用于价格更新的 RSS 馈送。 开发与质量 项目记录了通过静态文件服务器在无需构建的情况下运行站点,或使用 Vite 实现 HMR(热模块替换),以及 build、preview 和 lint/validate/quality/preflight 脚本目标、每页调试模式、为管理后端记录的环境变量矩阵,以及基于 GitHub 的工作流设置。该项目采用 Apache-2.0 许可证。