Time 使用文档
通过编辑 JSON 并创建剪贴板(Clip),获取 ExamCode,在 Time 页面加载自定义考试时间表。
使用步骤
- 准备 JSON: 按下方格式编辑你的考试安排 JSON。
- 创建 ExamCode: 复制完整 JSON 文本,访问
/page/clip/,在“文本剪贴板”粘贴后点击“创建”。保存系统返回的 Code(即 ExamCode)。 - 在 Time 页面加载: 打开
/page/time/,点击标题中的“自定义考试”,输入刚才的 ExamCode,即可加载并展示倒计时与进度。
Time 页面会从
/api/clip/get/{ExamCode} 拉取你粘贴的 JSON;时间基于 /api/ntptime/ 同步的服务器时间进行计算。
JSON 格式说明
- name:科目或事件名称(字符串)。
- start_at:开始时间(字符串,建议格式
YYYY-MM-DD HH:mm:ss,24 小时制)。 - duration_hour:持续时长(数字,单位:小时,可为小数)。
数组按时间先后排序更直观;Time 会自动寻找“尚未结束”的下一场考试并展示状态(未开始 / 考试中)、已过与剩余时间。
示例 JSON
复制下方示例,按需修改后作为你的考试安排。粘贴到剪贴板页创建即可获得 ExamCode:
[
{
"name": "语文",
"start_at": "2025-06-07 09:00:00",
"duration_hour": 2.5
},
{
"name": "数学",
"start_at": "2025-06-07 15:00:00",
"duration_hour": 2
},
{
"name": "物理历史",
"start_at": "2025-06-08 09:00:00",
"duration_hour": 1.25
},
{
"name": "外语",
"start_at": "2025-06-08 15:00:00",
"duration_hour": 2
},
{
"name": "化学",
"start_at": "2025-06-09 08:30:00",
"duration_hour": 1.25
},
{
"name": "地理",
"start_at": "2025-06-09 11:00:00",
"duration_hour": 1.25
},
{
"name": "思想政治",
"start_at": "2025-06-09 14:30:00",
"duration_hour": 1.25
},
{
"name": "生物",
"start_at": "2025-06-09 17:00:00",
"duration_hour": 1.25
}
]
常见问题
- 时区/时间误差: 前端显示基于服务端
/api/ntptime/,请确保服务器时区设置正确;start_at按服务器所在时区编写。 - ExamCode 无法加载: 检查剪贴板内容是否为有效 JSON;确认该 Clip 未过期、未超最大访问次数。
- 顺序与覆盖: 同一时间段多场考试会按数组顺序参与计算;请避免时间重叠或自行定义优先级。