Tauri API 手册

本页集中说明 HTTP Bridge 的接口规范、输入输出结构与关键示例，便于对接与调试。

基本信息

默认地址：http://127.0.0.1:4399

接口统一返回 ApiResponse：success / data / error / time。

前端统一使用 /v2 语义调用，内部映射至 Bridge。

新增模块（图书/资料分享）已接入同一 Bridge 层，便于统一鉴权和日志追踪。

响应结构

成功示例：

{
  "success": true,
  "data": { "...": "..." },
  "error": null,
  "time": "2026-02-04 12:00:00"
}

失败示例：

{
  "success": false,
  "data": null,
  "error": { "kind": "请求失败", "message": "登录失效" },
  "time": "2026-02-04 12:01:10"
}

HTTP Bridge 全量接口

路径	方法	输入	输出
/health	GET	-	健康状态
/login	POST	username, password, captcha?, lt?, execution?	登录结果与会话
/restore_session	POST	cookies	恢复会话
/export_cookies	GET	-	导出 Cookie
/import_cookies	POST	cookies	导入 Cookie
/sync_grades	POST	-	成绩列表 + meta
/sync_schedule	POST	-	课表 + meta
/export_schedule_calendar	POST	student_id, semester, week, events[]	ics 链接
/exports/{filename}	GET	-	下载 .ics 文件
/fetch_exams	POST	semester?	考试安排
/fetch_ranking	POST	student_id?, semester?	绩点排名
/fetch_student_info	POST	-	学生信息
/fetch_personal_login_access_info	POST	-	当前登录认证信息与设备信息
/fetch_semesters	POST	-	学期列表
/fetch_classroom_buildings	POST	-	教学楼列表
/fetch_classrooms	POST	week, weekday, periods, building	空教室列表
/fetch_training_plan_options	POST	-	培养方案选项
/fetch_training_plan_jys	POST	yxid	教研室列表
/fetch_training_plan_courses	POST	grade, kkxq, kkyx, kkjys, kcxz, kcgs, kcbh, kcmc, page, page_size	课程列表
/fetch_calendar_data	POST	semester?	校历与周次
/fetch_academic_progress	POST	fasz	学业完成情况
/qxzkb/options	GET	-	全校课表选项
/qxzkb/jcinfo	POST	xnxq	全校课表节次
/qxzkb/zyxx	POST	yxid, nj	专业信息
/qxzkb/kkjys	POST	kkyxid	开课教研室
/qxzkb/query	POST	多参数查询	课表列表
/library/dict	POST	term	图书检索筛选字典
/library/search	POST	query + filters + page	图书检索结果
/library/detail	POST	book_id / marc_no	图书详情与馆藏信息
/resource_share/proxy	GET	endpoint,path,username,password	资料分享代理流（预览/下载）
/electricity_query_location	POST	payload	电费位置
/electricity_query_account	POST	payload	电费余额
/fetch_transaction_history	POST	startDate, endDate, pageNo, pageSize	交易记录
/one_code_token	POST	-	一码通 token
/ai_init	POST	model, provider?	AI 初始化
/ai_upload	POST	file_content, filename	上传结果
/ai_chat	POST	content, context	AI 回复
/ai_chat_stream	POST	content, context	SSE 流
/cache/get	GET	table, key + JWT	缓存读取

远程配置关键字段（运行时）

ocr.endpoint：验证码识别服务地址（优先远程；失效时客户端自动回退本地兜底）。

temp_file_server.schedule_upload_endpoint：课表导出临时上传接口地址。

resource_share.endpoint：资料分享 WebDAV 源地址。

resource_share.office_preview_proxy：Office 文档在线预览代理地址。

announcements：首页滚动公告、置顶公告、确认公告内容。

force_update：最低可用版本控制与更新提示策略。

关键接口示例

课表导出 (本周 / 本学期)

POST /export_schedule_calendar
{
  "student_id": "2025xxxxxx",
  "semester": "2025-2026-2",
  "week": 10,
  "events": [
    {
      "summary": "高等数学",
      "start": "2026-02-04T08:20:00",
      "end": "2026-02-04T10:00:00",
      "description": "时间: 第10周 周3 第1-2节 08:20-09:55
地点: 教一 3-003",
      "location": "教一 3-003"
    }
  ]
}

响应:
{
  "success": true,
  "url": "http://127.0.0.1:4399/exports/schedule_xxx.ics",
  "filename": "schedule_xxx.ics",
  "count": 56
}

电费查询

POST /electricity_query_account
{
  "payload": {
    "utilityType": "electric",
    "bigArea": "",
    "area": "01",
    "building": "03",
    "unit": "",
    "level": "04",
    "room": "410",
    "subArea": ""
  }
}

响应:
{
  "success": true,
  "resultData": {
    "utilityStatusName": "正常",
    "templateList": [
      { "code": "balance", "value": "28.50" }
    ]
  }
}

交易记录

POST /fetch_transaction_history
{
  "startDate": "2025-02-04",
  "endDate": "2026-02-04",
  "pageNo": 1,
  "pageSize": 1000
}

响应:
{
  "success": true,
  "resultData": [
    {
      "tradeTime": "2026-02-03 11:14:01",
      "merchantName": "食堂",
      "amount": "-12.00",
      "balance": "35.60"
    }
  ]
}

图书详情查询

POST /library/detail
{
  "book_id": "123456"
}

响应:
{
  "success": true,
  "data": {
    "title": "高等数学",
    "cover": "https://.../cover.jpg",
    "items": [
      {
        "call_no": "O13/123",
        "barcode": "01906124",
        "location": "文学馆[5楼D区]",
        "status": "在架"
      }
    ]
  }
}

推荐阅读路径