OpenHands 把 Agent 的一举一动都显式建模成数据结构。整个 Agent 循环就一句话：

所有动作都继承一个基类，靠一个 kind 字段区分是哪种动作（base/base.ts:40）：

export interface ActionBase<T extends ActionEventType = ActionEventType> {
  kind: T;      // 判别式：告诉你这是哪种动作
}

OpenHands 的 Agent 能发出这些动作（节选自 frontend/src/types/v1/core/base/action.ts）：

简化版 → 真实版对照：如果让你自己设计"跑命令"动作，多半是这样——

// 你的朴素版：一个字段就够了吧？
interface RunCommand { command: string; }

能用，但真实终端会遇到三种麻烦：命令进入交互（问你 y/n）怎么办？命令跑 1 小时不结束怎么办？终端彻底卡死怎么办？看真实版怎么各补一个字段（action.ts:25-42）：

export interface ExecuteBashAction extends ActionBase<"ExecuteBashAction"> {
  command: string;        // 要执行的 bash 命令（Ctrl-C 可中断）
  is_input: boolean;      // true=向"正在运行的进程"输入；false=执行一条新命令
  timeout: number | null; // 超时秒数
  reset: boolean;         // true=重建终端会话（终端卡死时用）
}

{ kind: "ExecuteBashAction",
  command: "python -m pytest",   // 要跑的命令
  is_input: false,               // 这是一条新命令（不是喂给交互进程）
  timeout: 120, reset: false }

改文件用一套"子命令"设计（action.ts:63-123），这是业界（Anthropic str_replace_editor）的经典模式：

export interface FileEditorAction extends ActionBase<"FileEditorAction"> {
  command: "view" | "create" | "str_replace" | "insert" | "undo_edit";
  path: string;              // 文件路径
  file_text?: string;        // create 时的完整内容
  old_str?: string;          // str_replace：要被替换的原文
  new_str?: string;          // str_replace：替换成的新文
  insert_line?: number;      // insert：插在第几行
}

每种动作，基本都有一个对应的观察结果（base/observation.ts）。比如跑命令的结果（observation.ts:57-82）：

export interface ExecuteBashObservation extends ObservationBase<"ExecuteBashObservation"> {
  content: Array<TextContent | ImageContent>;  // 命令的输出
  command: string | null;
  exit_code: number | null;   // 退出码；-1 表示软超时、进程还没结束
  error: boolean;
  timeout: boolean;
  metadata: CmdOutputMetadata; // 工作目录、用户名等（从终端提示符 PS1 抓的）
}

• 可观测：一切行为都是数据 → 能存、能回放、能审计、能在 UI 实时看。
• 可安全管控：动作执行前可拦截、可要求人工确认（每个 ActionEvent 还带 security_risk 风险评估，Day 03）。
• 可对称处理：Action/Observation 孪生 → 运行时逻辑统一、前端渲染统一。
• 省钱高效：像 str_replace 这种细粒度动作，避免大模型重复输出大段内容。

✋ 动手：读真实类型定义

# 1. 动作全家福
sed -n '1,60p' frontend/src/types/v1/core/base/action.ts

# 2. 精读 bash 动作 + 文件编辑动作
sed -n '25,123p' frontend/src/types/v1/core/base/action.ts

# 3. 对称的观察
sed -n '57,140p' frontend/src/types/v1/core/base/observation.ts