Astra Gate安装与卸载
install / update / uninstall / set-password
安装桌面端
astra install --desktop
# 未全局安装 CLI 时：
npx @aidotnet/astra-gate install --desktop下载并安装当前平台的 Astra 桌面应用（Electron），并在 ~/.astra/install.json 记录服务端位置供桌面端使用。--client 是 --desktop 的旧写法，仍然可用。详见桌面端。
更新
astra update # 更新 CLI；若装了桌面端也一并更新，最后重启服务
astra update --desktop # 只更新桌面端版本一致性
CLI、服务端与控制台界面共用同一版本号。如果控制台顶部提示「服务端 API 版本与界面不一致」，
运行 astra update 并重启服务即可对齐。
管理密码
astra config set-password交互式输入并保存管理密码（用于对外监听时的控制台登录）。密码验证后才能把服务监听到非环回地址；忘记密码重新执行本命令即可重设。
卸载
astra uninstall # 停止服务 + 还原所有被接管客户端 + 移除自启动
astra uninstall --desktop # 只卸载桌面端
astra uninstall --purge # 连 ~/.astra 数据目录一起删除卸载顺序：先按 restore-all 的逻辑还原客户端配置（漂移项会先询问），再停止服务、移除 LaunchAgent / systemd / schtasks 条目。
--purge 删除全部本机数据
--purge 会删除 ~/.astra（请求记录、模型与提供商配置、客户端备份、密钥）。其中「首次修改前」的
客户端配置备份也会一并消失——执行前请确认不再需要。