Merge pull request #267 from microsoft/vyokky/dev

update bitex and shield for paper

Author: vyokky

README.md

@@ -18,6 +18,7 @@
 
 <br/>
 
+[![arxiv](https://img.shields.io/badge/Paper-arXiv:2511.11332-b31b1b.svg)](https://arxiv.org/abs/2511.11332)&ensp;
 [![arxiv](https://img.shields.io/badge/Paper-arXiv:2504.14603-b31b1b.svg)](https://arxiv.org/abs/2504.14603)&ensp;
 ![Python Version](https://img.shields.io/badge/Python-3776AB?&logo=python&logoColor=white-blue&label=3.10%20%7C%203.11)&ensp;
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)&ensp;
@@ -446,7 +447,7 @@ API_DEPLOYMENT_ID: "your-deployment-id"
 - 🎯 **Heterogeneous Orchestration**: Safe, asynchronous execution with capability-based device matching
 - 🔌 **Unified AIP Protocol**: WebSocket-based secure agent coordination with fault tolerance
 - 🛠️ **MCP-Empowered Agent Framework**: Template-driven toolkit for rapid device agent development
-- 📄 **Research Paper**: [UFO³: Weaving the Digital Agent Galaxy](https://arxiv.org/abs/[TBD])
+- 📄 **Research Paper**: [UFO³: Weaving the Digital Agent Galaxy](https://arxiv.org/abs/2511.11332)
 
 **Key Features:**
 - First multi-device orchestration framework for GUI agents
@@ -474,11 +475,10 @@ If you use UFO³ Galaxy or UFO² in your research, please cite the relevant pape
 ### UFO³ Galaxy Framework (2025)
 ```bibtex
 @article{zhang2025ufo3,
-  title   = {{UFO³: Weaving the Digital Agent Galaxy}},
-  author  = {Zhang, Chaoyun and [Authors TBD]},
-  journal = {arXiv preprint arXiv:[TBD]},
+  title={UFO$^3$: Weaving the Digital Agent Galaxy}, 
+  author = {Zhang, Chaoyun and Li, Liqun and Huang, He and Ni, Chiming and Qiao, Bo and Qin, Si and Kang, Yu and Ma, Minghua and Lin, Qingwei and Rajmohan, Saravan and Zhang, Dongmei},
+  journal = {arXiv preprint arXiv:2511.11332},
   year    = {2025},
-  note    = {Multi-device orchestration framework with Constellation-based planning}
 }
 ```
 

README_ZH.md

@@ -17,6 +17,7 @@
 <a href="https://trendshift.io/repositories/7874" target="_blank"><img src="https://trendshift.io/api/badge/repositories/7874" alt="microsoft%2FUFO | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
 <br/>
 
+[![arxiv](https://img.shields.io/badge/Paper-arXiv:2511.11332-b31b1b.svg)](https://arxiv.org/abs/2511.11332)&ensp;
 [![arxiv](https://img.shields.io/badge/Paper-arXiv:2504.14603-b31b1b.svg)](https://arxiv.org/abs/2504.14603)&ensp;
 ![Python Version](https://img.shields.io/badge/Python-3776AB?&logo=python&logoColor=white-blue&label=3.10%20%7C%203.11)&ensp;
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)&ensp;
@@ -439,7 +440,7 @@ API_DEPLOYMENT_ID: "your-deployment-id"
 - 🎯 **异构编排**：基于能力的设备匹配实现安全的异步执行
 - 🔌 **统一 AIP 协议**：基于 WebSocket 的安全智能体协调，具有容错能力
 - 🛠️ **支持 MCP 的智能体框架**：用于快速设备智能体开发的模板驱动工具包
-- 📄 **研究论文**：[UFO³: Weaving the Digital Agent Galaxy](https://arxiv.org/abs/[TBD])
+- 📄 **研究论文**：[UFO³: Weaving the Digital Agent Galaxy](https://arxiv.org/abs/2511.11332)
 
 **核心特性：**
 - 首个用于 GUI 智能体的多设备编排框架
@@ -467,11 +468,10 @@ API_DEPLOYMENT_ID: "your-deployment-id"
 ### UFO³ Galaxy 框架（2025）
 ```bibtex
 @article{zhang2025ufo3,
-  title   = {{UFO³: Weaving the Digital Agent Galaxy}},
-  author  = {Zhang, Chaoyun and [Authors TBD]},
-  journal = {arXiv preprint arXiv:[TBD]},
+  title={UFO$^3$: Weaving the Digital Agent Galaxy}, 
+  author = {Zhang, Chaoyun and Li, Liqun and Huang, He and Ni, Chiming and Qiao, Bo and Qin, Si and Kang, Yu and Ma, Minghua and Lin, Qingwei and Rajmohan, Saravan and Zhang, Dongmei},
+  journal = {arXiv preprint arXiv:2511.11332},
   year    = {2025},
-  note    = {Multi-device orchestration framework with Constellation-based planning}
 }
 ```
 

documents/docs/choose_path.md

@@ -200,11 +200,14 @@ You don't have to choose just one! Here are common hybrid patterns:
 
 ### Pattern 1: UFO² as Galaxy Device
 
-**Setup:** Run UFO² in agent-server mode as a Galaxy device
+**Setup:** Run UFO² as a Galaxy device (requires both server and client)
 
 ```bash
-# On Windows desktop
-python -m ufo --mode agent-server --port 5005
+# Terminal 1: Start UFO² Server on Windows desktop
+python -m ufo.server.app --port 5000
+
+# Terminal 2: Start UFO² Client (connect to server)
+python -m ufo.client.client --ws --ws-server ws://localhost:5000/ws --client-id my_windows_device --platform windows
 ```
 
 **Benefits:**
@@ -230,13 +233,20 @@ python -m ufo --task "Your current task"
 # config/galaxy/devices.yaml (prepare in advance)
 devices:
   - device_id: "my_windows"
-    server_url: "ws://localhost:5005/ws"
+    server_url: "ws://localhost:5000/ws"  # Where UFO client connects to UFO server
+    os: "windows"
     capabilities: ["office", "web"]
 ```
 
-**Phase 3:** Add Galaxy when needed
+**Phase 3:** Start UFO device agent and connect to Galaxy
 ```bash
-# Start using Galaxy for multi-device tasks
+# Terminal 1: Start UFO Server on your Windows machine
+python -m ufo.server.app --port 5000
+
+# Terminal 2: Start UFO Client (connects to UFO server above)
+python -m ufo.client.client --ws --ws-server ws://localhost:5000/ws --client-id my_windows --platform windows
+
+# Terminal 3: Start Galaxy (on control machine, can be same or different)
 python -m galaxy --request "Cross-device workflow"
 ```
 
@@ -274,10 +284,13 @@ python -m galaxy --request "Cross-device workflow"
 
 ### Misconception 2: "I need to rewrite everything to migrate to Galaxy"
 
-**Reality:** UFO² can run as a Galaxy device with zero code changes:
+**Reality:** UFO² can run as a Galaxy device with minimal changes:
 ```bash
-# Existing UFO² instance becomes Galaxy device
-python -m ufo --mode agent-server --port 5005
+# Terminal 1: Start UFO Server
+python -m ufo.server.app --port 5000
+
+# Terminal 2: Start UFO Client in WebSocket mode
+python -m ufo.client.client --ws --ws-server ws://localhost:5000/ws --client-id my_device --platform windows
 ```
 
 **Learn More:** [Migration Guide](./getting_started/migration_ufo2_to_galaxy.md#option-2-convert-ufo2-instance-to-galaxy-device)

documents/docs/client/computer_manager.md

@@ -68,7 +68,7 @@ graph TB
 
 ---
 
-## 🏗�?Computer Manager Architecture
+## 🏗️ Computer Manager Architecture
 
 ### Computer Instance Management
 
@@ -110,7 +110,7 @@ Data collection tools are designed for non-invasive information gathering, while
 
 ## Computer Manager Architecture
 
-## 🖥�?Computer (Instance) Architecture
+## 🖥️ Computer (Instance) Architecture
 
 ### Internal Structure
 
@@ -157,9 +157,9 @@ graph TB
 |-----------|------|---------|
 | `_name` | `str` | Computer name (identifier) |
 | `_process_name` | `str` | Associated process (e.g., "notepad.exe") |
-| `_data_collection_servers` | `Dict[str, BaseMCPServer]` | Namespace �?MCP server mapping (data collection) |
-| `_action_servers` | `Dict[str, BaseMCPServer]` | Namespace �?MCP server mapping (actions) |
-| `_tools_registry` | `Dict[str, MCPToolCall]` | Tool key �?tool info mapping |
+| `_data_collection_servers` | `Dict[str, BaseMCPServer]` | Namespace → MCP server mapping (data collection) |
+| `_action_servers` | `Dict[str, BaseMCPServer]` | Namespace → MCP server mapping (actions) |
+| `_tools_registry` | `Dict[str, MCPToolCall]` | Tool key → tool info mapping |
 | `_meta_tools` | `Dict[str, Callable]` | Built-in meta tools |
 | `_executor` | `ThreadPoolExecutor` | Thread pool for tool execution (10 workers) |
 | `_tool_timeout` | `int` | Tool execution timeout: **6000 seconds (100 minutes)** |
@@ -396,7 +396,7 @@ result = await asyncio.wait_for(
 
 ---
 
-## 🛠�?Tool Registry
+## 🛠️ Tool Registry
 
 ### Tool Registration
 

documents/docs/configuration/system/galaxy_devices.md

@@ -44,10 +44,10 @@ graph LR
 ```
 UFO2/
 ├── config/
-�?  └── galaxy/
-�?      ├── devices.yaml           # �?Device definitions (this file)
-�?      ├── constellation.yaml     # �?Runtime settings
-�?      └── agent.yaml.template    # �?Agent LLM configuration template
+    └── galaxy/
+        ├── devices.yaml           # 📄 Device definitions (this file)
+        ├── constellation.yaml     # ⚙️ Runtime settings
+        └── agent.yaml.template    # 🤖 Agent LLM configuration template
 ```
 
 **Loading in Code:**
@@ -545,34 +545,34 @@ def validate_device_config(device: dict) -> bool:
 
     **1. Use Meaningful device_id**
     ```yaml
-    # �?Good: Descriptive and unique
+    # ✅ Good: Descriptive and unique
     device_id: "windows_office_pc_01"
     device_id: "linux_prod_server_us_west_01"
     device_id: "gpu_ml_workstation_lab_a"
     
-    # �?Bad: Generic or ambiguous
+    # ❌ Bad: Generic or ambiguous
     device_id: "device1"
     device_id: "test"
     device_id: "agent"
     ```
 
     **2. Specify Granular Capabilities**
     ```yaml
-    # �?Good: Specific capabilities
+    # ✅ Good: Specific capabilities
     capabilities:
       - "web_browsing_chrome"
       - "office_excel_automation"
       - "email_outlook"
     
-    # �?Bad: Vague capabilities
+    # ❌ Bad: Vague capabilities
     capabilities:
       - "office"
       - "internet"
     ```
 
     **3. Include Rich Metadata**
     ```yaml
-    # �?Good: Comprehensive metadata
+    # ✅ Good: Comprehensive metadata
     metadata:
       location: "datacenter_us_west_rack_a42"
       performance: "very_high"
@@ -582,7 +582,7 @@ def validate_device_config(device: dict) -> bool:
       gpu_type: "NVIDIA A100"
       gpu_count: 4
     
-    # �?Bad: Minimal metadata
+    # ❌ Bad: Minimal metadata
     metadata:
       location: "server room"
     ```

documents/docs/galaxy/overview.md

@@ -456,7 +456,6 @@ UFO³ Galaxy consists of several integrated components working together:
 | **TaskConstellationOrchestrator** | `galaxy/constellation/orchestrator/` | Asynchronous execution, event coordination, safety enforcement |
 | **TaskConstellation** | `galaxy/constellation/task_constellation.py` | DAG data structure, validation, and modification APIs |
 | **DeviceManager** | `galaxy/client/device_manager.py` | WebSocket connections, heartbeat monitoring, message routing |
-| **Agent Server** | `ufo/mode/agent_server.py` | Device-side WebSocket server, AIP protocol handler |
 
 ### Supporting Infrastructure
 
@@ -579,7 +578,7 @@ print(f"🔀 Parallelism Ratio: {const_stats['parallelism_ratio']:.2f}")
 
 ---
 
-## �📚 Learn More
+## 📚 Learn More
 
 - **Research Paper**: [UFO³: Weaving the Digital Agent Galaxy](https://arxiv.org/) *(Coming Soon)*
 - **UFO² (Desktop AgentOS)**: [Documentation](../ufo2/overview.md)

documents/docs/getting_started/quick_start_mobile.md

@@ -999,7 +999,7 @@ python -m galaxy --interactive
 
 ---
 
-## � Understanding Mobile Agent Internals
+## 🔍 Understanding Mobile Agent Internals
 
 Now that you have Mobile Agent running, you may want to understand how it works under the hood:
 
@@ -1035,7 +1035,7 @@ Learn more: [MCP Commands Reference](../mobile/commands.md)
 
 ---
 
-## �🐛 Common Issues & Troubleshooting
+## 🐛 Common Issues & Troubleshooting
 
 ### Issue 1: ADB Device Not Found
 

documents/docs/index.md

@@ -7,7 +7,7 @@
   <p><em>A Multi-Device Orchestration Framework for Cross-Platform Intelligent Automation</em></p>
 </div>
 
-
+[![arxiv](https://img.shields.io/badge/Paper-arXiv:2511.11332-b31b1b.svg)](https://arxiv.org/abs/2511.11332)
 [![arxiv](https://img.shields.io/badge/Paper-arXiv:2504.14603-b31b1b.svg)](https://arxiv.org/abs/2504.14603)
 ![Python Version](https://img.shields.io/badge/Python-3776AB?&logo=python&logoColor=white-blue&label=3.10%20%7C%203.11)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -438,10 +438,10 @@ If you use UFO³ in your research, please cite:
 **UFO³ Galaxy Framework (2025)**
 ```bibtex
 @article{zhang2025ufo3,
-  title   = {{UFO³: Weaving the Digital Agent Galaxy}},
-  author  = {Zhang, Chaoyun and [Authors TBD]},
-  journal = {arXiv preprint arXiv:[TBD]},
-  year    = {2025}
+  title={UFO$^3$: Weaving the Digital Agent Galaxy}, 
+  author = {Zhang, Chaoyun and Li, Liqun and Huang, He and Ni, Chiming and Qiao, Bo and Qin, Si and Kang, Yu and Ma, Minghua and Lin, Qingwei and Rajmohan, Saravan and Zhang, Dongmei},
+  journal = {arXiv preprint arXiv:2511.11332},
+  year    = {2025},
 }
 ```