前言¶
在 DeepSeek Harness（DSH）里做教学相关自动化时，常见路径是手写脚本对接平台 API，或手工下载全通教育模板、逐列粘贴成绩再上传。辅立码课（智慧教学云）的导入链路涉及登录签名、任务列表、班级对照表、小题分格式与异步回执核对，任一步格式不对，平台会整份拒收且不一定在提交接口里立刻报错。
下面介绍社区插件 dsh-fuulea-import（维护者 100759，分类：工作流）。它在 DSH 工作台内完成：选已发布的「平常考试」任务 → 拖入成绩表 → 自动填充上传模板 → 预检 → 一键导入并核对平台回执。第一版不做绑卷、发布任务、阅卷分配与收尾，只覆盖「下模板 → 填充 → 预检 → 上传 → 核回执」这一段。
这是什么¶
dsh-fuulea-import 是 DSH 工作台插件，面向已在辅立码课 / 智慧教学云发布任务的教师或教务：从学校站点选任务，把 xlsx / xls / csv（或 zip 打包的多文件）拖进界面，自动识别姓名列、题号列与总分列，下载并填充全通教育「班级对照表」模板，预检通过后导入，并用平台消息回执确认是否真正收下。
账号绑定只写本机（默认 ~/.fuulea-import/bindings.json，权限 0600），可与「教学数据报告」等工作台共享已绑定学校；打开工作台可自动登录并在多校之间切换。
核心功能¶
任务与文件¶
- 任务范围（第一版）：只做平台已发布的「平常考试」类导入；老师照常发布任务即可。
- 加载任务：列出账号可见任务（不按类型过滤列表展示）；默认最近 90 天，可切换 7 / 30 / 90 天 / 一年 / 全部；支持按科目、任务名 / 班级关键词筛选。
- 成绩文件：支持多文件与 zip；可「批量体检」逐个判定格式、姓名列、题号列、名单是否在班级对照表内，只保留可用文件。
题号与填充¶
- 模板「小题分」使用叶子题号（例如父题 4 不占列，列为
1, 2, 3, 4.1, 4.2）；源表需按题号文本对齐，支持4.1、第4.1题等写法。 - 分析题号映射：规则优先（一致则直接对应、小题可求和合并等）；歧义时由 AI 只输出「源表题号 → 模板题号」对应关系，不生成或改分数；每条建议需勾选确认后才填充。
- 预检：空格、名单与班级对照表一致、必须有逐题分、单格分数不超过该题满分（读不到满分时会提示并跳过该项，不静默放行）。
导入与回执¶
- 导入走
POST /v2/tasks/import/data/，后台异步；接口返回{}只表示已提交。 - 核对回执读取平台 trainer 收件箱或界面步骤，以
【云平台通知】导入任务数据等回执为「收下」依据；分值越界等拒收原因会在工作台标为失败。
版本更新¶
- 页面右上角显示版本（如
v1.1.0）；github:安装源支持页面内一键更新或再次执行安装命令拉最新提交，更新后需重启 DSH。 - 内网可关闭联网检查：在
cordis.patch.yml的插件 config 中设置checkUpdates: false。
安装与启用¶
仓库：https://github.com/100759/dsh-fuulea-import
社区目录：https://www.skillhub.cn/plugins/100759/dsh-fuulea-import
装到 DSH profile（桌面端示例；Web 端将 desktop 换成 web）：
dsh plugin --profile desktop add github:100759/dsh-fuulea-import
本地调试可用 link: 或本地目录路径安装（见仓库 README）。插件自带 cordis.patch.yml，安装后会在 profile 中插入 fuulea-import；若管理界面显示未启用，手动启用一次。重启 DeepSeek Harness 后，工作台左侧出现「导入成绩」入口。
依赖（插件 Host 与填充脚本）：
- Node ≥ 22.19（插件
engines要求^22.19.0 || >=24.0.0） python3与openpyxl（必需）；直接读老式.xls可选xlrd（第一版也提示可另存为 xlsx）
python3 -m pip install openpyxl
python3 -m pip install xlrd
典型用法¶
经过安装并重启 DSH 后，可按下面顺序操作（与 README 一致）：
- 左侧进入「导入成绩」。
- 顶部选择学校；若无绑定，点「＋ 绑定学校」，填写子域名与账号密码，验证通过后凭据仅存本机。
- 点「加载任务」，在列表中选择目标任务（可先筛科目与时间范围，再用搜索框匹配任务名 / 班级）。
- 将成绩文件拖入 ① 区，点「解析文件」；题号复杂时可先「分析题号映射」并确认映射，再点 ② 区「填充模板 → 预检 → 导入 → 核对回执」。
批量处理时：先「批量体检」筛出可用文件，点「用这份」再进入解析与填充流程。
适用场景与注意¶
适合谁：已在辅立码课发布平常考试任务、手上有 Excel/CSV 成绩表、需要按全通教育模板规范导入并核对回执的一线教师或教务；希望在 DSH 工作台内完成整条链路、减少重复登录与手工对列的人。
边界：不做绑卷、发布考试、阅卷分配与收尾；父题总分无法拆成子题分时不会自动均摊，需人工处理源表。
安全与权限：插件以当前 DSH 进程权限运行，会读写本机绑定文件与输出目录（默认 ~/.fuulea-import/output），并向学校站点发起登录与导入请求。安装前应查看源码与 MIT 许可证，确认子域名与账号使用符合校内规定。
生态说明：DSH 采用「一切皆插件」的扩展方式；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系，本文介绍的是社区维护的第三方插件，非官方应用商店条目。
结尾¶
dsh-fuulea-import 把辅立码课成绩导入收敛为工作台内可复现的步骤：选任务、拖表、填模板、预检、上传、对回执，并把题号映射与拒收条件尽量拦在上传之前。需要安装命令、配置项与 API 细节时，以仓库 README 为准。
