Campus wallet

spec: 1
id: wallet
name: 校园钱包
description: 校园卡余额与付款码、充值，网费、电费、水费、浴卡。
version: 1.3.0
author: pkuinfo
icon: wallet
homepage: https://github.com/pkuinfo/pku-harness-plugins/tree/main/plugins/wallet
requires: [campus-session, network]
# Everything the student pays for on campus (merged from campus-card, netfee and utilities,
# 2026-10-22; ported from the TypeScript plugin):
# - 校园卡 bdcard.pku.edu.cn (pkucli crates/campuscard): balance, transactions, monthly stats,
#   payment code (payCode, tap-only, shown on the secure 付款码 screen), top-up (cardRecharge: a
#   signed order whose 收银台 URL goes to the browser only).
# - 网费 its.pku.edu.cn (pkucli crates/portal/src/netfee.rs).
# - 浴卡 and the 收费平台 cwpay.pku.edu.cn; 宿舍电费 has no web API (guide screen only).
# Tuition, income and payment orders stay in the finance plugin.
campus: [card, its, cwpay]
abilities: [browser, campusPage]
shared: shared.yaml
tools:
  cardBalance: tools/cardBalance.yaml
  cardSetDigital: tools/cardSetDigital.yaml
  cardMode: tools/cardMode.yaml
  cardSetMode: tools/cardSetMode.yaml
  cardRecharge: tools/cardRecharge.yaml
  cardMonthlyStats: tools/cardMonthlyStats.yaml
  cardTransactions: tools/cardTransactions.yaml
  netfeeBalance: tools/netfeeBalance.yaml
  bathCard: tools/bathCard.yaml
  bathRecharge: tools/bathRecharge.yaml
  payProjects: tools/payProjects.yaml
  openPayCenter: tools/openPayCenter.yaml
  payCode: tools/payCode.yaml
  cardTopUp: tools/cardTopUp.yaml
  bathTopUp: tools/bathTopUp.yaml
  overview: tools/overview.yaml
widgets:
  card: widgets/card.json
  netfee: widgets/netfee.json
  bath: widgets/bath.json
screens:
  wallet: screens/wallet.json
  pay: screens/pay.json
  card-mode: screens/card-mode.json
  recharge: screens/recharge.json
  bath-recharge: screens/bath-recharge.json
  electricity: screens/electricity.json
dataSources:
  cardBalance: { title: 校园卡余额, tool: cardBalance, ttl: 5m }
  netfeeBalance: { title: 网费余额, tool: netfeeBalance, ttl: 30m }
  bath: { title: 浴卡充值记录, tool: bathCard, ttl: 30m }
settings:
  - { screen: wallet, title: 校园钱包, subtitle: 校园卡、网费、浴卡与充值, icon: wallet }
  # Kept one tap away from Settings: it is what people open at the canteen till.
  - { screen: pay, title: 校园卡付款码, subtitle: 食堂、超市扫码付款, icon: qr }
commands:
  balance: { description: 查校园卡余额, aliases: [余额], prompt: 校园卡还剩多少钱？ }
  electricity: { description: 宿舍电费怎么查、怎么交, aliases: [电费, 电量, 购电], screen: electricity }
  bath: { description: 浴卡充值记录 / 充值, aliases: [浴卡, 洗澡, 浴室], prompt: 看看我的浴卡最近的充值记录。 }
# The three plugins the wallet replaced: saved checks, dashboard widgets and settings carry over.
legacy:
  pluginIds: [campus-card, netfee, utilities]
  tools:
    campus-card.getBalance: cardBalance
    campus-card.setDigitalCard: cardSetDigital
    campus-card.recharge: cardRecharge
    campus-card.getMonthlyStats: cardMonthlyStats
    campus-card.listTransactions: cardTransactions
    netfee.getStatus: netfeeBalance
    utilities.bathCard: bathCard
    utilities.rechargeBath: bathRecharge
    utilities.payProjects: payProjects
    utilities.openPayCenter: openPayCenter
  widgets:
    campus-card.balance: card
    netfee.balance: netfee
    utilities.bath: bath
i18n:
  en:
    name: Campus wallet
    description: Campus Card balance and payment code, top-ups, network fee, electricity, water and bath card.
    tools:
      cardBalance: { title: Check Campus Card balance, summary: 'Campus Card balance, today’s spending and card status' }
      cardSetDigital: { title: Switch to digital card, summary: Switch the card to digital mode (数字卡) for the payment code }
      cardMode: { title: Card mode, summary: 'The current card mode and the modes it can switch to (digital, physical card, phone NFC)' }
      cardSetMode: { title: Switch card mode, summary: 'Switch the card to a given mode, e.g. back to physical card or NFC from digital' }
      cardRecharge: { title: Top up Campus Card, summary: Create a top-up order and open the university’s cashier to pay with WeChat or Alipay }
      cardMonthlyStats: { title: Monthly spending, summary: 'One month of Campus Card income, spending by category and per day' }
      cardTransactions: { title: Transactions, summary: 'Recent Campus Card transactions, newest first' }
      netfeeBalance: { title: Check network fee, summary: 'Campus network balance, this month’s usage and fee' }
      bathCard: { title: Bath card, summary: 'Bath card number, holder and latest top-ups' }
      bathRecharge: { title: Top up bath card, summary: Create a bath-card order on the payment platform and open it to pay }
      payProjects: { title: Payment platform items, summary: Payment items currently open on the payment platform }
      openPayCenter: { title: Open payment platform, summary: Open the signed-in payment platform in the browser }
      payCode: { title: Get payment code, summary: The Campus Card payment code on the Payment code screen }
      cardTopUp: { title: Top up Campus Card (top-up screen), summary: Create a top-up order for the amount chosen on the top-up screen }
      bathTopUp: { title: Top up bath card (top-up screen), summary: Create a bath-card order for the amount chosen on the top-up screen }
      overview: { title: Wallet overview, summary: 'Campus Card, network fee and bath card on the wallet screen' }
    widgets:
      card: { title: Campus Card balance, description: 'Your Campus Card balance, today’s spending and card status; changes colour when the balance runs low (below ¥50).' }
      netfee: { title: Network fee, description: Campus network balance and this month’s usage. }
      bath: { title: Bath card, description: 'Your latest bath card top-up (amount, time, status) and a way to top up. The balance lives on the card’s chip and can’t be checked online.' }
    screens:
      wallet: { title: Campus wallet }
      pay: { title: Payment code }
      card-mode: { title: Card mode }
      recharge: { title: Top up }
      bath-recharge: { title: Top up bath card }
      electricity: { title: Dorm electricity }
    settings:
      wallet: { title: Campus wallet, subtitle: 'Campus Card, network fee, bath card and top-ups' }
      pay: { title: Campus Card payment code, subtitle: Scan to pay in canteens and shops }
    commands:
      balance: { prompt: How much is left on my campus card?, description: Check Campus Card balance, aliases: [card] }
      electricity: { description: How to check and pay for dorm electricity, aliases: [power] }
      bath: { prompt: Show my recent bath card top-ups., description: Bath card top-ups and history, aliases: [shower] }
    dataSources:
      cardBalance: { title: Campus Card balance }
      netfeeBalance: { title: Network balance }
      bath: { title: Bath card top-ups }

{
  "id": "wallet",
  "name": "校园钱包",
  "description": "校园卡余额与付款码、充值，网费、电费、水费、浴卡（原「校园卡」「网费」「水电浴」合并）。",
  "author": "pkuinfo",
  "kind": "builtin",
  "auth": "none",
  "icon": "wallet",
  "requires": [
    "campus-session",
    "network"
  ],
  "scopes": [
    "bdcard.pku.edu.cn",
    "its.pku.edu.cn",
    "cwpay.pku.edu.cn"
  ],
  "tags": [
    "official",
    "campus"
  ],
  "version": "1.3.0",
  "i18n": {
    "en": {
      "name": "Campus wallet",
      "description": "Campus Card balance and payment code, top-ups, network fee, electricity, water and bath card."
    }
  }
}