## 安装前准备

本插件需要调用聚合数据的 API 服务，使用前请先获取 API Key。

### 1. 注册聚合数据账号

1. 访问 [聚合数据控制台](https://dashboard.juhe.cn/)
2. 点击"立即注册"按钮
3. 验证手机号完成注册
4. 登录账号

### 2. 申请 IP 地址查询 API

1. 登录后进入控制台首页
2. 点击左侧菜单"数据中心" → "我的API"
3. 点击"申请新接口"
4. 搜索"IP地址"，找到"IP地址查询"接口
5. 点击"立即申请"，选择"免费版"（每天 50 次）
6. 申请成功后，在"我的API"列表中找到该接口，复制 **AppKey**

### 3. 申请天气预报 API

1. 同样在"申请新接口"页面
2. 搜索"天气"，找到"天气预报"接口
3. 点击"立即申请"，选择"免费版"（每天 50 次）
4. 申请成功后，在"我的API"列表中找到该接口，复制 **AppKey**

### 4. 配置插件

1. 首次启动插件时，会弹出设置界面
2. 将刚才复制的两个 AppKey 分别填入：
- **IP 查询 Key**：用于自动定位当前城市
- **天气查询 Key**：用于获取天气数据
3. 点击"保存"即可开始使用

## 功能说明

### 自动定位

- 插件启动时会自动获取您的 IP 地址
- 根据 IP 自动查询所在城市天气
- 如果定位失败，可以手动搜索城市

### 手动搜索

- 在搜索框输入城市名称（如"北京"、"上海"）
- 点击搜索按钮或按回车键
- 搜索的城市会自动保存，下次启动优先显示

### 数据展示

- **当前天气**：实时温度、天气状况、湿度、风向风力
- **未来预报**：未来 7 天天气预报 + 气温趋势图
- **生活指数**：穿衣、洗车、运动等 10 项生活建议

## 注意事项

1. **免费版限制**：每个 API 每天 50 次调用，超出后当天无法使用
2. **Key 安全**：您的 API Key 仅保存在本地，不会上传到任何服务器
3. **网络要求**：需要联网才能获取天气数据

## 常见问题

**Q: 为什么定位失败？**
A: 可能是网络问题比如代理地区或 IP 查询次数已用完。可以手动搜索城市，插件会记住您的选择。

**Q: 天气数据多久更新一次？**
A: 每次打开插件都会获取最新数据。