安全与隐私

本地数据与凭据

看板文件、输入设置与看板状态保存在你的设备上。Metrix.Bar 无需账号，不会把看板同步到云端数据库。看板直接连接你配置的数据服务。

secret 输入保存在操作系统凭据库中，与普通设置分开。本地 API 只返回 is_set，其 value 为 null。看板脚本可以读取已配置的凭据以连接服务，因此请只安装可信来源的看板，不要把凭据写进源码、日志或测试 fixture。

权限与连接

看板通过 <permissions> 声明网络来源与本地文件访问。公共 HTTP 请求必须使用 HTTPS；回环与局域网地址可使用明文 HTTP。直接 TCP/TLS 连接需要显式 socket 权限。扩展桌面能力需要对应的 <script apis="..."> 声明，开发约定见文件格式。

文件对话框授权用户选中的路径。写入目标必须经过保存对话框确认；仅声明文件权限不会授予写权限。

本地 API 只监听 127.0.0.1。健康检查之外的请求需要 Settings → Agent 中的 Bearer token，带有 Origin 请求头的请求会被拒绝。请使用设置显示的地址，首选默认端口为 6387。

使用统计

Metrix.Bar 可以发送匿名使用事件、App 版本与操作系统信息。随机生成的安装标识用于归集事件，不是账号或硬件标识。使用事件不包含看板指标值与凭据。请求会到达远程服务，对方仍会收到来源 IP 等正常连接信息。

在 Settings → Privacy 关闭 Share anonymous usage analytics 后，不再发送新的使用事件。看板取数与更新检查不受此设置控制。