跳到主要内容

Xiaohe Client

桌面壳，聊天 UI 与 Web UI 相同。连接本机或远程 Session API。

安装：安装与更新。短地图：概览。

本机聊天（典型）​

  1. 安装 Agent 与 Client。
  2. 启动 Session：
xiaohe server install
xiaohe server start
  1. 签发 Session 密钥（用于聊天——不是 Pro License）：
xiaohe server pair
  1. 打开 Client → 设置 → 连接 → 本机（http://127.0.0.1:8110）。
  2. 将 xh_… 粘贴到 小荷服务密钥 → 测试密钥。
  3. 可选：设置 工作区路径（常见 ~/workspace）。
  4. 新会话 → 发消息。

若模型失败，在本机配置 provider：xiaohe switch provider … 或 设置 → 助手。

设置 → 连接 → 本机服务 可在应用能调用本机 xiaohe server 时查看状态 / doctor / 重启。

远程或托管 Session​

  1. 设置 → 连接 → 添加远程服务器（或 Cloud → https://agent.xiaohe.team）。
  2. 填写该主机的 API 地址 + Session 密钥 → 测试密钥 → 聊天。

首次启动与 Pro​

  • 打开应用；macOS 可能需 右键 → 打开 一次。
  • 桌面 Pro 约 7 天试用；之后在 设置 → 授权 激活 License（xh_lic_…，来自 账号中心）。
  • 聊天仍需在 连接 里填 Session 密钥。MCP / Skills Hub 用授权里的 xh_mcp_…。

聊天界面​

侧栏会话 · 输入框 · 需要时出现批准条 · skills / /skill-name · 可导出。

可选（Pro）​

设置 → 私网：应用内 Tailnet（不是系统 Tailscale）。Session 在私网另一台机器上时，API 地址可用如 http://100.64.x.x:8110。

出问题​

现象处理
离线xiaohe server status 或本机服务面板
401 / 密钥无效再跑 xiaohe server pair，粘贴新密钥
激活闸门粘贴 Pro License，或改用无桌面 Pro 的 Web UI
Provider 错误在 Session 主机上配置 provider

更新： Client 走 设置 → 更新；Agent 走 xiaohe upgrade。

相关​