京东抢购助手 使用教程

一. 写在前面

1.1 关于京东抢购助手

京东抢购助手：包含登录，查询商品库存 / 价格，添加 / 清空购物车，抢购商品 (下单)，查询订单等功能。
最近特殊情况，很多人用来抢口罩。也是我接触这个项目的原因，接下来的配置也是围绕它展开的。

1.2 我可以使用吗？

1. 有编程基础的
   直接前往项目地址，下载后按照 wiki 配置运行即可。
2. 没有编程基础的
   一台电脑和足够的耐心，边看下面的教程边操作。

---

二. 京东抢购助手的安装

2.1 下载地址（二选一）

1. 点击这里下载
2. 从项目地址这里下载

2.2 文件解压

将下载的 zip 压缩包解压到任意非系统盘 (C:) 位置。
进入解压目录准备进行配置。

2.3 参数配置

2.3.1 config.ini（用户数据）

-> 官方教程

2.3.2 main.py（抢购函数）

-> 官方教程

这个 Main 文件，是整个程序的入口，到时候也是从这里开始运行的。
默认的代码里面，执行的是 JD 预约抢购的代码，而我需要的是有货就下单，于是到官方教程复制相关代码并进行替换。

1. main.py（抢购数据）
2. sku_ids：将需要抢购的商品 id 放到这里，参考教程点这里
3. area：检查是否有库存的地区，获取代码的教程在这里
4. 其他参数根据 main.py 的描述，酌情更改即可。

---

三. Python 及其环境的安装

3.1 Python 安装

自行找教程安装，python2.x 或者 python3.x 都行。

3.2 依赖安装

-> 官方教程
直接参考官方教程，打开命令提示符（/ 终端）。
切换 (cd 命令) 到京东抢购助手的解压目录下，
输入 pip install -r requirements.txt 并回车。

上面的示例图以 Windows10 下，Python2.7 为例，系统和版本不同可能操作略有不同。

---

四. 京东抢购助手的使用

4.1 PyCharm 环境

1. 下载安装 PyCharm（自行百度）
2. 使用 PyCharm 新建工程（自行百度）
3. 将解压（已更改配置）的所有文件复制到工程文件夹下
4. 打开 main.py 点击绿色按钮运行
   

4.2 IDLE（自带）环境

1. 在开始菜单 / 应用列表 打开 Python IDLE.
2. 选择上方菜单栏 File - Open… 打开解压目录下的 main.py
3. 选择弹出窗口上方菜单栏 Run - Run Module 运行即可
   

4.3 终端（bash/cmd) 环境

1. windows 下，按键盘 Win+R，输入 cmd 并回车打开命令提示符。
   （MacOS / Linux 用户打开系统终端应用）

2. 切换工作目录到刚才解压的项目目录下。

D:
cd D:\WorkSpace\python\jd-assistant
python main.py

（参考命令，具体换成自己的路径）

---

五. 常见问题汇总

5.1 我的电脑是 XXX 系统，能运行吗？

只要能安装 Python 就行，包括但不限于各个版本的 Windows、MacOS 和 Linux 各发行版。

5.2 Windows 命令提示符下中文乱码问题

执行 python main.py 前先执行 chcp 65001，该命令将 cmd 的编码格式改为 utf8。

5.3 程序抛出 UnicodeDecodeError 异常，影响观察抢购情况

在 jd_assistant.py 文件中，添加如下语句，将输出编码改为 utf8 而不是 ascii。

import sys

reload(sys)
sys.setdefaultencoding('utf8')

5.4 如何创建快捷方式一键启动脚本

5.4.1 windows

在项目解压文件夹下，新建文本文档，将以下代码写入后保存。

chcp 65001
python main.py

重命名文件后缀为.bat 文件，双击.bat 文件即可快速启动。

5.4.2 Linux/MacOS

用 vim/nano 等文本编辑器新建一个.sh 文件

vim start.sh

往里面写入以下代码后保存（python 后跟项目解压文件绝对路径）

#!/bin/bash
python ~/jd-assistant/main.py

下次在 start.sh 所在文件夹输入./start.sh 即可启动。
有特殊需要的通过 ln 创建快捷方式或者加入 PATH，写个.desktop 等的自行百度学习。

5.5 去哪里获取在售口罩的 sku_ids？

这里有一份从 tg 群中拿到的 ids，具体商品未知，可自行确认和使用。

六. 其它问题

如果有错误还望见谅并指出，再次感谢项目作者：Tychxn