[xiaobao_api_manager]
它是什么？
“小报日历同步助手”是我们社区专属的一个强大工具，旨在彻底改变您管理学业生活的方式。它就像一座桥梁，能将您在学校官方“小报”系统中的所有作业、考试和日常安排，一键、安全地同步到您在我们社区的个人专属日历中。
从此，您再也无需在两个系统之间来回切换，所有重要的截止日期和学术安排都将一目了然。
它有什么功能？
- 一键式同步: 只需一次点击，即可将“小报”中的所有日程安排拉取到您的个人日历中。
- 个性化与私密: 每个人的日历都是独立且私密的。您只会看到您自己的作业和考试，其他人无法查看。
- 无缝集成: 同步后的活动会直接出现在我们社区的日历页面上，您可以按月、按周或按列表视图进行浏览。
- 安全可靠: 您的个人登录凭证（Cookie）只会储存在您自己的浏览器中，永远不会被我们的网站服务器保存，确保了您账户的绝对安全。
它是如何工作的？(技术简介)
这个系统由两部分协同工作：一个安装在您浏览器上的扩展程序和一个在我们网站上的日历插件。
- 浏览器扩展 (您的“情报员”): 它的工作是作为一个安全的信使。当您授权后，它会使用您浏览器的登录状态，安全地从“小报”网站获取您的日程数据。
- 社区网站 (您的“私人秘书”): 扩展程序获取到数据后，会通过一个加密的 API 通道，将数据发送回我们的网站。网站后台的代码会接收这些数据，并自动为您在日历上创建或更新活动。
如何安装与配置 (一次性操作)
为了使用此功能，您需要完成一次性的安装和配置。
第一部分：安装浏览器扩展程序
这个助手是一个浏览器扩展程序，您需要在您的电脑浏览器（推荐使用 Chrome 或 Edge）上安装一次。
第1步：下载扩展文件
- 首先，您需要从 这里 获取扩展程序的安装文件包。这个文件包是一个
.zip压缩文件。 - 请将这个
.zip文件解压到一个您电脑上容易找到的文件夹中（例如，桌面上的一个新文件夹）。
第2步：打开扩展管理页面
- 对于 Edge 用户: 在地址栏输入
edge://extensions并按回车。 - 对于 Chrome 用户: 在地址栏输入
chrome://extensions并按回车。
第3步：开启“开发人员模式”
- 在扩展管理页面的左下角或右上角，找到并打开“开发人员模式 (Developer mode)”的开关。
第4步：加载扩展程序
- 开启“开发人员模式”后，页面顶部会出现一个新的按钮，名为 “加载已解压缩的 (Load unpacked)”。
- 点击这个按钮，然后在弹出的文件选择窗口中，选择您在第1步中解压的那个文件夹。
第5步：安装成功
- 如果一切顺利，您会在扩展管理页面上看到一个新的卡片，名为“小报日历同步助手”。
- 同时，在您浏览器右上角的工具栏中，会出现一个新的图标。
第二部分：获取并配置您的个人“通行证”
为了让系统安全地为您同步日历，您需要获取两个独一无二的“通行证”：API 密钥和小报登录 Cookie。
第1步：获取您的 API 密钥
- 向上滚动
- 找到开头
- 在这个页面上，您会看到您专属的 API 密钥。点击“复制”按钮。
第2步：获取您的完整 Cookie (最关键的一步)
- 在一个新的浏览器标签页中，正常登录到您学校的“小报”网站 (
tsinglanstudent.schoolis.cn)。 - 登录后，进入那个显示所有作业和考试列表的页面。
- 按
F12打开浏览器开发者工具，然后点击 “Network” (网络) 标签页。 - 在 “Network” 标签页顶部的“过滤器 (Filter)”输入框中，输入
GetList。 - 在过滤出的结果中，点击那一行
GetList?semesterId=...。 - 右侧会显示请求的详细信息。请确保您在 “Headers” (标头) 子标签页。
- 向下滚动，找到 “Request Headers” (请求标头) 部分，然后找到名为
cookie的那一行。 - 右键点击它右侧那段非常长的值，然后选择 “Copy value” (复制值)。
第3步：配置扩展程序
- 现在，点击浏览器右上角工具栏中我们扩展程序的图标。
- 在弹出的窗口中：
- 将您从“API 密钥管理”页面复制的 API 密钥，粘贴到“您的专属 API 密钥”输入框中。
- 将您刚刚从“小报”网站复制的完整 Cookie，粘贴到“小报登录 Cookie”输入框中。
- 点击 “保存设置” 按钮。
如何使用 (日常操作)
现在，一切准备就绪！
第1步：执行同步
- 在扩展程序的弹出窗口中，点击 “立即同步我的日历” 按钮。
- 您会看到一个状态提示，告诉您正在同步。请耐心等待几秒钟。
- 同步成功后，它会告诉您“同步成功！已处理 X 个项目。”
第2步：查看您的日历
- 现在，您可以访问我们网站的日历页面
- 您会看到所有为您同步的作业和考试，已经整齐地排列在日历上了！
常见问题解答 (FAQ)
- 同步失败怎么办？
- 最常见的原因是您的“小报” Cookie 已过期。Cookie 通常有几周的有效期。如果同步失败，请重复第二部分的第2步，获取一个全新的 Cookie，然后在扩展程序中重新保存即可。
- 我需要多久同步一次？
- 我们建议您每周或每两周同步一次，以确保您的日历包含最新的作业和考试安排。