🌲软件介绍

开箱即用的软件（仅windows）
web操作界面（跨平台）
登陆京东商城（www.jd.com）
- 手机扫码登录
- 保存/加载登录cookies (可验证cookies是否过期)
商品查询操作
- 提供完整的地址⇔ID对应关系
- 根据商品ID和地址ID查询库存
- 根据商品ID查询价格
购物车操作
- 清空/添加购物车 (无货商品也可以加入购物车，预约商品无法加入)
- 获取购物车商品详情
订单操作
- 获取订单结算页面信息 (商品详情, 应付总额, 收货地址, 收货人等)
- 提交订单（使用默认地址）
其他
- 商品预约
- 用户信息查询

📌使用教程

小白推荐 🖥通过 windows程序运行
（以下是四种使用方式，看一种就可以了。）

🖥通过 windows程序运行

点击通过Gitee下载压缩包(推荐)

点击通过GitHub下载压缩包

到release界面下载jd-shopper.zip包
解压后在jd-shopper目录找到jd-shopper.exe文件
点击运行，或者右键生成快捷方式后运行
到 /TEST/area_id/ 目录下查询你所在地的地区标识ID

注意：安装路径中不能有中文字符🚫

比如 C:/Users/someone/test/jd-shopper/ 目录可以运行

但是 C:/Users/某人/测试/jd-shopper/ 运行会报错

目前的v1.2.1只支持win11版本，如果win10运行可能会有无法预知的错误

🛠通过源代码运行

⛓运行环境

Python 3

🔌第三方库

V1.2.1以上版本可以自动检查并安装依赖

如果自动安装依赖出错，请挑选以下命令手动安装依赖：

pip install -r requirements.txt
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
python3 -m pip install -r requirements.txt
pip install lxml pyyaml bs4 requests stora

🕸web界面 - 使用教程

推荐 Chrome 浏览器
到 /TEST/area_id/ 目录下查询你所在地的地区标识ID
如果你的账户有京豆京券余额，请到 /Config/config.yaml 设置密码，或者换个账号运行
命令行运行服务

python3 runserver.py

注意：Windows环境下没有反应的话可以尝试

python runserver.py    # Python环境问题所致
py runserver.py    # Python环境问题所致

浏览器打开 http://localhost:12021/

⌨命令行 - 使用教程

1. 命令行可自定义各种功能，也许命令行更适合你

2. 网页扫码登录，或者账号密码登录

3. 填写config.yaml配置信息

(1)eid和fp找个普通商品随便下单,然后抓包就能看到,这两个值可以填固定的

随便找一个商品下单，然后进入结算页面，打开浏览器的调试窗口，切换到控制台Tab页，在控制台中输入变量_JdTdudfp，即可从输出的Json中获取eid和fp。
不会的话参考作者3的👉 使用教程请参看Wiki

不会的同学也可以打开TEST目录下的get_eid_fp.html文件，不过有概率失败

(2)到 /TEST/area_id/ 目录下查询你所在地的地区标识ID

(3)sku_id,DEFAULT_USER_AGENT

sku_id已经按照Xbox Series S的填好。
cookies_string 现在已经不需要填写了
DEFAULT_USER_AGENT 可以用默认的。谷歌浏览器也可以浏览器地址栏中输入about:version 查看USER_AGENT替换

(4)配置一下时间

现在不强制要求同步最新时间了，程序会自动同步京东时间

但要是电脑时间快慢了好几个小时，最好还是同步一下吧

以上都是必须的.

tips：
在程序开始运行后，会检测本地时间与京东服务器时间，输出的差值为本地时间-京东服务器时间，即-50为本地时间比京东服务器时间慢50ms。
本代码的执行的抢购时间以本地电脑/服务器时间为准

(5)修改抢购件数

代码中默认抢购件数为2
具体修改为：在config.yaml文件

(6) 特别提示！ 不止一个人卡在这个问题，如果不注意至少花两个小时调试debug

如果你的账户中有可用的京券（注意不是东券）或在上次购买订单中使用了京豆，
那么京东可能会在下单时自动选择京券支付或自动勾选京豆支付。
此时下单会要求输入六位数字的支付密码。请在config.yaml配置你的支付密码，如 123456 。

显著特点是添加购物车能成功，但一到订单结算页面就报错，基本就是这个原因！

4.运行main.py

python3 main.py

注意：Windows环境下没有反应可以尝试

python main.py    # Python环境问题所致
py main.py    # Python环境问题所致

根据提示选择相应功能即可

5.抢购结果确认

抢购是否成功通常在程序开始的一分钟内可见分晓！
搜索日志，出现“抢购成功，订单号xxxxx"，代表成功抢到了，务必半小时内支付订单！程序暂时不支持自动停止，需要手动STOP！
若两分钟还未抢购成功，基本上就是没抢到！程序暂时不支持自动停止，需要手动STOP！