PolyWeather/extension/README.md

# PolyWeather Side Panel

`PolyWeather Side Panel` 是一个面向天气交易市场的 Chrome / Edge 浏览器侧边栏工具。

## 功能

1. 自动识别当前 Polymarket 页面中的城市，也支持手动切换。
2. 展示城市档案：结算站点、站点距离、观测更新时间、周边站点数量。
3. 展示今日日内走势（简版）：`DEB` 走势与机场/官方观测对照，可悬停查看时间与温度。
4. 展示多日最高温预报（简版），当前以 `DEB` 优先。
5. 支持一键刷新，强制拉取最新温度数据。
6. 支持本地缓存，提升打开速度；插件版本更新时会刷新城市列表缓存。
7. 支持一键跳转到完整网站分析页面。

## 数据说明

- 香港使用 `HKO`（香港天文台）结算源。
- 其他城市按配置使用 `METAR / NOAA / AMOS / JMA / MGM / FMI / KNMI` 等官方数据源。
- 城市展示名以主站返回值为准，例如 `aurora` 市场在插件中会显示为 `Denver`。
- 首尔/釜山/东京/安卡拉/伊斯坦布尔/赫尔辛基/阿姆斯特丹已接入高频机场实时数据（1-10 分钟级）。

## 权限说明

- `tabs`：用于识别当前活动标签页 URL 并自动匹配城市。
- `storage`：用于保存插件配置与本地缓存，仅存储在本地浏览器。
- `sidePanel`：用于在浏览器侧边栏展示界面。

## 隐私说明

本扩展不要求用户登录，不收集个人身份信息，不上传浏览历史，仅在必要时请求天气接口数据以完成展示功能。

## 本地安装（开发者模式）

1. 打开 Chrome/Edge 扩展页面：
   - Chrome：`chrome://extensions`
   - Edge：`edge://extensions`
2. 打开"开发者模式"。
3. 选择"加载已解压的扩展程序"。
4. 选择目录：`extension/`。
5. 点击扩展图标，侧边栏会打开。

## 设置

首次建议打开扩展"选项页"并确认：

- `网站基础地址`：你的前端域名（例如 `https://polyweather.top`）
- `API 基础地址`：你的后端 API 域名（若同域也可填前端域名）
- `Bearer Token`：后端开启鉴权时填写

## 说明

- 当前版本仍是轻量产品，重点是"监控 + 基础判断 + 导流回站"，未接入支付链路。
- 若你的 API 做了严格鉴权，请先在设置页填写 token 再使用。
- 插件城市列表来自主站 `/api/cities`，非内置静态列表；安装更新后自动刷新最新城市。
- 机场市场统一显示机场 `METAR` / 官方观测点位，部分城市已覆盖 1 分钟级实时数据。
- 点击"打开网站查看更多"会回到主站继续查看完整分析。
- 插件不会承载完整分析；完整结构判断、历史对账和更多信号仍以主站为准。