Youqu

这个版本中，我们成功在欧拉社区开源 **[src-openeuler](https://gitee.com/src-openeuler/youqu)** ，后续将以 `patch` 的方式持续在欧拉社区进行代码更新，希望欧拉系统上使用到 `YouQu` 的同学们能给我们反馈使用情况。

此外，重点对统计 `commit` 功能进行了优化和 `Bug` 修复，此功能目前还处于内部灰度阶段，未来有希望成为 `YouQu` 的另一个亮点，能自动分析统计每次提交中包含的用例和方法的增删改的数据，数据汇报者统计者的利器。

**New 🌟**

- 新增 `skipif_not_xxx` 条件跳过逻辑；[PR 68](https://github.com/linuxdeepin/youqu/pull/68) by [DarkLii](https://github.com/DarkLii)
- 对生成的 `JSON` 报告的路径、文件名称、报告内容进行了重新规划，将在下一个版本开发并发布；[mikigo](https://github.com/mikigo)
- 文档更新：指南/框架必备/执行管理器，新增用例驱动方式章节，用以集中说明 `YouQu` 支持的驱动方式。[mikigo](https://github.com/mikigo)
- `YouQu` 插件 `image-center` 更新：支持 `Windows` 和 `MacOS`，图片入参支持多种图片格式，并兼容不带文件后缀名入参方式。[CCrazyPeter](https://github.com/CCrazyPeter)

**Fix 🐛**

- 修复统计 `commit` 数据中修复方法数量错误的问题；[mikigo](https://github.com/mikigo)
- 修改 `JSON` 报告计算逻辑：[mikigo](https://github.com/mikigo)

- 用例总数 = 通过数 + 失败数 （剔除跳过数）

- 失败数：剔除跳过数

- 跳过数：跳过用例数

- 通过率 = 通过数 / 用例总数
- 修复 `env.sh` 提示找不到 `youqu-shell-rm` 的问题，将删除虚拟环境的命令修改为：`youqu-rm`；[mikigo](https://github.com/mikigo)
- 修复统计 `commit` 功能 `enddate` 报错的问题；[mikigo](https://github.com/mikigo)

近期，`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 🌟**

- `JSON` 报告功能优化

**`run` 模式下：**

- `/report/json/detail_report.json` 包含每条 `py` 脚本的结果；
- `/report/json/summarize.json` 根据 `detail_report.json` 计算的汇总数据；

**`remote` 模式下：**

- 收集远程测试机上所有的 `/report/json/${timestr}_remote/detail_report_${IP}.json` ；
- 收集远程测试机上所有的 `/report/json/${timestr}_remote/summarize_${IP}.json`；
- 负载均衡驱动模式下自动汇总 `summarize` 数据：`/report/json/${timestr}_remote/summarize.json`；

- `remote` 模式新增参数：`git_url`、`git_user`、`git_password`、`branch`、`depth` 用以控制拉取 `git` 仓库代码；

- 由于 [letmego](https://linuxdeepin.github.io/letmego/) 方案使用场景较少，默认环境中移除此模块，子项目需要时通过新增依赖机制进行安装；

**Fix 🐛**

- 修复测试单驱动执行报错的问题；

**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)