Node CLI 命令参考

先分清四层：已安装的二进制、账号凭证、这台机器的身份、正在运行的进程。

接入账号

• login — 交互登录，然后在后台启动
• pair — 等待 Desktop 或 App 认领一次性码
• join [CODE] — 兑换 Desktop 加入码
• logout — 清除账号凭证并停止，保留机器身份

常用参数：--name 'lab-1'、--no-start、--foreground；支持确认的命令可加 --yes。

运行与查看

• start / stop — 改变进程状态，不改变登录
• autostart status|on|off — 查看或修改自动启动
• info — 查看账号、身份、进程与路径
• where — 查看二进制、数据目录和相关环境变量
• logs、logs -n 200、logs --once — 跟踪或查看日志
• code — 显示永久短码
• version — 显示二进制版本
• lang — 查看或设置持久化的 CLI 语言

诊断与重置

• doctor — 检查二进制、API、账号与进程，并给出修复建议
• reset --auth — 清凭证，保留机器身份
• reset --identity — 清身份；下次接入时创建或认领新的云端身份
• reset --all — 删除全部本地配置

升级与卸载

• upgrade — 安装最新已审核二进制，保留配置
• uninstall — 删除二进制
• uninstall --purge — 删除二进制和配置

若安装过程替换了正在运行的 Node，通常会自动停止并重启。只有明确想换文件但不重启时，才设置 AIHPER_NO_RESTART=1。

身份规则

logout 不等于“忘掉这台机器”。instance ID 会保留，之后登录可认回同一条云端记录。只有明确要新身份时才用 reset --identity。