跳至内容

使用场景

PushWard 的一天

一个家庭实验室，一天的推送。选择一个时间，看看哪个服务发送什么、从哪条路径进来，以及如何出现在 iPhone 上。

上班脚本

轻点一下开始工作日

早上 7:00，一个小脚本在锁定屏幕上发问。轻点“Start”即可回答，卡片随即变成八小时倒计时。

上班脚本 通过 REST API 发送到 PushWard，再由 PushWard 推送到 iPhone, Apple Watch, Mac。

连接方式
workday.sh 
# 07:00 from cron or launchd
curl -X POST https://api.pushward.app/activities \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "slug": "approval-request",
      "name": "Workday"
    }'

curl -X PATCH https://api.pushward.app/activities/approval-request \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/merge-patch+json" \
  -d '{
      "state": "ongoing",
      "content": {
        "template": "approval",
        "state": "Start your workday?",
        "source": "Script",
        "icon": "calendar",
        "accent_color": "blue",
        "details": [
          {
            "label": "Calendar",
            "value": "3 meetings, first at 9:30"
          }
        ],
        "options": [
          {
            "id": "start",
            "title": "Start",
            "style": "primary"
          },
          {
            "id": "later",
            "title": "Later",
            "style": "secondary"
          }
        ]
      }
    }'
阅读指南

找到适合您的配置

同样的流程，按使用者分组。打开任意一个即可查看它的配置。

家庭实验室

服务器、监控、下载和备份，会自己报告状态。

  • Gatus Relay Webhook

    网站何时宕机、何时恢复，一目了然

    连接方式
    gatus/config.yaml 
    alerting:
  custom:
    url: "https://relay.pushward.app/gatus"
    method: "POST"
    headers:
      Content-Type: "application/json"
      Authorization: "Bearer hlk_YOUR_KEY"
    # body: see the Gatus entry in the Relay guide
    阅读指南
  • Unraid Unraid 插件

    NAS 上的夜间任务

    连接方式
    Plugins > Install Plugin 
    https://github.com/mac-lucky/pushward-unraid-plugin/raw/main/pushward-unraid.plg
    阅读指南
  • SABnzbd Docker 桥接

    显示速度和剩余时间的下载

    连接方式
    compose.yaml 
    services:
  pushward-sabnzbd:
    image: ghcr.io/mac-lucky/pushward-sabnzbd:latest
    environment:
      PUSHWARD_URL: https://api.pushward.app
      PUSHWARD_API_KEY: hlk_YOUR_KEY
      PUSHWARD_SABNZBD_URL: http://sabnzbd:8080/api
      PUSHWARD_SABNZBD_API_KEY: your-sabnzbd-api-key
    restart: unless-stopped
    阅读指南
  • Backrest Relay Webhook

    会主动报告的备份

    连接方式
    Backrest > Hooks > Shoutrrr 
    generic+https://relay.pushward.app/backrest?@authorization=Bearer+hlk_YOUR_KEY&contenttype=application/json
    阅读指南
  • Komodo Relay Webhook

    来自 Komodo 的容器告警

    连接方式
    Komodo > Alerter > Custom 
    https://pushward:[[PUSHWARD_KEY]]@relay.pushward.app/komodo
    阅读指南

开发者与 CI

来自任何代码托管平台的构建、部署和告警，都显示在锁定屏幕上。

  • GitHub Actions Docker 桥接

    逐步跟踪 CI 作业

    连接方式
    compose.yaml 
    services:
  pushward-github:
    image: ghcr.io/mac-lucky/pushward-github:latest
    environment:
      PUSHWARD_URL: https://api.pushward.app
      PUSHWARD_API_KEY: hlk_YOUR_KEY
      PUSHWARD_GITHUB_TOKEN: github_pat_YOUR_TOKEN
      PUSHWARD_GITHUB_OWNER: your-username
    restart: unless-stopped
    阅读指南
  • Argo CD Relay Webhook

    从同步到 healthy，全程跟踪部署

    连接方式
    argocd-notifications-cm.yaml 
    data:
  service.webhook.pushward: |
    url: https://relay.pushward.app/argocd
    headers:
    - name: Authorization
      value: Bearer $pushward-key
  # plus the sync-running / sync-succeeded / deployed
  # templates and triggers from the Argo CD guide
    阅读指南
  • Forgejo Actions CLI

    用 CLI 从任意 CI 报告进度

    连接方式
    .forgejo/workflows/release.yml 
    env:
  PUSHWARD_API_TOKEN: ${{ secrets.PUSHWARD_API_TOKEN }}
steps:
  - run: pushward activity start release --name "Release v2.4.0" --template steps --step 1/3 --step-labels Build,Test,Ship --text Building
  - run: make build
  - run: pushward activity update release --step 2/3 --text Testing && make test
  - run: pushward activity update release --step 3/3 --text Shipping && make publish
  - run: pushward activity end release --status success
    阅读指南
  • Grafana Grafana 插件

    自带图表的告警

    连接方式
    grafana.ini 
    [plugins]
allow_loading_unsigned_plugins = pushward-alerts-app

# Then Apps > PushWard: paste the key, pick alert rules
# for timelines and PromQL queries for widgets.
    阅读指南

智能家居

来自家中各处的打印机、家电和提醒。

  • Bambu Lab Docker 桥接

    逐层跟踪 3D 打印

    连接方式
    compose.yaml 
    services:
  pushward-bambulab:
    image: ghcr.io/mac-lucky/pushward-bambulab:latest
    environment:
      PUSHWARD_URL: https://api.pushward.app
      PUSHWARD_API_KEY: hlk_YOUR_KEY
      PUSHWARD_BAMBULAB_HOST: your-printer-ip
      PUSHWARD_BAMBULAB_ACCESS_CODE: your-access-code
      PUSHWARD_BAMBULAB_SERIAL: your-printer-serial
    restart: unless-stopped
    阅读指南
  • Home Assistant HACS 集成

    提醒和房间温度

    连接方式
    Home Assistant 
    HACS > search "PushWard" > Download > restart
Settings > Devices & Services > Add Integration > PushWard

PushWard > Add tracked to-do list   todo.reminders
PushWard > Add tracked widget        sensor.living_room_temperature, ...
    阅读指南
  • Home Assistant HACS 集成

    任意实体都能变成实时活动

    连接方式
    Home Assistant 
    Settings > Devices & Services > PushWard
  > Add tracked entity   sensor.dishwasher_status
    阅读指南

AI 智能体

随时向您汇报、行动前先征求意见的智能体。

  • 自托管 AI 智能体 MCP 服务器

    让智能体先问再做

    连接方式
    MCP 
    # Connect the agent once
claude mcp add --transport http pushward https://mcp.pushward.app/mcp

# What it calls before it orders
create_activity      approval card "Place the grocery order?"  [Approve] [Not now]
wait_for_answer      blocks until a button is tapped -> "approve"
create_notification  "Order placed"
    阅读指南
  • 自托管 AI 智能体 MCP 服务器

    由智能体设置的循环提醒

    连接方式
    MCP 
    # "Remind me every Friday at 16:00 to do the weekly review"
create_scheduled_notification  cron "0 16 * * 5"  "Weekly review"
    阅读指南

个人仪表盘

把您自己的数字和日常习惯放到主屏幕和锁定屏幕上。

  • 上班脚本 REST API

    轻点一下开始工作日

    连接方式
    workday.sh 
    # 07:00 from cron or launchd
curl -X POST https://api.pushward.app/activities \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "slug": "approval-request",
      "name": "Workday"
    }'

curl -X PATCH https://api.pushward.app/activities/approval-request \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/merge-patch+json" \
  -d '{
      "state": "ongoing",
      "content": {
        "template": "approval",
        "state": "Start your workday?",
        "source": "Script",
        "icon": "calendar",
        "accent_color": "blue",
        "details": [
          {
            "label": "Calendar",
            "value": "3 meetings, first at 9:30"
          }
        ],
        "options": [
          {
            "id": "start",
            "title": "Start",
            "style": "primary"
          },
          {
            "id": "later",
            "title": "Later",
            "style": "secondary"
          }
        ]
      }
    }'
    阅读指南
  • 记账应用 REST API

    主屏幕上的预算

    连接方式
    budget-sync.sh 
    curl -X POST https://api.pushward.app/widgets \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "slug": "budget-trend",
      "name": "Spending",
      "content": {
        "template": "trend",
        "icon": "chart.line.uptrend.xyaxis",
        "label": "Budget used",
        "subtitle": "October",
        "value": 68,
        "unit": "%",
        "min_value": 0,
        "points": [
          4,
          9,
          12,
          18,
          21,
          27,
          30,
          34,
          41,
          44,
          49,
          53,
          58,
          61,
          64,
          68
        ],
        "trend": "up",
        "accent_color": "mint"
      }
    }'
    阅读指南
  • Mac 脚本 REST API

    您 Mac 上的脚本

    连接方式
    ai-limits.sh 
    # every 30 minutes from launchd
curl -X POST https://api.pushward.app/widgets \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "slug": "ai-limits",
      "name": "AI usage",
      "content": {
        "template": "stat_list",
        "icon": "sparkles",
        "label": "AI usage",
        "accent_color": "purple",
        "stat_rows": [
          {
            "label": "Work account",
            "value": "5h 38% · 7d 61%"
          },
          {
            "label": "Personal",
            "value": "5h 0% · 7d 12%"
          }
        ]
      }
    }'
    阅读指南

八种接入方式

本页的每个流程都使用其中一种。大多数只需几分钟即可设置好。

连接您的第一个服务

在应用中获取集成密钥，选择上面任一接入方式，几分钟后您的第一张卡片就会出现在锁定屏幕上。

开始使用 Playground

查看所有集成 实时活动 小组件 Playground