桌面端
Astra 桌面应用——把控制台与常驻服务装进一个原生窗口
桌面端(@aidotnet/desktop)是控制台的 Electron 封装:同一个管理界面,外加原生集成的便利。
安装
安装包:从下载页下载对应平台的安装包——macOS .dmg、Windows 安装程序(.exe)、Linux AppImage。安装包内置服务端,不需要 Node.js 或 CLI。
安装脚本:不想手动下载时,运行一键安装脚本并选择桌面端(macOS / Linux:curl -fsSL https://astra-gate.si/install.sh | bash -s -- --desktop),同样内置服务端、无需 Node.js。
通过 npm:
命令bash
无需全局安装 CLI;已全局安装的话用 astra install --desktop 即可。
它多了什么
桌面端复用同一份 ~/.astra 数据与同一个 astra-server——在桌面端与浏览器里看到的内容完全一致,astra CLI 管理的服务就是桌面端跑的服务。
服务二进制解析顺序
桌面端按以下顺序定位服务端二进制:
~/.astra/install.json中记录的安装位置(若其版本比安装包内置的服务端旧,则改用内置的);- 环境变量
ASTRA_SERVER_BIN(开发调试用); - 安装包内置的服务端;
- 开发构建(仅源码运行时)。
更新与卸载
- 安装包(macOS dmg、Windows 安装程序、Linux AppImage):应用内更新。新版本下载并校验 sha256 后,桌面端退出、替换自身(macOS 还要求新版本与当前版本签名团队一致),然后自动重新打开。
安装包自带服务端,所以更新的总是整个桌面端,内置的服务随新版本一起替换,桌面端与服务端版本保持一致;不会单独更新服务端。
放在无法写入的位置时(例如直接从 dmg 里运行),「立即更新」会改为打开下载页。更新过程记录在
~/.astra/logs/desktop-update.log。 - 预览版:在 设置 → 关于 打开「接收预览版更新」后,应用内更新会跟随预览通道;见预览版。
- 通过 npm 安装的:
命令bash