Skip to main content

Documentation Index

Fetch the complete documentation index at: https://manuals.autolibrary.kenanzhu.com/llms.txt

Use this file to discover all available pages before exploring further.

软件启动时，将自动在用户主目录下创建运行配置文件 run.json 和用户配置文件 user.json。 配置文件统一存放于用户主目录下的 AutoLibrary/config 文件夹中。以 Windows 系统为例： 
C:\Users\<用户名>\AppData\Roaming\AutoLibrary\config
任何情况下都不建议在该目录下修改除运行配置文件和用户配置文件以外的任何文件。即使是修改配置文件，也请务必保持 JSON 格式正确，否则可能导致软件无法正常启动或运行。

​
运行配置文件 (run.json)

{
  "library": {
    "host_url": "http://10.1.20.7",
    "login_url": "/login"
  },
  "mode": {
    "run_mode": 1
  },
  "login": {
    "auto_captcha": true,
    "max_attempt": 3
  },
  "web_driver": {
    "driver_type": "edge",
    "driver_path": "",
    "headless": false
  }
}

​
字段 (library)

关于图书馆的相关配置，目前版本下无需更改
参数类型说明
host_urlString图书馆主机URL，无需更改
login_urlString登录页面URL，无需更改

​
字段 (mode)

AutoLibrary 的运行模式
参数类型说明
run_modeNumber运行模式组合（+1 预约, +2 签到, +4 续约）

​
字段 (login)

AutoLibrary 处理登录时的相关配置
参数类型说明
auto_captchaBoolean自动验证码识别，建议保持 true
max_attemptNumber登录尝试次数，默认 3 次

​
字段 (web_driver)

AutoLibrary 使用的浏览器及其驱动的相关配置
参数类型说明
driver_typeString浏览器类型：edge / chrome / firefox
driver_pathString驱动文件路径，为空则运行失败
headlessBoolean无头模式，默认 false

​
用户配置文件 (user.json)

{
  "groups": [
    {
      "name": "分组名",
      "enable": true,
      "users": [
        {
          "username": "您的学号",
          "password": "您的密码",
          "enable": true,
          "reserve_info": {
            "date": "2025-10-30",
            "place": "1",
            "floor": "4",
            "room": "5",
            "begin_time": {
              "time": "09:30",
              "max_diff": 30,
              "prefer_early": true
            },
            "end_time": {
              "time": "21:23",
              "max_diff": 30,
              "prefer_early": false
            },
            "renew_time": {
              "expect_duration": 1.0,
              "max_diff": 30,
              "prefer_early": false
            },
            "seat_id": "31A",
            "expect_duration": 6,
            "satisfy_duration": true
          }
        }
      ]
    }
  ]
}

​
字段 (groups)

这是用户配置的最外层的用户分组，分组中会包含一个用户列表，
即使只添加用户列表而不使用分组包裹，AutoLibrary 也会默认为该用户列表创建兼容分组。
参数类型说明
nameString分组名称
enableBoolean是否启用该分组，false 时跳过

​
字段 (users)

用户分组中的用户列表
参数类型说明
usernameString学号
passwordString密码
enableBoolean是否启用该用户，false 时跳过

​
字段 (reserve_info)

该字段包含了用户的座位预约信息
参数类型说明
dateString预约日期（格式 yyyy-MM-dd）
placeString"图书馆" 或 "1"
floorString楼层代码，详见下方楼层映射
roomString区域代码，详见下方区域映射
seat_idString座位编号，如 12A 012a
expect_durationNumber期望预约时长（分钟）
satisfy_durationBoolean是否满足期望时长
代码楼层
2二层
3三层
4四层
5五层
代码区域
1二层内环
2二层西区
3三层内环
4三层外环
5四层内环
6四层外环
7期刊区
8五层考研

​
子字段 begin_time

参数类型说明
timeString开始时间（格式 HH:mm）
max_diffNumber最大时间差（分钟）
prefer_earlyBoolean是否优先较早时间

​
子字段 end_time

参数类型说明
timeString结束时间（格式 HH:mm）
max_diffNumber最大时间差（分钟）
prefer_earlyBoolean结束时间优先较晚

​
子字段 renew_time

该子字段只在用户的续约模式下才会被 AutoLibrary 读取
参数类型说明
expect_durationNumber期望续约时长（小时）
max_diffNumber最大时间差（分钟）
prefer_earlyBoolean续约时间优先较晚