v4.0.0-beta.2

Breaking Changes

Standard Go Error Handling

我们已采用标准的 Go 错误处理模式，将所有 API 统一为返回 error：

• 构造函数：*T → (*T, error)
• 设置方法：bool → error
• 查询方法：(T, bool) → (T, error)
• 运行方法：T → (T, error)

此变更提高了错误的可见性，符合 Go 语言的最佳实践。

AgentClient Options Pattern

NewAgentClient 现在使用选项模式进行构造，提供了更灵活的配置方式。

Controller Screenshot Options

SetScreenshot 方法已重构为选项模式，移除了分散的配置方法。

OverrideNext API Change

OverrideNext 方法参数类型从 []string 改为 []NodeNextItem，提供更清晰的结构化配置。

Type Name Corrections

• InterenceDevice → InferenceDevice
• OverriderImage → OverrideImage
• CustomAction → CustomActionRunner
• CustomRecognition → CustomRecognitionRunner

Method Renaming

• Context.GetNodeData → Context.GetNode

New Features

Resource.GetNode

新增 Resource.GetNode 方法。

TaskJob Error Tracking

TaskJob 现在会保存任务创建过程中的错误（如 JSON 序列化失败），新增 Error() error 方法用于获取错误信息。

Detailed Library Load Errors

新增 LibraryLoadError 类型，提供更清晰的库加载失败诊断信息。

Bug Fixes

• 修复了 Controller 事件回调中的资源清理问题
• 修复了若干类型名称拼写错误
• 修复了若干已知问题

Documentation

• 完善了 API 文档注释

Migration Guide

完整的迁移说明和受影响 API 列表请查看 CHANGELOG.md 。