Library

spec: 1
id: library
name: 图书馆
description: 北大图书馆：馆藏检索、我的借阅与续借、预约取书、研讨室预约、研修专座余量和开馆时间。
version: 0.2.0
author: pkuinfo
icon: library
homepage: https://github.com/pkuinfo/pku-harness-plugins/tree/main/plugins/library
requires: [campus-session, network]
# Ported from the TypeScript plugin (src/; shapes captured from the live sites in 2026-10, pkucli
# does not cover the library):
# - opac.lib.pku.edu.cn (catalog search + holdings), www.lib.pku.edu.cn (today's hours) and
#   kjyy.lib.pku.edu.cn/ic-web/psgSeatMenu (研修专座) are public. They answer JSON only when asked
#   for it (accept: application/json; Spring negotiation), see JSON_HEADERS in shared.yaml.
# - `library` (a.lib.pku.edu.cn 个人中心): the harness adapter replaces a literal `{session}` in
#   the url / body with the user's pkulib session.
# - `library-space` (kjyy.lib.pku.edu.cn ic-web): the adapter adds the cookies and token header.
campus: [library, library-space]
network: [opac.lib.pku.edu.cn, www.lib.pku.edu.cn, kjyy.lib.pku.edu.cn]
abilities: [todos]
shared: shared.yaml
tools:
  search: tools/search.yaml
  holdings: tools/holdings.yaml
  hours: tools/hours.yaml
  studySeats: tools/studySeats.yaml
  loans: tools/loans.yaml
  renew: tools/renew.yaml
  remindDueDates: tools/remindDueDates.yaml
  holds: tools/holds.yaml
  placeHold: tools/placeHold.yaml
  cancelHold: tools/cancelHold.yaml
  spaceRooms: tools/spaceRooms.yaml
  reserveSpace: tools/reserveSpace.yaml
  spaceReservations: tools/spaceReservations.yaml
  cancelSpace: tools/cancelSpace.yaml
widgets:
  nextDue: widgets/nextDue.json
  mySpace: widgets/mySpace.json
dataSources:
  loans: { title: 我的借阅, tool: loans, ttl: 30m }
  hours: { title: 今日开馆, tool: hours, ttl: 6h }
commands:
  library: { description: 图书馆概况：开馆时间、借阅到期、我的预约, aliases: [图书馆, lib], prompt: '图书馆今天几点开？我借的书什么时候到期，有没有研讨室预约？' }
  loans: { description: 我的借阅和到期日, aliases: [借阅, 还书], prompt: '我在图书馆借了哪些书，什么时候到期？能续借的列出来。' }
  book: { description: 在图书馆找书, aliases: [找书, 馆藏], argHint: 书名 / 作者 / ISBN, prompt: '在北大图书馆找一下「{{input}}」，告诉我在哪个阅览室、现在有没有在架。' }
i18n:
  en:
    name: Library
    description: 'Peking University Library (图书馆): catalogue search, loans and renewals, holds, study room booking, study seat availability and opening hours.'
    tools:
      search: { title: Search catalogue, summary: Find books in the PKU Library catalogue }
      holdings: { title: Holdings, summary: 'Where each copy of a book is, and whether it is on the shelf' }
      hours: { title: Today’s opening hours, summary: Whether the Library is open today and its hours }
      studySeats: { title: Study seat availability, summary: Free long-term study seats per room }
      loans: { title: My loans, summary: 'Books you have on loan, with due dates' }
      renew: { title: Renew books, summary: Renew books you have on loan }
      remindDueDates: { title: Due date reminders, summary: Turn your due dates into to-do reminders }
      holds: { title: My holds (pickup), summary: 'Your hold requests, and which are ready to collect' }
      placeHold: { title: Place hold, summary: Request a book that is checked out }
      cancelHold: { title: Cancel hold, summary: Cancel one of your hold requests }
      spaceRooms: { title: Free study room slots, summary: Free periods of the Library study rooms on a day }
      reserveSpace: { title: Book study room, summary: Book a Library study room for your group }
      spaceReservations: { title: My space bookings, summary: Your Library study room and study seat bookings }
      cancelSpace: { title: Cancel space booking, summary: Cancel a study room or study seat booking }
    widgets:
      nextDue: { title: Books due, description: 'Your next books due: title, due date and days left; changes colour when overdue or due within 3 days. Shows how many you have on loan.' }
      mySpace: { title: My study room booking, description: 'Your next active Library study room (or study seat) booking: place, time and status, with a check-in reminder.' }
    commands:
      library: { prompt: 'When is the library open today? When are my books due, and do I have any discussion room bookings?', description: 'Library at a glance: hours, due dates, my holds' }
      loans: { prompt: 'Which library books do I have out, and when are they due? List the ones I can renew.', description: My loans and due dates, aliases: [due] }
      book: { prompt: 'Find “{{input}}” in the PKU Library: which reading room it’s in and whether a copy is on the shelf now.', description: Find a book in the Library, argHint: 'Title, author or ISBN', aliases: [find-book] }
    dataSources:
      loans: { title: My loans }
      hours: { title: Today’s opening hours }

{
  "id": "library",
  "name": "图书馆",
  "description": "馆藏检索、我的借阅与续借、预约取书、研讨室预约、研修专座余量和开馆时间。",
  "author": "pkuinfo",
  "kind": "builtin",
  "auth": "none",
  "icon": "library",
  "requires": [
    "campus-session",
    "network"
  ],
  "scopes": [
    "opac.lib.pku.edu.cn",
    "a.lib.pku.edu.cn",
    "kjyy.lib.pku.edu.cn",
    "www.lib.pku.edu.cn",
    "sso.lib.pku.edu.cn"
  ],
  "tags": [
    "official",
    "campus",
    "library"
  ],
  "version": "0.2.0",
  "i18n": {
    "en": {
      "name": "Library",
      "description": "Peking University Library (图书馆): catalogue search, loans and renewals, holds, study room booking, study seat availability and opening hours."
    }
  }
}