refactor(alias): reorganize file structure and refine documentation

Author: XiuShenAl

alias/README.md

@@ -373,12 +373,12 @@ After the first startup, you can log in with the superuser credentials configure
 
 ### 🌐 Basic Usage -- AgentScope Runtime Deployment
 
-Alias now supports rapid startup based on [AgentScope-runtime](https://github.com/agentscope-ai/agentscope-runtime/), providing an out-of-the-box WebUI (powered by the AgentScope Runtime WebUI).
+Alias is now fully compatible with [AgentScope Runtime](https://github.com/agentscope-ai/agentscope-runtime/), enabling you to quickly deploy Alias as a standardized backend service. Once launched, you can easily invoke Alias capabilities via the accompanying AgentScope Runtime API.
 
 #### 1. Prerequisites
 
-*   **Sandbox & API Keys**: Please refer to the previous sections [🐳 Sandbox Setup](#-sandbox-setup-optional) and [🔑 API Keys Configuration](#-api-keys-configuration) to complete the basic environment setup.
-*   **Configure Environment Variables**: Copy the example environment file from the project root:
+*   **Sandbox & API Keys**: Please refer to the previous sections [🐳 Sandbox Setup (Optional)](#-sandbox-setup-optional) and [🔑 API Keys Configuration](#-api-keys-configuration) to complete the basic environment setup.
+*   **Environment Variables**: Copy the example environment file from the project root:
     ```bash
     cp .env.example .env
     ```
@@ -387,69 +387,67 @@ Alias now supports rapid startup based on [AgentScope-runtime](https://github.co
     docker run -d -p 6379:6379 --name alias-redis redis:7-alpine
     ```
 
-#### 2. Installation and Sandbox Startup
+#### 2. Installation & Sandbox Launch
 
-Install the package in editable mode from the project root. This will automatically install the `alias_agent_runtime` command-line tool:
+Install the package in editable mode from the project root. This will automatically install the `alias_agent_runtime` CLI tool:
 ```bash
 pip install -e .
 ```
 
-To ensure features like code execution and file operations work correctly, start the sandbox server in a separate terminal:
+To ensure proper code execution and file operations, start the sandbox server in a separate terminal:
 ```bash
 runtime-sandbox-server --extension src/alias/runtime/alias_sandbox/alias_sandbox.py
 ```
 
-#### 3. Start AgentScope Runtime Service
+#### 3. Launching AgentScope Runtime Service
 
-##### Option A: Using the Command Line Interface (Recommended)
+You can choose to start the service via the CLI or Python code, depending on your use case.
 
-Use the `alias_agent_runtime` command to launch both the backend service and the WebUI with a single command:
+##### Option A: Using CLI (Recommended)
+Use the `alias_agent_runtime` command to launch the backend service with one click:
 
 ```bash
-alias_agent_runtime --host 127.0.0.1 --port 8090 --chat-mode general --web-ui
+alias_agent_runtime --host 127.0.0.1 --port 8090 --chat-mode general
 ```
 
 **Parameter Descriptions**:
-*   `--host` / `--port`: Specifies the host address and port for the service (default port is 8090).
-*   `--chat-mode`: Sets the operational mode. Available options: `general`, `dr`, `browser`, `ds`, `finance` (defaults to `general`).
-*   `--web-ui`: Enables the AgentScope Runtime WebUI. If this flag is omitted, the WebUI will not be started.
+*   `--host` / `--port`: Specify the service address and port (default port is 8090).
+*   `--chat-mode`: Set the running mode. Options: `general`, `dr`, `browser`, `ds`, `finance` (default: `general`).
+*   `--web-ui`: (Optional) Enable AgentScope Runtime WebUI for a visual interaction interface. Skip this if you only need the API.
 
-> **Note**: When launching with `--web-ui` for the first time, the system will automatically install necessary frontend dependencies. This process may take a few minutes; please be patient.
+> **Note**: When enabling `--web-ui` for the first time, the system will automatically install necessary frontend dependencies. This may take a few minutes.
 
-##### Option B: Programmatic Usage (Recommended for Developers)
-
-If you prefer to integrate or customize the startup logic within your Python code, you can use `AliasRunner` in conjunction with `AgentApp` as shown below:
+##### Option B: Using Python Code (Recommended for Developers)
+If you wish to integrate or customize the launch logic within Python, you can use `AliasRunner` and `AgentApp` as shown below:
 
 ```python
 from agentscope_runtime.engine.app import AgentApp
 from alias.server.runtime.runner.alias_runner import AliasRunner
 
 # 1. Initialize AliasRunner
-# Available default_chat_mode options: "general", "dr", "browser", "ds", "finance"
+# default_chat_mode options: "general", "dr", "browser", "ds", "finance"
 runner = AliasRunner(
     default_chat_mode="general",
 )
 
-# 2. Create an AgentApp instance
+# 2. Create AgentApp instance
 agent_app = AgentApp(
     runner=runner,
     app_name="Alias",
     app_description="An LLM-empowered agent built on AgentScope and AgentScope-Runtime",
 )
 
 # 3. Run the service
-# Setting web_ui=True will also launch the frontend interface (default port: 5173)
-agent_app.run(host="127.0.0.1", port=8090, web_ui=True)
+# Set web_ui=True to enable the visual debugging interface
+agent_app.run(host="127.0.0.1", port=8090)
 ```
 
-#### 4. Access the Application
-
-Once the service is running, you can interact with Alias via the following addresses:
+#### 4. Accessing the Application
 
-*   **Frontend Interface**: `http://localhost:5173`
-*   **Runtime API Service**: `http://localhost:8090/process`
+Once the service is running, you can access Alias via:
 
-Through the WebUI, you can intuitively track the agent's reasoning process, tool invocation traces, and other execution details.
+*   **Runtime API Access**: Send standard HTTP POST requests to `http://localhost:8090/process`. This is the primary method for integrating Alias into third-party frontends or backend workflows.
+*   **Visual Monitoring (Optional)**: If started with the `--web-ui` flag, visit `http://localhost:5173`. This interface allows developers to observe the agent's reasoning process, tool execution traces, and other debugging information.
 
 
 ## ⚖️ License

alias/README_ZH.md

@@ -373,7 +373,7 @@ bash script/start_memory_service.sh
 
 ### 🌐 基础用法 -- AgentScope Runtime 部署
 
-Alias 现在支持基于 [AgentScope-runtime](https://github.com/agentscope-ai/agentscope-runtime/) 快速启动，并提供开箱即用的 WebUI 交互界面（基于AgentScope Runtime 的 WebUI）。
+Alias 现已适配 [AgentScope Runtime](https://github.com/agentscope-ai/agentscope-runtime/)，您可以利用 AgentScope Runtime 将 Alias 快速部署为标准后端服务。启动后，通过配套的 AgentScope Runtime API 即可轻松调用 Alias 所提供的服务。
 
 #### 1. 前期准备
 
@@ -401,17 +401,19 @@ runtime-sandbox-server --extension src/alias/runtime/alias_sandbox/alias_sandbox
 
 #### 3. 启动 AgentScope Runtime 服务
 
+您可以根据使用场景，选择通过命令行或 Python 代码启动服务。
+
 ##### 选项 A：使用命令行工具（推荐）
-使用 `alias_agent_runtime` 命令一键启动后端服务及 WebUI 界面：
+使用 `alias_agent_runtime` 命令一键启动后端服务：
 
 ```bash
-alias_agent_runtime --host 127.0.0.1 --port 8090 --chat-mode general --web-ui
+alias_agent_runtime --host 127.0.0.1 --port 8090 --chat-mode general
 ```
 
 **参数说明**：
 *   `--host` / `--port`: 指定服务的运行地址和端口（默认端口为 8090）。
 *   `--chat-mode`: 设置运行模式，可选 `general`, `dr`, `browser`, `ds`, `finance`（默认为 `general`）。
-*   `--web-ui` : 启用 AgentScope Runtime WebUI。若未指定该参数，则默认不启动 WebUI。
+*   `--web-ui` : (可选) 启用 AgentScope Runtime WebUI 以开启可视化交互界面。若仅需调用 API，请忽略此参数。
 
 > **注意**：首次启动并开启 `--web-ui` 时，系统会自动安装必要的前端依赖包，可能需要花费几分钟时间，请耐心等待。
 
@@ -436,18 +438,16 @@ agent_app = AgentApp(
 )
 
 # 3. 运行服务
-# web_ui=True 将同时启动前端交互界面（默认端口 5173）
-agent_app.run(host="127.0.0.1", port=8090, web_ui=True)
+# 如需启用可视化调试界面，可设置 web_ui=True
+agent_app.run(host="127.0.0.1", port=8090)
 ```
 
 #### 4. 访问应用程序
 
-服务启动后，您可以通过访问以下地址与 Alias 进行交互：
-
-*   **前端交互界面**：`http://localhost:5173`
-*   **Runtime API 服务**：`http://localhost:8090/process`
+服务启动后，您可以通过以下方式访问 Alias：
 
-通过 WebUI，您可以直观地查看智能体的思考过程以及工具调用轨迹等信息。
+*   **Runtime API 调用**：通过标准 HTTP POST 请求访问 `http://localhost:8090/process`。这是将 Alias 集成至第三方前端或后端工作流的主要方式。
+*   **可视化监控 (可选)**：若启动时开启了 `--web-ui` 参数，可通过 `http://localhost:5173` 访问 WebUI。该界面主要用于开发者观察智能体的思考过程以及工具调用轨迹等调试信息。
 
 ## ⚖️ 许可证
 

alias/src/alias/runtime/__init__.py

@@ -1,7 +1,8 @@
 # -*- coding: utf-8 -*-
 """Runtime module for Alias"""
 
-__all__ = ["alias_sandbox"]
+__all__ = ["alias_sandbox", "runtime_compat"]
 
 # Import submodule to make it accessible via alias.runtime.alias_sandbox
 from . import alias_sandbox  # noqa: E402, F401
+from . import runtime_compat  # noqa: E402, F401

…ias/src/alias/server/runtime/__init__.py …alias/runtime/runtime_compat/__init__.pyalias/src/alias/server/runtime/__init__.py renamed to alias/src/alias/runtime/runtime_compat/__init__.py alias/src/alias/server/runtime/__init__.py renamed to alias/src/alias/runtime/runtime_compat/__init__.py

@@ -25,7 +25,7 @@
 )
 from alias.server.core.task_manager import task_manager
 from alias.server.exceptions.base import BaseError
-from alias.server.runtime.adapter.alias_stream_adapter import (
+from alias.runtime.runtime_compat.adapter.alias_stream_adapter import (
     adapt_alias_message_stream,
 )
 from alias.server.schemas.chat import ChatRequest

…alias/server/runtime/adapter/__init__.py …ntime/runtime_compat/adapter/__init__.pyalias/src/alias/server/runtime/adapter/__init__.py renamed to alias/src/alias/runtime/runtime_compat/adapter/__init__.py alias/src/alias/server/runtime/adapter/__init__.py renamed to alias/src/alias/runtime/runtime_compat/adapter/__init__.py

@@ -1,7 +1,7 @@
 # -*- coding: utf-8 -*-
 import asyncio
 from typing import Optional
-from alias.server.runtime.runner.alias_runner import AliasRunner
+from alias.runtime.runtime_compat.runner.alias_runner import AliasRunner
 
 _lock: Optional[asyncio.Lock] = None
 _runner: Optional[AliasRunner] = None

…/runtime/adapter/alias_stream_adapter.py …e_compat/adapter/alias_stream_adapter.pyalias/src/alias/server/runtime/adapter/alias_stream_adapter.py renamed to alias/src/alias/runtime/runtime_compat/adapter/alias_stream_adapter.py alias/src/alias/server/runtime/adapter/alias_stream_adapter.py renamed to alias/src/alias/runtime/runtime_compat/adapter/alias_stream_adapter.py

@@ -1,7 +1,7 @@
 # -*- coding: utf-8 -*-
 from agentscope_runtime.engine.app import AgentApp
 
-from alias.server.runtime.runner.alias_runner import AliasRunner
+from alias.runtime.runtime_compat.runner.alias_runner import AliasRunner
 
 PORT = 8090