diff --git a/.github/workflows/validate-yamls.yml b/.github/workflows/validate-yamls.yml
index cde6d64b4..87c103862 100644
--- a/.github/workflows/validate-yamls.yml
+++ b/.github/workflows/validate-yamls.yml
@@ -37,6 +37,11 @@ jobs:
         uses: astral-sh/setup-uv@v4
         with:
           enable-cache: true
+
+      - name: Install system dependencies for pycairo
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libcairo2-dev pkg-config
       
       - name: Cache uv dependencies
         uses: actions/cache@v4
diff --git a/README-zh.md b/README-zh.md
index 8f2d53cf3..4f3dc76a0 100755
--- a/README-zh.md
+++ b/README-zh.md
@@ -120,6 +120,17 @@ ChatDev 已从一个专门的软件开发多智能体系统演变为一个全面
 
 ### ⚡️ 运行应用
 
+#### 使用 Makefile（推荐）
+
+**同时启动后端与前端**：
+```bash
+make dev
+```
+
+> 然后访问 Web 控制台：**[http://localhost:5173](http://localhost:5173)**。
+
+#### 手动命令
+
 1.  **启动后端**：
     ```bash
     # 从项目根目录运行
@@ -140,6 +151,25 @@ ChatDev 已从一个专门的软件开发多智能体系统演变为一个全面
     > * **后端**：启动时指定 `--port 6401`
     > * **前端**：设置 `VITE_API_BASE_URL=http://localhost:6401`
 
+#### 常用命令
+
+*   **帮助命令**：
+    ```bash
+    make help
+    ```
+
+*   **同步 YAML 工作流到前端**：
+    ```bash
+    make sync
+    ```
+    将 `yaml_instance/` 中的所有工作流文件上传到数据库。
+
+*   **校验所有 YAML 工作流**：
+    ```bash
+    make validate-yamls
+    ```
+    检查所有 YAML 文件的语法与 schema 错误。
+
 
 ### 🔑 配置
 
@@ -252,6 +282,7 @@ if result.final_message:
     <td align="center"><a href="https://github.com/shiowen"><img src="https://github.com/shiowen.png?size=100" width="64px;" alt=""/><br /><sub><b>shiowen</b></sub></a></td>
     <td align="center"><a href="https://github.com/kilo2127"><img src="https://github.com/kilo2127.png?size=100" width="64px;" alt=""/><br /><sub><b>kilo2127</b></sub></a></td>
     <td align="center"><a href="https://github.com/AckerlyLau"><img src="https://github.com/AckerlyLau.png?size=100" width="64px;" alt=""/><br /><sub><b>AckerlyLau</b></sub></a></td>
+    <td align="center"><a href="https://github.com/LaansDole"><img src="https://github.com/LaansDole.png?size=100" width="64px;" alt=""/><br /><sub><b>LaansDole</b></sub></a></td>
 </table>
 
 ## 🤝 致谢
diff --git a/README.md b/README.md
index 4a640606a..f9329855f 100644
--- a/README.md
+++ b/README.md
@@ -289,6 +289,7 @@ By contributing to DevAll, you'll be recognized in our **Contributors** list bel
     <td align="center"><a href="https://github.com/shiowen"><img src="https://github.com/shiowen.png?size=100" width="64px;" alt=""/><br /><sub><b>shiowen</b></sub></a></td>
     <td align="center"><a href="https://github.com/kilo2127"><img src="https://github.com/kilo2127.png?size=100" width="64px;" alt=""/><br /><sub><b>kilo2127</b></sub></a></td>
     <td align="center"><a href="https://github.com/AckerlyLau"><img src="https://github.com/AckerlyLau.png?size=100" width="64px;" alt=""/><br /><sub><b>AckerlyLau</b></sub></a></td>
+    <td align="center"><a href="https://github.com/LaansDole"><img src="https://github.com/LaansDole.png?size=100" width="64px;" alt=""/><br /><sub><b>LaansDole</b></sub></a></td>
 </table>
 
 ## 🤝 Acknowledgments