Files
MujicaUI/docs/components/276-sandbox-status.md
ZacharyZhang-NYandClaude Opus 5.5 bcce34cda1 Upgrade MyGo to v0.5.5
MyGo v0.5.5 returns ui.Element as a checked value handle instead of a
pointer. Migrated with `mygo migrate-ui`, then fixed what the codemod
leaves to review:

- Element nil checks become .Valid(); absent elements are ui.Element{}.
- Input handlers and paint callbacks run outside the build pass, where
  elements expire and Context methods are inert: read IsDisabled into a
  local during the build, keep a ui.Handle for Focus, use c.Services()
  for clipboard access, create ui.Local state during the build.
- Add core.AutoFocus: v0.5.5 records an overlay's opener after its
  content builds, so same-frame autofocus lost focus restore on close.
  It focuses one frame later; cascader rows defer their focus likewise.
- core.OverlayLayer identifies build passes by the root element, not
  c.Now(), which repeats across passes and under the Tester clock.
- Context menus survive the opening press counted as PressedOutside;
  split button tooltip no longer reorders its open menu; disabled
  menubar rows pass presses to the panel; Form defers blur-started
  async checks so the growing message no longer moves Submit away
  from the release; Combobox drops its disabled copy now that MyGo
  blocks typing under a disabled wrapper (canary flipped to a guard).
- The Tester clock is virtual: tests use Advance/Now instead of
  time.Sleep/time.Now and read element state inside the view. The web
  mirror advances the clock to wall time before each frame and input.
- AGENTS.md and docs describe the value Element API and the new pin.

Snapshot goldens are darwin-only and were not re-verified here.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-10-17 01:37:54 -04:00

1.4 KiB
Raw Permalink Blame History

276 SandboxStatus 沙箱状态

用途

显示沙箱的运行状态、资源占用和剩余时间。

最小示例

info := agent.SandboxInfo{Name: "sandbox-7", State: agent.SandboxRunning,
	Resources: []agent.SandboxResource{{Name: "CPU", Used: 1.5, Limit: 2, Unit: "cores"}}}
view := func(c *ui.Context) {
	core.Use(c, core.Settings{})
	agent.SandboxStatus(c, info, agent.SandboxStatusOptions{})
}
ui.Render(view, 400, 300, 1)

签名:func SandboxStatus(c *ui.Context, info SandboxInfo, opts SandboxStatusOptions) ui.Element。状态未知、资源名为空、Limit 不大于 0 或 Used 不在 0 到 Limit 之间时 panic。

参数

字段 类型 默认值 含义
Still bool false 停止执行中动画;系统减少动画时也自动静止。

状态

  • SandboxInfo 字段:Name、State(SandboxStarting、SandboxRunning、SandboxStopped、SandboxFailed)、Resources、Expires。
  • 每项资源显示“已用 / 上限 单位”与细条;达到 90% 时加警示图标和“接近上限”说明。
  • 设置 Expires 且运行中时显示剩余时间,每秒刷新;到时显示“已到时”。

事件

  • 无事件。

键盘操作

  • 不获取焦点。

限制

  • 倒计时依赖界面帧,窗口隐藏时 MyGo 暂停帧,重新显示后立即校正。