把任意机器变成你的 Node

logout 只清账号凭证，保留本机编号（短码），下次登录仍识别为同一节点。要忘掉本机用 reset --identity 或 reset --all。

日常

• aihper 登录登录并后台启动（回到 shell；展示名默认 hostname）
• aihper 配对生成配对码并等待 Desktop 认领（无需账密）
• aihper 加入用 Desktop 加入码连接并启动节点；可命令行带码或隐藏输入
• aihper 加入 <加入码>带加入码一行命令加入并启动节点
• aihper 退出退出账号：清凭证；本机编号（短码）仍保留，下次登录仍识别为同一节点
• aihper 启动已登录时启动进程（默认后台）。电脑关机/重启、stop 之后，或 login --no-start 后需要再用；刚 login 过一般不用。
• aihper 停止只停进程，不清登录凭证
• aihper 开机启动 status查看当前是否已开启登录/开机自动启动
• aihper 开机启动 on开启登录/开机自动启动节点（需已 login / pair / join）
• aihper 开机启动 off关闭开机自动启动
• aihper 总览完整状态总览：登录、身份、进程、路径
• aihper 位置只看位置：二进制、数据目录、环境变量（别名 paths）
• aihper 语言查看或设置界面语言（写入配置）
• aihper 日志持续跟踪日志（先打最近若干行，再一直输出）
• aihper 日志 -n 200先看最近 N 行，再持续跟踪
• aihper 日志 --once只看最近日志，不持续跟踪
• aihper 短码打印本机短码，供 Desktop 识别/挂载（别名 shortcode）

安装

在线节点也可在桌面端「节点管理」远程升级。

• aihper 升级本机下载并覆盖最新二进制（保留配置）。若进程在跑，安装脚本会自动重启；设 AIHPER_NO_RESTART=1 会跳过重启。在线时优先用桌面端远程升级。
• aihper 卸载删除二进制
• aihper 卸载 --purge删除二进制并清空本地配置

排障

• aihper 诊断诊断常见问题并给出一条修复建议
• aihper 重置 --auth只清账号凭证（等同 logout，编号仍在）
• aihper 重置 --identity清掉本机编号；下次登录在云端会当成新机器
• aihper 重置 --all删除整个 ~/.config/aihper（凭证+编号全清）

更多命令

• aihper 登录 --name 'lab-1'可选：登录时指定展示名（默认同 hostname；也可之后在桌面端改别名）
• aihper 登录 --no-start只存凭证、不上线（例如交给 systemd 再 start）
• aihper 登录 --foreground登录后前台运行节点（阻塞当前终端，适合调试）
• aihper 启动 --foreground前台启动（systemd / 调试用；默认 start 已是后台）
• aihper 语言 zh设置为中文并保存
• aihper 语言 en设置为英文并保存
• aihper 语言 de设置为德语并保存
• aihper 语言 es设置为西班牙语并保存
• aihper 语言 pt设置为葡萄牙语并保存

reset / uninstall --purge 可加 --yes 跳过确认。若被桌面端远程退出，再执行 login 即可。