From b8cf6bd36e3da52910339644cc5386dd8416407a Mon Sep 17 00:00:00 2001
From: mikigo <huangmingqiang@uniontech.com>
Date: Tue, 31 Oct 2023 16:23:47 +0800
Subject: [PATCH] docs: update readme.md

Description:

Log:
---
 README.md              |  2 +-
 conftest.py            |  2 --
 docs/AT开发规范.md | 19 ++++++++++++-------
 src/button_center.py   |  1 +
 4 files changed, 14 insertions(+), 10 deletions(-)

diff --git a/README.md b/README.md
index e8bf354..4cc890b 100644
--- a/README.md
+++ b/README.md
@@ -26,7 +26,7 @@
 
 ---
 
-有趣（YouQu）是深度科技设计和开发的一个自动化测试基础框架，采用结构分层的设计理念，支持多元化元素定位和断言、用例标签化管理和执行、强大的日志和报告输出等特色功能，同时完美兼容X11、Wayland显示协议，环境部署简单，操作易上手。
+有趣（YouQu）是深度科技开源的一个用于 `Deepin/UOS` 操作系统（Linux）的自动化测试框架，采用结构分层的设计理念，支持多元化元素定位和断言、用例标签化管理和执行、强大的日志和报告输出等特色功能，同时完美兼容X11、Wayland显示协议，环境部署简单，操作易上手。
 
 ### 爱上 “有趣” 的 18 个理由
 
diff --git a/conftest.py b/conftest.py
index cdbf7ad..94a7e87 100644
--- a/conftest.py
+++ b/conftest.py
@@ -196,11 +196,9 @@ def pytest_configure(config):
     """pytest_configure"""
     if hasattr(config, "workerinput"):
         return  # xdist worker
-    # 获取终端报告器插件
     reporter = config.pluginmanager.getplugin("terminalreporter")
     if config.option.duringfail and reporter:
         custom_reporter = DuringfailingTerminalReporter(reporter)
-        # 替换成我们自己的报告插件
         config.pluginmanager.unregister(custom_reporter)
         config.pluginmanager.register(custom_reporter)
 
diff --git a/docs/AT开发规范.md b/docs/AT开发规范.md
index 6a36e6e..7dda469 100644
--- a/docs/AT开发规范.md
+++ b/docs/AT开发规范.md
@@ -110,9 +110,8 @@ autotest-basic-frame = 0.9.5
 
 ## 1. 基础框架
 
-- 自动化测试基础框架仓库：https://gerrit.uniontech.com/admin/repos/autotest-basic-frame
+- 自动化测试基础框架仓库：https://github.com/linuxdeepin/deepin-autotest-framework
 
-  基础框架不允许匿名访问，如果你登录 `gerrit` 之后仍然无法访问以上链接，则需要申请访问权限；
 
 ## 2. 应用仓库
 
@@ -206,6 +205,8 @@ class TestMusic(BaseCase):
 - 一个类里面可以有多个用例函数，这取决这条用例有多少个测试点：
 
   ```python
+  # test_music_679537.py
+  
   class TestMusic(BaseCase):
       """音乐用例"""
       
@@ -234,10 +235,12 @@ class TestMusic(BaseCase):
   举例，`PMS` 用例：
 
 ![](https://pic.imgdb.cn/item/64f054c8661c6c8e54ff4c71.png)
-  
+
   直接选中用例内容，复制下来，然后粘贴到自动化用例脚本中：
-  
+
   ```python
+  # test_music_679537.py
+  
   class TestMusic(BaseCase):
       """音乐用例"""
   
@@ -251,10 +254,12 @@ class TestMusic(BaseCase):
           # 双击任意演唱者封面
           # 进入演唱者详情页面
   ```
-  
+
   上例中井号注释部分就是直接从 `PMS` 上复制过来的，在此基础上写用例：
-  
+
   ```python
+  # test_music_679537.py
+  
   class TestMusic(BaseCase):
       """音乐用例"""
       
@@ -272,7 +277,7 @@ class TestMusic(BaseCase):
           # 进入演唱者详情页面
           self.assert_xxx
   ```
-  
+
   你看，非常清楚每一步在做什么，重点是省去了写注释的时间，真的炒鸡方便。
 
 - 不写 `if __name__ == '__main__':`，不写多余的代码；
diff --git a/src/button_center.py b/src/button_center.py
index 4ae00a3..158c9eb 100644
--- a/src/button_center.py
+++ b/src/button_center.py
@@ -74,6 +74,7 @@ class ButtonCenter:
             dbus.Interface(proxy_object, "org.kde.KWin").WindowMove()
             sleep(self.pause)
             ShortCut.esc()
+            # Wayland下使用窗管提供的接口获取窗口信息
             return WaylandWindowINfo().window_info()
         return None