修正 DirectTurnEnqueueFailure 文档对 message 来源的描述

- 原文写"一处生成的 Display 文案"不准确：可留痕的宿主/环境失败走 record_direct_codex_failure 的 direct-codex-failure:v2 收口文案 - 文档改为写明两条来源（Display 与脱敏诊断收口文案），并保留"Rust 侧不解析该字符串"的约定
2026-10-01 16:43:03 +08:00
parent b202c70271
commit d1e637b9fd
1 changed files with 5 additions and 2 deletions
@@ -17,8 +17,11 @@
 //! 事件载荷（`thread_manager::wire::DirectTurnFailure`）仍然只有 `{kind, message}` 两个字段：
 //! 那是**线上协议**，由 [`DirectTurnError::wire_kind`] 与 `Display` 在这一个出口投影出来，不是
 //! 另一种状态模型。跨进程边界（`#[tauri::command]`）的**入队失败**载荷是结构化的
-//! [`DirectTurnEnqueueFailure`]（变体 + 一处生成的 `Display` 文案）；其余只需要一句文案的出口
+//! [`DirectTurnEnqueueFailure`]（变体 + 一条可展示 `message`）；`message` 有两条来源：
-//! 仍由 `Display` 生成。Rust 侧任何地方都不解析这个字符串。
+//! 不需要留痕的失败用 [`DirectTurnError`] 的 `Display`，需要留痕的宿主 / 环境事实改用
 //! `record_direct_codex_failure` 生成的脱敏诊断收口文案（`direct-codex-failure:v2 …`，同时写
 //! `.agent/runtime/errors` 与错误上报池）。其余只需要一句文案的出口仍由 `Display` 生成。
 //! 无论哪条来源，Rust 侧任何地方都不解析这个字符串。
 //!
 //! 谁负责产生哪个变体：
 //! - 命令入口与回合编排（`direct_runtime`）：调用级拒绝、阶段失败；