更新 README,添加完整功能说明和使用指南
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
136
README.md
136
README.md
@@ -1,64 +1,104 @@
|
|||||||
# yidaima - Umi-OCR 桌面自动化脚本
|
# yidaima - 自动化工具集
|
||||||
|
|
||||||
|
综合自动化工具,支持微信公众号文章发布、项目截图、文章管理等功能。
|
||||||
|
|
||||||
|
## 功能模块
|
||||||
|
|
||||||
|
### 1. 发布微信公众号
|
||||||
|
- Markdown 编辑器,支持代码高亮和主题切换
|
||||||
|
- 一键转换为微信适配格式
|
||||||
|
- 支持富文本编辑和实时预览
|
||||||
|
|
||||||
|
### 2. 文章发布管理
|
||||||
|
- 文章列表展示(分页、搜索)
|
||||||
|
- 文章状态管理
|
||||||
|
- 数据库持久化存储
|
||||||
|
|
||||||
|
### 3. 项目运行截图
|
||||||
|
- 自动化截取项目运行界面
|
||||||
|
- 支持配置截图区域和参数
|
||||||
|
- 适用于项目文档和演示
|
||||||
|
|
||||||
|
### 4. 参数设置
|
||||||
|
- 数据库连接配置
|
||||||
|
- Umi-OCR 配置
|
||||||
|
- 截图参数配置
|
||||||
|
|
||||||
## 依赖与准备
|
## 依赖与准备
|
||||||
|
|
||||||
- 启动 **Umi-OCR** 并开启 **HTTP 服务**(默认 `http://127.0.0.1:1224/api/ocr`)
|
- Python 3.8+
|
||||||
- 安装依赖:
|
- MySQL 数据库
|
||||||
|
- **Umi-OCR**(用于 OCR 功能,需开启 HTTP 服务,默认 `http://127.0.0.1:1224/api/ocr`)
|
||||||
```bash
|
- **Playwright**(用于浏览器自动化,可选)
|
||||||
python -m pip install -r requirements.txt
|
|
||||||
```
|
|
||||||
|
|
||||||
## 快速验证
|
|
||||||
|
|
||||||
- 等待某个文字出现在屏幕上:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
python main.py --wait "确定" --timeout 20
|
|
||||||
```
|
|
||||||
|
|
||||||
- 点击某个文字:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
python main.py --click "确定"
|
|
||||||
```
|
|
||||||
|
|
||||||
## 局部区域 OCR(更快)
|
|
||||||
|
|
||||||
指定区域格式为 `left,top,width,height`(屏幕坐标):
|
|
||||||
|
|
||||||
```bash
|
|
||||||
python main.py --wait "登录" --region 100,100,800,600
|
|
||||||
```
|
|
||||||
|
|
||||||
## 配置
|
|
||||||
|
|
||||||
编辑 `config.yaml`:
|
|
||||||
|
|
||||||
- `umi_ocr.url`: Umi-OCR API 地址
|
|
||||||
- `screenshot.default_region`: 默认 OCR 区域(null 为全屏)
|
|
||||||
- `screenshot.prefer_mss`: 优先使用 mss 截图(更快),失败会自动回退
|
|
||||||
|
|
||||||
## Playwright 示例:百度搜索并截图
|
|
||||||
|
|
||||||
对应文档 `docs/baidu.md`,脚本入口:`baidu_playwright.py`。
|
|
||||||
|
|
||||||
安装依赖:
|
安装依赖:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
python -m pip install -r requirements.txt
|
python -m pip install -r requirements.txt
|
||||||
python -m playwright install chromium
|
python -m playwright install chromium # 仅浏览器自动化需要
|
||||||
```
|
```
|
||||||
|
|
||||||
运行(可见浏览器):
|
## 快速开始
|
||||||
|
|
||||||
|
### 启动 GUI
|
||||||
|
|
||||||
|
```bash
|
||||||
|
python gui.py
|
||||||
|
```
|
||||||
|
|
||||||
|
### 命令行模式
|
||||||
|
|
||||||
|
等待屏幕上出现文字:
|
||||||
|
```bash
|
||||||
|
python main.py --wait "确定" --timeout 20
|
||||||
|
```
|
||||||
|
|
||||||
|
点击屏幕上文字:
|
||||||
|
```bash
|
||||||
|
python main.py --click "确定"
|
||||||
|
```
|
||||||
|
|
||||||
|
指定区域 OCR(格式:`left,top,width,height`):
|
||||||
|
```bash
|
||||||
|
python main.py --wait "登录" --region 100,100,800,600
|
||||||
|
```
|
||||||
|
|
||||||
|
### 百度搜索示例(Playwright)
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
python baidu_playwright.py --keyword "java教程"
|
python baidu_playwright.py --keyword "java教程"
|
||||||
```
|
# 无头模式
|
||||||
|
|
||||||
无头模式:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
python baidu_playwright.py --keyword "java教程" --headless
|
python baidu_playwright.py --keyword "java教程" --headless
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## 配置
|
||||||
|
|
||||||
|
编辑 `config.yaml` 或通过 GUI 设置:
|
||||||
|
|
||||||
|
- `database`: MySQL 数据库连接配置
|
||||||
|
- `umi_ocr.url`: Umi-OCR API 地址
|
||||||
|
- `screenshot.default_region`: 默认截图区域(null 为全屏)
|
||||||
|
- `screenshot.prefer_mss`: 优先使用 mss 截图(更快),失败自动回退
|
||||||
|
|
||||||
|
## 项目结构
|
||||||
|
|
||||||
|
```
|
||||||
|
├── gui.py # 主程序 GUI
|
||||||
|
├── markdown_editor.py # Markdown 编辑器
|
||||||
|
├── editor_gui.py # 编辑器界面
|
||||||
|
├── md_to_wechat.py # Markdown 转微信格式
|
||||||
|
├── wechat_publisher.py # 微信公众号发布
|
||||||
|
├── project_screenshot.py # 项目截图
|
||||||
|
├── db_manager.py # 数据库管理
|
||||||
|
├── config_loader.py # 配置加载
|
||||||
|
├── step1.py, step2.py # 自动化步骤
|
||||||
|
└── config.yaml # 配置文件
|
||||||
|
```
|
||||||
|
|
||||||
|
## 技术栈
|
||||||
|
|
||||||
|
- **GUI**: Tkinter
|
||||||
|
- **数据库**: MySQL
|
||||||
|
- **OCR**: Umi-OCR
|
||||||
|
- **浏览器自动化**: Playwright
|
||||||
|
- **配置**: YAML
|
||||||
|
|||||||
Reference in New Issue
Block a user