# JDRouterPush

**Repository Path**: jan9392/JDRouterPush

## Basic Information

- **Project Name**: JDRouterPush
- **Description**: 京东云无线宝积分推送，支持多设备查看积分使用情况
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 6
- **Created**: 2021-09-17
- **Last Updated**: 2022-12-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">
<h1 align="center">
JDRouterPush
</h1>
</div>

## 项目简介

本项目调用京东云无线宝API,可每天定时推送积分收益情况,帮助你更好的观察主要信息,不收集用户任何信息.

## 项目功能

***当前版本:  20210810***

1. 查询今日总收益，设备总收益
2. 查询绑定账户
3. 单个设备积分收益情况，积分到期提醒，积分操作记录
4. 支持多设备查询
5. 多设备自定义IP段
6. 支持自定义设置设备名，自动获取设备名，操作记录条数
7. 支持查看当前网速,ip，路由模式,固件版本,插件状态,插件版本,缓存大小
8. 支持查看设备开机时间与PCDN
9. 推送支持servier酱,Telegram,Bark,pushplus,企业微信(支持文本推送/图文推送两种方式)

## 更新日志

### 2021-07-11:
1. 自定义IP段（只在6点前执行,需要更改每日定时,6点前执行一次，建议2-5点内）

### 2021-04-23:
1. 企业微信添加图文推送方式

### 2021-04-13:
1. 自动获取设备名称,优先自定义
2. 添加企业微信通知
3. 添加当前网速,当前ip，路由模式,固件版本,插件状态,插件版本,缓存大小等

### 2021-03-04: 
1. 支持自定义设置设备名称
2. 支持自定义设置记录条数

### 2021-03-02: 
1. 查询绑定的京东账户
2. 通知排版优化
3. 脚本检测更新
4. 支持Server酱Turbo版

### 2021-02-25: 
1. 实现多设备查询
2. 查询今日收益,总收益,可用收益
3. 设备在线天数
4. 可查看最近七条积分动态

## 使用说明

### Actions 方式

1. **Fork 本项目**
2. **获取京东云无线宝wskey**
- 目前只用Android抓包演示（抓包工具有很多，这里使用HttpCanary作为演示）

- 打开HttpCanary点击右下角按钮开始抓包

  <img src="docs/IMG/httpcanary1.jpg" style="zoom: 33%;" />

- 然后再打开京东云无线宝,点击积分管理

  <img src="docs/IMG/httpcanary2.jpg" style="zoom: 33%;" /><img src="docs/IMG/httpcanary3.jpg" style="zoom: 33%;" />

- 回到HttpCanary，右上角找到搜索，搜索`wskey` 

  <img src="docs/IMG/httpcanary4.jpg" style="zoom:33%;" />

- 然后随便点击一条进去，找到请求里面的`wskey` ，复制值

  <img src="docs/IMG/httpcanary5.jpg" style="zoom:33%;" />

3. **点击项目 Settings -> Secrets -> New Secrets 添加以下 2 个 Secrets，其中server酱微信推送的sckey可参阅[微信订阅通知](#微信订阅通知)**

| Name          | Value                                    | 是否必填 |
| ------------- | ---------------------------------------- | -------- |
| WSKEY         | 从京东云无线宝中获取                    | 必填     |
| SERVERPUSHKEY | server酱推送的sckey                    | 非必填   |
| DEVICENAME    | 格式：mac后6位:设置的名称，多个使用&连接 | 非必填   |
| RECORDSNUM    | 需要设置的获取记录条数   不填默认7条     | 非必填   |
| TG_BOT_TOKEN  | Telegram推送服务Token     | 非必填   |
| TG_USER_ID    | Telegram推送服务UserId     | 非必填   |
| BARK          | bark消息推送服务,secrets可填;形如jfjqxDx3xxxxxxxxSaK的字符串   | 非必填   |
| PUSHPLUS          | pushplus推送服务Token   | 非必填   |
| ACCESSTOKEN          | 企业微信access_token   | 非必填   |
| CORPID          | 企业ID（如果已经填写ACCESSTOKEN  则无需填写这个）| 非必填   |
| CORPSECRET          | 应用的凭证密钥secret（如果已经填写ACCESSTOKEN  则无需填写这个）| 非必填   |
| TOUSER          | touser指定接收消息的成员  默认为“@all”   | 非必填   |
| AGENTID          | agentid企业应用的id   | 非必填   |
| THUMB_MEDIA_ID          | 企业微信素材库图片id   | 非必填   |
| AUTHOR          | 企业微信文章作者名字   | 非必填   |
| NETWORK_SEGMENT          | 设置IP网段   | 非必填   |

***DEVICENAME***变量填写例子：

例如：完整mac为：ABC12D456EF7(取后6位)    想设置为韭菜1号

单个设备：456EF7:韭菜1号

多个设备：456EF7:韭菜1号&789FE1:韭菜2号&123FR2:韭菜3号             （中间使用&连接即可）

***THUMB_MEDIA_ID***变量填写说明:

不填写此变量直接推送text文本格式（由于text/card等推送方式存在字数限制，所以大于3台设备的同学尽量使用图文推送）

填写此变量直接推送图文格式文章，类似于公众号文章。图片id请登入网页版进入素材库上传一张图片之后点击下载链接，在下载链接内有media_id=xxx（&结尾）

***AUTHOR***变量填写说明:

图文文章作者名字，设置了THUMB_MEDIA_ID就必须填写。

***NETWORK_SEGMENT***变量填写说明:

设置IP网段,例如当前IP为100.84.102.15,你的100.107开头的网段上传速度较快,就可以将NETWORK_SEGMENT变量参数设置为    456EF7:100.107.星号.星号     (将星号两个中文字符换成一个字符星号（*）)
(456EF7表示mac后6位，参考DEVICENAME变量,星号代表1-225内所有数字，可以设置大于或者小于,例如你想将IP段设置为100.107.大于100.小于80===>100.107.星号>100.星号<80，格式星号+大于或小于+数字（1-255）)
注意：不要将IP设置为不可获取到的数值，否则设备一直重启,此变量需为4段已.(点)分割

​	<img src="docs/IMG/settings.jpg" style="zoom: 50%;" />

1. **开启 Actions 并触发每日自动执行**

**Github Actions 默认处于关闭状态，需要手动开启 Actions ，执行一次工作流，验证是否可以正常工作。**

![图示](docs/IMG/actions.jpg)

如果需要修改每日任务执行的时间，请修改 `.github/workflows/JDPush.yml`，在第 7行左右位置找到下如下配置。

```yml
  schedule:
    - cron: '30 22 * * *'
    # cron表达式，Actions时区是UTC时间，需要往前推8个小时  此时为6点30推送
    # 示例： 每天晚上22点30执行 '30 14 * * *'
```

*如果收到了 GitHub Action 的错误邮件，请检查 WSKEY是不是失效了，如果退出或重登都会导致京东云无线宝 `WSKEY` 失效*


## 订阅通知

### 订阅执行结果

目前Turbo版本的消息通道支持以下渠道

- 企业微信应用消息
- Android
- Bark iOS
- 企业微信群机器人
- 钉钉群机器人
- 飞书群机器人
- 自定义微信测试号
- 方糖服务号

1. 前往 [sct.ftqq.com](https://sct.ftqq.com/sendkey)点击登入，创建账号。
2. 点击点[SendKey](https://sct.ftqq.com/sendkey) ，生成一个 Key。将其增加到 Github Secrets 中，变量名为 `SERVERPUSHKEY`
3. [配置消息通道](https://sct.ftqq.com/forward) ，选择方糖服务号，保存即可。
4. 推送效果展示
   <img src="docs/IMG/ysxg1.jpg" style="zoom:33%;" /> <img src="docs/IMG/ysxg2.jpg" style="zoom:33%;" /> <img src="docs/IMG/ysxg3.jpg" style="zoom:33%;" />