名词解释 / Glossary
名词解释 / Glossary
本页汇总 LinkSoul AgentSDK（JS / 浏览器）文档中的核心术语。跨语言共享的业务概念、模型术语、JSON 协议字段与各语言一致，这里只补充 JS / 浏览器特有的约束，避免与平台级术语重复。
一、JS 特有的接入约束
| 名词 | 解释 |
|---|---|
| 同源服务端代理 | 浏览器无法设 WebSocket 自定义头，需你的服务端用 appSecret 签名、连上游网关，再把本地代理 URL 交给浏览器。是 JS SDK 鉴权的唯一方式。 |
authProvider | ConnectionOptions 里的回调，async () => ({ url, protocols? })。每次 connect() 与重连时被调用，返回已鉴权的代理 URL。 |
| 心跳转换契约 | SDK 发 JSON {"type":"ping"} 文本，代理转协议级 PingFrame；代理再把 Pong 合成 JSON 回浏览器。缺失则心跳超时。 |
| 安全上下文 | 浏览器里麦克风、crypto.randomUUID 仅在 https / localhost 可用。 |
二、SDK 术语
| 名词 | 解释 |
|---|---|
AgentSdk / createAgentSdk | JS SDK 主入口，按 appId 单例（同 appId 复用实例）。 |
AgentConnection | 连接编排层：connect() / close() / on(event, listener)，自动重连（默认 3s）。 |
KeepAliveController | 连接层保活：空闲探测 → 超时关闭触发重连（区别于 TeleopSession.keepAlive() 探测机器人是否在线）。 |
TeleopSession | 超视距遥操会话：enter() / startAudio() / sendAudio() / finishAudio() / keepAlive() / exit()。 |
ExtSkillSession | 扩展技能会话：query() 查清单 / invoke(extSkillId, input) 触发执行。 |
sn | 遥操按 机器人硬件序列号 寻址（与 agentId 区分）；TeleopSession 报文 sn 字段即此。 |
agentMode | 每条上行报文的模式标记，遥操恒为 AgentPolicy.Teleop（"teleop"），扩展技能恒为 AgentPolicy.ExtSkill（"extskill"）。 |
newEventId() | 生成 event_<base36>_<seq>_<hex> 事件 ID。 |
message 事件 | JS SDK 无回调类，所有下行经 sdk.on('message') 拿到 { data }，业务侧 JSON.parse 后按 type 分派。 |
三、模型与音视频
| 名词 | 解释 |
|---|---|
| ASR / LLM / VLM / TTS / VAD | 与平台级语义一致（语音识别 / 大语言模型 / 视觉语言模型 / 语音合成 / 语音活动检测）。JS SDK 目前不直接承载这些（被动交互未实现）。 |
| 遥操音频上行格式 | 24kHz / 16bit / 单声道 / 40ms 一帧（960 样本 = 1920 字节），sendAudio 逐帧发 base64 teleop_audio.delta。 |
gain | sendAudio 的音频增益倍数，默认 1.0，<=0 归一为 1.0，>10 截为 10.0。 |
audioLen | 每帧 base64 解码后的字节数，SDK 自动计算并下发，供服务端做完整性 / QoS 校验。 |
四、交互模式
| 名词 | 解释 |
|---|---|
| 被动交互（Passive） | 机器人发起 → SDK 处理 → 返回 ASR/LLM/VLM/TTS/技能。JS 暂未提供。 |
| 主动交互（Active / 任务流） | SDK 主动向机器人下发多步任务。JS 暂未提供。 |
| 超视距遥操（Teleop） | ✅ v1.5.0 JS 已提供：Web 操作员经服务端代理接管机器人的实时语音收发。 |
| 扩展技能（ExtSkill） | ✅ v1.5.0 JS 已提供：query() 查机器人扩展技能清单 / invoke() 触发指定技能。 |
五、对话决策与拒识
| 名词 | 解释 |
|---|---|
| 拒识（Reject） | 对话系统对"无法 / 不应处理"的输入选择静默或兜底。被动交互能力，JS 未实现，语义见各原生语言 被动交互指南。 |