← 返回列表

S2D-学习通开放能力可行性评估报告.md

S2D 学习通开放能力可行性评估报告

1. 调研对象

对象是什么与本品关系
学习通 App超星移动学习客户端（iOS / Android / HarmonyOS / 桌面客户端）。官方入口 app.chaoxing.com、轻量网页 i.chaoxing.com。学生端发布与回收的主入口；教师也可在 App 发活动、发作业、发考试。
泛雅网络教学平台电脑端网页教学平台，学校专属域多为 {校码}.fanya.chaoxing.com。手机端学习通与电脑端泛雅内容打通、同步（见厦门大学嘉庚学院教务部说明）。教师批量导入题库、作业库、试卷库、成绩「一键导出」主要在电脑端完成。
一平三端超星对「泛雅平台 + 学习通移动端 + 课堂端」的产品统称。课堂活动（签到/投票/问卷/测验/讨论）走学习通；课程建设与题库走泛雅。
超星开放平台 / 微服务公开可检索到域名 open.chaoxing.com、openapi.chaoxing.com（站长工具与域名汇总称「超星微服务开放平台」）。未检索到面向第三方备课工具的公开 REST 文档。学校信息化对接（账号、课表、教务中间库）可能走此通道；需向学校/超星确认本校是否开通、权限范围是否含作业/测验写入。
批量导入题库 / 作业库 / 试卷库：快速导入、Word/Excel 模板导入、Word 智能导入、专有 .ti 格式。本品 P9 已出开放 Excel + 列映射说明；本阶段要对齐学校当前模板。
成绩导出课程「统计 → 成绩管理 → 一键导出」Excel；作业/考试可单独导出成绩与答题附件。电脑端可下载，手机端多只能查看。可人工反哺 F8 课后反馈；无公开写入接口回传本品。
教师端手动路径对章节 → 传课件 → 发讨论 → 发作业 → 发测验。对应本品「去学习通五步」。阶段 2 可落地的集成形态。

产品侧已落地的交换物（P9，供对照）：

2. 逐项评估

判定口径：可行 = 公开资料已证明教师端路径稳定，本品可按交换物落地；部分可行 = 能力存在但格式/权限/题型不完全对齐，或只能人工不能接口；不可行 = 公开资料表明第三方无法合法调用；需进一步验证 = 公开文档缺失或取决于本校合同/开通。

a) 题库批量导入

维度结论
可行性部分可行（教师端模板导入 可行；与 P9 列结构 需对齐官方模板后才算完全匹配；专有 .ti / 官方二进制模板 需向学校/超星确认）

现状

泛雅课程门户 资料 → 题库 支持四种录入路径（多所高校教师手册一致）：

  1. 手动添加：逐题填题型、题干、答案、解析、难度、知识点。
  2. 模板导入：平台内下载模板后填写再上传。模板类型包括 快速导入模板、Word 模板、Excel 模板；部分手册还写明支持 .ti 格式。
  3. 智能导入：将已有 Word 试卷/题库直接识别（题与题之间空行；题干与答案同段；可标「答案」「题型」）。智能导入对单选/多选/判断/填空/简答较稳，其它题型手册多建议手录。
  4. 快速导入：按页面「题目格式」粘贴文本，或下载快速导入模板。

题型覆盖：单选、多选、填空、判断、简答为导入常用集；考试系统另支持名词解释、论述、计算、分录、连线、排序、完形填空、阅读理解、口语、听力等（近二十种，可自定义）。题目可带图片/音视频/附件。导入后可按目录（章节/知识点）归档，再组卷或选题进作业/考试。题库可 导出全部为 Excel / Word / .ti / PDF。

Excel 模板公开描述（未能在未登录状态下下载到学校当前二进制模板本身）：

与本品 P9 列结构匹配度

P9 列学习通侧对应匹配
题型题型（单选/多选/判断/填空/简答…）部分：P9 目前只产出单选/填空/简答，无多选、判断；学习通题型枚举更长
题干题干匹配
选项A–D选项列（官方模板可能为 A/B/C/D 或 选项A…）部分：列名与选项个数（是否支持 E/F）需对齐官方模板
答案正确答案部分：单选学习通通常要 A/B/C/D；P9 可能写入答案全文。填空/简答可写要点
难度难度（易/中/难）匹配（P9 已映射为易/中/难）
知识点知识点匹配（学习通侧常为下拉，导入时可能按文本新建或需预建，需确认）
解析答案解析匹配
层级无对应列不导入（P9 说明已写：放入备注/解析）
目标编号无对应列不导入（自用）

证据 / 来源

建议

  1. 阶段 2 内请任课教师在 本校泛雅 下载当前「excel模板」，把表头、示例行、注意事项交回产品，做一次 列映射对照表（比凭公开手册猜列名可靠）。
  2. 导入路径固化为：资料 → 题库 → 批量导入 → 模板导入（Excel）；识别失败再走 智能导入（Word） 兜底。P9 导入说明应按此改步骤文案（现文案写「导入试题 → 选择 Excel/CSV」，与真实菜单「批量导入 / 模板导入」不完全一致）。
  3. 单选答案列改为 字母（A/B/C/D）；选项列名按官方模板改（若官方是 A,B,C,D 则导出双表头或转换层）。
  4. 不把 .ti 当阶段 2 交付：该格式由平台导出/导入，无公开规范。
  5. 多选题、判断题：若教案需要，再扩 P9 题型枚举；当前单选+简答已覆盖「再认测验 + 真实性任务作业」分工。

b) 作业 / 讨论 / 测验发布

维度结论
可行性部分可行（教师端手动发布 可行；公开 API 发布 不可行）

现状

全部为 教师在泛雅或学习通内手工创建并「发放」，公开资料中 没有 面向第三方应用的「创建作业 / 发讨论 / 发测验」REST 文档。

活动教师端路径批量/导入API
讨论学习通班级「+」→ 主题讨论；或课程「讨论」。标题+正文。无批量导入；活动清单正文可粘贴未公开
作业课程「作业」→ 新建。方式：手动编辑 / 智能导入 Word / 从题库选题 / 作业库 Excel 或 .ti 模板导入。设置发放班级、时间后「发布」。正式成绩用作业模块，章节内小测不算正式作业。有 Excel/.ti/Word未公开
测验（1）课堂活动「测验」：即时发放，部分手册写明 不支持成绩导出及排名，要导出建议改发作业；（2）章节测验：插在章节任务点；（3）考试：试卷库手动组卷或随机组卷后发放。先导入题库再组卷未公开
资料/课件章节上传 PPT/Word/PDF 等，可设任务点、是否允许下载。逐文件上传；无「课件包 API」未公开

作业库还可教师间用 .ti 互导。测验/考试支持从题库按题型、难度、目录抽题，随机组卷最多约 20 套。

证据 / 来源

建议

  1. 阶段 2 固化五步手动路径，活动清单已含操作提示，按上表微调：
    • ③讨论：学习通班级「+」→ 主题讨论，粘贴活动清单引导语。
    • ④作业：作业 → 新建 → 从题库选题 或 智能导入；真实性任务/简答走作业（可导出成绩）。
    • ⑤测验：先模板导入题库 → 作业或考试模块组卷发放；课堂「测验」控件只用于课中即时，不替代可计分作业。
  2. 不要在产品里接 GitHub 上的非官方学习通协议（刷课/交作业类仓库）。那些是逆向网页/App 接口，违反平台条款，且会把学生作答与账号暴露给不可控脚本。
  3. 若学校信息化部门确认有官方写入 API，再进入第 5 节「阶段 3 输入条件」。

c) 问卷发布（学习通问卷/投票 vs 本品 /q）

维度结论
可行性部分可行（课堂问卷/投票作 并行通道；不能替代 本品 F9 /q 作为开学诊断主路径）

现状

学习通 班级活动 含：

与本品 F9 对照：

能力学习通问卷本品 /q/[token]
题型单选/多选/简答蓝图 A–F（迷思情景、工具经验、量化准备、专业先行、态度、开放期望）
蓝图硬约束无；教师自由出题AI 禁止增构念、禁止删必测模块
开学第一课依赖课程/班级已建好教材未到位、学习通班未建时仍能发
隐私/学号学习通账号实名；学号随学校学生库匿名汇总；学号自愿选填、不进分析、不用于成绩/训练
画像写回无（最多导出表）教师确认后写回 profile
批量导入题目公开手册以手录/问卷库为主；知识点导入有更新日志提及。Excel 问卷模板是否对教师开放需向学校确认题目 JSON + 导入说明（设计已要求并行通道）

GROK-EDT-K2 已裁决：不关闭 /q、不强制走学习通；/q 补隐私、限期限次；题目 JSON + 学习通导入说明为并行。本评估支持维持该裁决。

证据 / 来源

建议

d) 成绩导出与回传

维度结论
可行性部分可行（教师 Excel 导出可行；自动回传本品 不可行；人工粘贴进 F8 阶段 3 再做）

现状

与 F8 对齐：阶段 1 课后反馈是教师四字段（目标达成/难度/案例是否引发讨论/下节建议），说明书已 预留学习通汇总指标粘贴字段（阶段 1 不自动采集）。DS-EDT-G6 明确不采纳课中签到/投票实时回传；阶段 3 仅允许教师粘贴/导入学习通汇总表。

学习通导出的是 学生级分数/完成率，F8 要的是 教师对课堂的教学判断。二者粒度不同，即使有表也不能自动改深度档位（F9.3：完成率过低只出「供参考」）。

证据 / 来源

建议

e) 开放 API 总体

维度结论
可行性需进一步验证（对「学校是否已开通官方对接」）；在 无学校授权、无官方文档 的前提下，第三方备课工具调用 不可行

现状

线索含义对产品
open.chaoxing.com、openapi.chaoxing.com 域名存在，被称作超星微服务开放平台有内部/合作方开放门户，无公开可浏览的 API 目录、申请页、SDK不能当已开放的开发者平台用
多校已完成 教务系统 ↔ 超星 师生账号、课表、学生库对接属 校级信息化合同 + 超星项目实施，不是教师个人可申请的 AppKey账号同步 ≠ 作业/题库写入 API
超星课堂「对接教务课表自动绑定」需各地销售联系产品部开通连课表自动建课都要商务开通写入类能力门槛更高
腾讯会议等官方合作是超星侧产品对接合作方白名单本品不在名单内
GitHub 大量「chaoxing-api / 刷课 / 交作业」非官方逆向，用于学生客户端协议禁止用于本品
面向教师的官方材料一律是「登录泛雅 / 打开学习通 → 点菜单」产品策略是人机界面，不是开放 API与 F10 边界一致

本校是否已开通：公开网页无法判断。必须问 学校教务/信息化 + 驻校超星工程师。

证据 / 来源

建议

3. 结论与建议

3.1 阶段 2 内可落地的集成

项做法工作量量级
题库模板对齐用本校下载的 Excel 官方模板做对照；必要时改 P9 表头/答案字母/去掉不识别列；保留「层级」「目标编号」在解析或说明页小（有官方模板后 0.5–1 天）
导入步骤细化把 question-bank.ts 导入说明改为：资料→题库→批量导入→模板导入（Excel）→预览→加入题库→作业/考试组卷；失败则 Word 智能导入小
手动路径固化五步 + 活动清单按 §2.b 菜单名校对；测验强调「先题库后组卷」，课堂测验控件不替代可导出成绩的作业小
问卷并行说明一页：/q 仍是开学诊断；学习通问卷仅课中短测；蓝图题型如何降级手录小
成绩导出指引五步说明增加「电脑端统计一键导出，不回写本品」极小
官方 .ti / 二进制模板若学校提供 .ti 样例，只评估是否值得做导出器；默认不做视样例

以上均不改变 F10 边界，也不在 UI 增加「同步」按钮。

3.2 不承诺项及理由

不承诺理由
API 一键同步（建课、传课件、发讨论/作业/测验）无公开教师/第三方写入 API；学校级开放平台未证实对本品授权；逆向协议不合规
成绩自动回传仅有教师 Excel 导出；无推送接口；学号级成绩进备课系统有合规风险；与「非学习平台」定位及 DS-EDT-G6 裁决冲突
课中签到/投票实时回传动态画像修改说明已裁；依赖未知 API
用学习通问卷替换 /q题型/蓝图/匿名/开学未建班均不满足 F9
保证任意学校官方模板字节级兼容模板随平台版本与校内配置变化，必须以本校下载件为准

3.3 建议向学校 / 超星客服咨询的清单

请教务处、信息化中心或驻校超星工程师书面回复（可转发本清单）：

  1. 本校泛雅地址、教师账号是否已开通「题库批量导入 / 作业库导入 / 成绩一键导出」。
  2. 请提供 当前题库 Excel 模板、Word 模板、作业库 Excel 模板 各一份（含说明页）。列名、必填列、题型枚举、答案格式（字母还是原文）、知识点是否需预建。
  3. 是否仍支持 .ti 导入导出；若支持，能否给一份由平台导出的样例（不必给规范）。
  4. 问卷活动是否支持 Excel/文本批量导入题目，模板在哪下载。
  5. 成绩一键导出的字段列表（是否含学号、任务点完成率、作业均分、讨论数）；导出是否只能发到绑定邮箱。
  6. 学校是否已采购/开通 超星开放平台、数据中台、教务中间库、课表自动建课。若是：接口清单里有没有「创建章节、上传资料、发布作业/测验、拉取成绩」；申请主体是学校还是任课教师；有无测试环境与保密协议。
  7. 第三方教学工具官方接入的商务与安全评审流程（等保、学生数据出境/出校）。
  8. 学习通课程 ID、班级 ID 的查看路径（供教师手填本品 chaoxing_course_id / chaoxing_class_id，仅用于文件命名，不用于调用接口）。

4. 风险

风险说明缓解
超星能力与模板变化菜单名、模板列、智能识别规则随版本改；高校手册年份跨 2019–2025，细节不完全一致以 本校当前下载的模板 为唯一准绳；导入说明写「以平台下载模板为准」
学校未开通或权限不足部分校只开学习通课堂活动、未开考试/题库；或教师无「资料-题库」权限五步仍可传课件+发讨论；题库导入失败则 Word 智能导入或手录；不算阶段 1 返工
数据合规学生成绩、学号、作答属个人信息；非官方 API 会带 cookie/token；生成内容与作答不得用于模型训练只用教师登录态在官方页面导出；本品不存学习通密码；回传若做只收聚合；禁止逆向 SDK
误把课堂测验当成绩源部分测验控件不能导出成绩活动清单写明计分任务走「作业/考试」
列名看似接近、导入全失败「选项A」vs「A」、答案全文 vs 字母、多余列「层级」对照官方模板做转换，不假设 P9 列可直接上传
学术诚信与 ToS公开检索到的「学习通 API」几乎都是刷课/答题黑产文档与代码评审时拒绝此类依赖

5. 下一步：若学校确认有 API 权限，阶段 3 再评估的输入条件

仅当下列 全部 具备，才启动阶段 3「官方接口评估」（仍不自动改 F10 承诺，需单独裁决）：

  1. 书面授权：学校信息化 + 超星方面确认本品（或学校自建中间件）为合法调用方；有 AppId/密钥发放途径，禁止用教师账号密码模拟登录。
  2. 接口范围书面清单，至少要能回答：
    • 是否能按 courseId/classId 创建章节、上传课件、发布讨论/作业/测验；
    • 题库是「提交 Excel」还是「逐题 JSON」；
    • 成绩是拉取还是推送、字段是否含学号、是否可只要班级聚合；
    • 限流、审计日志、数据保留期。
  3. 测试课：非真实教学班的沙箱课程，允许导入/删除试题与作业。
  4. 数据保护：学生个人信息不进入大模型提示词；出校传输走学校等保范围；密钥只放服务端。
  5. 失败兜底：接口不可用时五步手动路径仍是主路径，UI 仍不写「同步到学习通」。
  6. 产品定位复核：即使接口可用，是否仍保持「生成在本品、发布在学习通」；一键发布若做，须单独改说明书 F10.1，不在阶段 3 默许扩范围。

若第 1–3 条任一否定，阶段 3 只做「学习通汇总表粘贴进反馈」（DS-EDT-G6 已允许的人工导入），不做 API。

附录 A 本品对照（只读，本报告不改代码）

附录 B 来源链接汇编

共 24 条有效来源（去重后；不含刷课插件下载页作为能力依据，仅 1 条逆向仓库作反面证据）。

平台与关系

  1. https://app.chaoxing.com/
  2. https://i.chaoxing.com/
  3. https://fanya.chaoxing.com/
  4. https://jwb.xujc.com/2022/0220/c5838a135020/page.htm

题库 / 作业 / 考试导入

  1. https://info.zzuli.edu.cn/_t961/2022/0601/c1488a269391/page.htm
  2. https://www.ustl.edu.cn/__local/9/4F/48/634306928C6730FC10D301CA7B5_5962F44C_5AA447.pdf?e=.pdf
  3. https://jxcj.xujc.com/_upload/article/files/af/ba/c97642bb44928e0da82e7c0c1958/257dd0ac-1b62-48e4-a73b-22d18ad1deaf.pdf
  4. https://gzist.edu.cn/__local/3/63/CE/5E98E4B8FA2F81D378C8656C277_5851F89B_5B968D.pdf
  5. https://sharewh.chaoxing.com/share/note/2025bf51-2284-4154-8125-cc7f8fedf8b6/note_detail?s_noteId=2025bf51-2284-4154-8125-cc7f8fedf8b6&sharebacktype=3&t=1592195659259&appId=1000
  6. https://www.siva.edu.cn/_upload/article/files/44/5a/ba71a2b845198436e9980e5dd8a7/fbc7158b-3001-4be7-bb8a-8f7feb9c43de.pdf
  7. https://mooc1.chaoxing.com/mooc-ans/ztnodedetailcontroller/visitnodedetail?courseId=250967448&knowledgeId=965384790
  8. https://mooc1.chaoxing.com/course/89991195.html

问卷 / 讨论 / 活动

  1. https://www.dxhx.pku.edu.cn/article/2020/1000-8438/20200534.shtml
  2. https://www.siva.edu.cn/_upload/article/files/44/5a/ba71a2b845198436e9980e5dd8a7/82c95d30-dcf6-464a-8107-859c81558f5d.pdf
  3. https://jwc.sta.edu.cn/93/c2/c674a103362/page.htm
  4. https://sharewh.mti100.com/share/edc646da-67b4-412c-8aec-8995cf22ec99?t=3
  5. https://www.ccut.edu.cn/__local/7/67/28/E3B58301514BB858400009B3295_8C64B3D4_1AFEB3.pdf?e=.pdf

成绩导出

  1. https://www.zhihu.com/question/578459331/answer/2843144857
  2. http://sygl.cwxu.edu.cn/UpLoadFile/Attached/2%E5%AD%A6%E6%A0%A1%E6%95%99%E8%82%B2%E5%9C%A8%E7%BA%BF%E5%B9%B3%E5%8F%B0%E4%BD%BF%E7%94%A8%E6%89%8B%E5%86%8C%EF%BC%88%E6%95%99%E5%B8%88%E7%89%88%EF%BC%89_1650543077.pdf

校级对接 / 开放平台线索

  1. https://ugs.swu.edu.cn/info/1012/3322.htm
  2. https://sharewh.mti100.com/share/ac193ca0-1fff-48d7-83e7-8f53401f129a?t=3
  3. http://120.25.237.190/2yuming/chaoxing.html

反面证据（不可用）

  1. https://github.com/chettoy/FxxkStar

产品依据

  1. 本仓库《设计说明书-v0.2》F10、§7.3；《修改说明文档》§4.2 / DS-EDT-K2 / GROK-EDT-K2 / DS-EDT-G6；《v0.2修订执行计划》原则 4、P9；src/lib/exporters/question-bank.ts

附录 C 遗留确认项（汇总）

  1. 本校当前 Excel/Word/作业库 官方模板文件与列名。
  2. 单选答案必须填字母还是允许全文。
  3. 知识点列是自由文本还是须先在平台建知识点。
  4. .ti 是否对本校教师开放。
  5. 学习通 问卷 是否支持文件批量导入。
  6. 本校是否开通超星开放平台/数据中台，以及接口是否包含作业与成绩。
  7. 教师如何在界面看到 courseId/classId（供手填命名字段）。
  8. 成绩导出字段是否含学号、能否只要班级汇总。

以上 8 项在拿到学校书面回复或官方模板文件前，产品侧维持 手动交换物 + 不承诺同步。

下载此文件