273 ScreenshotStream Agent 画面流

用途

查看 Agent 的画面帧序列：默认跟随最新帧，可暂停并逐帧前后查看。帧由调用方提供。

最小示例

var st agent.ScreenshotStreamState
var frames []agent.ScreenshotFrame // appended as the agent captures them
view := func(c *ui.Context) {
	core.Use(c, core.Settings{})
	agent.ScreenshotStream(c, &st, frames, agent.ScreenshotStreamOptions{})
}
ui.Render(view, 400, 300, 1)

签名：func ScreenshotStream(c *ui.Context, st *ScreenshotStreamState, frames []ScreenshotFrame, opts ScreenshotStreamOptions) ChoiceResult。st 为 nil、帧没有图像或 Height 为负时 panic。

参数

状态

• ScreenshotFrame 字段：Image（ui.ImageSource）、Caption、At。
• ScreenshotStreamState 字段：Index、Paused；未暂停时 Index 总是最后一帧。
• 逐帧操作会自动暂停；“回到实时”恢复跟随。
• 没有帧时显示“等待画面”。

事件

• Changed()：用户暂停、恢复或移动了帧。

键盘操作

• Tab 到画面区：← → 逐帧，Space 暂停或恢复；上一帧、下一帧按钮同样可用。

限制

• 不解码视频，帧图像由调用方提供。