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

- **工作包**：阶段 2 / 工作包 2D
- **任务来源**：《修改说明文档》§4.2「学习通开放能力可行性验证」；《v0.2修订执行计划》原则 4（教学闭环优先，学习通同步靠后）、第 4 章「学习通官方题库二进制模板 → 阶段 2」
- **产品边界**：《设计说明书-v0.2》**F10.1**：本平台负责「生成与导出」，学习通负责「发布与回收」；**不承诺 API 一键同步与成绩回传**（阶段 2 仅做可行性评估）。**§7.3**：题库 Excel（题干/选项/答案/难度/知识点列）+ 一页导入说明；活动清单；课件包命名读 `classes.chaoxing_*`；「去学习通五步」勾选记录。学校官方模板为本阶段要对齐的对象。
- **评估日期**：2026-08-22
- **方法**：读本仓库 P9 交换物实现；联网检索超星学习通 / 泛雅 / 开放平台 / 题库导入模板 / 成绩导出公开资料。搜不到或依赖本校开通状态的，一律标 **需向学校/超星确认**。
- **明确不做（本报告结论维持）**：界面不写「同步到学习通」；不接非官方逆向协议；不承诺一键发布与成绩自动回传。

---

## 1. 调研对象

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

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

- 题库列：`题型, 题干, 选项A, 选项B, 选项C, 选项D, 答案, 难度, 知识点, 解析, 层级, 目标编号`
- 题型映射：有选项的再认题 →「单选题」；无选项再认 →「填空题」；其余 →「简答题」
- 难度：易 / 中 / 难
- 另出活动清单、课件包清单、五步勾选记录、导入步骤说明

---

## 2. 逐项评估

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

### a) 题库批量导入

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

**现状**

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

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

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

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

- 须先在 **本校泛雅页面点击「excel模板下载」**，按模板内示例与说明填写，不可自行发明表头。
- Excel 路径「编写格式比较清晰，导入识别精准度较高」。
- 公开演示写明 Excel 版题型支持单选、多选、填空等；填空可勾选「答案互斥」。
- 列级字段在教师端编辑页可见：**题型、题干、选项（A/B/C/D…）、答案、答案解析、难度、知识点**。与模板列名是否一字不差（「选项A」vs「A」、答案填字母还是全文）**取决于本校当前模板版本，需向学校/超星确认**。

**与本品 P9 列结构匹配度**

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

**证据 / 来源**

- 郑州轻工业大学《关于在线学习平台线上考试操作指南》：模板导入用 Excel，智能导入用 Word。[info.zzuli.edu.cn](https://info.zzuli.edu.cn/_t961/2022/0601/c1488a269391/page.htm)
- 辽宁科技大学《教师考试操作手册》：批量导入 = 快速导入 / 模板导入 / 智能导入；模板三类 = 快速导入、Word、Excel；智能导入示例含「答案：D」「题型：单选题」；导出全部为 Excel。原件：[`ustl.edu.cn` 教师考试操作手册 PDF](https://www.ustl.edu.cn/__local/9/4F/48/634306928C6730FC10D301CA7B5_5962F44C_5AA447.pdf?e=.pdf)
- 厦门大学嘉庚学院「一平三端」使用指南：资料→题库→批量导入→模板导入，下载 Word/Excel 模板；「模板导入要求的编写格式比较高」。[jxcj.xujc.com PDF](https://jxcj.xujc.com/_upload/article/files/af/ba/c97642bb44928e0da82e7c0c1958/257dd0ac-1b62-48e4-a73b-22d18ad1deaf.pdf)
- 广州理工学院等教师手册：模板导入支持 **Excel、`.ti`**。[gzist.edu.cn PDF](https://gzist.edu.cn/__local/3/63/CE/5E98E4B8FA2F81D378C8656C277_5851F89B_5B968D.pdf)
- 超星智慧考试教师说明：手动添加 / 模板导入 / 智能导入（Word 试卷无需特意改格式）。[sharewh.chaoxing.com](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)
- 超星慕课专题课演示 Excel 模板导入流程（需登录学习通查看全文）。[mooc1.chaoxing.com 专题](https://mooc1.chaoxing.com/mooc-ans/ztnodedetailcontroller/visitnodedetail?courseId=250967448&knowledgeId=965384790)

**建议**

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 套。

**证据 / 来源**

- 嘉庚学院 FAQ：教师发布主题讨论、投票等互动；作业由教师发放，学生收通知。[jwb.xujc.com](https://jwb.xujc.com/2022/0220/c5838a135020/page.htm)
- 浙江工业大学设计艺术学院等手册：新建作业 = 手动 / 智能导入 / 题库选题；模板导入 Excel+`.ti`。[design.zjut.edu.cn 同类手册检索摘要](http://www.design.zjut.edu.cn/uploadfile/files/202112060902234.pdf)
- 上海视觉艺术学院手册：作业库 Excel 模板导入、`.ti` 互导、导出 Word/Excel/`.ti`。[siva.edu.cn PDF](https://www.siva.edu.cn/_upload/article/files/44/5a/ba71a2b845198436e9980e5dd8a7/fbc7158b-3001-4be7-bb8a-8f7feb9c43de.pdf)
- 上海兴伟学院 FAQ：讨论在手机端课程—班级—「+」—主题讨论；大型正式作业走【作业】，章节测验走章节页。[jwc.sta.edu.cn](https://jwc.sta.edu.cn/93/c2/c674a103362/page.htm)
- 长春工业大学手册：课堂测验不支持成绩导出，需导出则发作业。[ccut.edu.cn PDF](https://www.ccut.edu.cn/__local/7/67/28/E3B58301514BB858400009B3295_8C64B3D4_1AFEB3.pdf?e=.pdf)

**建议**

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

---

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

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

**现状**

学习通 **班级活动** 含：

- **问卷**：单选、多选、简答；可加图片；可设积分、时长、是否允许学生看统计；可课前保存、课上「开始」；数据实时、可投屏、**支持导出**；可「再次发放」。部分版本支持从问卷库选题、导入知识点。
- **投票**：正确/错误、赞同/反对、A/B、A/B/C/D 等短交互，可导出。

与本品 F9 对照：

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

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

**证据 / 来源**

- 《大学化学》实践：课堂互动组合「问卷 + 抢答 + 小测 + 选人 + 主题讨论」。[dxhx.pku.edu.cn](https://www.dxhx.pku.edu.cn/article/2020/1000-8438/20200534.shtml)
- 广州理工 / 浙工大设计学院手册：问卷三种题型、实时统计、导出、再次发放。[gzist.edu.cn PDF](https://gzist.edu.cn/__local/3/63/CE/5E98E4B8FA2F81D378C8656C277_5851F89B_5B968D.pdf)
- 上海视觉艺术学院：电脑端班级活动添加问卷；可从问卷库选题。[siva.edu.cn 活动篇 PDF](https://www.siva.edu.cn/_upload/article/files/44/5a/ba71a2b845198436e9980e5dd8a7/82c95d30-dcf6-464a-8107-859c81558f5d.pdf)
- 泛雅更新日志：问卷、投票支持导入知识点。[sharewh.mti100.com](https://sharewh.mti100.com/share/edc646da-67b4-412c-8aec-8995cf22ec99?t=3)
- 设计说明书 F9 / F10 与修改说明 GROK-EDT-K2 裁决。

**建议**

- **开学诊断、素养画像、A–F 蓝图**：继续走 `/q`。
- **课中即时意向**（一题投票、三五题摸底）：教师用学习通问卷/投票，与五步并行，不进本品学生入口。
- 阶段 2 可补一页「若要把蓝图题迁到学习通问卷」的 **手工对照说明**（题型降级：情景判断 → 单选；开放期望 → 简答；学号与匿名条款无法在学习通复现，须在题干重申「不用于成绩」）。
- 不把 `/q` 扩展成签到/投票/作业入口。

---

### d) 成绩导出与回传

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

**现状**

- 电脑端课程 **统计 → 成绩管理**：设权重后 **「一键导出」Excel**（综合成绩及分项；可选单班/全部班）。
- 作业：已发放作业可 **导出成绩 Excel、导入成绩、导出答题详情**。
- 考试：导出成绩、导出考试附件（作答与批改）、试卷分析报告。
- 课堂活动（签到等）可在统计中导出 Excel。
- **手机端统计多仅查看、不能下载**（嘉庚学院 FAQ）。
- 存在内部导出任务接口被第三方脚本调用的痕迹（如 `fystat-ans.chaoxing.com/api/export-back-task`，需登录会话，非正式开放 API）。**本品不得调用。**
- 公开资料 **没有**「把成绩推送到校外备课系统」的官方接口。

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

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

**证据 / 来源**

- 知乎操作步骤：统计 → 成绩管理 → 权重 → 一键导出。[zhihu.com](https://www.zhihu.com/question/578459331/answer/2843144857)
- 无锡学校教师手册：统计界面「一键导出」Excel；成绩管理可导出、设权重。[sygl.cwxu.edu.cn PDF](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)
- 嘉庚 FAQ：电脑端可出报表，手机端不能下载。[jwb.xujc.com](https://jwb.xujc.com/2022/0220/c5838a135020/page.htm)
- 郑州轻工业大学考试指南：批阅「更多」中导出考试附件、成绩。[info.zzuli.edu.cn](https://info.zzuli.edu.cn/_t961/2022/0601/c1488a269391/page.htm)
- 上视手册：考试详情导出表格。[siva 成绩统计 PDF 检索](https://www.siva.edu.cn/_upload/article/files/44/5a/ba71a2b845198436e9980e5dd8a7/9051f457-f219-49ac-bf94-d6bed9349362.pdf)

**建议**

- 阶段 2：在导入说明/五步记录中加一句「成绩在泛雅电脑端统计→一键导出；不回写本平台」。
- 阶段 3：若要做「粘贴学习通汇总」，只收 **班级聚合**（均分、提交率、讨论条数），禁止学号级成绩进生成上下文；保留教师四字段为主信号。
- 不承诺自动回传。

---

### e) 开放 API 总体

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

**现状**

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

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

**证据 / 来源**

- 学习通 / 泛雅门户：[app.chaoxing.com](https://app.chaoxing.com/)、[i.chaoxing.com](https://i.chaoxing.com/)、[fanya.chaoxing.com](https://fanya.chaoxing.com/)
- 域名汇总称 `openapi.chaoxing.com` 为超星微服务开放平台（第三方整理，非官方文档）。[域名页](http://120.25.237.190/2yuming/chaoxing.html)
- 西南大学本科生院：智慧教学系统已与教务数据对接（登录方式，非开放给第三方备课）。[ugs.swu.edu.cn](https://ugs.swu.edu.cn/info/1012/3322.htm)
- 超星课堂指南：教务课表对接中间库「如需开通，请各地销售、项目人员联系学习通产品部」。[sharewh.mti100.com](https://sharewh.mti100.com/share/ac193ca0-1fff-48d7-83e7-8f53401f129a?t=3)
- 非官方协议示例（仅作「存在逆向、不可用」证据）：[chettoy/FxxkStar](https://github.com/chettoy/FxxkStar)

**建议**

- 阶段 2 **不申请、不开发** 任何超星 HTTP 客户端。
- 把「学校是否具备超星开放平台/数据中台权限」列入向学校咨询清单（第 3.3 节）。
- 界面、导出包、五步文案继续写「不提供同步到学习通的 API」。

---

## 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  本品对照（只读，本报告不改代码）

- P9 题库表头见 `src/lib/exporters/question-bank.ts` → `CHAOXING_BANK_HEADERS`
- 导入说明仍写「学校官方题库二进制模板为阶段 2」——本报告给出的落地动作即：拿到本校模板后改映射，而不是自制 `.ti` 生成器
- 五步文案见 `src/lib/prepare/status.ts` `CHAOXING_FIVE_STEPS`

## 附录 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  

**题库 / 作业 / 考试导入**

5. https://info.zzuli.edu.cn/_t961/2022/0601/c1488a269391/page.htm  
6. https://www.ustl.edu.cn/__local/9/4F/48/634306928C6730FC10D301CA7B5_5962F44C_5AA447.pdf?e=.pdf  
7. https://jxcj.xujc.com/_upload/article/files/af/ba/c97642bb44928e0da82e7c0c1958/257dd0ac-1b62-48e4-a73b-22d18ad1deaf.pdf  
8. https://gzist.edu.cn/__local/3/63/CE/5E98E4B8FA2F81D378C8656C277_5851F89B_5B968D.pdf  
9. 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  
10. https://www.siva.edu.cn/_upload/article/files/44/5a/ba71a2b845198436e9980e5dd8a7/fbc7158b-3001-4be7-bb8a-8f7feb9c43de.pdf  
11. https://mooc1.chaoxing.com/mooc-ans/ztnodedetailcontroller/visitnodedetail?courseId=250967448&knowledgeId=965384790  
12. https://mooc1.chaoxing.com/course/89991195.html  

**问卷 / 讨论 / 活动**

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

**成绩导出**

18. https://www.zhihu.com/question/578459331/answer/2843144857  
19. 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  

**校级对接 / 开放平台线索**

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

**反面证据（不可用）**

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

**产品依据**

24. 本仓库《设计说明书-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 项在拿到学校书面回复或官方模板文件前，产品侧维持 **手动交换物 + 不承诺同步**。