AIDAWORK / ARCHITECTURE

Interaction 材料全家桶

独立图页 ↗
机制说明(SoT)图是辅读 · 结论以说明与证据为准

「材料」在 AidaWork 里落在 四条平行面,不要合成一个 Kernel:

本页可直接往下读完整机制说明,不需要「演示 / 播放故事」。术语不熟先看 术语表。

先读机制说明,结论以说明与证据为准 · 基于固定代码版本核验 · 部署状态另行确认

机制说明(全文)

Interaction 材料全家桶

统一读法

「材料」在 AidaWork 里落在 四条平行面,不要合成一个 Kernel:

面 权威 / 落点 典型产物 不是什么
Interaction Kernel conversation_interactions + settlement Save As(local_file_save_as / collect_material)、structured form、澄清、业务授权门 不是收件箱,也不是聊天附件行
Business effect batch 根 ActionProposal 成员范围 + effect ledger 一次明确意图下的有界变更集合 不是第二个 Interaction Kernel;成员 proposal 不可独立发现
Critical fields Orchestrator selectCriticalFieldsForAgent → ResponseGuard 按本轮工具交集选出的数值溯源 pattern 不是人机 settlement;见 critical-fields*
Inbox / Desktop 投影 Message Center 通知读模型;Desktop source / offscreen_mirror 收件箱摘要、卡片展示、本地草稿 展示与打扰策略;不拥有业务迁移权

与聊天 LF 对话附件的分界

  • 对话附件(Local File V5):chat-submission-store.insertSubmitted 在同一事务写入 user message 后挂 folder/file relation;后续 run 用 listForConversation。这是 conversation/message relation + operation ledger,不是 Interaction settlement 对象(mig 113→114 前置链见 interaction-lifecycle / local-file-v5)。
  • Save As:Kernel producer local_file_save_as,purpose=collect_material,input=file_select;人机门收集保存目标,回执 saveDestinationId。与 path-free 附件行分层。

Inbox vs Kernel

Message Center 在会话 / Interaction / Workflow 之上持久化通知读模型;用户处理后仍由上游业务或运行时决定终态。Desktop 投影里只有 source 卡可编辑;offscreen_mirror 仅导航与状态;本地草稿选择 ≠ settlement。

视图

  • main — Kernel 材料 / batch / critical-fields / inbox·投影 / 聊天附件 五路对照。

相关

  • interaction-lifecycle、critical-fields、critical-fields-select-flow、critical-fields-hr-vs-bi
  • local-file-v5、message-center

证据与范围

  • aida-agent · packages/agent/src/interaction-kernel/producer-inventory.ts L17–47 · local_file_save_as · e2adc9a3c325
  • aida-agent · CONTEXT.md L858–863 · Business effect batch · e2adc9a3c325(历史引用:该文件在上一钉点与当前钉点均不存在,未能复核;见 ATLAS-DEBT)
  • aida-agent · docs/architecture/lifecycle-map.md L44–66 · Authority boundaries · e2adc9a3c325(历史引用:该文件在上一钉点与当前钉点均不存在,未能复核;见 ATLAS-DEBT)
  • aida-agent · docs/architecture/lifecycle-map.md L225–250 · Desktop projection · e2adc9a3c325(历史引用:该文件在上一钉点与当前钉点均不存在,未能复核;见 ATLAS-DEBT)
  • aida-agent · docs/architecture/message-center.md L1–35 · Message Center · e2adc9a3c325(历史引用:该文档已在 aida-agent 44d63e20 退役,上一钉点与当前钉点均不存在;见 ATLAS-DEBT)
  • aida-agent · packages/agent/src/orchestrator/critical-field-registry.ts L45–55 · selectCriticalFieldsForAgent · e2adc9a3c325
  • aida-agent · packages/agent/src/session/chat-submission-store.ts L1742–1782 · insertSubmitted · e2adc9a3c325

结论来自固定版本的静态源码与合同阅读;实现存在、默认开关和生产启用分别判断。本站代码证据面板列出声明状态与具体限制。

机制说明

Interaction 材料全家桶

统一读法

「材料」在 AidaWork 里落在 四条平行面,不要合成一个 Kernel:

面 权威 / 落点 典型产物 不是什么
Interaction Kernel conversation_interactions + settlement Save As(local_file_save_as / collect_material)、structured form、澄清、业务授权门 不是收件箱,也不是聊天附件行
Business effect batch 根 ActionProposal 成员范围 + effect ledger 一次明确意图下的有界变更集合 不是第二个 Interaction Kernel;成员 proposal 不可独立发现
Critical fields Orchestrator selectCriticalFieldsForAgent → ResponseGuard 按本轮工具交集选出的数值溯源 pattern 不是人机 settlement;见 critical-fields*
Inbox / Desktop 投影 Message Center 通知读模型;Desktop source / offscreen_mirror 收件箱摘要、卡片展示、本地草稿 展示与打扰策略;不拥有业务迁移权

与聊天 LF 对话附件的分界

  • 对话附件(Local File V5):chat-submission-store.insertSubmitted 在同一事务写入 user message 后挂 folder/file relation;后续 run 用 listForConversation。这是 conversation/message relation + operation ledger,不是 Interaction settlement 对象(mig 113→114 前置链见 interaction-lifecycle / local-file-v5)。
  • Save As:Kernel producer local_file_save_as,purpose=collect_material,input=file_select;人机门收集保存目标,回执 saveDestinationId。与 path-free 附件行分层。

Inbox vs Kernel

Message Center 在会话 / Interaction / Workflow 之上持久化通知读模型;用户处理后仍由上游业务或运行时决定终态。Desktop 投影里只有 source 卡可编辑;offscreen_mirror 仅导航与状态;本地草稿选择 ≠ settlement。

视图

  • main — Kernel 材料 / batch / critical-fields / inbox·投影 / 聊天附件 五路对照。

相关

  • interaction-lifecycle、critical-fields、critical-fields-select-flow、critical-fields-hr-vs-bi
  • local-file-v5、message-center

证据与范围

  • aida-agent · packages/agent/src/interaction-kernel/producer-inventory.ts L17–47 · local_file_save_as · e2adc9a3c325
  • aida-agent · CONTEXT.md L858–863 · Business effect batch · e2adc9a3c325(历史引用:该文件在上一钉点与当前钉点均不存在,未能复核;见 ATLAS-DEBT)
  • aida-agent · docs/architecture/lifecycle-map.md L44–66 · Authority boundaries · e2adc9a3c325(历史引用:该文件在上一钉点与当前钉点均不存在,未能复核;见 ATLAS-DEBT)
  • aida-agent · docs/architecture/lifecycle-map.md L225–250 · Desktop projection · e2adc9a3c325(历史引用:该文件在上一钉点与当前钉点均不存在,未能复核;见 ATLAS-DEBT)
  • aida-agent · docs/architecture/message-center.md L1–35 · Message Center · e2adc9a3c325(历史引用:该文档已在 aida-agent 44d63e20 退役,上一钉点与当前钉点均不存在;见 ATLAS-DEBT)
  • aida-agent · packages/agent/src/orchestrator/critical-field-registry.ts L45–55 · selectCriticalFieldsForAgent · e2adc9a3c325
  • aida-agent · packages/agent/src/session/chat-submission-store.ts L1742–1782 · insertSubmitted · e2adc9a3c325

结论来自固定版本的静态源码与合同阅读;实现存在、默认开关和生产启用分别判断。本站代码证据面板列出声明状态与具体限制。

代码证据

引用核验检查固定 commit 的文件与范围;实现结论来自代码阅读。自动检查不证明生产环境已启用。

已核验实现

Kernel producer 清单含 local_file_save_as(purpose=collect_material, file_select)、structured_form(collect_structured_input)与 business_effect_authorization(authorize)。

aida-agentpackages/agent/src/interaction-kernel/producer-inventory.ts:17–477f2e519936b57902d4907ed8026fe1ecdd146e82符号:local_file_save_as
已核验实现

Business effect batch 是根 ActionProposal 保存的有界成员集合;Conversation Interaction 只结算这一份授权,成员 proposal 不是第二个 Kernel。

aida-agentGLOSSARY.md:832–8377f2e519936b57902d4907ed8026fe1ecdd146e82符号:Business effect batch
已核验实现

Conversation Interaction 是唯一用户输入生命周期权威;Desktop projection 仅为 presentation / composer / recovery affordances。

aida-agentpackages/agent/src/shared/interaction-kernel-state.ts:2–327f2e519936b57902d4907ed8026fe1ecdd146e82符号:Conversation Interaction
已核验实现

Desktop 投影位置为 source 或 offscreen_mirror;仅 source 可编辑,显式 submit 才打 settlement;本地草稿不是权威。

aida-agentpackages/agent/src/shared/interaction-kernel-state.ts:80–1107f2e519936b57902d4907ed8026fe1ecdd146e82符号:offscreen_mirror
已核验实现

Message Center 是通知读模型(摘要/指针/动作契约),不取代上游业务实体或 Interaction Kernel。

aida-agentpackages/agent/src/notifications/publisher.ts:14–447f2e519936b57902d4907ed8026fe1ecdd146e82符号:NotificationService.emit
已核验实现

critical fields 由 selectCriticalFieldsForAgent 按本轮工具与 sourceTools 交集选出,交给 ResponseGuard;不是 Interaction settlement。

aida-agentpackages/agent/src/orchestrator/critical-field-registry.ts:45–557f2e519936b57902d4907ed8026fe1ecdd146e82符号:selectCriticalFieldsForAgent
已核验实现

聊天 Local File 对话附件由 chat-submission-store 在写入 user message 后 insertSubmitted;不是 Interaction settlement 对象。

aida-agentpackages/agent/src/session/chat-submission-store.ts:1762–17927f2e519936b57902d4907ed8026fe1ecdd146e82符号:insertSubmitted