Skip to content

Appendix Verification

ChangYo edited this page Oct 26, 2026 · 3 revisions

待验证清单

这页只放还没有复现、不能写成事实的线索。每条都写清楚:要验证什么、怎么验证、需要什么权限。验证完成后,把结论写进对应平台页,并从这页删掉。

Note

不要把这里的条目直接写进生产代码。它们只是「值得查」的线索,不是契约。

高优先级

项 要验证什么 怎么验证 需要
i.sjtu 成绩/考试/GPA 端点、参数、CSRF/Referer、字段、分页 本人账号抓一次成绩页/考试页请求;对照 pysjtu、sjtu-mcp-server 本人账号、当前学期有成绩
课堂视频 list/termYear 参数、返回结构、currentTerm 是否稳定 学期切换前后各抓一次;对照 Dela api.ts 本人账号、两个学期
课堂视频转写/PPT 异步状态 状态字段、完成条件、重试间隔 录制后连续几天抓同一场次 本人账号、有录课课程
水源 POST /uploads.json 是否可用、大小限制、返回 short_url write key 上传一张小图;看 200/413/403 write key、测试帖
水源通知已读/发帖/私信写 具体端点、权限、CSRF write key 在测试对象上逐项试;能撤销的先确认撤销 write key、测试主题
Canvas 作业提交/上传 端点、scope、文件字段、幂等 在测试课程/测试作业上试;不要提交真实作业 测试课程、本人 Token
Canvas OAuth(Developer Key) 授权码流程、refresh、多用户 联系 Canvas 管理方申请 Developer Key 管理方批准
Pan 私有 API /api/v1 端点、UserToken 刷新、COS 分片 对照 sjtu-downloader-all-in-one,小文件试 本人账号、测试文件
数据资源 API 字段行为 实际返回字段、分页上限、错误码 有审批的应用/字段;小范围查询 部门应用、字段审批
InfoPlus File/Notification/Export 端点、权限、返回格式 有 App/流程权限的环境;测试流程 App、租户/流程管理员

中优先级

项 要验证什么 怎么验证 需要
Open API Enterprise 组织/岗位/权限/校历端点 有 scope 的应用;逐接口试 clientId + scope
Open API Mail 读/发/状态端点 有 read_mails/send_mail 的应用 clientId + scope
Open API Card/Finance/Signature 读写边界、高风险确认 不要在真实账户上试写;先读文档/沙箱 业务审批
水源 message_bus 能否做推送式更新 抓 /message-bus/...;看 message_bus_last_id 登录会话
水源 AI 摘要 summarizable/has_cached_summary 对应端点 找有摘要的帖子;抓请求 登录会话
教务成绩/考试页面 是否仍是 cjcx/xskscx 家族 DevTools 抓请求;对照社区代码 本人账号
体育场馆 场地图/订单/取消端点 只读查询;不要自动预约 本人账号
第二课堂报名/取消 method: 7 的语义、form_value 结构、取消端点 在可退的测试活动上报名再取消,逐项记录 本人账号、测试活动
图书馆 借阅/座位/研讨间 只读查询 本人账号
传承·交大 下载/积分 下载扣分规则、积分记录端点、重复下载是否再扣 选一份低价资料下载一次;对照 has_purchased 本人账号、少量积分
传承·交大 上传 上传端点、文件类型/大小限制、审核状态 上传一个无版权测试文件 本人账号
选课社区写操作 点评、投票、关注、选课记录的端点与撤销 用本人 Key 发一条可删除的测试点评;逐项试 本人 Key、可删除的测试内容
班车/食堂/空教室 数据源、更新频率 对照 openclaw-sjtu;连续几天观察 公开页面/校园会话

低优先级 / 待确认入口

项 问题
SJTU Date 正式入口、账号体系、可读数据
龙虾广场 正式入口、内容范围、与 OpenClaw 的关系
CNMOOC 课程目录、学习进度、SSO 会话
选课社区 /api/ext/* 系统 Key 的申请条件、端点与用途
校园卡/思源码 支付码/身份码的合规边界;默认不做

验证完成后怎么写

  1. 把结论写进对应平台页的端点、字段和常见问题部分。
  2. 标 [实测 YYYY-MM-DD,账号权限范围,样本量]。
  3. 如果结论是「不可用」,写进已废弃接口。
  4. 从这页删掉条目;在页面「变更记录」加一行。

证据标准

  • 至少两次独立请求,排除偶发。
  • 记录 method/path/status/关键字段/日期。
  • 写操作要在测试对象上做,先确认撤销路径。
  • 不贴 Token/Cookie/学号/姓名/正文。
  • 不接受「我这边可以」但没有请求/响应的结论。

变更记录

  • 2026-10-25:首版。把 Roadmap 的公开 TODO 改成可认领的验证队列。
  • 2026-10-26:第二课堂、选课社区已有平台页,待验证项收缩到写操作与未覆盖端点;补传承·交大的下载、积分和上传。

Clone this wiki locally