更新 README.md,添加操作指南部分并链接到项目操作手册。

This commit is contained in:
wangqifan 2025-08-10 11:47:23 +08:00
parent eda6d4ad66
commit 957e0cb097
2 changed files with 38 additions and 0 deletions

View File

@ -2,6 +2,10 @@
这是一个使用 Python 和 Selenium 的模块化项目架构,支持通过命令行参数调用不同的业务逻辑,并支持两种方式启动和控制 Google Chrome 浏览器。 这是一个使用 Python 和 Selenium 的模块化项目架构,支持通过命令行参数调用不同的业务逻辑,并支持两种方式启动和控制 Google Chrome 浏览器。
## 操作指南
详细的操作步骤请参考 **[项目操作手册](operate.md)**。
## 文件结构 ## 文件结构
``` ```

34
operate.md Normal file
View File

@ -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. 脚本将会自动接管在步骤一中打开的浏览器,并执行后续操作。请观察命令行中的输出信息以了解程序运行状态。