From 957e0cb097ffbc7c16c4d773ed76b634af7a590c Mon Sep 17 00:00:00 2001 From: wangqifan Date: Sun, 10 Aug 2025 11:47:23 +0800 Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=20README.md=EF=BC=8C?= =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E6=93=8D=E4=BD=9C=E6=8C=87=E5=8D=97=E9=83=A8?= =?UTF-8?q?=E5=88=86=E5=B9=B6=E9=93=BE=E6=8E=A5=E5=88=B0=E9=A1=B9=E7=9B=AE?= =?UTF-8?q?=E6=93=8D=E4=BD=9C=E6=89=8B=E5=86=8C=E3=80=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 4 ++++ operate.md | 34 ++++++++++++++++++++++++++++++++++ 2 files changed, 38 insertions(+) create mode 100644 operate.md 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. 脚本将会自动接管在步骤一中打开的浏览器，并执行后续操作。请观察命令行中的输出信息以了解程序运行状态。