概览

Xiaohe Agent 分三层，上手时的困惑多半来自漏掉其中一层。

层	是什么	在哪里
Agent	引擎 —— `xiaohe` 运行时，带着技能和你的工作区	你自己掌控的电脑
Session	引擎对外提供的 HTTP 服务。窗口连的是 Session，不直接连引擎	同一台电脑、你的另一台机器，或别人代你运行的主机
窗口	聊天界面 —— 桌面客户端、浏览器 Web UI、iPhone	你手上的设备

装好 Agent 并启动 Session 是同一件事，窗口则是另一次安装，可以放在别的设备上。

Session 可以放在哪里

窗口和它的 Session 不必在同一台机器上。

三种形态都只需要两样东西：一个地址，一把 Session 密钥。

用在哪里	起什么作用	长什么样
设置 → 助手	模型能出话	各家服务商自己的 key 格式
设置 → 服务器	某个 Session 的聊天权限。本机安装会替你写好，同一账号的设备会自动同步	`xh_ses_…`
设置 → 授权与密钥 → 许可证	桌面专业版功能，来自账号中心	`xh_lic_…`
设置 → 授权与密钥 → 云钥匙	云端服务 —— MCP、DERP 与模型网关	`xh_cld_…`

Session 密钥不能解锁专业版，授权也不能开始聊天。绝大多数“用不了”的反馈，都是这两样贴错了地方。

在 设置 → 账号 登录后，这台电脑和手机就属于同一个账号：Session 钥匙随登录同步，你的其他电脑也会出现在设备列表里。