回忆 Day 05：app_server 是"管家/网关层"，它不亲自跑 Agent（那是沙箱里 agent-server 的活）。管家只干这些：

• 管理用户、会话（conversation）的生命周期
• 供给/暂停/回收沙箱（sandbox）
• 持久化事件、鉴权
• 对沙箱里的 agent-server 做代理转发（浏览器连不上沙箱时）

app_server/app.py 是 FastAPI 应用的"组装车间"——它只做拼装，不含业务逻辑：

# app_server/app.py（简化）
app = FastAPI(
    lifespan=combine_lifespans(*lifespans),          # 合并多个生命周期钩子
    routes=[Mount(path='/mcp', app=mcp_app)],        # 挂载 MCP 子应用
)
app.include_router(v1_router.router)                 # 业务 API（/api/v1/*）
app.include_router(health_router)                    # 探活
if os.path.exists('./frontend/build'):
    app.mount('/', SPAStaticFiles(...))              # 挂前端单页应用
# 中间件：CORS、缓存控制、限流
app.add_middleware(LocalhostCORSMiddleware)
app.add_middleware(CacheControlMiddleware)
app.add_middleware(RateLimitMiddleware, ...)

核心是一个 Pydantic 模型 AppServerConfig（config.py:191），字段分三类：基础配置、Injector（注入器）字段、Services。关键的是那一堆 Injector 字段：

class AppServerConfig(BaseModel):
    # 基础
    persistence_dir: str
    web_url: str
    # ★ 一堆"注入器"——每个都是 XxxServiceInjector | None
    event: EventServiceInjector | None = None
    sandbox: SandboxServiceInjector | None = None
    app_conversation: AppConversationServiceInjector | None = None
    user: UserServiceInjector | None = None
    # ...

services/injector.py:12 定义了统一的 Injector 抽象，一份实现同时服务两种使用场景：

class Injector(Generic[T], ABC):
    @abstractmethod
    async def inject(self, state, request=None) -> AsyncGenerator[T, None]: ...

    @contextlib.asynccontextmanager
    async def context(self, state, request=None):     # 用法1：后台任务 async with
        async for result in self.inject(state, request): yield result

    async def depends(self, request):                 # 用法2：FastAPI Depends 注入
        async for result in self.inject(request.state, request): yield result

看 config_from_env() 里选沙箱实现的真实代码（config.py:332）：

if os.getenv('RUNTIME') == 'remote':
    config.sandbox = RemoteSandboxServiceInjector(...)   # 远程沙箱
elif os.getenv('RUNTIME') in ('local', 'process'):
    config.sandbox = ProcessSandboxServiceInjector()     # 本地进程
else:
    config.sandbox = DockerSandboxServiceInjector(...)   # 默认 Docker

app_server 里几乎每个能力都用同一种三层结构（以会话为例）：

• 抽象接口：AppConversationService（定义"该有哪些方法"）
• Mixin 基类：AppConversationServiceBase（放公共能力，如 git 相关）
• 具体实现：LiveStatusAppConversationService（真正干活）

✋ 动手

sed -n '1,90p' openhands/app_server/app.py            # 应用装配
grep -n 'Injector' openhands/app_server/config.py | head -20   # 一堆注入器字段
grep -n "getenv('RUNTIME')\|SandboxServiceInjector" openhands/app_server/config.py
sed -n '12,40p' openhands/app_server/services/injector.py     # Injector 抽象