02Interactive diagrams
OpenHands
Ten Archify diagrams. Each node carries SRC badges
that link to the exact lines they were drawn from. Nine are pinned to
OpenHands/software-agent-sdk@54daf05
(tag v1.53.0, the agent-server version Agent Canvas pins) and one to
OpenHands/OpenHands@7ea83ba.
10 张 Archify 图。每个节点都带有 SRC 标记，链接到绘制依据的具体源码行。
其中 9 张固定在 software-agent-sdk@54daf05（标签 v1.53.0，即 Agent Canvas 固定的 agent-server 版本），
1 张固定在 OpenHands/OpenHands@7ea83ba。图中文字为英文，中英文文章共用同一套图。
-
01architecture
Architecture
How Canvas, Agent Server, SDK and runtime fit together
Canvas、Agent Server、SDK 和运行时如何组合
Pinned to
software-agent-sdk -
02sequence
Execution flow
What happens from
POST /api/conversationsto anObservationEventon the WebSocket 从POST /api/conversations到 WebSocket 上出现ObservationEvent之间发生了什么 Pinned tosoftware-agent-sdk -
03architecture
Core abstractions
Which object owns what (Conversation, State, EventLog, View, Agent, LLM, Tool, Workspace, Condenser)
每个对象分别拥有什么（Conversation、State、EventLog、View、Agent、LLM、Tool、Workspace、Condenser）
Pinned to
software-agent-sdk -
04dataflow
Context flow
What enters the model context, what is excluded, how it is bounded
什么进入模型上下文、什么被排除、如何限制大小
Pinned to
software-agent-sdk -
05workflow
Agent loop
LocalConversation.run()+Agent.step(), early returns and recoveryLocalConversation.run()+Agent.step()，提前返回与恢复 Pinned tosoftware-agent-sdk -
06lifecycle
Conversation lifecycle
ConversationExecutionStatustransitionsConversationExecutionStatus的状态转换 Pinned tosoftware-agent-sdk -
07dataflow
Memory flow
Two-tier
MEMORY.md: writer, loader, injection, staleness 两层MEMORY.md：谁写、谁加载、如何注入、如何处理过时 Pinned tosoftware-agent-sdk -
08sequence
Tool runtime
Tool call → validation → confirmation → executor → workspace → observation
工具调用 → 校验 → 确认 → 执行器 → 工作区 → 观察结果
Pinned to
software-agent-sdk -
09sequence
Sub-agent flow
TaskTooldelegation and context isolationTaskTool委托与上下文隔离 Pinned tosoftware-agent-sdk -
10architecture
Canvas local stack
What
agent-canvaslaunches and how the ingress routesagent-canvas启动了什么、入口代理如何路由 Pinned toOpenHands/OpenHands
The diagram list (titles, types, questions, pins) lives in
_data/studies.yml.
Each diagram passed archify finalize --quality showcase --repo-root <pinned checkout>
(schema validation, verified delivery, strict provenance check, real-browser check)
and archify visual-check (light/dark, 1440×900 and 2048×1320). Receipts with
specification/artifact SHA-256 and the number of verified source references are in
assets/openhands/archify/receipts.json.
The JSON specifications (Archify candidates) and a regeneration recipe are in assets/openhands/archify/.
每张图都通过了 archify finalize --quality showcase --repo-root <固定版本的检出目录>（schema 校验、可验证交付、严格的来源检查、
真实浏览器检查）和 archify visual-check（亮色/暗色，1440×900 与 2048×1320）。包含规格/产物 SHA-256 和已验证源码引用数的回执见
receipts.json；JSON 规格与重新生成步骤见 assets/openhands/archify/（链接同上）。