安装与更新

从零开始

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

npx skills add https://metrix.bar

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

下载与安装

在下载页选择匹配系统与 CPU 的 GUI 安装包，确认该包列出的最低系统版本。默认选择 Stable；Preview 仅在你明确选择时使用。Stable 没有匹配包时先确认是否接受 Preview，不自动切换。发布索引与 SHA-256 可在发布信息查看。

• 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 安装参考。不绕过系统保护或擅自提权。

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

语言与编码支持

软件界面语言为英文。用户填写的参数、面板文本、指标标签以及外部接口返回的内容均完整支持中文、日文、韩文（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 打开当前频道的下载页面。