diff --git a/README.md b/README.md index a78f8c9..cc9e8e5 100644 --- a/README.md +++ b/README.md @@ -2,6 +2,10 @@ 这是一个使用 Python 和 Selenium 的模块化项目架构,支持通过命令行参数调用不同的业务逻辑,并支持两种方式启动和控制 Google Chrome 浏览器。 +## 操作指南 + +详细的操作步骤请参考 **[项目操作手册](operate.md)**。 + ## 文件结构 ``` diff --git a/operate.md b/operate.md new file mode 100644 index 0000000..9bc70ec --- /dev/null +++ b/operate.md @@ -0,0 +1,34 @@ +# 项目操作手册 + +## 1、or钱包地址转换 + +### 步骤一:启动调试模式的Chrome浏览器 + +程序需要通过远程调试端口连接并控制一个独立的Chrome浏览器实例。 + +1. 首先,请确保您已完全关闭所有正在运行的Chrome浏览器窗口。 +2. 打开您系统的命令行工具(例如,在Windows上是 `CMD` 或 `PowerShell`)。 +3. 执行以下命令来启动一个带有远程调试端口的Chrome浏览器: + ```shell + chrome.exe --remote-debugging-port=9222 --user-data-dir="D:\chrome-debug-profile" + ``` + **重要提示:** + * 如果 `chrome.exe` 不在您的系统环境变量中,您需要提供完整的路径,例如 `"C:\Program Files\Google\Chrome\Application\chrome.exe"`。 + * `--user-data-dir` 参数会指定一个独立的用户配置文件夹。这可以防止程序与您日常使用的Chrome浏览器产生冲突。您可以将其路径设置为任意一个您方便管理的空文件夹。 + * 执行此命令后,会打开一个新的Chrome浏览器窗口,**在程序运行期间请勿关闭此窗口**。 + +### 步骤二:修改地址数据文件 + +1. 在项目根目录下,找到 `data` 文件夹。 +2. 打开 `o-address.csv` 文件。此文件用于存放需要进行转换的OR地址。 +3. 根据您的需求修改文件内容,每行一个地址。您可以参考 `data/o-address-sample.csv` 文件中的格式。 + +### 步骤三:运行主程序 + +1. 确保您的计算机已经安装了Python环境以及本项目所需的所有依赖包(可以通过 `pip install -r requirements.txt` 命令安装)。 +2. 打开一个新的命令行工具,并确保当前路径位于项目根目录下。 +3. 执行以下命令启动自动化脚本: + ```shell + python main.py --module or-address --debug + ``` +4. 脚本将会自动接管在步骤一中打开的浏览器,并执行后续操作。请观察命令行中的输出信息以了解程序运行状态。