diff --git a/docs/MixPage使用方法/简介.md b/docs/MixPage使用方法/简介.md
new file mode 100644
index 0000000..3c13963
--- /dev/null
+++ b/docs/MixPage使用方法/简介.md
@@ -0,0 +1,15 @@
+本库 3.0 以前的版本是对 selenium 进行重新封装实现的。
+
+其页面对象为`MixPage`和`DriverPage`,对应于新版的`WebPage`和`ChromiumPage`。
+
+经过几年的使用,旧版已相当稳定。但由于依赖 selenium,功能开发受到较大制约,且 selenium 有其特征,容易被网站识别,故开发了新版`WebPage`取代之。
+
+新版于旧版使用方法基本一致,但新版功能更多更强,且部分方法或属性名称有修改。
+
+目前旧版开发已冻结,为兼容以前的项目,除了修复 bug,旧版不会再有功能上的修改。
+
+有兴趣的读者可以了解一下。
+
+其结构图如下:
+
+
diff --git a/docs/README.md b/docs/README.md
index 608c3da..eaa2fb8 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -1,3 +1,5 @@
+#
+
DrissionPage 是一个基于 python 的网页自动化工具。
它既能控制浏览器,也能收发数据包,甚至能把两者合而为一,
diff --git a/docs/_sidebar.md b/docs/_sidebar.md
index a6b2ba9..973e8c8 100644
--- a/docs/_sidebar.md
+++ b/docs/_sidebar.md
@@ -2,73 +2,74 @@
* [☀️ 2 特性和亮点](#)
- * [💖 2.1 贴心设计](特性和亮点\贴心设计.md)
- * [🌟 2.2 特性演示](#)
- * [⭐ 与 requests 对比](特性和亮点\特性演示\与requests代码对比.md)
- * [⭐ 与 selenium 对比](特性和亮点\特性演示\与selenium代码对比.md)
- * [⭐ 模式切换](特性和亮点\特性演示\模式切换.md)
- * [⭐ 获取并打印元素属性](特性和亮点\特性演示\获取并打印元素属性.md)
- * [⭐ 下载文件](特性和亮点\特性演示\下载文件.md)
+ * [💖 2.1 贴心设计](特性和亮点\贴心设计.md)
+ * [🌟 2.2 特性演示](#)
+ * [⭐ 与 requests 对比](特性和亮点\特性演示\与requests代码对比.md)
+ * [⭐ 与 selenium 对比](特性和亮点\特性演示\与selenium代码对比.md)
+ * [⭐ 模式切换](特性和亮点\特性演示\模式切换.md)
+ * [⭐ 获取并打印元素属性](特性和亮点\特性演示\获取并打印元素属性.md)
+ * [⭐ 下载文件](特性和亮点\特性演示\下载文件.md)
-* [🧭 2 入门指南](#)
+* [🧭 3 入门指南](#)
- * [🌏 2.1 基本概念](入门指南\基本概念.md)
- * [🌏 2.2 安装和导入](入门指南\安装和导入.md)
- * [🌏 2.3 准备工作](入门指南\准备工作.md)
- * [🌏 2.4 上手示例](#)
- * [🌐 控制浏览器](入门指南\上手示例\控制浏览器.md)
- * [🌐 收发数据包](入门指南\上手示例\收发数据包.md)
- * [🌐 模式切换](入门指南\上手示例\模式切换.md)
+ * [🌏 3.1 基本概念](入门指南\基本概念.md)
+ * [🌏 3.2 安装和导入](入门指南\安装和导入.md)
+ * [🌏 3.3 准备工作](入门指南\准备工作.md)
+ * [🌏 3.4 上手示例](#)
+ * [🌐 控制浏览器](入门指南\上手示例\控制浏览器.md)
+ * [🌐 收发数据包](入门指南\上手示例\收发数据包.md)
+ * [🌐 模式切换](入门指南\上手示例\模式切换.md)
-* [🛠 3 使用方法](#)
+* [🛠 4 使用方法](#)
- * [🔨 3.0 简介](WebPage使用方法\3.0简介.md)
- * [🔨 3.1 创建页面对象](WebPage使用方法\3.1创建页面对象.md)
- * [🔨 3.2 访问网页](WebPage使用方法\3.2访问网页.md)
- * [🔨 3.3 查找元素](WebPage使用方法\3.3查找元素.md)
- * [🔨 3.4 获取元素信息](WebPage使用方法\3.4获取元素信息.md)
- * [🔨 3.5 元素操作](WebPage使用方法\3.5元素操作.md)
- * [🔨 3.6 获取网页信息](WebPage使用方法\3.6获取网页信息.md)
- * [🔨 3.7 页面操作](WebPage使用方法\3.7页面操作.md)
- * [🔨 3.8 标签页操作](WebPage使用方法\3.8标签页操作.md)
- * [🔨 3.9 iframe操作](WebPage使用方法\3.9iframe操作.md)
- * [🔨 3.10 动作链](WebPage使用方法\3.10动作链.md)
+ * [🔨 4.0 简介](WebPage使用方法\3.0简介.md)
+ * [🔨 4.1 创建页面对象](WebPage使用方法\3.1创建页面对象.md)
+ * [🔨 4.2 访问网页](WebPage使用方法\3.2访问网页.md)
+ * [🔨 4.3 查找元素](WebPage使用方法\3.3查找元素.md)
+ * [🔨 4.4 获取元素信息](WebPage使用方法\3.4获取元素信息.md)
+ * [🔨 4.5 元素操作](WebPage使用方法\3.5元素操作.md)
+ * [🔨 4.6 获取网页信息](WebPage使用方法\3.6获取网页信息.md)
+ * [🔨 4.7 页面操作](WebPage使用方法\3.7页面操作.md)
+ * [🔨 4.8 标签页操作](WebPage使用方法\3.8标签页操作.md)
+ * [🔨 4.9 iframe操作](WebPage使用方法\3.9iframe操作.md)
+ * [🔨 4.10 动作链](WebPage使用方法\3.10动作链.md)
-* [📝 4 启动配置](#)
+* [📝 5 启动配置](#)
- * [🗒️ 4.1 概述](启动配置\概述.md)
- * [🗒️ 4.2 浏览器启动配置](启动配置\浏览器启动配置.md)
- * [🗒️ 4.3 Session 启动配置](启动配置\Session启动配置.md)
- * [🗒️ 4.4 使用配置文件](启动配置\使用配置文件.md)
+ * [🗒️ 5.1 概述](启动配置\概述.md)
+ * [🗒️ 5.2 浏览器启动配置](启动配置\浏览器启动配置.md)
+ * [🗒️ 5.3 Session 启动配置](启动配置\Session启动配置.md)
+ * [🗒️ 5.4 使用配置文件](启动配置\使用配置文件.md)
-* [🧰 5 进阶使用](#)
+* [🧰 6 进阶使用](#)
- * [⚙️ 5.1 打包程序](进阶使用\打包程序.md)
- * [⚙️ 5.2 监听浏览器网络](进阶使用\监听浏览器网络.md)
- * [⚙️ 5.3 下载文件](进阶使用\下载文件.md)
+ * [⚙️ 6.1 打包程序](进阶使用\打包程序.md)
+ * [⚙️ 6.2 监听浏览器网络](进阶使用\监听浏览器网络.md)
+ * [⚙️ 6.3 下载文件](进阶使用\下载文件.md)
-* [🛠 6 旧版使用方法](#)
+* [🛠 7 旧版使用方法](#)
- * [🔨 6.1 创建页面对象](MixPage使用方法\创建页面对象.md)
- * [🔨 6.2 访问网页](MixPage使用方法\访问网页.md)
- * [🔨 6.3 查找页面元素](MixPage使用方法\查找页面元素.md)
- * [🔨 6.4 获取元素信息](MixPage使用方法\获取元素信息.md)
- * [🔨 6.5 元素操作](MixPage使用方法\元素操作.md)
- * [🔨 6.6 获取网页信息](MixPage使用方法\获取网页信息.md)
- * [🔨 6.7 页面操作](MixPage使用方法\页面操作.md)
- * [🔨 6.8 cookies 的使用](MixPage使用方法\cookies的使用.md)
- * [🔨 6.9 Drission 对象](MixPage使用方法\Drission对象.md)
- * [🔨 6.10 对接 selenium 及 requests 代码](MixPage使用方法\对接selenium及requests代码.md)
- * [🔨 6.11 使用其它系统或浏览器](MixPage使用方法\使用其它系统或浏览器.md)
- * [🔨 6.12 DriverPage 和 SessionPage](MixPage使用方法\DriverPage和SessionPage.md)
+ * [🔨 7.0 简介](MixPage使用方法\简介.md)
+ * [🔨 7.1 创建页面对象](MixPage使用方法\创建页面对象.md)
+ * [🔨 7.2 访问网页](MixPage使用方法\访问网页.md)
+ * [🔨 7.3 查找页面元素](MixPage使用方法\查找页面元素.md)
+ * [🔨 7.4 获取元素信息](MixPage使用方法\获取元素信息.md)
+ * [🔨 7.5 元素操作](MixPage使用方法\元素操作.md)
+ * [🔨 7.6 获取网页信息](MixPage使用方法\获取网页信息.md)
+ * [🔨 7.7 页面操作](MixPage使用方法\页面操作.md)
+ * [🔨 7.8 cookies 的使用](MixPage使用方法\cookies的使用.md)
+ * [🔨 7.9 Drission 对象](MixPage使用方法\Drission对象.md)
+ * [🔨 7.10 对接 selenium 及 requests 代码](MixPage使用方法\对接selenium及requests代码.md)
+ * [🔨 7.11 使用其它系统或浏览器](MixPage使用方法\使用其它系统或浏览器.md)
+ * [🔨 7.12 DriverPage 和 SessionPage](MixPage使用方法\DriverPage和SessionPage.md)
-* [⚡️ 7 示例和技巧](#)
+* [⚡️ 8 示例和技巧](#)
- * [🌠 自动登录码云](示例和技巧\自动登录码云.md)
- * [🌠 采集猫眼电影TOP100榜](示例和技巧\采集猫眼电影TOP100榜.md)
- * [🌠 下载星巴克产品图片](示例和技巧\下载星巴克产品图片.md)
- * [🌠 下载豆瓣图书封面图片](示例和技巧\下载豆瓣图书封面图片.md)
- * [🌠 多线程操作多标签页](示例和技巧\多线程操作多标签页.md)
+ * [🌠 自动登录码云](示例和技巧\自动登录码云.md)
+ * [🌠 采集猫眼电影TOP100榜](示例和技巧\采集猫眼电影TOP100榜.md)
+ * [🌠 下载星巴克产品图片](示例和技巧\下载星巴克产品图片.md)
+ * [🌠 下载豆瓣图书封面图片](示例和技巧\下载豆瓣图书封面图片.md)
+ * [🌠 多线程操作多标签页](示例和技巧\多线程操作多标签页.md)
* [🔖 9 版本历史](版本历史.md)
diff --git a/docs/入门指南/上手示例/gitee_1.jpg b/docs/imgs/gitee_1.jpg
similarity index 100%
rename from docs/入门指南/上手示例/gitee_1.jpg
rename to docs/imgs/gitee_1.jpg
diff --git a/docs/入门指南/上手示例/gitee_2.jpg b/docs/imgs/gitee_2.jpg
similarity index 100%
rename from docs/入门指南/上手示例/gitee_2.jpg
rename to docs/imgs/gitee_2.jpg
diff --git a/docs/imgs/mixpage.jpg b/docs/imgs/mixpage.jpg
new file mode 100644
index 0000000..3930da2
Binary files /dev/null and b/docs/imgs/mixpage.jpg differ
diff --git a/docs/入门指南/上手示例/控制浏览器.md b/docs/入门指南/上手示例/控制浏览器.md
index af1d91d..5a1380a 100644
--- a/docs/入门指南/上手示例/控制浏览器.md
+++ b/docs/入门指南/上手示例/控制浏览器.md
@@ -8,7 +8,7 @@
打开网址,按`F12`,我们可以看到页面元素如下:
-
+
用户名输入框`id`为`'user_login'`,密码输入框`id`为`'user_password'`,登录按钮`value`为`'登 录'`。
diff --git a/docs/入门指南/上手示例/收发数据包.md b/docs/入门指南/上手示例/收发数据包.md
index 9d49219..2aeffb3 100644
--- a/docs/入门指南/上手示例/收发数据包.md
+++ b/docs/入门指南/上手示例/收发数据包.md
@@ -10,7 +10,7 @@
打开网址,按`F12`,我们可以看到页面元素如下:
-
+
从 html 代码中可以看到,所有开源项目的标题都是`class`属性为`'title project-namespace-path'`的``元素。我们可以遍历这些``元素,获取它们的信息。
diff --git a/docs/入门指南/准备工作.md b/docs/入门指南/准备工作.md
index 4c4356b..b2b42a8 100644
--- a/docs/入门指南/准备工作.md
+++ b/docs/入门指南/准备工作.md
@@ -36,7 +36,11 @@ from DrissionPage.easy_set import set_paths
set_paths(chrome_path=r'这里修改为您的Chrome浏览器exe文件路径', check_version=False)
```
-执行这段代码会记录您电脑的 Chrome 浏览器路径到配置文件。现在,请重新执行上一步的代码,如果正确访问了百度,说明已经设置完成。
+执行这段代码会记录您电脑的 Chrome 浏览器路径到配置文件。
+
+## 📍 重试控制浏览器
+
+现在,请重新执行第二步的代码,如果正确访问了百度,说明已经设置完成。
# ✔️ 说明
diff --git a/docs/入门指南/安装和导入.md b/docs/入门指南/安装和导入.md
index fc7c4d4..8ef6464 100644
--- a/docs/入门指南/安装和导入.md
+++ b/docs/入门指南/安装和导入.md
@@ -1,14 +1,12 @@
# ✔️ 安装
-## 📍 安装
-
请使用 pip 安装 DrissionPage:
```shell
pip install DrissionPage
```
-## 📍 升级
+# ✔️ 升级
```shell
pip install DrissionPage --upgrade