文档：同步 ThreadItem 与 TurnFailure 的生成绑定注释

- ThreadItem 注记改为"原样投影、脱敏在前端" - TurnFailure 注记改为 TurnError::classify / TurnErrorClassified::ShouldContinue
2026-10-03 12:00:00 +08:00
parent 68cb41e332
commit 500479b4aa
2 changed files with 4 additions and 3 deletions
@@ -2,7 +2,7 @@
 import type { ThreadFileChange } from './ThreadFileChange';

 /**
- * 聊天视图的输入条目：一条 Codex 原始条目的脱敏投影。
+ * 聊天视图的输入条目：一条 Codex 原始条目的原样投影（脱敏与限长在事件进前端状态时统一做）。
 *
 * `itemType` 就是 Codex 的原始类型，逐字透传；前端按它决定投影成消息、思考还是工具卡片。
 * 未识别的类型走 [`ThreadItem::Other`]，Rust 不替前端决定它是否可见。
@@ -16,8 +16,9 @@ import type { Unclassified } from './Unclassified';
 * 按变体拼文案；宿主原始事实（`detail` / `cause` / `diagnostic`）留在字段里，只用于分流与诊断、
 * 不直接上屏。
 *
- * 唯一投影点是 [`crate::agent::TurnError::terminal_failure`]：控制流（返修要求）返回
- * `None`，所以控制流既不会出现在这里，前端也不需要为它写分支。
+ * 唯一投影点是 [`crate::agent::TurnError::classify`]：控制流（返修要求）落进
+ * [`crate::agent::TurnErrorClassified::ShouldContinue`]，所以控制流既不会出现在这里，前端也
+ * 不需要为它写分支。
 */
 export type TurnFailure =
  | ({ type: 'projectRootUnanchored' } & ProjectRootUnanchored)