使用 ui.inflate 动态添加 UI 元素时报错，出现 NullPointerException 并提示 ScriptRuntime ... on a null object reference，其根本原因是：当前脚本执行环境没有正确初始化 UI 模块所需的运行时上下文（ScriptRuntime）。

这个错误通常发生在以下场景：

❌ 错误发生场景

1. 在非 UI 线程或定时任务中直接调用 ui.inflate
   Hamibot 的 UI 模块（如 ui.inflate）只能在创建了 UI 运行环境的上下文中使用。如果你在：

   • 定时任务（非前台活动）
   • 后台服务脚本
   • REST API 触发的脚本
   • 或通过 threads.start() 开启的子线程中

   直接调用 ui.inflate，就会因为缺少 Activity 或 ScriptRuntime 上下文而报空指针异常。

2. 尝试在无界面环境下动态构建布局
   ui.inflate 是用于在 UI 脚本（如悬浮窗、配置页） 中解析 XML 布局字符串并生成视图组件的方法。它依赖于一个正在运行的 Activity 或 Dialog 环境。如果脚本本身没有启动任何 UI 界面，该环境就不存在。

✅ 正确使用条件

你只能在如下环境中安全使用 ui.inflate：

• 使用 ui.layout(...) 或 ui.setContentView(...) 创建了 UI 界面之后。
• 在 ui.main 线程中执行。
• 脚本已启用“显示悬浮窗”权限，并且是在前台运行的交互式脚本。

✅ 解决方案与替代做法

✅ 方案一：确保在正确的 UI 上下文中调用

// 文档地址 https://docs.hamibot.com/
ui.layout(
  <vertical>
    <text id="status">等待更新...</text>
    <button id="btn">点击添加</button>
  </vertical>
);

// 正确：在 ui.layout 之后，可以安全使用 inflate
ui.btn.click(() => {
  let view = ui.inflate(
    <horizontal>
      <text text="新添加的文本" />
      <input text="输入框" />
    </horizontal>
  );
  // 假设你有一个容器
  if (!ui.container) {
    ui.addView(view);
  } else {
    ui.container.addView(view);
  }
});

⚠️ 注意：ui.inflate 只能用于 <tag>...</tag> 这种 XML 格式的布局，且必须配合 ui.layout 或 ui.addContentView 使用。

✅ 方案二：避免在后台脚本中使用 UI 相关方法

如果你的脚本是纯自动化任务（例如定时打卡、后台点击），不要使用 ui.inflate。你应该将 UI 展示逻辑和自动化逻辑分离：

• 用一个脚本负责用户交互（UI 脚本）
• 另一个脚本负责执行任务（无 UI）

两者可通过 global 变量或文件进行通信。

✅ 方案三：使用原生 Android API 替代（谨慎使用）

若确实需要动态创建视图，请确保已在 UI 环境中，并使用标准方式添加：

// 文档地址 https://docs.hamibot.com/
let context = activity.getApplicationContext();
let linearLayout = new android.widget.LinearLayout(context);
linearLayout.setOrientation(android.widget.LinearLayout.HORIZONTAL);

let textView = new android.widget.TextView(context);
textView.setText("动态文本");
linearLayout.addView(textView);

// 添加到已有布局
ui.addContentView(linearLayout, new android.view.ViewGroup.LayoutParams(
  android.widget.LinearLayout.LayoutParams.WRAP_CONTENT,
  android.widget.LinearLayout.LayoutParams.WRAP_CONTENT
));

但依然要求你在 ui.layout 初始化后才可操作。

🔚 总结

✅ 最佳实践建议：

• 不要在后台任务、定时任务、API 触发中使用 ui.inflate。
• 所有 UI 操作必须在 ui.layout 初始化后的主线程中进行。
• 如需动态更新界面，请先定义好容器 <vertical id="container" />，再用