Skip to main content
xkat-cli 是 xkat 的命令行包。一个 xkat 命令提供 两种工具，请勿混淆。

下载页

在 xkat.space/download 获取桌面版与 CLI

在 npm 查看

npm 上的 xkat-cli

​
安装

xkat-cli 每天检查一次 npm 上是否有新版本，并用一行提示告知（不会自动更新）。 更新请用 npm install -g xkat-cli@latest。要关闭提示，设置 XKAT_NO_UPDATE_CHECK=1。
需要 Node.js 18+。参见本地环境。桌面应用的 Tools 菜单也可运行相同命令。

​
1) Agent

用 Agent 将 Dynamic Workspace 连到本机。

​
功能

本地 Shell

Web 终端 ↔ 本机 shell

文件同步

工作目录与 Web 同步

仅 localhost

127.0.0.1:38000–38050

后台运行

xkat-cli up

​
命令

​
安全

  • 仅本机端口
  • 仅官方域名可连接
  • ~/.xkat/agent.log
  • 在 Windows 主机终端中运行：Agent 与 Windows 主机浏览器通信。请在 Windows PowerShell/CMD 中运行 npx xkat-cli@latest up，而非在 WSL 内运行。
  • PermissionDenied (10013) 错误：当 Hyper-V/WSL2 (winnat) 占用 38000–38050 端口时发生。请在管理员 PowerShell 中依次运行 net stop winnat 和 net start winnat。

​
2) Lab

面向 Linux、网络与 Agent 课程的 Ubuntu 24.04。无需自行配置虚拟机。

​
命令

​
典型流程

  1. xkat-cli lab install
  2. xkat-cli lab up
  3. xkat-cli lab shell
  4. xkat-cli lab stop / xkat-cli lab delete

​
Agent vs Lab

​
桌面应用

从下载页安装。安装文件按 …/desktop/v{version}/… 提供，与页面显示的版本一致。 应用内置 xkat-cli，在应用中使用时无需 npm install。标题栏的 Tools 会用这份内置副本运行 Agent / Lab 命令。Lab: Open Shell 会打开系统终端。更新的应用会带来更新的 xkat-cli；通过 npm 单独安装的副本需要单独更新。 登录在系统浏览器中进行，完成后应用会自动登录(127.0.0.1 回环重定向，授权码 + PKCE)。

​
与云端工作区的关系

​
更多