---
title: "用 AI Agent 做第一个看板 · Metrix.Bar"
description: "几分钟做出原生菜单栏应用：通过 Metrix.Bar Agent Skill 讲给 Claude Code、Codex 或 Cursor，或在浏览器演练场中试做并下载 .bar 文件。"
canonical: "https://metrix.bar/zh/docs/first-dashboard"
language: "zh-CN"
---

# 做第一个看板

> 把需求讲给 Agent 或浏览器演练场，得到一个能在菜单栏运行的 .bar 文件。

## 概述

你自己做的看板，才最贴合你的工作。你不必亲自写代码：说出需求、确认设计，由 Agent 编写、检查并安装 `.bar` 文件。有两条路径：

- **借助 Agent**：Claude Code、Codex 或 Cursor 直接操作已安装的 App，使用真实数据和全部桌面能力。
- **在演练场中**：无需安装，在浏览器里用示例数据试做，再下载 `.bar` 文件。

## 借助 Agent

### 1. 安装 App 与 Skill

[安装 Metrix.Bar](/zh/docs/installation.md) 并启动。然后在终端或 Agent 的工作目录中添加 Agent Skill：

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

如果还没有安装 App，Skill 也可以帮助 Agent 选择、校验并安装合适的安装包。

### 2. 连接

在 Metrix.Bar 中进入 **Agent**，打开 **启用本地 API**，点击 **复制提示词**，把提示词发给 Agent。其中包含 Agent 需要的本地地址与令牌。详见 [Agent 接入指南](/zh/docs/agents.md)。

### 3. 说出你的需求

说明要显示什么、数据从哪里来、多久变化一次，以及希望出现在哪里。例如：

> 把我 GitHub 仓库的 Star、未关闭 Issue 和最新 Release 放到菜单栏，面板里显示最近的 Pull Request。

> 在刘海屏显示 Stripe 今日收入，面板里画出近 30 天的图表。API Key 从密钥设置中读取。

> 做一个菜单栏番茄钟：专注 25 分钟、休息 5 分钟，每次切换发通知，并记录今天的专注历史。

服务比较小众时，附上 API 文档链接或一段示例响应。

### 4. 确认设计

动手写代码前，Agent 会阅读格式参考和相近的官方看板，提出菜单栏数值、面板布局、交互，以及空状态与错误状态的设计。调整到符合预期后再确认。

### 5. 让 Agent 完成编写与安装

Agent 编写 `.bar` 文件，校验结构，运行隔离检查，安装并刷新看板。看板需要 Token 时，请在看板设置表单中自行填写，它会直接存入系统凭据库。

### 6. 持续迭代

用自然语言提出修改：“加一个周图表”“超过 80% 时变红”“加一个小组件”“显示到刘海屏”。Agent 会原地更新同一个安装。

## 在演练场中

1. 打开[演练场](/zh/playground)，把看板需求讲给内置的 fx Agent。它使用默认模型；也可以在**自定义模型**中换成你自己的 OpenAI 兼容模型。
2. 查看预览。Agent 会修改 `.bar` 源码和 `fixture.json`（预览使用的示例数据）。
3. 你也可以直接修改源码，点击**运行预览**查看效果。
4. 点击**下载 .bar**，在 Metrix.Bar 中通过 **导入 .bar…** 导入文件，填写设置后即可使用真实数据。

演练场运行在浏览器沙箱中，读取文件、蓝牙、通知等桌面能力需要在 App 中运行才可用。

## 你可以做什么

看板不只是一个数字。它可以调用你允许的任意 API，把数据存进 SQLite 或 IndexedDB，运行 WebAssembly，读取系统指标与媒体播放状态，发送通知，通过收件箱接收邮件和 Webhook，并以原生界面绘制图表、表格和编辑器。全部能力见 [.bar 格式](/zh/docs/bar-format.md)与[组件](/zh/docs/components.md)参考。

## 分享

导出 `.bar` 文件即可分享，其中不会包含你的密钥。要向他人发布更新，可以自建[看板源](/zh/docs/registries.md#自托管看板源)或分享[安装链接](/zh/docs/registries.md#安装链接)。

## 下一步

- [看板开发](/zh/docs/development.md)：组件、状态与依赖库。
- [本地 API](/zh/docs/local-api.md)：Agent 使用的接口。
- [.bar 格式](/zh/docs/bar-format.md)与[组件](/zh/docs/components.md)：完整参考。
