---
title: "安装要求与自动更新配置指南 · Metrix.Bar"
description: "下载并安装 macOS、Windows 或 Linux 版 Metrix.Bar，了解更新渠道与检查设置。"
canonical: "https://metrix.bar/zh/docs/installation"
language: "zh-CN"
---

# 安装与更新

> 系统要求、安装步骤与自动更新配置。

## 从零开始

你可以先安装 Agent Skill，再让 Claude Code、Codex 或 Cursor 协助检测系统、选择安装包、校验下载并安装启动 App：

```bash
npx skills add https://metrix.bar
```

也可以先手动安装 App，再按 [Agent 接入指南](/zh/docs/agents.md)完成连接。已有 App 时只需启动，不必重装。安装操作需经你同意，系统授权由你完成。

## 下载与安装

在[下载页](https://metrix.bar/zh/download)选择匹配系统与 CPU 的 GUI 安装包，确认该包列出的最低系统版本。默认选择 Stable；Preview 仅在你明确选择时使用。Stable 没有匹配包时先确认是否接受 Preview，不自动切换。发布索引与 SHA-256 可在[发布信息](https://downloads.agili.app/metrix-bar/release-info.json)查看。

- **macOS**：选择 Apple 芯片、Intel 或兼容的 Universal DMG。打开后将真实 App 拖入 Applications 或用户 Applications，再启动；当前至少需要 macOS 12，以安装包要求为准。
- **Windows**：选择对应架构的 NSIS `.exe` 安装器，按标准交互流程完成安装，从开始菜单启动。不使用猜测的静默参数。
- **Linux**：选择对应架构的 `.deb` 或 `.tar.gz`。DEB 使用桌面包安装器；tar.gz 解压到新的用户目录，保留配套资源，运行其中的 `metrix-bar`。需要 GTK 3 与桌面会话，DEB 还需满足包声明的依赖。托盘通过会话 D-Bus 使用 StatusNotifierItem 宿主（GNOME 需启用 AppIndicator 扩展），无需 Ayatana AppIndicator 动态库。托盘不可用时仍可进入设置；桌面不转发主点击时，可通过托盘菜单的 Open 打开看板。

自动化安装的逐平台操作与校验步骤见 [Skill 安装参考](https://metrix.bar/.well-known/agent-skills/metrix-bar/references/installation.md)。不绕过系统保护或擅自提权。

启动后打开 **Settings → Agent**，启用 **Enable local API** 并确认 **Running**。点击 **Copy Prompt** 发给 Agent，以实际本地地址和 token 验证连接；健康检查无需鉴权，随后需带 Bearer 请求看板列表验证权限。详见 [Agent 指南](/zh/docs/agents.md)。

### 语言与编码支持

软件界面语言为英文。用户填写的参数、面板文本、指标标签以及外部接口返回的内容均完整支持中文、日文、韩文（CJK）及 Unicode 字符。

## 软件更新

Metrix.Bar 内置更新器，自动检查发布通道并安装签名的更新包。

### 更新设置

打开设置窗口（菜单栏图标 → **Settings**），滚动到 **Updates**：

- **频道**：选择 `Stable` 获取正式版本，或 `Preview` 获取预览构建。切换频道后立即检查更新。
- **检查周期**：选择 `Manually`、`Hourly`、`Daily` 或 `Weekly`，默认为 `Daily`。
- **Check for updates**：无论周期设置如何，都可立即检查最新版本。

发现新版本后点击 **Install update**，再点击 **Restart to finish update** 完成安装。如需手动安装，可点击 **Download from website** 打开当前频道的下载页面。