文档 / 做第一个看板
做第一个看板
把需求讲给 Agent 或浏览器演练场,得到一个能在菜单栏运行的 .bar 文件。
概述
你自己做的看板,才最贴合你的工作。你不必亲自写代码:说出需求、确认设计,由 Agent 编写、检查并安装 .bar 文件。有两条路径:
- 借助 Agent:Claude Code、Codex 或 Cursor 直接操作已安装的 App,使用真实数据和全部桌面能力。
- 在演练场中:无需安装,在浏览器里用示例数据试做,再下载
.bar文件。
借助 Agent
1. 安装 App 与 Skill
安装 Metrix.Bar 并启动。然后在终端或 Agent 的工作目录中添加 Agent Skill:
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 会原地更新同一个安装。
在演练场中
- 打开演练场,把看板需求讲给内置的 fx Agent。它使用默认模型;也可以在自定义模型中换成你自己的 OpenAI 兼容模型。
- 查看预览。Agent 会修改
.bar源码和fixture.json(预览使用的示例数据)。 - 你也可以直接修改源码,点击运行预览查看效果。
- 点击下载 .bar,在 Metrix.Bar 中通过 导入 .bar… 导入文件,填写设置后即可使用真实数据。
演练场运行在浏览器沙箱中,读取文件、蓝牙、通知等桌面能力需要在 App 中运行才可用。
你可以做什么
看板不只是一个数字。它可以调用你允许的任意 API,把数据存进 SQLite 或 IndexedDB,运行 WebAssembly,读取系统指标与媒体播放状态,发送通知,通过收件箱接收邮件和 Webhook,并以原生界面绘制图表、表格和编辑器。全部能力见 .bar 格式与组件参考。
分享
导出 .bar 文件即可分享,其中不会包含你的密钥。要向他人发布更新,可以自建看板源或分享安装链接。