注释用词统一:入队半 / 放行半 改成 入队侧 / 放行侧

- `codex_app_server/mod.rs` 两处、`direct_runtime/mod.rs`、`direct_thread_queue.rs`、`direct_runtime/user_input.rs` 各处的简体表述统一
- 同步实施计划文档里的同一处措辞,保持词汇一致
- 只改措辞,不改任何行为
This commit is contained in:
2026-09-30 11:43:21 +08:00
parent f4558475a0
commit 20126ead0c
5 changed files with 8 additions and 8 deletions
@@ -3300,7 +3300,7 @@ impl CodexAppServerConnection {
.map(str::trim)
.filter(|turn_id| !turn_id.is_empty())
.map(str::to_string);
// 用户条目由放行半在**放行之后、起 codex 之前**落盘("落盘即回合成立"),这里不再重复写;
// 用户条目由放行侧在**放行之后、起 codex 之前**落盘("落盘即回合成立"),这里不再重复写;
// 本函数只取它的身份,把它作为本回合的第一条运行态条目下发,前端就能用同一个 itemId 把
// "本地乐观气泡"和"历史里的同一条"合成一条。
// 没有条目但给了 `clientTurnId` 的调用方(不是 GUI 命令那条路)只拿到一份本地投影:
@@ -8204,7 +8204,7 @@ done
bootstrap.events.is_empty(),
"订阅发生在回合之前,bootstrap 必须为空"
);
// 生产入口(`enqueue_direct_codex_turn` + 放行半)在起 codex 之前先放行(认领时登记调用身份),
// 生产入口(`enqueue_direct_codex_turn` + 放行侧)在起 codex 之前先放行(认领时登记调用身份),
// 再把用户条目落盘:
// 这里补上同一步,于是这一轮的边界仍在同一个订阅里成对出现,历史里也有那条用户消息。
let _reservation =
@@ -4277,7 +4277,7 @@ pub(crate) fn build_direct_codex_system_prompt_with_creation_type(
/// 入队前必须成立的前置条件:目录可用、读写权限、正文非空、创建类型合法。
///
/// GUI 命令在入队半调用(不成立就是**入队失败**),CLI 入口在起回合前调用。两处共用这一份判据,
/// GUI 命令在入队侧调用(不成立就是**入队失败**),CLI 入口在起回合前调用。两处共用这一份判据,
/// 不要再各自复制一遍条件。
pub(crate) fn check_direct_turn_preconditions(
root: &Path,
@@ -30,7 +30,7 @@ pub(crate) fn normalize_direct_client_turn_id(
/// DirectProject 聊天命令:**只入队**,不 await、也不起回合。
///
/// 入队半就是"这条消息能不能收下":`clientTurnId` 校验 → 工作流恢复 → 用户条目校验 → prompt
/// 入队侧就是"这条消息能不能收下":`clientTurnId` 校验 → 工作流恢复 → 用户条目校验 → prompt
/// 投影 → 前置条件 → 工程准备,任何一步失败都是**入队失败**(typed 载荷)。全部通过之后只做一件事
/// ——把待发消息排进队列:不登记占用、不落盘、不发回合事件、不起 codex。
///
@@ -64,7 +64,7 @@ pub(crate) async fn enqueue_direct_codex_turn(
.map_err(|failure| direct_turn_enqueue_failure(root, boundary_turn_id.as_deref(), failure))
}
/// 入队半:全程 typed,顺序固定,**每一步失败都还是入队失败**:
/// 入队侧:全程 typed,顺序固定,**每一步失败都还是入队失败**:
/// `clientTurnId` 校验 → 工作流恢复 → 用户条目校验 → prompt 投影 → 前置条件 → 工程准备 → 入队。
///
/// 这个顺序不是风格问题:工程准备(可能建工程、铺脚手架)必须在"这条消息真的被收下"之前判定;
@@ -92,7 +92,7 @@ pub(crate) enum EnqueueOutcome {
AlreadyKnown,
}
/// 入队被检查挡下来的原因。满队之外的原因由入队半自己的 typed 错误表达。
/// 入队被检查挡下来的原因。满队之外的原因由入队侧自己的 typed 错误表达。
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub(crate) enum EnqueueRejection {
/// 在队条目已达 [`MAX_PENDING_DIRECT_TURNS`]。
@@ -64,8 +64,8 @@
改动点:
- `agent/direct_runtime/user_input.rs`:把命令主体拆成两半。
**入队半**:`clientTurnId` 校验 → 工作流恢复 → 用户条目校验 → prompt 投影 → 前置条件 → 工程准备 → 入队;
任何一步失败返回 typed 入队失败。**放行半**(第 2 步)从占用登记起。
**入队侧**:`clientTurnId` 校验 → 工作流恢复 → 用户条目校验 → prompt 投影 → 前置条件 → 工程准备 → 入队;
任何一步失败返回 typed 入队失败。**放行侧**(第 2 步)从占用登记起。
- 队列条目(宿主侧产物,只在内存):`PendingDirectTurn { client_turn_id, user_item: Value, prompt: String, creation_type: Option<String>, at: u64 }`。
`prompt` 与 `creation_type` 是入队检查的产物,放行不再重算;事件里**不带** `prompt`。
- `agent/direct_thread_manager.rs`: