前言¶
在 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 爲準。
