下载 Astra 桌面版
桌面版是控制台加常驻服务,装好就能用,不需要 Node.js。当前版本 0.14.3116,2026 年 11 月 21 日发布。
选你的电脑
按你的浏览器判断是 macOS。是 Apple 芯片还是 Intel,在苹果菜单 › 关于本机 里能看到。
Astra-0.14.3116-darwin-arm64.dmg
macOS · Apple 芯片 · .dmg 安装包 · 81.9 MB
- 需要 macOS 13 或更高。
- 安装包内置服务端和控制台,不需要 Node.js,也不用另装 CLI。
- 应用内更新:新版本下载并校验 sha256 后自动替换,服务端跟着一起更新。
装好后打开 Astra,在客户端页点「启用」。不确定接哪个服务商?回首页按你的工具看步骤
不装桌面版
要 astra 命令,在终端里管服务和客户端。需要 Node.js 18 或更高,会按平台自动装好服务端。
npm install -g @aidotnet/astra-gateastra start --open
安装文档 里有每种方式的细节,包括预览版。
0.14.3116 更新了什么
新增
- Antigravity 桌面端客户端:客户端页新增「Antigravity」(Google 的桌面 Agent 应用,与 Antigravity CLI 分开,两者可以同时启用)。启用后 Astra 会把它的
~/.gemini/antigravity/settings.json里的modelProvider、model和自定义模型指向网关,并在 shell 配置文件(~/.zshrc或~/.bashrc)里加一段受管块,导出GOOGLE_GEMINI_BASE_URL和GEMINI_API_KEY;关闭时恢复原值并移除这段。启用后需要完全退出并重新打开 Antigravity。启用期间它用 API Key 登录,不使用 Google 账号,同一份 shell 配置里的终端也会看到这两个变量(Gemini CLI 同样会走网关)。不支持 Windows。这是按它与 CLI 共用同一个引擎推断的接入方式,尚未在已登录的真实应用上验证,遇到问题请反馈。
修复
- 0.14.3115 的 Docker 镜像没有发布:发布流程里镜像的启动检查等待时间过紧导致失败,npm 包和安装包不受影响。本版起 Docker 用户可以拉到新镜像。
0.14.3116 的全部安装包
给另一台电脑下载时用。下载后可以用 sha256 核对文件。
更早的版本
共 53 个正式版。点开看更新内容和安装包。
新增
- 桌面端更新卡片:更新提醒、检查结果、下载进度和更新结果合并成右下角的一张卡片。主窗口在前台时,卡片显示在窗口右下角(盖在打开的弹窗之上);窗口隐藏时,显示在屏幕角落的独立小窗里,更新过程中切换窗口也不会丢。
改进
- 桌面端界面组件库升级:TKCode.Arc 升到 1.3.0(Avalonia 12.1.6)。
修复
- 桌面端点「方案」闪退:在客户端页点右上角「方案」,弹窗里的方案列表加载完成时程序会报错「The control TKCode.Arc.Input already has a visual parent StackPanel」并退出。现在可以正常打开、保存、重命名和应用方案。
0.14.3113 在 macOS 公证环节遇到 Apple 服务故障,没有发布成功;它的内容(Docker 自动更新、模型列表只接受已启用的模型)包含在本版里。
新增
- Docker 自动更新:仓库里的
compose.yaml新增updater服务(Watchtower 的维护分支)。Astra 发现新版本后会请求它拉取新镜像并重启容器;设置 → 关于新增「自动安装更新」(默认打开)和「立即更新」按钮。更新器只管 astra 容器,也只在 Astra 请求时动作;镜像标签决定装哪个版本(latest正式版,preview预览版)。已有部署需要先升级到本版镜像、再换用新的compose.yaml:旧镜像不认识更新器的环境变量,不会生成/data/updater-token,也不会报错。启动日志现在会写出「Container updater: …,token file … (created/read)」,可以据此确认。
修复
- 数据库出现磁盘 I/O 错误后一直失败:Docker 部署里数据卷偶发
SQLite Error 10: 'disk I/O error'后,令牌请求、告警投递和同步会一直失败,直到重启容器。现在服务每 30 秒读一次数据库,遇到这类错误会记录完整错误码(含扩展码)、关闭连接池并重新连接,日志里能看到是否恢复。根因(数据卷或文件系统)尚未确认;若日志里仍反复出现,请把含错误码的那几行发来。 - 停用或删除模型后仍能调用:以前在提供商的模型列表里停用或删除一个模型,它只会从模型列表和客户端配置里消失,请求仍会原样转发到上游。现在只要提供商有模型列表,就只接受列表里已启用的模型,其他模型直接返回 404,不会发到上游(有多个提供商或提供商池时会跳到下一个能提供该模型的)。模型列表为空的提供商仍会转发任意模型名。注意:客户端如果会请求列表里没有的模型(例如 Claude Code 后台用的 Haiku),需要把这些模型加进列表。
- 更新器令牌文件的创建:容器的健康检查不再创建
updater-token,文件改为独占创建,避免健康检查和服务同时启动时写出两个不同的令牌。
新增
- 路由分组:在「路由分组」页(或
astra group add)把多个提供商的模型合成一个虚拟模型group/名称,客户端像选普通模型一样选它。支持智能、按顺序、轮换、最少使用、按节奏、按权重六种方式,可以嵌套;一个成员失败自动换下一个,对话在提示缓存还有价值时留在同一个成员上。智能路由的档位也可以指向分组。数据库迁移 0027。 - 按剩余额度选账号:订阅账号、插件账号和 API Key 列表的切换方式新增「智能」「按节奏」「最少使用」,按各账号剩余额度和重置时间挑选,用量超过 90% / 98% 的账号自动排到后面;没有额度数据时按原来的顺序,不会报错。
- 一个提供商多个 API Key:在提供商页的 Key 列表里添加、排序、启用 / 停用 Key,可为每个 Key 设置权重、限定协议、独立代理和备注;Key 被拒绝(401/403)或被限流(429)时自动冷却并换下一个,客户端无感,并按 Key 统计请求、tokens 和费用。从 magpie、CC Switch 导入时多 Key 合并为一个提供商;提供商备份带上全部 Key,旧备份仍可恢复;新增
astra provider keys命令。 - 方案(Profile):把所有客户端的当前配置存成命名方案,一键切换(应用前可预览,走正常的启用 / 停用流程,原配置照常备份与恢复)。Clients 页顶部和桌面托盘都能切换;命令行
astra profile save/use/list/rm,以及astra client use <客户端> <提供商/模型>。 - 常用模型短名单:每个客户端可以只看到你勾选的模型,包括写进它配置里的模型列表和它看到的
/v1/models。 - 内置工具:在「工具」页配置 Tavily、Brave、Exa、Firecrawl、You.com、DeepSeek、豆包、元宝、TinyFish、SearXNG 以及插件提供的搜索 API(多个 Key、顺序与轮换)。上游不会联网搜索时,网关可以替模型搜索(默认关闭,支持 Anthropic、Responses、Chat、Gemini)。内置 MCP 服务器
astra提供web_search、web_fetch(拒绝内网地址)、generate_image和插件工具;新增astra tool命令。 - 经由 claude 程序使用 Claude 订阅:Claude 订阅账号可以选择「经由 claude 程序」,用本机安装的 Claude Code 回答任意客户端的请求,调用方的工具通过 MCP 往返。按账号开启,默认关闭;这种方式没有在真实订阅上做过长期验证,额度消耗可能高于直接调用。
- 5 小时窗口预热:设置里打开「窗口预热」后,每天在设定的时间(或上一个窗口刚重置时),用每个 Claude 和 ChatGPT(Codex)订阅账号自己的凭据发一条最便宜的请求,提前开启 5 小时窗口;令牌已过期的账号会跳过,不会为预热续令牌。请求日志里标为「预热」。
- 资源库:新增「资源库」页,指令、子代理、斜杠命令、钩子和环境变量只写一次,按各客户端的格式写进它的文件;Astra 只收回自己写入且未被改动的内容。指令、子代理、命令、Skills 和自有 MCP 服务器可以放进某个项目目录。Skills 新增市场搜索与安装、Git 更新检查、可选的 Skill 路由,并覆盖更多客户端。数据库迁移 0028。
- 整机备份、恢复与多机同步:设置页新增「备份与同步」。一次备份覆盖提供商、令牌、客户端、方案、路由、隐私、工具、MCP、告警、插件数据和 Skill 库,密钥只存在于口令加密的备份里;恢复前可以按分区预览并自动保存当前状态;每天自动做一份本地备份;可以经文件夹、WebDAV、S3(含兼容服务)或 GitHub 私有仓库在多台机器之间按记录合并同步。命令行
astra backup、astra sync。 - 47 个新客户端:OpenChamber、DevEco Code、StepCode、Aside、OmO、Prime Agent、mu、MothX、PenguinHarness、Antigravity CLI、Dim、Command Code、fx、Goose、Zoo Code、JetBrains Air、Air(JetBrains IDE)、Copilot(JetBrains)、CodeBuddy、Qoder、Qoder CN、T3 Code、Pencil、OpenPencil、Raycast、Obsidian(Copilot for Obsidian)、Reasonix Studio、Mister Morph、jcode、Mistral Vibe、Empryo、nanobot、miniQ、Paimon、Cline(CLI)、Grok App、AtomCode、Snow CLI、Ante、Craft Agents、Tuanjie Cowork、LiveAgent、OpenMausBot、AstrBot、QwenPaw、OpenClaw、OpenBot。fx、Command Code、Empryo、Ante、Craft Agents、Obsidian、OpenBot 不能把密钥写进配置,使用前需要在设置里关闭「本地网关需要密钥」。
- 35 个新内置提供商:Mistral、Groq、Together、Fireworks、NVIDIA NIM、魔搭、阶跃星辰、LongCat、百度千帆、腾讯云、华为云、小米 MiMo、Azure OpenAI、Vercel AI Gateway 等(套餐和区域作为版本);支持 Amazon Bedrock(API Key、IAM 访问密钥 SigV4 签名、Mantle)和 Google Vertex AI(服务账号 JSON,自动换取访问令牌)。
- 更多网关接口:
/v1/embeddings、/v1/rerank、/v1/audio/*(转写、翻译、语音合成)、Codex 使用的 Responses WebSocket、Ollama 兼容接口(客户端里填http://127.0.0.1:<端口>/ollama)和提供商原生接口透传/v1/astra/native/<提供商>/…;都走令牌鉴权、路由、请求日志和计费,Gemini 提供商的 embeddings 自动转换。 - 显示币种:在设置里手动填写汇率后,可以把费用、价格和图表换成人民币、欧元、日元等 15 种货币显示(Astra 不会联网获取汇率,底层仍按美元记账);令牌的费用上限和自定义价格也按显示币种填写。
- 上下文窗口占用:请求日志新增「上下文」列,请求详情显示这次请求用了多少上下文窗口、多少来自缓存、输出离上限还有多远,以及提示词大致由系统提示、工具、历史和最新一轮各占多少。数据库迁移 0026。
- 插件 v2:更多宿主事件和数据:插件可以订阅
provider.changed、account.changed和alert.fired事件;request.completed改用新的请求行格式;data.requests.stats新增groupBy;env新增locale、timeZone和utcOffsetMinutes;插件的http.fetch现在走系统代理。
改进
- 隐私脱敏:占位符改为稳定的
{{类别_哈希}},同一个值在整个对话的所有请求里都用同一个占位符,提示缓存不再因为脱敏失效;一个值脱敏过一次,之后出现在任何地方都会脱敏(只存在内存里)。新增护照号、IBAN、MAC、公网 IP、出生日期、序列号、家目录用户名(公网 IP 和家目录用户名默认关闭);银行卡、身份证、IBAN、SSN 会检查校验位,减少误判;示例域名下的邮箱不再脱敏。流式回复里工具调用参数中的占位符(包括被拆到多个片段、原值带引号或换行的情况)现在能正确还原。护栏打开但无法运行时,请求会被拒绝(503),不会未脱敏就发出。「试一试」会显示真正发给模型的文本。 - 插件:内置的 magpie 插件宿主更新到最新版本;取消的插件调用会通知宿主停止;插件拒绝发起登录时会显示它给出的原因。
修复
- 插件 SDK 缺少命令行:
@astragate/plugin-sdk的astra-plugin命令行文件此前没有纳入版本库,从仓库构建的 SDK 会缺少它;现在已补上。
修复
- GitHub Copilot 报「input item does not belong to this connection」:长时间续用或恢复的会话里带着较早会话的推理内容,Copilot 的 Responses 接口不再接受,之前网关只能返回 400、让你新开会话。现在设置里新增「自动丢弃过期的推理内容」(默认开启):遇到这个拒绝时,网关去掉这些推理条目的加密内容,用同一个账号重发一次,对话继续,只是丢掉了那几轮的推理上下文。请求在被拒绝之前不会被改动;关闭开关,或重发后仍被拒绝时,仍返回 400 并说明原因。链路追踪里被拒的那次标记为「丢弃过期推理后重发」。
新增
- 从其他机器管理 MCP 服务器:用 Docker 部署(宿主机也算其他机器)或要在局域网里的另一台电脑上配置时,原来无法新增、修改、测试和授权 MCP 服务器。现在 MCP 页的网关设置里新增「允许从其他机器管理 MCP 服务器」开关(默认关):打开后,已登录管理会话的其他机器也可以。关着时行为不变;写入客户端配置和自有 MCP 服务器仍只能在本机操作。在 Docker 里做 OAuth 授权时,回调地址取自
ASTRA_PUBLIC_URL,请设成浏览器能打开的地址(#40)。
修复
- DeepSeek 的 Responses 协议报
unknown field "reasoning_effort":有的客户端在/v1/responses请求里写了 Chat Completions 风格的顶层reasoning_effort,网关透传时原样发给上游,DeepSeek 这类严格校验字段的上游会直接返回 400。现在透传 Responses 请求时,会把它改写成 Responses 的标准写法reasoning.effort(请求里已有reasoning.effort时以它为准),请求不再被拒绝。
新增
- Claude Code 子代理模型:客户端页 Claude Code 的模型设置在 Haiku 档位后新增「子代理模型」,写入
CLAUDE_CODE_SUBAGENT_MODEL,子代理定义和单次调用没指定模型时使用它,而不是跟随主模型。选项里新增「所有子代理使用子代理模型」,写入CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1,忽略各子代理自己指定的模型。两者清空或关闭接入时都会还原你原来的值;修改后需要重新写入客户端配置(#42)。
改进
- Haiku 档位也加 1M 后缀:打开 Claude Code 的「1M 上下文」后,Haiku 档位和其他档位一样加
[1m]后缀(Haiku 5.5 原生支持 1M),只有已知窗口不足 1M 的模型(如 Haiku 4.5)不加。已开启此选项的用户重新写入配置后,Haiku 档位的模型名会带上后缀(#42)。
修复
- 桌面端提示被面板遮住:在备份等面板里操作后,「备份成功」之类的提示和错误提示显示在面板遮罩下面;现在始终显示在最上层(#41)。
新增
- 桌面端支持 WebDAV 云端备份:桌面端提供商页的「备份」面板新增「云端备份(WebDAV)」:填写服务地址、用户名、密码和文件夹后,可测试连接、「立即备份」(不含密钥或口令加密,明文密钥不会上传)和「从云端恢复」;恢复的文件会先进入导入预览,确认后才写入。此前桌面端只有加密文件的导出 / 导入,网页控制台一直有这个功能(#33、#41)。