---
title: "Metrix.Bar — 菜单栏与系统托盘指标看板"
description: "在 macOS、Windows 与 Linux 的菜单栏或系统托盘查看指标。连接 Agent，创建、定制与管理你的看板，接入你需要的数据。"
canonical: "https://metrix.bar/zh"
language: "zh-CN"
---

# Metrix.Bar

> 指标，尽在菜单栏。

面向 macOS、Windows 与 Linux 的菜单栏与系统托盘指标看板。抬眼即见你关心的指标。

## 一款可由 Agent 完全控制的指标看板

一次连接后，Claude Code、Codex 或 Cursor 就能为你创建、修改、校验和配置看板，刷新数据并管理已安装的看板。

你向 Agent 提出 GitHub 仓库看板的需求，Agent 会校验 .bar 文件、安装看板、设置仓库并刷新数据。随后菜单栏显示 Star 数，点击即可打开完整面板。

- **创建与修改**: 从一句需求开始，接入数据并调整指标与面板。
- **配置与管理**: 设置看板参数、刷新数据，管理已安装的看板。
- **校验与诊断**: 检查配置与运行结果，定位问题并继续调整。

### 试着这样说

> 帮我把 GitHub 仓库的 Star、Fork 和最新 Release 放到菜单栏。

### 安装 Agent Skill

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

在 Settings → Agent 中点击 Copy Prompt，发送给你的 Agent 完成连接。

[查看 Agent 接入指南](https://metrix.bar/zh/docs/agents)

## 官方看板一览

- **Claude Code**: 订阅用量与重置时间
- **GitHub Repository**: 仓库 Star、Fork 与动态
- **Weather**: 实时天气与未来 6 天预报
- **Crypto Price**: CoinGecko 行情与 24 小时涨跌
- **Umami**: Umami 网站访问统计

[浏览看板库](https://metrix.bar/zh/gallery)

## 按你的需求，定制每一项指标

让 Agent 接入你需要的 API，调整指标、布局与刷新频率。每个看板都保存在一个可修改、导出与分享的 .bar 文件中。下方展示真实源码与面板截图。

[阅读 .bar 规范文档](https://metrix.bar/zh/docs/bar-format)

## 为常驻菜单栏而设计

- **原生跨平台常驻**: 常驻 macOS 菜单栏或 Windows、Linux 系统托盘，随时查看指标。
- **数据本地，凭据隔离**: 指标与配置留在本机，API 密钥存放于系统凭据库。
- **单文件分享**: 一个看板就是一个 .bar 文件，可导出、修改与分享。

## 开始使用

1. **下载安装 App**: 选择系统与芯片对应的安装包，安装后启动。
2. **安装 Skill**: 将 Agent Skill 添加到你常用的编程助手。
3. **连接 Agent**: 在 Settings → Agent 点击 Copy Prompt，发给 Agent。
4. **提出需求**: 告诉 Agent 你关心哪些指标，让它创建并调整看板。

[Agent 接入指南](https://metrix.bar/zh/docs/agents)

## 下载

v0.0.1 · macos 12.0+ · windows 10+ · linux

- [下载](https://downloads.agili.app/stable/metrix-bar/releases/0.0.1/build-11/macos-arm64/Metrix.Bar-0.0.1-arm64.dmg)

## 文档

### 快速入门

- [产品介绍](https://metrix.bar/zh/docs/introduction.md)：Metrix.Bar 的核心定位、开箱即用看板与 AI 协作机制。
- [安装与更新](https://metrix.bar/zh/docs/installation.md)：系统要求、安装步骤与自动更新配置。
- [使用看板](https://metrix.bar/zh/docs/dashboards.md)：官方看板使用指南、参数配置、外观预览、菜单栏常驻与 .bar 文件导入导出。

### AI 协作

- [AI 协作模式](https://metrix.bar/zh/docs/agents.md)：配合 Claude Code、Codex 或 Cursor，使用 Agent Skill 与本地 API 快速构建与调整看板。
- [本地 API 参考](https://metrix.bar/zh/docs/local-api.md)：面向 AI Agent 与本地自动化的 HTTP REST API 规范。

### 格式参考

- [.bar 格式规范](https://metrix.bar/zh/docs/bar-format.md)：Metrix.Bar 单文件 .bar v0 看板规格说明。
- [看板源 Registries](https://metrix.bar/zh/docs/registries.md)：Metrix.Bar 如何从远程看板源发现、校验并安装 .bar 看板。
- [看板开发](https://metrix.bar/zh/docs/tech-stack.md)：构建原生组件树、管理状态并为 .bar 看板选择可选依赖。
- [原生 UI 组件](https://metrix.bar/zh/docs/components.md)：Metrix.Bar .bar v0 原生 UI 组件库、属性反射、布局与事件回调完整参考。

### 安全与隐私

- [安全与隐私](https://metrix.bar/zh/docs/privacy.md)：本地数据、凭据保护、权限与使用统计控制。