update docs

docs/.vitepress/config.mts

@@ -20,7 +20,7 @@ export default defineConfig({
         nav: [
             {text: '🏠 首页', link: '/index'},
             {text: '🧭 指南', link: '/指南/简介/YouQu3是什么'},
-            {text: '🏃‍ 实践', link: '/实践/方法开发'},
+            {text: '🏃‍ 实践', link: '/实践/简介'},
             {text: '🎵 规划', link: '/规划/YouQu3架构设计规划'},
             {text: '🔌 插件', link: '/插件/插件列表'},
         ],
@@ -78,8 +78,18 @@ export default defineConfig({
 
             ],
             "/实践/": [
-                {text: "方法开发", link: "/实践/方法开发"},
-                {text: "用例开发", link: "/实践/用例开发"},
+                {
+                    text: "从零开始构建自动化工程",
+                    collapsed: false,
+                    items: [
+                        {text: "简介", link: "/实践/简介"},
+                        {text: "工程创建", link: "/实践/工程创建"},
+                        {text: "配置模块", link: "/实践/配置模块"},
+                        {text: "方法开发", link: "/实践/方法开发"},
+                        {text: "用例开发", link: "/实践/用例开发"},
+                        {text: "依赖管理", link: "/实践/依赖管理"},
+                    ]
+                }
             ],
             "/规划/": [
                 {

docs/实践/依赖管理.md

@@ -0,0 +1 @@
+# 依赖管理

docs/实践/工程创建.md

@@ -0,0 +1 @@
+# 工程创建

docs/实践/方法开发.md

@@ -0,0 +1 @@
+# 方法开发

docs/实践/用例开发.md

@@ -0,0 +1 @@
+# 用例开发

docs/实践/简介.md

@@ -0,0 +1,15 @@
+# 从零开始构建自动化工程
+
+我们将指导如何基于 YouQu3 从零开始构建一个完成的自动化用例工程。
+
+按照以下章节：
+
+- [工程创建](./工程创建.md)：使用 YouQu3 官方提供的脚手架工具，快速创建一个自动化用例工程模板。
+
+- [配置模块](./配置模块.md)：介绍自动化用例工程配置模块如何管理配置。
+
+- [方法开发](./方法开发.md)：使用 PO 设计理念进行方法封装，方法类如何组织，提高可维护性。
+
+- [用例开发](./用例开发.md)：按照业务流程调用方法进行用例代码开发，Fixture 如何编写。
+
+- [依赖管理](./依赖管理.md)：如何管理自动化用例工程的依赖项。

docs/实践/配置模块.md

@@ -0,0 +1 @@
+# 配置模块

youqu3/cmd.py

@@ -1,3 +1,4 @@
+import os
 import subprocess
 import sys
 
@@ -106,6 +107,7 @@ def sudo_run(
             cls,
             command,
             password: str = None,
+            workdir: str = None,
             interrupt: bool = False,
             timeout: int = 25,
             print_log: bool = True,
@@ -114,8 +116,13 @@ def sudo_run(
     ):
         if password is None:
             password = setting.PASSWORD
+        wd = ""
+        if workdir:
+            if not os.path.exists(workdir):
+                raise FileNotFoundError
+            wd = f"cd {workdir} && "
         return cls.run(
-            f"echo '{password}' | sudo -S {command}",
+            f"{wd}echo '{password}' | sudo -S {command}",
             interrupt=interrupt,
             timeout=timeout,
             print_log=print_log,
@@ -127,7 +134,6 @@ def sudo_run(
         "grep",
         "pytest",
         "python",
-        "tee",
         "ffmpeg",
         "youqu",
     )