从一条企业任务看懂 AidaWork
一条企业任务的理解入口(整站先看
site-runtime)。图是辅读;先读本机制说明,结论以 NOTES + evidence 为准。 钉点:Agente2adc9a3c325· Desktop8eecd12081db· Pluginsa33ce3733365。
一句话
一次企业任务:用户从 Desktop 说话 → Agent 控制面受理并持有 Run / Interaction(交互生命周期,下称 IX)/ 效应账本 → 模型与工具在执行切片里干活 → 需要本机能力时跨到 Desktop Main;写有没有落地,只看账本,不看聊天气泡。 贯穿例子:用户要改企业系统里的一条记录——确认卡点同意只表示「可以继续执行」,最终是否写成功以效应账本结案为准,不是 SSE(服务端推送事件)投影一闪就成功。
控制面 vs 执行面
| 面 | 人话 | 深挖 |
|---|---|---|
| 厚控制面 | 会话绑定、准备执行、IX 结算、lease / 账本、恢复 | control-plane |
| 薄执行切片 | 有界模型轮次 + 工具调用(常称 ReAct 环);不拥有业务终态权威 | enterprise-task-e2e |
默认工作绑定是 runtime-work-v1(原工作);runtime-v2.1 文本入口在 2026-10-12 tip 已从 chat 移除(仅存量处理代码),chat 统一为 Work 路径;生产全量切流未核实——见 runtime-v2-status(新人建议先看 compare 对照)。
权威矩阵(一行)
Run / IX / LF(本机文件 Local File)Operation / 业务效应写在 Agent(SoT = Source of Truth,真相来源);Desktop 本地仓与 Message Center 是投影 / 通知,不能反写 SoT。详表 → state-authority。
主路径六步(人话)+ 深挖岔口
编号约定:焦点「1–3 理解顺序 / 4–6 任务流程 / 深挖岔口」与下列步骤对齐。前三步是理解顺序(先建立全景,不是运行时序);后三步才是任务流程。导读箭头 ≠ 执行时序。
- 整坨定位 — 上「一句话」。
- 控制面 vs 执行面 — 厚平面管状态,薄执行切片只跑有界轮次 →
control-plane。 - 谁说了算 — 权威矩阵一行;投影不是真相 →
state-authority。 - 任务进门 — Desktop 组装 →
POST /api/chat→ GatewayresolveAndRun(prepareExecution不调模型)。 - 模型与工具 —
composeDeps→orchestrate→ExecutionHostRouter。分清两层:(a)路由器能力上可接 Server / LF / Plugin / LE(Local Executor,本机执行器)等执行宿主;(b)钉点上 AgentRun 实际接入侧重server-read宿主;服务端连接器写的授权·声明·CAS 消费见write-authority,不要把「Router 可分发」读成「四条宿主都已走同一套写权限链」。密时序 →enterprise-task-e2e。 - 确认 · 结案 — IX 挂起 → settle → continuation 再跑;Desktop 只收 SSE/投影。确认 ≠ 写成功——写是否落地只看账本。写路径 →
write-authority。
深挖下一站(可点;按阅读顺序)
先控制面与权威,再端到端,最后专题:
- 控制面与权威:
control-plane·state-authority·ledger-authority - 端到端:
enterprise-task-e2e - 专题:
local-file-v5·write-authority·runtime-v2-status·trust-boundaries·storage-planes
步进图见本主题 main(无 trace 动画;焦点视图即章节)。更密时序与 fail/ok 对偶仍在 enterprise-task-e2e——入口链到本页,不把 dense 图当第一站。
读图约定(轻量漂移债)
- 钉点 SHA:结论只对 catalog 里三仓 commit 负责;工作区 tip 新于钉点时,先升钉再改 NOTES,禁止用未提交代码当证据。
- 现状 ≠ 默认开 ≠ 生产启用:图上「有实现」不等于开关默认开,更不等于正式环境已开。
runtime-v2.1、部分冷路径即此例。 - 未实现必须分栏/分色:如
write-authority的 tip 已有 vs #255/#257;禁止把缺口画成已落地。 - 行号 / 证据过期:
evidence:check对不上时,改 NOTES 行号或标债;本轮不重做站岗 bot。明显过期钉点记入ATLAS-DEBT.md,除非阻塞理解否则不大扫。 - 辅图:仓外
/workspace/aidawork-step-diagrams的 HTML 步进图可对照读;权威仍以仓内 NOTES + evidence 为准。
产品定位旁挂(非本页机制)
整站怎么跑见 site-runtime。对内材料 / 会前口径(延期框架、MSP ≠ 单纯多租户、Pack×Edition、通用/业务能力拆分)见 product-narrative(2026-10-29,产品叙事,非 tip 源码事实)。本页仍只讲一条企业任务的控制面 / 账本读法。
证据与范围
aida-desktop·apps/desktop/electron/agent-loop/enterprise-adapter.tsL65–123 ·prepareEnterpriseChatInput·4346d79eb364aida-agent·packages/agent/src/gateway/chat-routes.tsL255–266 ·createChatRoutes·e2adc9a3c325aida-agent·packages/agent/src/gateway/orchestrator-runtime.tsL372–379 ·resolveAndRun·e2adc9a3c325aida-agent·packages/agent/src/gateway/orchestrator-runtime.tsL283–313 ·composeDeps·e2adc9a3c325aida-agent·packages/agent/src/execution-host/router.tsL50–80 ·ExecutionHostRouter·e2adc9a3c325aida-agent·packages/agent/src/interaction-kernel/kernel.tsL226–258 ·InteractionKernel·e2adc9a3c325aida-agent·packages/agent/src/session/run-store.tsL658–688 ·UPDATE agent_runs·e2adc9a3c325aida-agent·packages/agent/src/runtime/work/run-work-admission.tsL16–57 ·bindAdmittedWork·e2adc9a3c325aida-agent·packages/agent/src/orchestrator/run.tsL630–646 ·InMemoryExecutionHandleStore/server-read·e2adc9a3c325
结论来自固定版本的静态源码阅读;实现存在、默认开关和生产启用分别判断。Router 可接宿主 ≠ AgentRun 已为各宿主接入同一写权限链。