使用情境

PushWard 的一天

一個 homelab，一天的推播。選擇一個時間，看看哪個服務傳送什麼、從哪條路徑進來，以及如何出現在 iPhone 上。

上班腳本

點一下開始工作日

早上 7:00，一個小腳本在鎖定畫面上提問。點一下「Start」即可回覆，卡片隨即變成八小時倒數。

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"
          }
        ]
      }
    }'

找到適合您的設定

同樣的流程，依使用者分組。打開任一個即可查看它的設定。

Homelab

會自己回報狀態的伺服器、監控、下載與備份。

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 Server

讓代理先問再做

串接方式

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 Server

由代理設定的週期提醒

串接方式

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"
          }
        ]
      }
    }'

記帳 App 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%"
          }
        ]
      }
    }'

八種接入方式

本頁的每個流程都使用其中一種。大多數只要幾分鐘就能設定完成。

串接您的第一個服務

在 App 中取得整合金鑰，選擇上方任一接入方式，幾分鐘後您的第一張卡片就會出現在鎖定畫面上。

開始使用 Playground