第一个文件，今天只学一件事：
你的输入怎样交给下一层？

它拿到了什么？

fn submit_user_message_with_history_and_shell_escape_policy(
    &mut self,
    user_message: UserMessage,
    history_record: UserMessageHistoryRecord,
    shell_escape_policy: ShellEscapePolicy,
) -> (bool, Option<AppCommand>) {

fn 标记函数开头。括号里列出这段代码工作时要用的东西，今天重点看 user_message：本次用户输入。它已经是整理好的数据，不是原始键盘按键。

第一遍只要能说：“它接收本次输入，并处理提交”，就可以往下走。

源码：函数入口 · 上游怎样组成 UserMessage

是不是每次输入都立刻往下交？

不是。配置尚未准备好时，会先排队；文字和两类图片都没有时，会直接返回。

if user_message.text.is_empty()
    && user_message.local_images.is_empty()
    && user_message.remote_image_urls.is_empty()
{
    return (false, None);
}

if 是“如果”；is_empty() 是“是否为空”；&& 是“同时成立”；return 是“结束当前函数并交回结果”。

这段检查的是“文字和图片都没有”，不是“没有文字就一定拒绝”。先学会沿着条件判断走流程。

源码：未准备好时排队 · 空输入检查

你的文字怎样变成程序能统一处理的内容？

let mut items: Vec<UserInput> = Vec::new();

// 中间省略其他分支；下面是普通文字处理
if !text.is_empty() {
    items.push(UserInput::Text {
        text: text.clone(),
        text_elements: app_server_text_elements(&text_elements),
    });
}

先准备一个叫 items 的空列表。text.is_empty() 问的是“文字是不是空的”；前面的 ! 把结果反过来，所以 if !text.is_empty() 是“如果文字不为空”。

text 来自本次传进来的 user_message。text.clone() 复制的是本次的文字，不会读取或补入上次输入。items.push(...) 是把包装好的文字输入加进本次列表；真正交出去要等后面的 submit_op。

items 装的是本次提交的输入内容，不是整段 Thread 的历史，也不是未来生成的回答。

源码：本次文字的来源 · 准备列表 · 加入文字；Rust 官方说明：! 取反 · clone 复制

为什么不能只交出那一句文字？

同样一句“检查代码”，还需要知道在哪个目录、用哪个模型、按哪些权限工作。AppCommand::user_turn(...) 把输入和这些设置组成一条内部命令，起名为 op。

这里是在组装内部命令，不是在生成答案，也还不是把 JSON-RPC 文本直接写到网络上。

源码：组装命令 · user_turn 的实现

哪里把东西真正交出去了？

if !self.submit_op(op.clone()) {
    return (false, None);
}

submit_op 将内部命令交到后续处理路径。若这一步没成功，当前函数就停止；成功提交也只表示这一层已交接，不表示模型已经完成工作。

submit_op 仍然在 TUI 内部：调用它的是 TUI 的 ChatWidget。在当前 AppEvent 路径中，它把 op 包装成 AppEvent::CodexOp，交给 TUI 自己的事件处理器；事件处理器随后才调用 App Server 的 turn/start 接口。

这里不是“submit_op 离开后又回到 TUI”，而是“同一个 TUI 内部，从 ChatWidget 子组件向上交给应用协调层”。跨到 App Server 的边界发生在后面的 turn_start 调用。

源码：提交位置 · submit_op 实现 · 后续 turn/start · 输入历史