跳到主要内容

高级使用

终端路线：xiaohe 命令、终端聊天、为窗口运行 Session、模型服务商。本页所有操作都在承载 Agent 的那台机器上进行。

先安装 Agent，见快速开始。新装之后，新开一个终端，看看还缺什么：

xiaohe init      # 安装器若有遗留步骤，从这里继续
xiaohe doctor    # 报告还缺什么

xiaohe init 是续跑而不是重跑，重复执行是安全的。

终端聊天​

想让回复出话，先要一个模型 key，见模型服务商。

xiaohe                 # 启动默认智能体
xiaohe workspace init  # 初始化项目工作区（可选）

为窗口运行 Session​

xiaohe server ensure   # 安装 + 启动 + 在这台机器还没有密钥时写一把

桌面客户端、Web UI 和手机连的都是这一步拉起的服务。xiaohe server pair 再签一把新密钥、只打印一次，并默认写进桌面设置文件（--write-client）。浏览器不读这个文件，它的密钥要手工粘贴。

查看服务状态：

xiaohe server status
xiaohe server doctor
xiaohe server logs

密钥日后用 xiaohe keys issue|list|revoke … 管理。Session 密钥只用于聊天 —— 它既不是专业版授权，也不是云端密钥。概览把四类凭据放在一起对照。

模型服务商​

新装的机器还没有 DeepSeek 预设。先添加，再切换：

xiaohe provider add DeepSeek --kind deepseek --switch
xiaohe switch provider                         # 列出预设
xiaohe switch provider deepseek                # 切到已有的 DeepSeek 预设
xiaohe switch provider kimi --model kimi-k2.6 --base-url <URL>
xiaohe switch provider claude

add 会用隐藏输入提示贴 key。同命令的 --key 参数是给脚本用的 —— 它会落进 shell 历史。

xiaohe provider 也能列表、删除和存 key。key 只留在那台机器上，应用里的 设置 → 助手 是同一处设置。

更新与卸载​

xiaohe upgrade           # 公开通道
xiaohe upgrade --beta    # 浸泡通道
xiaohe uninstall

命令速查​

范围命令
本机status · version · doctor · init（setup）· upgrade · uninstall · switch · provider · completion
服务ensure · install · start · stop · restart · status · doctor · logs · pair · uninstall

日常优先用这些生命周期命令，而不是系统服务内部调用的前台辅助命令（server api、worker 之类）。

对接集成​

  • Session API —— REST 端点，从你自己的工具与流水线驱动智能体
  • 模型网关 —— 一个 Anthropic 兼容端点访问 DeepSeek、Kimi 与 Claude

相关​