docs: rewrite README in Chinese-first style and add compose runtime

Author: Yifanliu-scut

Makefile

@@ -1,4 +1,4 @@
-.PHONY: sync lint format test check run run-cli docker-build
+.PHONY: sync lint format test check run run-cli docker-build docker-run
 
 sync:
 	uv sync
@@ -22,3 +22,6 @@ run-cli:
 
 docker-build:
 	docker build -t argus-dual-agent:latest .
+
+docker-run:
+	docker compose run --rm argus

README.md

@@ -2,141 +2,134 @@
 
 # Argus Dual-Agent System
 
-Production-oriented dual-agent framework for desktop and code automation.
+面向复杂自动化任务的双 Agent 执行框架
 
 [![Python](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/)
-[![Architecture](https://img.shields.io/badge/architecture-Dual%20Agent-black.svg)](#system-architecture)
+[![Architecture](https://img.shields.io/badge/architecture-Dual%20Agent-black.svg)](#系统架构)
 [![Runtime](https://img.shields.io/badge/runtime-LiteLLM%20%2B%20Tools-5A45FF.svg)](https://github.com/BerriAI/litellm)
 [![CI](https://img.shields.io/badge/CI-GitHub_Actions-2088FF.svg)](https://github.com/sudo-yf/hackathon2512/actions)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 
 </div>
 
-## Overview
+## 项目简介
 
-Argus 是一个双 Agent 协同自动化系统：`GUI Agent` 负责界面理解与桌面动作，`Code Agent` 负责逻辑分析与代码执行，`Smart Router` 根据任务语义、执行反馈与失败信号进行动态路由与切换。
+Argus 通过 `GUI Agent` 与 `Code Agent` 双路协同执行任务：
 
-该项目面向阿里 Agent 挑战赛与 Gemini Hackathon 场景，支持 GUI 形态与 CLI 形态双运行模式。
+- `GUI Agent` 负责屏幕理解、界面操作与流程执行
+- `Code Agent` 负责代码分析、脚本执行与逻辑推理
+- `Smart Router` 根据任务类型、执行结果与失败信号做动态路由与兜底切换
 
-## Table of Contents
+项目面向阿里 Agent 挑战赛与 Gemini Hackathon 场景，支持 GUI 与 CLI 双运行模式。
 
-- [Overview](#overview)
-- [Core Capabilities](#core-capabilities)
-- [System Architecture](#system-architecture)
-- [Quick Start](#quick-start)
-- [Runtime Modes](#runtime-modes)
-- [Environment Variables](#environment-variables)
-- [Project Structure](#project-structure)
-- [Design References](#design-references)
-
-## Core Capabilities
+## 核心能力
 
 - Dual-Agent 协同执行（GUI + Code）
-- 自动路由与失败兜底切换
-- Tool Calling 工具体系（screen/window/mouse/keyboard/code）
-- 会话记忆（Agent Memory）
-- GUI 可视化运行与 CLI 任务批处理
-- 标准化工程能力（uv / Docker / lint / test / CI）
+- 自动路由与失败回退策略
+- Tool Calling 工具体系（screen / window / mouse / keyboard / code）
+- Agent Memory 上下文记忆
+- GUI 可视化模式 + CLI 批处理模式
+- 标准工程化能力（uv / Docker / lint / test / CI）
 
-## System Architecture
+## 系统架构
 
 ```mermaid
 graph TD
-    User[User Task] --> Router[Smart Router]
-    Router -->|GUI-first tasks| GUIAgent[GUI Agent]
-    Router -->|Code-first tasks| CodeAgent[Code Agent]
+    User[用户任务] --> Router[Smart Router]
+    Router -->|GUI任务| GUIAgent[GUI Agent]
+    Router -->|Code任务| CodeAgent[Code Agent]
     GUIAgent --> Tools[Tool Runtime]
     CodeAgent --> Tools
     Tools --> Desktop[Desktop APIs]
     Tools --> Exec[Code Execution]
     GUIAgent --> Memory[Agent Memory]
     CodeAgent --> Memory
-    Router --> Fallback[Fallback Policy]
+    Router --> Fallback[Fallback Strategy]
 ```
 
-## Quick Start
+## 快速开始
 
-### 1. Install Dependencies
+### 1. 安装依赖
 
 ```bash
 uv sync
+cp .env.example .env
 ```
 
-### 2. Configure Model Endpoints
+### 2. 配置模型环境变量
 
-配置以下环境变量后运行（见下方变量表）：
+至少配置以下变量：
 
 - `GUIAgent_MODEL`
-- `GUIAgent_API_BASE`
 - `GUIAgent_API_KEY`
 - `CodeAgent_MODEL`
-- `CodeAgent_API_BASE`
 - `CodeAgent_API_KEY`
 
-### 3. Run
+可选：
+
+- `GUIAgent_API_BASE`
+- `CodeAgent_API_BASE`
 
-GUI 模式（无参数）：
+### 3. 运行方式
+
+GUI 模式：
 
 ```bash
 uv run python main.py
 ```
 
-CLI 模式（有参数）：
+CLI 模式：
 
 ```bash
 uv run python main.py --task "打开浏览器并搜索 GitHub"
 ```
 
-强制使用某个 Agent：
+强制指定 Agent：
 
 ```bash
 uv run python main.py --task "分析当前目录代码结构" --force code
 ```
 
-### 4. Quality Gates
+### 4. 质量检查
 
 ```bash
 make lint
 make test
 make check
 ```
 
-## Runtime Modes
-
-| Mode | Command | Target |
-|---|---|---|
-| GUI | `uv run python main.py` | Windows GUI 自动化 |
-| CLI | `uv run python main.py --task "..."` | 跨平台任务编排/验证 |
+## 容器部署
 
-## Environment Variables
+构建镜像：
 
-| Variable | Required | Description |
-|---|---|---|
-| `GUIAgent_MODEL` | Yes | GUI Agent 使用的模型名 |
-| `GUIAgent_API_BASE` | No | GUI Agent API Base URL |
-| `GUIAgent_API_KEY` | Yes | GUI Agent API Key |
-| `CodeAgent_MODEL` | Yes | Code Agent 使用的模型名 |
-| `CodeAgent_API_BASE` | No | Code Agent API Base URL |
-| `CodeAgent_API_KEY` | Yes | Code Agent API Key |
+```bash
+make docker-build
+```
 
-## Docker (CLI)
+运行容器（CLI 示例）：
 
 ```bash
-docker build -t argus-dual-agent:latest .
+make docker-run
 ```
 
+或 Compose：
+
 ```bash
-docker run --rm -it \
-  -e GUIAgent_MODEL=... \
-  -e GUIAgent_API_BASE=... \
-  -e GUIAgent_API_KEY=... \
-  -e CodeAgent_MODEL=... \
-  -e CodeAgent_API_BASE=... \
-  -e CodeAgent_API_KEY=... \
-  argus-dual-agent:latest
+docker compose run --rm argus
 ```
 
-## Project Structure
+## 环境变量
+
+| 变量名 | 必填 | 说明 |
+|---|---|---|
+| `GUIAgent_MODEL` | 是 | GUI Agent 模型名 |
+| `GUIAgent_API_BASE` | 否 | GUI Agent API Base |
+| `GUIAgent_API_KEY` | 是 | GUI Agent API Key |
+| `CodeAgent_MODEL` | 是 | Code Agent 模型名 |
+| `CodeAgent_API_BASE` | 否 | Code Agent API Base |
+| `CodeAgent_API_KEY` | 是 | Code Agent API Key |
+
+## 目录结构
 
 ```text
 hackathon2512/
@@ -150,12 +143,13 @@ hackathon2512/
 │   └── ui/
 ├── tests/
 ├── Dockerfile
+├── docker-compose.yml
 ├── Makefile
 ├── pyproject.toml
 └── LICENSE
 ```
 
-## Design References
+## 参考项目
 
 - [AutoGen](https://github.com/microsoft/autogen)
 - [LangGraph](https://github.com/langchain-ai/langgraph)

docker-compose.yml

@@ -0,0 +1,14 @@
+version: "3.9"
+
+services:
+  argus:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    image: argus-dual-agent:latest
+    container_name: argus-dual-agent
+    env_file:
+      - .env
+    volumes:
+      - ./:/app
+    command: ["uv", "run", "python", "main.py", "--task", "输出当前环境检查结果"]