文档 / 做第一个看板

做第一个看板

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

概述

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

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

借助 Agent

1. 安装 App 与 Skill

安装 Metrix.Bar 并启动。然后在终端或 Agent 的工作目录中添加 Agent Skill:

bash
npx skills add https://metrix.bar

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

2. 连接

在 Metrix.Bar 中进入 Agent,打开 启用本地 API,点击 复制提示词,把提示词发给 Agent。其中包含 Agent 需要的本地地址与令牌。详见 Agent 接入指南。

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

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

你可以做什么

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

分享

导出 .bar 文件即可分享,其中不会包含你的密钥。要向他人发布更新,可以自建看板源或分享安装链接。

下一步