VAO PUSH / 使用指南

卡片工作台

把一份数据，变成每天都想看一眼的卡片。

先分清三个概念

数据源

数据从哪里来、哪些字段在更新。一个源可以供多张卡片使用。

卡片设计

字段怎样排列和显示。草稿与发布分开保存。

01 · 接入数据

在 Web「我的卡片」中新建卡片，创建独立数据源，或选择一个已有源。

接入方式	工作方式
读取 JSON / API	提供公网 HTTPS JSON 地址，配置所需鉴权与字段映射，由服务端按周期读取。
工具主动上报	脚本向该数据源的专属地址 PUT JSON，每次替换整份最新状态。

json

{
  "fields": {
    "progress": {
      "type": "percent",
      "label": "Progress",
      "value": "68"
    },
    "status": {
      "type": "text",
      "value": "In progress"
    }
  }
}

这里用相册整理进度作虚构示例。数值使用十进制字符串；绑定 progress 字段即可显示完成率。

02 · 设计样式，检查草稿

从实际字段中选择显示项，调整名称、字号与排版，查看不同尺寸的预览。常用编辑在可视化界面完成；复杂布局可使用高级布局或导入受控的 JSON 描述。卡片不执行任意网页代码。

03 · 发布并导入设备

保存草稿，检查字段、数据和尺寸；确认后发布到设备。
在「接入与订阅」生成订阅码。手机先连接同一服务器，再在「卡片 → ＋」中导入。
导入后可微调名称、外观和部分字段显示；再通过系统添加桌面小组件并选择这张卡片。

日常只更新数据源即可，不需要重新发布样式。Web 发布兼容的设计更新时，设备上的独立微调会保留。手机本机也可以创建最近消息的简单模板。

更新与删除的边界

数据采集成功不等于桌面已经刷新。小组件更新时间由系统调度，离线时可能保留上次有效内容。

删除卡片前会先展示影响范围，保留数据源与其他卡片。只有没有任何卡片引用的数据源才能删除，未发布草稿也算引用。