LinkSoul AgentSDK for Java v1.4.0

⚠️ 验签方式标准化（不兼容 v1.3.0 及更早版本）/ Breaking auth change
v1.4.0 已遵循灵心开放平台规范，对 SDK 的鉴权（验签）方式做了标准化改造，v1.3.0 及更早版本无法直接平滑升级：
项目 v1.3.0 及更早 v1.4.0
网关 URL wss://agentsdk.agibot.com/v1/agentsdk wss://open.agibot.com/api/V1/open-portal/app/wss/agent-sdk
凭证来源灵心平台「二开智能体模板」灵心开放平台「应用」（新增 appKey）
创建方法 AgentSdk.create(url, appId, appSecret) AgentSdk.create(url, appId, appKey, appSecret)
鉴权机制 JWT（AGIBOT_AUTHORIZATION 请求头） HMAC-SHA256（5 个请求头：X-App-Id / X-App-Key / X-Timestamp / X-Nonce / X-Signature）
回调类型 JWT payload 独立请求头 X-Callback-Types（JSON 数组字符串）
升级路径见 zh/CHANGELOG.md / en/CHANGELOG.md。
v1.4.0 standardises the AgentSDK signing scheme to match the LinkSoul open-platform spec and is NOT backward compatible with v1.3.0 or earlier. JWT auth (one AGIBOT_AUTHORIZATION header) is replaced by HMAC-SHA256 with five signed request headers (X-App-Id / X-App-Key / X-Timestamp / X-Nonce / X-Signature); AgentSdk.create() gains a new appKey parameter, credentials are issued by the open-platform application page, and the gateway URL has changed. See the CHANGELOGs above for the full migration path.

项目	v1.3.0 及更早	v1.4.0
网关 URL	`wss://agentsdk.agibot.com/v1/agentsdk`	`wss://open.agibot.com/api/V1/open-portal/app/wss/agent-sdk`
凭证来源	灵心平台「二开智能体模板」	灵心开放平台「应用」（新增 `appKey`）
创建方法	`AgentSdk.create(url, appId, appSecret)`	`AgentSdk.create(url, appId, appKey, appSecret)`
鉴权机制	JWT（`AGIBOT_AUTHORIZATION` 请求头）	HMAC-SHA256（5 个请求头：`X-App-Id` / `X-App-Key` / `X-Timestamp` / `X-Nonce` / `X-Signature`）
回调类型	JWT payload	独立请求头 `X-Callback-Types`（JSON 数组字符串）

选择语种 / Choose locale

语种 / Locale	入口
简体中文	zh/index.md
English	en/index.md

章节速览 / Section quick-links

Section	中文	English
Home / 首页	zh/index.md	en/index.md
Quick Start / 快速开始	zh/guide/quickstart.md	en/guide/quickstart.md
Architecture / 架构	zh/guide/architecture.md	en/guide/architecture.md
Passive guide / 被动交互	zh/guide/passive_callbacks.md	en/guide/passive_callbacks.md
Active guide / 主动交互	zh/guide/active_operations.md	en/guide/active_operations.md
Task-flow payload / 任务流协议	zh/guide/taskflow_payload.md	en/guide/taskflow_payload.md
Semantic skills / 语义技能	zh/guide/skills.md	en/guide/skills.md
Error handling / 错误处理	zh/guide/error_handling.md	en/guide/error_handling.md
AgentSdk API	zh/api/agent_sdk.md	en/api/agent_sdk.md
Passive callbacks API	zh/api/passive_callbacks.md	en/api/passive_callbacks.md
Active requests API	zh/api/active_requests.md	en/api/active_requests.md
Enums	zh/api/enums.md	en/api/enums.md
Passive examples / 被动示例	zh/examples/passive_examples.md	en/examples/passive_examples.md
Active examples / 主动示例	zh/examples/active_examples.md	en/examples/active_examples.md
Glossary / 名词解释	zh/glossary.md	en/glossary.md
Changelog	zh/CHANGELOG.md	en/CHANGELOG.md

跨语言对照 / Cross-language counterparts

同版本号的 Python SDK 文档与本套接口等价。 The Python SDK docs at the same version expose an equivalent API surface.