Skip to content

会话锚点(Conversation Anchor) ​

会话锚点(Conversation Anchor)是 Runtime 为 LocalAgent 的持久 Conversation 签发的连续性标识,帮助已授权界面接续同一段对话。它不是访问凭证,也不能替代当前会话的 agentHandle。

会话锚点与 LocalAgent 的身份 ID 相互独立,绝不能通过 UI 路由参数、Avatar 具身实例 ID、前端本地消息缓存或先前活跃的智能体状态进行推断或拼接。

会话的创建、轮次提交、状态快照、异常恢复与中断,均由 Runtime 统一管控并对外提供标准化投影视图。每个 LocalAgent 对应唯一的活跃主会话上下文:首次打开时建立,后续所有获得授权的调用方均接入相同的已提交会话流。调用方应当妥善保存 SDK 返回的 Runtime 会话锚点,将其作为连续性标识;会话锚点不用于隔离应用私有分支或窗口私有历史。

会话创建与状态恢复 ​

调用方通过 SDK 提交结构化的操作意图并传入会话级 agentHandle。在创建或恢复会话前,Runtime 会依据当前活跃的安全会话严格核验用户账号、应用身份、授权范围以及对目标 LocalAgent 的访问策略。

会话的状态恢复完全依赖 Runtime 维护的锚点索引与运行时状态快照。前端本地存储的消息记录仅充当 UI 渲染缓存:它无法作为状态证明,更无法反向重构会话流、长期记忆或知识库的真实上下文。

视图投影与安全边界 ​

获得授权的调用方可以订阅当前会话中已提交的对话轮次与结构化执行状态。大模型服务商的原始 Token 序列、解析器底层数据、认证凭据、系统提示词(System Prompt)以及 Runtime 内部鉴权凭据始终保持私有隔离。

Avatar 渲染模块可以将角色的 2D/3D 具身形象挂载到已授权的会话锚点上进行呈现。Avatar 的实例 ID 与渲染管线状态既无法创建会话,也不能作为会话存在的有效证明。

Source Basis ​

Nimi 文档:可安装、开源、本地优先的个人 AI 产品。