app_conversation_models.py 里有三个关键模型，分工明确：

• AppConversationInfo（:110）：要落库的会话元数据（id、sandbox_id、repo、分支、llm_model、tags…），不含实时状态。
• AppConversation（:195）：= Info + 实时字段（sandbox_status、execution_status、conversation_url、session_api_key）。运行时拼装，不落库。
• AppConversationStartRequest（:221）：启动参数（repo、branch、initial_message、llm_model、agent_type…）。

启动会话很慢（拉容器、clone、装环境要几十秒），所以用一个"启动任务"对象 AppConversationStartTask 承载进度，它是一个状态机（app_conversation_models.py:288）：

启动方法的签名很特别（app_conversation_service.py:81）——它返回一个异步生成器，反复 yield 同一个 task 的最新状态：

async def start_app_conversation(
    self, start_request: AppConversationStartRequest
) -> AsyncGenerator[AppConversationStartTask, None]:
    # 每完成一步，就 yield 一次更新后的 task
    yield task  # WORKING
    # ...拉沙箱...
    yield task  # WAITING_FOR_SANDBOX
    # ...clone...
    yield task  # PREPARING_REPOSITORY
    # ...
    yield task  # READY

启动端点 start_app_conversation（app_conversation_router.py:364）有个巧妙处理：只取生成器的第一个值就返回，剩下的进度放后台消费：

set_db_session_keep_open(request.state, True)     # 请求返回后别关连接
set_httpx_client_keep_open(request.state, True)
async_iter = app_conversation_service.start_app_conversation(start_request)
result = await anext(async_iter)                  # 只取第一个（初始 task）立即返回
# ...
asyncio.create_task(_consume_remaining(async_iter, db_session, httpx_client))  # 剩余进度后台跑

真正的启动逻辑在 live_status_app_conversation_service.py:361 的 _start_app_conversation——会话逻辑的心脏。串起来就是 Day 05 那条旅程：

# 概念流程（每步 yield 一个状态）
# 1. 取 user_id；有 parent_conversation_id 则继承父会话配置（复用同一沙箱/repo/model）
# 2. _wait_for_sandbox_start：找一个在跑的沙箱，或 start_sandbox 新建，
#                             轮询 wait_for_sandbox_running 直到容器 RUNNING 且 agent-server /alive
# 3. _seed_sandbox_profiles：把用户的 LLM profiles 同步进沙箱
# 4. 算 working_dir → 建 AsyncRemoteWorkspace
# 5. run_setup_scripts：clone 仓库、跑 setup.sh、装 git hooks、加载 skills
# 6. 构建 Agent（见 L06）
# 7. POST {agent_server_url}/api/conversations 在沙箱里真正创建会话
# 8. 落库 AppConversationInfo
# 9. 注册事件回调（总是确保有 SetTitleCallbackProcessor 自动生成标题）
# 10. 状态置 READY；处理排队的 pending 消息
# 异常 → 状态置 ERROR，detail 经 redact_text_secrets 脱敏

_build_start_conversation_request_for_user（:1610）组装出要交给 agent-server 的 Agent 配置：

if agent_type == AgentType.PLAN:
    tools = get_planning_tools(plan_path=plan_path)     # 规划型 Agent
else:
    register_builtins_agents(enable_browser=True)
    tools = get_default_tools(enable_browser=True, enable_sub_agents=...)  # 默认工具集
configured_agent_settings = user.agent_settings.model_copy(update={
    'llm': llm, 'tools': tools, 'mcp_config': mcp_config or {},
    'agent_context': AgentContext(system_message_suffix=..., secrets=secrets)})
agent = configured_agent_settings.create_agent()

会话建好后，很多操作（发消息、看 diff、下载文件）前端无法直连沙箱，就由 app_server 代理转发。这些端点刻意做成"薄代理"——只转发、不加逻辑：

# send-message 端点（router:441）文档原话：convenience wrapper，不做额外处理
# 把消息直接转发到沙箱 agent-server 的 /api/conversations/{id}/events

✋ 动手

grep -n 'class AppConversationInfo\|class AppConversation\|StartTaskStatus' openhands/app_server/app_conversation/app_conversation_models.py
grep -n 'def start_app_conversation\|anext\|create_task' openhands/app_server/app_conversation/app_conversation_router.py
grep -n 'def _start_app_conversation\|_wait_for_sandbox_start\|redact_text_secrets' openhands/app_server/app_conversation/live_status_app_conversation_service.py