更新

README.en.md

@@ -80,11 +80,11 @@ The page element class in session mode can obtain element attribute values and s
 
 The following code implements exactly the same function, compare the amount of code between the two:
 
-- Use explicit waiting to find all elements that contain some text
+- Find the first element whose text contains some text with explicit wait
 
 ```python
 # Use selenium:
-element = WebDriverWait(driver).until(ec.presence_of_all_elements_located((By.XPATH,'//*[contains(text(), "some text")]')))
+element = WebDriverWait(driver).until(ec.presence_of_element_located((By.XPATH,'//*[contains(text(), "some text")]')))
 
 # Use DrissionPage:
 element = page('some text')
@@ -179,11 +179,11 @@ shadow_element = element.shadow_root
 
 
 
-- Use xpath to get attributes or nodes
+- Use xpath to get attributes or text nodes directly
 
 ```python
 # Use selenium:
-The usage is not supported
+Quite complicated
 
 # Use DrissionPage:
 class_name = element('xpath://div[@id="div_id"]/@class')
@@ -306,6 +306,7 @@ pip install DrissionPage
 ```
 Only supports python3.6 and above, and the driver mode currently only supports chrome.It has only been tested in the Windows environment.
 To use the driver mode, you must download chrome and **corresponding version** of chromedriver. [[chromedriver download]](https://chromedriver.chromium.org/downloads)  
+The get_match_driver() method in the easy_set tool can automatically identify the chrome version and download the matching driver.
 
 # Instructions
 
@@ -314,7 +315,7 @@ To use the driver mode, you must download chrome and **corresponding version** o
 ## Import module
 
 ```python
-from DrissionPage import *
+from DrissionPage import MixPage
 ```
 
 
@@ -325,31 +326,74 @@ If you only use session mode, you can skip this section.
 
 Before using selenium, you must configure the path of chrome.exe and chromedriver.exe and ensure that their versions match.
 
-There are three ways to configure the path:
-- Write two paths to system variables.
-- Manually pass in the path when in use.
-- Write the path to the ini file of this library (recommended).
+There are four ways to configure the path:
+-Use the get_match_driver() method of the easy_set tool (recommended)
+-Write the path to the ini file of this library
+-Write two paths to system variables
+-Manually pass in the path when using
 
-If you choose the third method, please run these lines of code before using this library for the first time and record these two paths in the ini file.
+### Use get_match_driver() method
+
+If you choose the first method, please run the following code before using it for the first time. The program will automatically detect the Chrome version installed on your computer, download the corresponding driver, and record it in the ini file.
+
+```python
+from DrissionPage.easy_set import get_match_driver
+get_match_driver()
+```
+
+Output:
+
+```
+ini文件中chrome.exe路径 D:\Google Chrome\Chrome\chrome.exe 
+
+version 75.0.3770.100 
+
+chromedriver_win32.zip
+Downloading to: D:\python\projects\DrissionPage\DrissionPage
+ 100% Success.
+
+解压路径 D:\python\projects\chromedriver.exe 
+
+正在检测可用性...
+版本匹配，可正常使用。
+```
+
+Then you can start using it.
+
+If you want to specify the save path of the ini file and chromedriver.exe, you can write:
+
+```python
+get_match_driver(ini_path ='ini file path', save_path ='save path')
+```
+
+
+
+### Use set_paths() method
+
+If the previous method fails, you can download chromedriver.exe yourself, and then run the following code to record the path to the ini file.
 
 ```python
 from DrissionPage.easy_set import set_paths
-driver_path ='D:\\chrome\\chromedriver.exe'  # Your chromedriver.exe path, optional
-chrome_path ='D:\\chrome\\chrome.exe'  # Your chrome.exe path, optional
+driver_path ='D:\\chrome\\chromedriver.exe' # Your chromedriver.exe path, if not filled in, it will be searched in system variables
+chrome_path ='D:\\chrome\\chrome.exe' # Your chrome.exe path, if not filled in, it will be searched in system variables
 set_paths(driver_path, chrome_path)
 ```
 
 This method also checks whether the chrome and chromedriver versions match, and displays:
 
 ```
-The version matches and can be used normally.
+正在检测可用性...
+版本匹配，可正常使用。
+```
 
-# Or
+or
 
-Abnormal:
+```
+出现异常：
 Message: session not created: Chrome version must be between 70 and 73
   (Driver info: chromedriver=73.0.3683.68 (47787ec04b6e38e22703e856e101e840b65afe72),platform=Windows NT 10.0.19631 x86_64)
-chromedriver download URL: https://chromedriver.chromium.org/downloads
+可执行easy_set.get_match_driver()自动下载匹配的版本。
+或自行从以下网址下载：https://chromedriver.chromium.org/downloads
 ```
 
 After passing the check, you can use the driver mode normally.
@@ -390,10 +434,9 @@ drission = Drission(ini_path ='D:\\settings.ini')
 drission = Drission(read_file = False)
 ```
 
-To manually pass in the configuration:
+To manually pass in the configuration (ignore the ini file):
 
 ```python
-# Create with the incoming configuration information (ignore the ini file)
 from DrissionPage.config import DriverOptions
 
 # Create a driver configuration object, read_file = False means not to read the ini file
@@ -417,7 +460,7 @@ drission = Drission(driver_options, session_options)
 The MixPage page object encapsulates common web page operations and realizes the switch between driver and session modes.
 MixPage must receive a Drission object and use the driver or session in it. If it is not passed in, MixPage will create a Drission by itself (using the configuration of the default ini file).
 
-Tips: When multiple page objects work together, remember to manually create a Drission object and pass it to the page object for use. Otherwise, the page objects will each create their own Drission objects, making the information unable to pass.
+Tips: When multiple objects work together, you can pass the Drission object in one MixPage to another, so that multiple objects can share login information or operate the same page.
 
 ### Create Object
 
@@ -432,7 +475,7 @@ page = MixPage('s')
 page = MixPage(drission)
 page = MixPage(drission, mode='s', timeout=5)  # session mode, waiting time is 5 seconds (default 10 seconds)
 
-# Create with incoming configuration information
+# Incoming configuration information, MixPage internally creates Drission according to the configuration
 page = MixPage(driver_options=DriverOption, session_options=SessionOption)  # default d mode
 ```
 
@@ -653,7 +696,7 @@ element.hover()  # Hover the mouse over the element
 
 ## Docking with selenium code
 
-The DrissionPage code can be seamlessly spliced ​​with the selenium code, either directly using the selenium WebDriver object, or using its own WebDriver everywhere for the selenium code. Make the migration of existing projects very convenient.
+The DrissionPage code can be seamlessly spliced with the selenium code, either directly using the selenium WebDriver object, or using its own WebDriver everywhere for the selenium code. Make the migration of existing projects very convenient.
 
 ### selenium to DrissionPage
 
@@ -717,19 +760,20 @@ The configuration of chrome is very cumbersome. In order to simplify the use, th
 The DriverOptions object inherits from the Options object of selenium.webdriver.chrome.options, and the following methods are added to it:
 
 ```python
-remove_argument(value)  # delete an argument value
-remove_experimental_option(key)  # delete an experimental_option setting
-remove_all_extensions()  # Remove all plugins
-save()  # Save the configuration to the default ini file
-save('D:\\settings.ini')  # save to other path
-set_argument(arg, value)  # set argument attribute
-set_headless(on_off)  # Set whether to use no interface mode
-set_no_imgs(on_off)  # Set whether to load images
-set_no_js(on_off)  # Set whether to disable js
-set_mute(on_off)  # Set whether to mute
-set_user_agent(user_agent)  # set user agent
-set_proxy(proxy)  # set proxy address
-set_paths(driver_path, chrome_path, debugger_address, download_path, user_data_path, cache_path)  # Set browser- related paths
+options.remove_argument(value) # Remove an argument value
+options.remove_experimental_option(key) # delete an experimental_option setting
+options.remove_all_extensions() # Remove all plugins
+options.save() # Save the currently opened ini file
+options.save('D:\\settings.ini') # Save to the specified path ini file
+options.save('default') # Save the current settings to the default ini file
+options.set_argument(arg, value) # set argument property
+options.set_headless(on_off) # Set whether to use interfaceless mode
+options.set_no_imgs(on_off) # Set whether to load images
+options.set_no_js(on_off) # Set whether to disable js
+options.set_mute(on_off) # Set whether to mute
+options.set_user_agent(user_agent) # set user agent
+options.set_proxy(proxy) # Set proxy address
+options.set_paths(driver_path, chrome_path, debugger_address, download_path, user_data_path, cache_path) # Set browser-related paths
 ```
 
 
@@ -737,16 +781,17 @@ set_paths(driver_path, chrome_path, debugger_address, download_path, user_data_p
 ### Instructions
 
 ```python
-do = DriverOptions(read_file=False)  # Create chrome configuration object, not read from ini file
+do = DriverOptions(read_file=False) # Create chrome configuration object, do not read from ini file
 do.set_headless(False) # show the browser interface
 do.set_no_imgs(True) # Do not load pictures
 do.set_paths(driver_path='D:\\chromedriver.exe', chrome_path='D:\\chrome.exe') # set path
 do.set_headless(False).set_no_imgs(True) # Support chain operation
 
 drission = Drission(driver_options=do) # Create Drission object with configuration object
-page = MixPage(drission)  # Create a MixPage object with Drission object
+page = MixPage(drission) # Create MixPage object with Drission object
 
-do.save()  # Save the configuration to the default ini file
+do.save() # Save the currently opened ini file
+do.save('default') # Save the current settings to the default ini file
 ```
 
 
@@ -821,11 +866,15 @@ headers = {
 The OptionsManager object is used to read, set and save the configuration.
 
 ```python
-get_value(section, item) - > str  # Get the value of a configuration
-get_option(section) - > dict  # Return all attributes of configuration in dictionary format
-set_item(section, item, value)  # Set configuration attributes
-save()  # Save the configuration to the default ini file
-save('D:\\settings.ini')  # save to other path
+manager.paths # Return path settings in dictionary form
+manager.chrome_options # Return chrome settings in dictionary form
+manager.session_options # Return session settings in dictionary form
+manager.get_value(section, item) # Get the value of a configuration
+manager.get_option(section) # Return all attributes of configuration in dictionary format
+manager.set_item(section, item, value) # Set configuration properties
+manager.manager.save() # Save the currently opened ini file
+manager.save('D:\\settings.ini') # Save to the specified path ini file
+manager.save('default') # Save the current settings to the default ini file
 ```
 
 
@@ -838,19 +887,17 @@ from DrissionPage.configs import *
 options_manager = OptionsManager() # Create OptionsManager object from the default ini file
 options_manager = OptionsManager('D:\\settings.ini') # Create OptionsManager object from other ini files
 driver_path = options_manager.get_value('paths','chromedriver_path') # read path information
-options_manager.save()  # Save to the default ini file
-options_manager.save('D:\\settings.ini')  # save to other path
+options_manager.save() # Save the currently opened ini file
+options_manager.save('D:\\settings.ini') # Save to the specified path ini file
 
-drission = Drission(ini_path ='D:\\settings.ini')  # Use other ini files to create objects
+drission = Drission(ini_path='D:\\settings.ini') # Use the specified ini file to create the object
 ```
 
-**Note**: If you do not pass in the path when saving, it will be saved to the ini file in the module directory, even if the read is not the default ini file.
-
 
 
 ## easy_set method
 
-Calling the easy_set method will modify the content of the default ini file.
+The methods of frequently used settings can be quickly modified. Calling the easy_set method will modify the content of the default ini file.
 
 ```python
 set_headless(True)  # Turn on headless mode
@@ -2363,7 +2410,7 @@ Save the settings to a file and return to yourself for chain operation.
 
 Parameter Description:
 
-- path: str  - the path of the ini file, saved to the module folder by default
+- path: str  - the path of the ini file, pass in 'default' would save to the default ini file
 
 Return: OptionsManager  - return to yourself
 
@@ -2378,6 +2425,7 @@ The Chrome browser configuration class, inherited from the Options class of sele
 Parameter Description:
 
 - read_file: bool  - Whether to read configuration information from the ini file when creating
+- ini_path: str      - ini file path, if it is None, the default ini file will be read
 
 
 
@@ -2403,7 +2451,7 @@ Save the settings to a file and return to yourself for chain operation.
 
 Parameter Description:
 
-- path: str  - the path of the ini file, saved to the module folder by default
+- path: str  - the path of the ini file, pass in 'default' would save to the default ini file
 
 Return: DriverOptions  - return self
 
@@ -2551,6 +2599,12 @@ Chrome configuration is too complicated, so the commonly used configuration is w
 
 Automatically identify the chrome version and download the matching driver. Get the chrome.exe path recorded in the ini file, if not, get the path in the system variable.
 
+Parameter Description:
+
+- ini_path: str-the path of the ini file to be read and modified
+
+- save_path: str-chromedriver save path
+
 Returns: None
 
 
@@ -2559,23 +2613,36 @@ Returns: None
 
 Print all configuration information in the ini file.
 
+Parameter Description:
+
+- ini_path: str-ini file path, if it is None, read the default ini file
+
 Returns: None
 
 
 
 ### set_paths()
 
-Convenient way to set the path, save the incoming path to the default ini file, and check whether the chrome and chromedriver versions match.
+Convenient way to set the path, save the passed path to an ini file, and check whether the chrome and chromedriver versions match.
 
 Parameter Description:
 
 - driver_path: str-chromedriver.exe path
+
 - chrome_path: str-chrome.exe path
+
 - debugger_address: str-debug browser address, for example: 127.0.0.1:9222
+
 - download_path: str-download file path
+
 - global_tmp_path: str-Temporary folder path
+
 - user_data_path: str-user data path
+
 - cache_path: str-cache path
+
+- ini_path: str-ini file path, if it is None, save to the default ini file
+
 - check_version: bool-whether to check if chromedriver and chrome match
 
 Returns: None
@@ -2584,12 +2651,15 @@ Returns: None
 
 ### set_argument()
 
-Set the properties. If the attribute has no value (such as'zh_CN.UTF- 8'), value is passed in bool to indicate switch; otherwise, value is passed in str, and when value is'' or False, delete the attribute item.
+Set the properties. If the attribute has no value (such as'zh_CN.UTF-8' ), value is passed in bool to indicate a switch; otherwise, value is assigned to the attribute. When value is'' or False, delete the attribute item.
 
 Parameter Description:
 
-- arg:str    - Property name
-- value[bool, str]  -  Attribute value, the attribute with value is passed in the value, and the attribute without value is passed in bool
+- arg: str-attribute name
+
+- value: [bool, str]-attribute value, the value attribute is passed in the value, and the non-property is passed in bool
+
+- ini_path: str-ini file path, if it is None, save to the default ini file
 
 Returns: None
 
@@ -2603,6 +2673,8 @@ Parameter Description:
 
 - on_off: bool-whether to turn on headless mode
 
+- ini_path: str-ini file path, if it is None, save to the default ini file
+
 Returns: None
 
 
@@ -2613,7 +2685,9 @@ Turn picture display on or off.
 
 Parameter Description:
 
-- on_off: bool  -  Whether to turn on the no image mode
+- on_off: bool-whether to turn on the no image mode
+
+- ini_path: str-ini file path, if it is None, save to the default ini file
 
 Returns: None
 
@@ -2625,7 +2699,9 @@ Turn on or off disable JS mode.
 
 Parameter Description:
 
-- on_off: bool  -  Whether to enable the disable JS mode
+- on_off: bool-whether to enable or disable JS mode
+
+- ini_path: str-ini file path, if it is None, save to the default ini file
 
 Returns: None
 
@@ -2637,7 +2713,9 @@ Turn on or off the silent mode.
 
 Parameter Description:
 
-- on_off: bool  -  Whether to turn on silent mode
+- on_off: bool-whether to turn on silent mode
+
+- ini_path: str-ini file path, if it is None, save to the default ini file
 
 Returns: None
 
@@ -2651,6 +2729,8 @@ Parameter Description:
 
 - user_agent: str-user_agent value
 
+- ini_path: str-ini file path, if it is None, save to the default ini file
+
 Returns: None
 
 
@@ -2663,6 +2743,8 @@ Parameter Description:
 
 - proxy: str-proxy value
 
+- ini_path: str-ini file path, if it is None, save to the default ini file
+
 Returns: None
 
 

README.zh-cn.md

@@ -2,7 +2,8 @@
 
 ***
 
-DrissionPage，即 driver 和 session 的合体，是个基于 python 的 Web 自动化操作集成工具。  
+DrissionPage，即 driver 和 session 的合体。  
+是个基于 python 的 Web 自动化操作集成工具。  
 它实现了 selenium 和 requests 之间的无缝切换。  
 因此可以兼顾 selenium 的便利性和 requests 的高效率。  
 它集成了页面常用功能，两种模式系统一致的 API，使用便捷。
@@ -80,11 +81,11 @@ session 模式下的页面元素类，可获取元素属性值，也可在其下
 
 以下代码实现一模一样的功能，对比两者的代码量：
 
-- 用显性等待方式查找所有文本包含 some text 的元素
+- 用显性等待方式查找第一个文本包含 some text 的元素
 
 ```python
 # 使用 selenium：
-element = WebDriverWait(driver).until(ec.presence_of_all_elements_located((By.XPATH, '//*[contains(text(), "some text")]')))
+element = WebDriverWait(driver).until(ec.presence_of_element_located((By.XPATH, '//*[contains(text(), "some text")]')))
 
 # 使用 DrissionPage：
 element = page('some text')
@@ -179,11 +180,11 @@ shadow_element = element.shadow_root
 
 
 
-- 用 xpath 获取属性或节点
+- 用 xpath 直接获取属性或文本节点（返回文本）
 
 ```python
 # 使用 selenium：
-不支持该用法
+相当复杂
 
 # 使用 DrissionPage：
 class_name = element('xpath://div[@id="div_id"]/@class')
@@ -247,6 +248,7 @@ page.get('https://gitee.com/profile')  # 访问个人中心页面（未登录，
 
 page.ele('@id:user_login').input('your_user_name')  # 使用 selenium 输入账号密码登录
 page.ele('@id:user_password').input('your_password\n')
+sleep(1)
 
 page.change_mode()  # 切换到 session 模式
 print('登录后title：', page.title, '\n')  # 登录后 session 模式的输出
@@ -315,7 +317,7 @@ easy_set 工具中的 get_match_driver() 方法可自动识别 chrome 版本并
 ## 导入模块
 
 ```python
-from DrissionPage import *
+from DrissionPage import MixPage
 ```
 
 
@@ -332,6 +334,8 @@ from DrissionPage import *
 - 将两个路径写入系统变量
 - 使用时手动传入路径
 
+### 使用 get_match_driver()  方法
+
 若你选择第一种方式，请在第一次使用前，运行以下代码，程序会自动检测电脑安装的 chrome 版本，下载对应 driver，并记录到 ini 文件。
 
 ```python
@@ -358,7 +362,17 @@ Downloading to: D:\python\projects\DrissionPage\DrissionPage
 
 然后就可以开始使用了。
 
-若上一种方法失败，可自行下载 chromedriver.exe，然后运行以下代码，把这两个路径记录到 ini 文件中。
+若你想指定 ini 文件及 chromedriver.exe 的保存路径，可以这样写：
+
+```python
+get_match_driver(ini_path='ini文件路径', save_path='保存路径')
+```
+
+
+
+### 使用 set_paths() 方法
+
+若上一种方法失败，可自行下载 chromedriver.exe，然后运行以下代码，把路径记录到 ini 文件中。
 
 ```python
 from DrissionPage.easy_set import set_paths
@@ -370,14 +384,18 @@ set_paths(driver_path, chrome_path)
 该方法还会检查 chrome 和 chromedriver 版本是否匹配，显示：
 
 ```
+正在检测可用性...
 版本匹配，可正常使用。
+```
 
-# 或
+或
 
+```
 出现异常：
 Message: session not created: Chrome version must be between 70 and 73
   (Driver info: chromedriver=73.0.3683.68 (47787ec04b6e38e22703e856e101e840b65afe72),platform=Windows NT 10.0.19631 x86_64)
-chromedriver下载网址：https://chromedriver.chromium.org/downloads
+可执行easy_set.get_match_driver()自动下载匹配的版本。
+或自行从以下网址下载：https://chromedriver.chromium.org/downloads
 ```
 
 检查通过后，即可正常使用 driver 模式。
@@ -396,13 +414,13 @@ Tips：
 
 - 不同项目可能须要不同版本的 chrome 和 chromedriver，你还可保存多个 ini 文件，按须使用。
 - 推荐使用绿色版 chrome，并手动设置路径，避免浏览器升级造成与 chromedriver 版本不匹配。
-- 调试项目时推荐设置 debugger_address，使用手动打开的浏览器调试，省时省力。
+- 调试项目时推荐设置 debugger_address，使用手动打开的浏览器，再用程序接管，好处多多。
 
 
 
 ## 创建驱动器对象 Drission
 
-创建的步骤不是必须，若想快速上手，可跳过本节。MixPage 对象会自动创建该对象。
+创建的步骤不是必须，若想快速上手，可跳过本节。MixPage 会自动创建该对象。
 
 Drission 对象用于管理 driver 和 session 对象。在多个页面协同工作时，Drission 对象用于传递驱动器，使多个页面类可控制同一个浏览器或 Session 对象。  
 可直接读取 ini 文件配置信息创建，也可以在初始化时传入配置信息。
@@ -418,10 +436,9 @@ drission = Drission(ini_path = 'D:\\settings.ini')
 drission = Drission(read_file=False)
 ```
 
-若要手动传入配置：
+若要手动传入配置（不使用 ini 文件）：
 
 ```python
-# 用传入的配置信息创建（忽略ini文件）
 from DrissionPage.config import DriverOptions
 
 # 创建 driver 配置对象，read_file = False 表示不读取 ini 文件
@@ -443,9 +460,9 @@ drission = Drission(driver_options, session_options)
 ## 使用页面对象 MixPage
 
 MixPage 页面对象封装了常用的网页操作，并实现 driver 和 session 模式之间的切换。  
-MixPage 须接收一个 Drission 对象并使用其中的 driver 或 session，如没有传入，MixPage 会自己创建一个 Drission（使用默认ini文件的配置）。
+MixPage 须接收一个 Drission 对象并使用其中的 driver 或 session，如没有传入，MixPage 会自己创建一个（使用默认 ini 文件的配置）。
 
-Tips: 多页面对象协同工作时，记得手动创建 Drission 对象并传递给页面对象使用。否则页面对象会各自创建自己的 Drission 对象，使信息无法传递。
+Tips: 多对象协同工作时，可将一个 MixPage 中的 Drission 对象传递给另一个，使多个对象共享登录信息或操作同一个页面。
 
 ### 创建对象
 
@@ -460,7 +477,7 @@ page = MixPage('s')
 page = MixPage(drission)
 page = MixPage(drission, mode='s', timeout=5)  # session 模式，等待时间5秒（默认10秒）
 
-# 以传入配置信息创建
+# 传入配置信息，MixPage 根据配置在内部创建 Drission
 page = MixPage(driver_options=do, session_options=so)  # 默认 d 模式
 ```
 
@@ -743,19 +760,20 @@ chrome 的配置很繁琐，为简化使用，本库提供了常用配置的设
 DriverOptions 对象继承自 selenium.webdriver.chrome.options 的 Options 对象，在其基础上增加了以下方法：
 
 ```python
-remove_argument(value)  # 删除某argument值
-remove_experimental_option(key)  # 删除某experimental_option设置
-remove_all_extensions()  # 删除全部插件
-save()  # 保存配置到默认ini文件
-save('D:\\settings.ini')  # 保存到其它路径
-set_argument(arg, value)  # 设置argument属性
-set_headless(on_off)  # 设置是否使用无界面模式
-set_no_imgs(on_off)  # 设置是否加载图片
-set_no_js(on_off)  # 设置是否禁用js
-set_mute(on_off)  # 设置是否静音
-set_user_agent(user_agent)  # 设置user agent
-set_proxy(proxy)  # 设置代理地址
-set_paths(driver_path, chrome_path, debugger_address, download_path, user_data_path, cache_path)  # 设置浏览器相关的路径
+options.remove_argument(value)  # 删除某 argument 值
+options.remove_experimental_option(key)  # 删除某 experimental_option 设置
+options.remove_all_extensions()  # 删除全部插件
+options.save()  # 保存当前打开的 ini 文件
+options.save('D:\\settings.ini')  # 保存到指定路径 ini 文件
+options.save('default')  # 保存当前设置到默认 ini 文件
+options.set_argument(arg, value)  # 设置 argument 属性
+options.set_headless(on_off)  # 设置是否使用无界面模式
+options.set_no_imgs(on_off)  # 设置是否加载图片
+options.set_no_js(on_off)  # 设置是否禁用 js
+options.set_mute(on_off)  # 设置是否静音
+options.set_user_agent(user_agent)  # 设置 user agent
+options.set_proxy(proxy)  # 设置代理地址
+options.set_paths(driver_path, chrome_path, debugger_address, download_path, user_data_path, cache_path)  # 设置浏览器相关的路径
 ```
 
 
@@ -772,7 +790,8 @@ do.set_headless(False).set_no_imgs(True)  # 支持链式操作
 drission = Drission(driver_options=do)  # 用配置对象创建 Drission 对象
 page = MixPage(drission)  # 用Drission对象创建 MixPage 对象
 
-do.save()  # 保存配置到默认ini文件
+do.save()  # 保存当前打开的 ini 文件
+do.save('default')  # 保存当前设置到默认 ini 文件
 ```
 
 
@@ -845,11 +864,15 @@ headers = {
 OptionsManager 对象用于读取、设置和保存配置。
 
 ```python
-get_value(section, item) -> str  # 获取某个配置的值
-get_option(section) -> dict  # 以字典格式返回配置全部属性
-set_item(section, item, value)  # 设置配置属性
-save()  # 保存配置到默认ini文件
-save('D:\\settings.ini')  # 保存到其它路径
+manager.paths  # 以字典形式返回路径设置
+manager.chrome_options  # 以字典形式返回chrome设置
+manager.session_options  # 以字典形式返回session设置
+manager.get_value(section, item)  # 获取某个配置的值
+manager.get_option(section)  # 以字典格式返回配置全部属性
+manager.set_item(section, item, value)  # 设置配置属性
+manager.manager.save()  # 保存当前打开的 ini 文件
+manager.save('D:\\settings.ini')  # 保存到指定路径 ini 文件
+manager.save('default')  # 保存当前设置到默认 ini 文件
 ```
 
 
@@ -862,19 +885,17 @@ from DrissionPage.configs import *
 options_manager = OptionsManager()  # 从默认ini文件创建OptionsManager对象
 options_manager = OptionsManager('D:\\settings.ini')  # 从其它ini文件创建OptionsManager对象
 driver_path = options_manager.get_value('paths', 'chromedriver_path')  # 读取路径信息
-options_manager.save()  # 保存到默认ini文件
-options_manager.save('D:\\settings.ini')  # 保存到其它路径
+options_manager.save()  # 保存当前打开的 ini 文件
+options_manager.save('D:\\settings.ini')  # 保存到指定路径 ini 文件
 
-drission = Drission(ini_path = 'D:\\settings.ini')  # 使用其它ini文件创建对象
+drission = Drission(ini_path='D:\\settings.ini')  # 使用指定 ini 文件创建对象
 ```
 
-**注意**：保存时若不传入路径，会保存到模块目录下的ini文件，即使读取的不是默认 ini 文件也一样。
-
 
 
 ## easy_set 方法
 
-调用 easy_set 方法会修改默认ini文件相关内容。
+可快速地修改常用设置的方法，调用 easy_set 方法会修改默认 ini 文件相关内容。
 
 ```python
 set_headless(True)  # 开启 headless 模式
@@ -2355,7 +2376,7 @@ session 模式的元素对象，包装了一个Element对象，并封装了常
 
 参数说明：
 
-- path:str  - ini 文件的路径，默认保存到模块文件夹下的
+- path: str  - ini 文件的路径，传入 'default' 保存到默认ini文件
 
 返回： OptionsManager  - 返回自己
 
@@ -2370,6 +2391,7 @@ chrome 浏览器配置类，继承自 selenium.webdriver.chrome.options 的 Opti
 参数说明：
 
 - read_file: bool  - 创建时是否从 ini 文件读取配置信息
+- ini_path:  str     - ini 文件路径，为None则读取默认 ini 文件
 
 
 
@@ -2395,7 +2417,7 @@ chrome.exe 的路径
 
 参数说明：
 
-- path:str  - ini 文件的路径，默认保存到模块文件夹下的
+- path: str  - ini 文件的路径，传入 'default' 保存到默认ini文件
 
 返回： DriverOptions  - 返回自己
 
@@ -2543,6 +2565,11 @@ chrome 配置太复杂，所以把常用的配置写成简单的方法，调用
 
 自动识别 chrome 版本并下载匹配的driver。获取 ini 文件记录的 chrome.exe 路径，若没有则获取系统变量中的。
 
+参数说明：
+
+- ini_path: str      - 要读取和修改的 ini 文件路径
+- save_path: str  - chromedriver 保存路径
+
 返回： None
 
 
@@ -2551,13 +2578,17 @@ chrome 配置太复杂，所以把常用的配置写成简单的方法，调用
 
 打印 ini 文件中所有配置信息。
 
+参数说明：
+
+- ini_path: str  - ini 文件路径，为 None 则读取默认 ini 文件
+
 返回： None
 
 
 
 ### set_paths()
 
-便捷的设置路径方法，把传入的路径保存到默认 ini 文件，并检查 chrome 和 chromedriver 版本是否匹配。
+便捷的设置路径方法，把传入的路径保存到 ini 文件，并检查 chrome 和 chromedriver 版本是否匹配。
 
 参数说明：
 
@@ -2568,6 +2599,7 @@ chrome 配置太复杂，所以把常用的配置写成简单的方法，调用
 - global_tmp_path: str      - 临时文件夹路径
 - user_data_path: str        - 用户数据路径
 - cache_path: str              - 缓存路径
+- ini_path: str                    - ini 文件路径，为 None 则保存到默认 ini 文件
 - check_version: bool       - 是否检查 chromedriver 和 chrome 是否匹配
 
 返回： None
@@ -2576,12 +2608,13 @@ chrome 配置太复杂，所以把常用的配置写成简单的方法，调用
 
 ### set_argument()
 
-设置属性。若属性无值（如'zh_CN.UTF-8'），value传入bool表示开关；否则value传入str，当value为''或False，删除该属性项。
+设置属性。若属性无值（如 'zh_CN.UTF-8' ），value 传入 bool 表示开关；否则把 value 赋值给属性，当 value 为 '' 或 False，删除该属性项。
 
 参数说明：
 
 - arg: str                - 属性名
-- value[bool, str]  - 属性值，有值的属性传入值，没有的传入bool
+- value: [bool, str]  - 属性值，有值的属性传入值，没有的传入 bool
+- ini_path: str         - ini 文件路径，为 None 则保存到默认 ini 文件
 
 返回： None
 
@@ -2594,6 +2627,7 @@ chrome 配置太复杂，所以把常用的配置写成简单的方法，调用
 参数说明：
 
 - on_off: bool  - 是否开启 headless 模式
+- ini_path: str  - ini 文件路径，为 None 则保存到默认 ini 文件
 
 返回： None
 
@@ -2606,6 +2640,7 @@ chrome 配置太复杂，所以把常用的配置写成简单的方法，调用
 参数说明：
 
 - on_off: bool  - 是否开启无图模式
+- ini_path: str  - ini 文件路径，为 None 则保存到默认 ini 文件
 
 返回： None
 
@@ -2618,6 +2653,7 @@ chrome 配置太复杂，所以把常用的配置写成简单的方法，调用
 参数说明：
 
 - on_off: bool  - 是否开启禁用 JS 模式
+- ini_path: str  - ini 文件路径，为 None 则保存到默认 ini 文件
 
 返回： None
 
@@ -2630,6 +2666,7 @@ chrome 配置太复杂，所以把常用的配置写成简单的方法，调用
 参数说明：
 
 - on_off: bool  - 是否开启静音模式
+- ini_path: str  - ini 文件路径，为 None 则保存到默认 ini 文件
 
 返回： None
 
@@ -2642,6 +2679,7 @@ chrome 配置太复杂，所以把常用的配置写成简单的方法，调用
 参数说明：
 
 - user_agent: str  - user_agent 值
+- ini_path: str        - ini 文件路径，为 None 则保存到默认 ini 文件
 
 返回： None
 
@@ -2654,6 +2692,7 @@ chrome 配置太复杂，所以把常用的配置写成简单的方法，调用
 参数说明：
 
 - proxy: str  - 代理值
+- ini_path: str  - ini 文件路径，为 None 则保存到默认 ini 文件
 
 返回： None