Youqu

近期，`YouQu` 自动化测试框架迎来了一系列令人振奋的更新，这些更新不仅提升了框架的性能和稳定性，也拓展了其功能和适用范围。通过引入 `OCR` 服务集群化部署和模型 `v4`，我们显著提高了文本识别的准确性和效率。新增的链式调用函数接口使操作更加直观和便捷。

在功能创新方面，我们推出了 `Web UI` 自动化测试功能和远程交互式控制功能，为自动化测试提供了更加丰富和灵活的手段。同时，我们还增强了报告的功能，新增了生成的` json` 结果以 `py` 维度统计，为测试数据的分析和解读提供了更多维度。

平台兼容适配性方面，我们对 `openEuler` 系统完成了适配，为后续开源到 `openEuler` 社区做好准备。

在问题修复方面，我们针对用户反馈的多个问题进行了积极的调查和解决，包括报告生成时的错误处理、远程调用的稳定性和兼容性等问题，这些修复进一步提升了用户体验，确保了框架的稳定性和可靠性。

总的来说，这一系列的更新标志着 `YouQu` 自动化测试框架在便捷性和稳定性方面迈出了重要的一步，我们坚信这些更新将极大地提升开发者和测试人员的效率，推动自动化测试技术向前发展。

**New 🌟**

- `OCR` 服务性能优化，使用 OCR 服务集群化部署，框架自动做负载均衡，同时启用 `OCR` 识别模型 `v4`，进一步提高识别稳定性和准确性。[mikigo](https://github.com/mikigo)

- YouQu OCR 新增支持链式调用函数接口，使用更方便更符合语义，原函数接口使用方法不变以保持兼容性。[mikigo](https://github.com/mikigo)

python
from src import OCR

新的函数接口ocrx，支持链式调用
OCR.ocrx("确定").click()
OCR.ocrx("确定").center()
原函数接口ocr，返回坐标
OCR.ocr("确定")


- 完成 `openEuler` 系统适配。[mikigo](https://github.com/mikigo)

**Fix 🐛**

- 修复 `json` 报告失败数量没有剔除跳过数量的问题。[mikigo](https://github.com/mikigo)
- 修复内网文档不能加载 `favicon` 的问题。[mikigo](https://github.com/mikigo)
- 修复远程调用时，调用函数同时传入可变参数和默认参数，远端无法解析默认参数的问题。[mikigo](https://github.com/mikigo)

**New 🌟**

- 文档新增 `指南/框架必备/Ruff代码检查` 章节；[mikigo](https://github.com/mikigo)

**Fix 🐛**

- 修复生成测试报告阶段，机器密码不对时报错；[mikigo](https://github.com/mikigo)
- 文档界面UI调整；[mikigo](https://github.com/mikigo)
- 修改 HTML 报告中用例总数为包含跳过用例数量；[mikigo](https://github.com/mikigo)

**New 🌟**

- 将项目根目录下 `_env_base.sh` 移动到 `setting` 目录下，简化项目根目录下文件目录结构；[mikigo](https://github.com/mikigo)
- 将项目根目录下 `pylint.sh` 移动到 `src/utils` 目录下，YouQu 目前已经启用了更先进的 Ruff，Pylint 后续默认不再使用，但考虑到有些同学仍然有使用 Pylint 的需求，因此暂留。[mikigo](https://github.com/mikigo)
- 添加 `CODE_OF_CONDUCT.md` 。[mikigo](https://github.com/mikigo)
- 在线文档增加团队页。[mikigo](https://github.com/mikigo)
- 报告增加 `PMS` 用例维度统计数据；[mikigo](https://github.com/mikigo)
- 将生成的 `json` 用例结果以 `py` 维度统计；[mikigo](https://github.com/mikigo)
- 整合 `env.sh` 和 `env_dev.sh` 为一个脚本，通过选项来控制安装逻辑；[mikigo](https://github.com/mikigo)

**Fix 🐛**

- 修复远程调用返回 `None` 报错的问题；
- 修复无法连续多次调用对远程终端的键鼠操作；[issues 64](https://github.com/linuxdeepin/youqu/issues/64) Fix by [mikigo](https://github.com/mikigo)

**New 🌟**

- YouQu 在线文档 **3.0** 版本上线，重新整理了章节结构和排版，界面UI也进行了优化调整。[mikigo](https://github.com/mikigo)

- **新增尝鲜版 `Web UI` 自动化测试功能**：[mikigo](https://github.com/mikigo)
- 框架为 `Web UI`自动化测试提供一个 `Fixture` 对象：`page`，它默认使用系统自带的浏览器进行测试，如果需要指定其他第三方的浏览器，提供配置项可以指定浏览器对应的路径。
- 还提供一个 `Fixture` 对象：`native_page`，它使用 `playwright` 最新的 `chromium` 浏览器进行测试。
- 重写了 `Playwright` 的断言语句，以保持统一的断言语句风格。

- **新增远程控制功能**，在用例步骤中操作远程机器，且远程操作方法实现了编辑器代码补全。[mikigo](https://github.com/mikigo)
- 新增命令行入参或配置文件传入远程机器的 `user`、`ip`、`password` 信息，用例中通过框架提供的 `Fixture` 对象：`slaves` 获取数据，供用例层使用。[mikigo](https://github.com/mikigo)
- 分辨率检查功能支持多组分辨率；[mikigo](https://github.com/mikigo)
- `env_dev.sh` 初步适配欧拉系统；[mikigo](https://github.com/mikigo)

**Fix 🐛**

- 修复远程调用报错后，本地再次调用报属性找不到的问题； [mikigo](https://github.com/mikigo)

- 修复使用远程执行命令时，返回值为 `None`； [mikigo](https://github.com/mikigo)
- 修复实例化远程类时，传入 `transfer_appname="xxx"` 参数后，远程路径错误的问题； [mikigo](https://github.com/mikigo)
- 修复 `CmdCtl.sudo_run_cmd("xxx")` 方法没有返回值；[PR 62](https://github.com/linuxdeepin/youqu/pull/62) by [DarkLii](https://github.com/DarkLii)
- 修复从 PMS 同步标签到 CSV 文件用例列表不完整的问题；[mikigo](https://github.com/mikigo)

**New 🌟**

- `env.sh` 增加 `-p` 选项用于传递系统密码；[mikigo](https://github.com/mikigo)
- 自动输入日志增加以 `Page` 结尾的 `class` 名称，以适应 `Web UI` 类自动化；[mikigo](https://github.com/mikigo)

**Fix 🐛**

- 修复统计用例和方法数量功能在子项目为 `gitlab` 时，无法获取到 `commit` 详细记录的问题；[mikigo](https://github.com/mikigo)
- 修复基于 `Python` 标准库`difflib` 做 `commit` 文件对比时，输出原始数据错误的问题；[mikigo](https://github.com/mikigo)
- 修复域管环境下，写日志文件报权限不够的问题；[mikigo](https://github.com/mikigo)

**New 🌟**

- `startapp` 初始化应用新增 2 条示例用例和一个方法；[issues 46](https://github.com/linuxdeepin/youqu/issues/46) by [mikigo](https://github.com/mikigo)
- 新增子命令 `youqu manage.py git` 可用于拉取 `git` 仓库代码到 `apps` 目录下，支持统计分析仓库新增修复的用例或方法数量；[issues 40](https://github.com/linuxdeepin/youqu/issues/40) by [mikigo](https://github.com/mikigo)
- 更新[贡献者名单](https://linuxdeepin.github.io/youqu/#_4)；

**Fix 🐛**

- 修复 `env.sh` 中 Python 虚拟环境的解释器版本没有动态获取系统中的 Python 版本的问题；[PR 51](https://github.com/linuxdeepin/youqu/pull/51) by [saifeiLee](https://github.com/saifeiLee)
- 修复 `wayland` 环境下 `XAUTHORITY` 环境变量缺失问题；[PR 55](https://github.com/linuxdeepin/youqu/pull/55) by [DarkLii](https://github.com/DarkLii)
- `assert_ocr_exist` 新增 `any` 匹配模式，即任意一个匹配成功则通过；[PR 55](https://github.com/linuxdeepin/youqu/pull/55) by [DarkLii](https://github.com/DarkLii)