文档先行：AGC 命令错误结构化与错误报告口径

- 新增 ADR：命令错误按具体变体结构化（ts-rs 导出）、报告池只收没人处理的错误、前端按 type 分流不匹配文案 - 更新【技术方案】AGC错误报告与诊断上传：采集口径改为"只收没有调用方处理的错误"，补命令变体分流与 clientApi 边界 - 更新共享记忆 decision-log：记录本次口径与影响范围 - 更新共享记忆 pitfalls：记录"输错密码被当成客户端缺陷上报"的现象、根因与判据 - 修正 DirectTurnError 模块注释中"命令边界只给字符串"的过期描述，改为结构化拒单载荷 - docs/README.md 登记新 ADR
2026-10-01 14:52:28 +08:00
parent 66e12cc3fd
commit fe200598c0
6 changed files with 112 additions and 4 deletions
@@ -16,8 +16,9 @@
 //!
 //! 事件载荷（`thread_manager::wire::DirectTurnFailure`）仍然只有 `{kind, message}` 两个字段：
 //! 那是**线上协议**，由 [`DirectTurnError::wire_kind`] 与 `Display` 在这一个出口投影出来，不是
-//! 另一种状态模型。跨进程边界（`#[tauri::command]`）同样只给前端一个字符串：那是**序列化**，
-//! 由 `Display` 一处生成；Rust 侧任何地方都不再解析这个字符串。
+//! 另一种状态模型。跨进程边界（`#[tauri::command]`）的**拒单**载荷是结构化的
+//! [`DirectTurnEnqueueFailure`]（变体 + 一处生成的 `Display` 文案）；其余只需要一句文案的出口
+//! 仍由 `Display` 生成。Rust 侧任何地方都不解析这个字符串。
 //!
 //! 谁负责产生哪个变体：
 //! - 命令入口与回合编排（`direct_runtime`）：调用级拒绝、阶段失败；