十六进制课件与作业关联课时

要解决的问题

在十六进制平台上，课件和作业是分散管理的资源：课件存在本地，必须先上传平台拿到 coursewareId，才能挂到指定课时；已发布的作业（HTE）也需要把 hteId 逐条关联到课时。手动操作要在界面里反复切换，参数层级多（courseId、directoryId、classPeriodId），很容易挂错目录或重复关联。这个技能把「上传课件 / 添加作业 → 关联到指定课时」收敛为一次脚本调用。

核心能力与工作流程

技能不依赖任何 MCP 连接器，通过内置 hex_mcp_proxy.py 通信层 + hex_tool.py 通用调用器直连云端 mcp-server。

• 课件分支：--upload 模式在本地完成六步流程——读取文件并计算 SHA-1、按名称查重、获取 OSS 签名、本地直传 OSS、注册资源、注册课件，返回 coursewareId；再调用 addfiletoclassperiod 关联到课时。支持 PPT / Word / PDF / Excel 等格式。
• 作业分支：收集单个或多个 hteId 组装为 hteList，调用 addhtetoclassperiod 批量添加到课时，每个作业可独立设置 sequence 排序、state 分类（1=预习，2=复习，3=作业，4=随堂练习）与 isPublish。
• 参数解析：用户未提供 courseId 时先用 getlastcourse 取当前课程；课时未知时用 listclassdictionaries + listclassperiods 列出目录和课时供用户选择。编号字段在展示层隐藏、只显示名称，但编号与名称的映射保留在对话上下文中。

同一课件可关联多个课时，同一作业可挂到多个课时且重复添加不报错。

注意点

• classPeriodId 是 number 类型，JSON 中不加引号；coursewareId 只能来自上传返回值，不能猜测或手动指定。
• hteId 必须是已发布的作业/考试 ID，缺失时要向用户询问，不能编造。
• 课件文件路径缺失时必须先询问用户；作业 ID 缺失同理。
• 命令示例统一写 python3，Windows 下替换为 python；路径使用 ~/ 写法。
• 认证全自动：首次使用自动打开浏览器登录，遇到 401 会自动重新登录，apiKey 保存在 ~/.hexfuture/apikey.json。