[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7AVAV3QV9K5P80P395TT9VP":3,"skill-same:01M7AVAV3QV9K5P80P395TT9VP":54},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M7AVAV3QV9K5P80P395TT9VP","eduseed-student-submit",null,"① 帮学生查挑战、预检交付物、提交项目并跟踪评分闭环（查→检→确认→交→跟踪），提交前必须向学生展示摘要并等待人工确认;② 适合\"看看 C03 要交什么\"\"检查我项目缺什么\"\"提交 C03\"\"我上次评分多少\";③ 触发词:挑战、提交、交作业、交付物、评分、评审","bonc-ai\u002Fcogseed","bonc-ai","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F313335383?v=4","01M7AV826PEZKTFGW9MCPBERA7","东方国信 BONC","01M7AV827DEZPMD30Y94T1ZFKQ",19,"MIT","https:\u002F\u002Fgithub.com\u002Fbonc-ai\u002Fcogseed\u002Fblob\u002Fmain\u002Fresources\u002Fbuiltin-packages\u002Feduseed-course-client\u002Fskills\u002Feduseed-student-submit\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: eduseed-student-submit\ndescription: ① 帮学生查挑战、预检交付物、提交项目并跟踪评分闭环（查→检→确认→交→跟踪），提交前必须向学生展示摘要并等待人工确认;② 适合\"看看 C03 要交什么\"\"检查我项目缺什么\"\"提交 C03\"\"我上次评分多少\";③ 触发词:挑战、提交、交作业、交付物、评分、评审\n---\n\n# EduSeed 学生提交｜挑战提交闭环（Plugin 版）\n\n本 Skill 是 EduSeed 课程客户端（Course Plugin）的学生侧入口。运行时为技能脚本\n`scripts\u002Fruntime.js`（自包含单文件，直接调平台 HTTP Agent API，**不再走 MCP 连接器**）。\n\n## 首次使用（激活向导，onboarding）\n\n1. 先跑 `license-check` 确认席位状态：\n   - 返回 licensed:true → 正常使用；\n   - 返回 SEAT_NOT_LICENSED \u002F COURSE_NOT_LICENSED → 告诉学生\"该席位未授权，\n     请联系学校管理员开通\"，并给出三个必配项（EDUSEED_SERVER_URL \u002F EDUSEED_API_KEY \u002F EDUSEED_STUDENT_ID）\n     与平台 \u002Fcompanion 页的指引——**不执行任何课程命令**；\n2. 缺配置（CONFIG 类报错）→ 提示学生从平台 \u002Fcompanion 页生成 API Key 并下载配置，\n   把 env 三件套配好再试；\n3. 激活后建议先跑 `list-challenges` 冒烟，确认能看到挑战列表再开始正式使用。\n\n## 运行时调用方式\n\n唯一受支持的方式（CogSeed 内，bash 工具）：\n\n```bash\n\"$COGSEED_NODE\" \"$COGSEED_PC_DIR\u002Fbin\u002Frun-skill.cjs\" eduseed-student-submit runtime -- \u003C命令> '\u003CJSON载荷>'\n```\n\n新版 run_skill 工具等价形式：`{skill_id:\"eduseed-student-submit\", script:\"runtime\", args:[\"\u003C命令>\",\"\u003CJSON载荷>\"]}`\n\n> ⚠️ **不要**用 `node scripts\u002Fruntime.js …` 之类的方式直接跑脚本。`run-skill.cjs` 是宿主\n> 注入运行时凭证的唯一入口，绕过它就拿不到凭证，所有需要鉴权的命令都会 `AUTH_FAILED`。\n\n每次调用 stdout 输出一个 JSON 结果（`{ok, ...}`）。**不得**把多次结果拼进一个 shell 命令的管道再喂给用户，必须逐步读取、逐条解释。\n\n## 凭证由宿主注入（重要：不要自行查找凭证）\n\n`EDUSEED_SERVER_URL` \u002F `EDUSEED_API_KEY` \u002F `EDUSEED_STUDENT_ID` \u002F `EDUSEED_ROLE`\n由 CogSeed **在本次技能运行的那一刻**注入技能进程，随本次运行结束即收回。\n\n因此：\n\n- 在 bash 里 `printenv | grep EDUSEED` **看不到任何东西是正常的**，不代表凭证缺失；\n- **不要**用环境变量判断凭证是否存在；**不要**全盘 `find` \u002F `grep` 搜索凭证文件；\n- **不要**使用桌面、下载目录里的历史 `*-config-*.json`——那可能是别的学号的旧配置；\n- 需要鉴权的命令（`list-challenges` \u002F `get-challenge` \u002F `export-challenge-pack` …）\n  **只用上面那条首选命令**即可，凭证会自动到位；\n- `health` 是免鉴权端点，它通过**不代表**凭证有效，**不能**作为凭证就绪的依据；\n- 若按首选命令仍报 `AUTH_FAILED`，正确处置是引导学生到平台 `\u002Fcompanion` 重新生成\n  API Key；**绝不要**关闭授权校验（例如 `EDUSEED_REQUIRE_LICENSE=0`）。\n\n## 命令面（学生视角，来自 runtime help）\n\n| 命令 | 作用 | 关键载荷 |\n|---|---|---|\n| `list-challenges` | 已发布挑战列表 | — |\n| `get-challenge` | 挑战详情（交付物\u002Frubric\u002F截止） | `{\"challengeId\":\"C03\"}` |\n| `get-challenge-content` | 挑战正文全文（G3：CHALLENGE.md\u002Fchallenge.yaml\u002Frubric.json） | `{\"challengeId\":\"C03\"}` 可选 `workdir` 落盘 |\n| `export-challenge-pack` | 一键导出完整资料包（任务卡+正文+材料，SHA-256 可复核） | `{\"challengeId\":\"C03\",\"workdir\":\"\u002Fabs\u002Fpath\"}` |\n| `list-challenge-materials` | 挑战材料清单（G4，已自动过滤平台 `._*` 垃圾件） | `{\"challengeId\":\"C03\"}` |\n| `download-challenge-materials` | 下载材料到本地工作区（G4，已自动过滤平台 `._*` 垃圾件） | `{\"challengeId\":\"C03\",\"workdir\":\"\u002Fabs\u002Fpath\"}` 可选 `file` |\n| `list-course-materials` | 课程级公共资料清单（P3：体系文档\u002F先修课\u002F群公告与参考资料） | `{\"scope\":\"system-docs\"}`（prereq \u002F reference） |\n| `download-course-materials` | 下载课程级公共资料到本地工作区（P3） | `{\"scope\":\"system-docs\",\"workdir\":\"\u002Fabs\u002Fpath\"}` 可选 `file` |\n| `check-deliverables` | 本地交付物检查（离线，非权威） | `{\"workdir\":\"\u002Fabs\u002Fpath\",\"requiredDeliverables\":\"README.md, src\u002F**\"}` |\n| `prepare-submission` | 预检报告 + 行动项 + 提交草稿（离线） | 同上 + `githubRepoUrl`,`projectTitle` |\n| `submit-project` | 提交（预检→Envelope→task_id） | 见下 |\n| `submit-and-track` | 提交并跟踪完整闭环（output contract） | 见下 |\n| `get-task` | 任务状态轮询 | `{\"taskId\":\"task-xxx\"}` |\n| `list-my-submissions` | 我的提交记录 | — |\n| `get-evaluation` | 评审详情（AI 初评\u002F教师终审\u002F同伴） | `{\"submissionId\":\"sub-xxx\"}` |\n| `get-dashboard` | 进度仪表盘 | — |\n| `get-delta-r` | ΔR 偏差分析（calibration\u002Flearning） | `{\"submissionId\":...}` 或 `{\"challengeId\":...}` |\n| `list-episodes` \u002F `get-episode` \u002F `get-replay-suggestions` | KSTAR 学习记忆 | `{\"episodeId\":...}` 等 |\n| `agent-send` \u002F `agent-inbox` \u002F `agent-contacts` | P3394 师生互通 | `{\"toAgentId\":...,\"text\":...}` |\n| `health` | 平台连接检查 | — |\n| `get-my-binding` | 查询本人 GitHub 绑定状态（提交前预检，未绑定会被平台拒收） | — |\n\n## 九步工作流（继承课程提交技能模板，不可跳过）\n\n### Phase A — 只读校验（步骤 1-4，无后端写入）\n\n1. **validate_submission_inputs** — 必填项存在性\u002FURL 形状；AAR ≠ 自评链接。失败：`INPUT_MISSING` \u002F `INPUT_MALFORMED`\n2. **resolve_student_record** — `health` 确认连接；身份由平台从 x-api-key 解析（不可伪造）。失败：`AUTH_FAILED`\n3. **resolve_github_binding**（2026-09-09，防串作业硬门）— `get-my-binding` 查本人 GitHub 绑定状态：**未绑定 → 立即停止，明确告知学生先去学生端【设置 → GitHub 绑定】填写用户名后再提交，绝不发起 submit-project**（平台对未绑定提交会直接拒收）；已绑定 → 记录绑定的用户名，进入下一步。教师已代填\u002F挑战豁免时同样以 `get-my-binding` 返回为准放行。\n4. **resolve_challenge_record** — `get-challenge` 查挑战；确认 deadline\u002Fstatus 开放。失败：`CHALLENGE_NOT_FOUND` \u002F `CHALLENGE_CLOSED`\n5. **stage_challenge_materials**（G3+G4，2026-09-08）— 若学生要做题且该挑战有材料：`download-challenge-materials` 把材料落到 `\u003Cworkdir>\u002F挑战\u003Cid>_材料\u002F`；需查看挑战正文全文时用 `get-challenge-content`（可选 `workdir` 落到 `\u003Cworkdir>\u002F挑战\u003Cid>_正文\u002F`）。**只落盘、只回报文件清单与路径，绝不把材料内容整读进上下文**；缺材料则跳过（`NO_MATERIALS` 不是失败）。失败：`DOWNLOAD_FAILED`（可让学生稍后重试，不阻塞提交）。平台材料目录混有的 macOS `._*` 垃圾文件已由运行时自动过滤（结果含 `junk_skipped` 计数）。\n6. **validate_artifact_links** — `check-deliverables` + `prepare-submission` 本地通配符检查 + GitHub 指针；完整报告每个检查项。失败（软）：`REPO_PATTERN_MISMATCH` \u002F `README_MISSING`\n\n### 步骤 4.5 — 提交摘要人工确认（MVP User Story，硬性）\n\n在调用 `submit-project` \u002F `submit-and-track` 之前，必须：\n1. 向学生展示**提交摘要**：**提交身份（学号，取自运行时 submit 结果的 studentId，A2-2 硬性）**、**挑战名称（challengeTitle，取自 get-challenge 返回的 title）**、挑战 ID、项目标题、GitHub 仓库、AAR\u002F自评字数、交付物检查结果、缺件清单；\n2. 明确提问：\"将以 \u003C学号> 身份提交，确认吗？（回复'确认'后才会写平台）\"；\n3. **只在学生明确确认后**执行写入。学生未确认\u002F要求修改 → 停止并列出待改项。\n失败行为：`never_submit_without_user_confirm`\n\n\n### 确认卡片（GUI 模式，硬性要求）\n\n**具备 create_artifact 工具时必须使用「确认卡片」，禁止退化为纯文字确认**。仅当卡片创建失败或工具不可用时才允许文字确认，且必须在回复中明确说明原因：\n\n1. 创建 artifact（title=「待确认：提交项目」），含两个文件：\n   - `index.html`：确认卡片宿主模板（附录 A，**原样使用**，不要增删改动）\n   - `confirm-config.json`：`{\"op\":\"submit-project\",\"payload\":{…完整写入载荷…}}`（A2-2 硬性：payload 必须包含 `提交身份` 字段 = 运行时 submit 结果的 studentId；Bug2 硬性：payload 必须包含 `challengeTitle` = get-challenge 返回的 title，与 `challengeId` 并存——卡片会把「挑战名称」与「挑战 ID」分开展示，不得只用裸 ID 充当挑战名）\n2. 对话中会渲染出插件确认面板（载荷摘要 + 确认\u002F取消按钮）；\n3. 等待用户操作：\n   - 收到 `{\"action\":\"plugin-confirm\",\"op\":\"submit-project\",\"payload\":…}` → 用该 payload 执行第 5 步 `submit-project`；\n   - 收到 `{\"action\":\"plugin-cancel\",…}` 或用户文字取消 → 停止写入，按用户意见修改；\n4. 用户未点击时**不得**执行写入。\n\n### 附录 A：确认卡片宿主（index.html 模板）\n\n```html\n\u003C!DOCTYPE html>\n\u003Chtml lang=\"zh-CN\">\n\u003Chead>\n  \u003Cmeta charset=\"utf-8\" \u002F>\n  \u003Ctitle>确认卡片\u003C\u002Ftitle>\n\u003C\u002Fhead>\n\u003Cbody style=\"margin:0;background:transparent\">\n\u003Cscript src=\"__cogseed\u002Fbridge.js\">\u003C\u002Fscript>\n\u003Cscript>\n(function () {\n  'use strict';\n  var frame = document.createElement('iframe');\n  frame.style.cssText = 'width:100%;border:0;display:block;min-height:340px';\n  frame.setAttribute('sandbox', 'allow-scripts allow-same-origin allow-forms');\n  frame.setAttribute('referrerpolicy', 'no-referrer');\n  document.body.appendChild(frame);\n\n  function sendToChat(payload) {\n    if (window.cogseedArtifact && typeof window.cogseedArtifact.send === 'function') {\n      window.cogseedArtifact.send(payload);\n      return;\n    }\n    try { parent.postMessage({ __cogseedArtifact: true, type: 'submit', payload: payload }, '*'); } catch (e) {}\n  }\n\n  fetch('.\u002Fconfirm-config.json')\n    .then(function (r) { if (!r.ok) throw new Error('no config'); return r.json(); })\n    .then(function (c) {\n      var q = new URLSearchParams();\n      q.set('op', String((c && c.op) || ''));\n      q.set('payload', JSON.stringify((c && c.payload) || {}));\n      frame.src = 'cogseed-plugin:\u002F\u002Feduseed-course-client\u002Fui\u002Fconfirm.html?' + q.toString();\n    })\n    .catch(function () { frame.remove(); });\n\n  window.addEventListener('message', function (ev) {\n    var d = ev.data;\n    if (!d || typeof d !== 'object' || d.__cogseedPlugin !== true) return;\n    try { if (ev.source !== frame.contentWindow) return; } catch (e) { return; }\n    if (d.type === 'resize') {\n      var h = Number(d.height);\n      if (isFinite(h) && h > 0) frame.style.height = Math.min(Math.max(h, 120), 900) + 'px';\n      return;\n    }\n    if (d.type === 'confirm') {\n      sendToChat({ action: 'plugin-confirm', op: String(d.op || ''), payload: d.payload });\n      return;\n    }\n    if (d.type === 'cancel') {\n      sendToChat({ action: 'plugin-cancel', op: String(d.op || '') });\n      return;\n    }\n  });\n})();\n\u003C\u002Fscript>\n\u003C\u002Fbody>\n\u003C\u002Fhtml>```\n\n### Phase B — 写入阶段（步骤 5-9）\n\n5. **create_or_update_submission_record** — `submit-project`（载荷：challengeId\u002FgithubRepoUrl\u002FprojectTitle\u002FaarText(≥10字)\u002FselfEvaluationText(≥10字)\u002FisPublic\u002FreviewMode；可选 workdir+requiredDeliverables 触发预检）。返回 task_id\n6. **generate_submission_summary** — `get-task` 轮询**至任务终态**（见下方终态规则）；组装教授向 `summary_markdown`\n> **任务终态规则（硬性）**：`submit-project` 返回 task_id 后，用 `get-task` 轮询\n> **到任务终态为止**（pending → processing → completed \u002F failed），终态后分叉：\n> - `completed`（result 含 submissionId；pendingReview=true 表示 AI 初评异步回填中）→\n>   **立即结束本轮回复**，告诉学生\"提交成功，AI 初评约 1-5 分钟回填，稍后可以问我\n>   「我上次评分多少」，或等飞书「AI 初评完成」通知\"。**禁止再轮询等待\n>   evaluationId \u002F 分数**——评分是异步的，继续等只会拖长回合。\n> - `failed`（result.error 带平台错误文案）→ **如实转告学生该文案**（缺必填项、\n>   仓库\u002F交付物问题等，以平台返回为准），按文案修复后重新提交，再轮询到终态。\n>   错误处理只认平台返回的 error 文案，不臆造、不绕过、不为特定错误另设流程。\n> - 轮询间隔 2-5 秒，单次提交最多轮询约 2 分钟；仍未到终态 → 按最后一次看到的\n>   状态如实说明并结束（pending \u002F processing 表示平台还在处理，**不是失败**，\n>   不要误报失败）。\n7. **trigger_self_evaluation** — 平台自动触发 AI 初评；`get-evaluation` 查分项\u002F优缺点\u002F建议\n8. **update_portfolio_index** — 平台自动生成作品集条目\n9. **notify_professor_or_course_owner** — 平台飞书通知（学生 + 班级群）\n\n## 付费授权（激活门，硬性）\n\n- 除 help\u002Flicense-check\u002Fplugin-version\u002Fhealth\u002F本地预检外，**每个命令执行前运行时都会自动向平台做授权校验**（安装不授权、激活才计数）；\n- 返回 `LICENSE_REQUIRED`（或 SEAT_NOT_LICENSED \u002F COURSE_NOT_LICENSED）时：**立即停止课程操作**，\n  如实告诉学生\"该席位未授权，请联系学校\u002F平台管理员开通\"，**不得尝试绕过、不得改用本地文件瞎编挑战\u002F评分**；\n- `license-check` 命令可主动查询授权状态。\n\n## 版本检查（skill 自动更新，硬性）\n\n- 每次开始课程任务前，先执行 `plugin-version`：\n  - `update_required: true` → **立即停止课程操作**，告诉学生\"插件版本过低，必须升级\"，\n    并按《排障手册》升级步骤执行（`cogseed-pkg update aix-course-elite20`，用 PLUGIN_TOKEN）；\n  - `update_available: true` → 提示学生\"有新版本，建议说「升级课程插件」\"，不阻塞当前任务；\n  - 已是最新 → 继续。\n- 升级完成后再继续原任务；不得用旧版本强行执行被平台要求升级的功能。\n\n## 输出契约\n\n```yaml\noutputs:\n  submission_record_id: string        # 后端记录 ID（经 task 轮询获取）\n  submission_status: enum             # draft|submitted|validated|failed\n  validation_report: {checks:[{name,passed,detail}], passed_count, failed_count}\n  evaluation_record_id: string|null\n  portfolio_update_status: enum       # updated|skipped|failed\n  summary_markdown: string            # 教授向摘要\n```\n\n## 错误分类\n\n| 错误码 | 处理 |\n|---|---|\n| `INPUT_MISSING(field)` | 明确列出缺失字段 |\n| `DUPLICATE_LINK` | AAR 与自评同链接 → 要求区分 |\n| `AUTH_FAILED` \u002F `CHALLENGE_CLOSED` | 报告原因，不重试不绕过 |\n| `ROLE_DENIED` | 学生不可发布\u002F越权（发布是教师命令） |\n\n## 停止规则\n\n用户停止；缺交付物且不补充；平台 401\u002F503；挑战已关闭；**学生未确认提交摘要**。\n\n## 失败行为\n\nnever_invent_submission_content；never_skip_local_check；never_submit_without_aar；\nnever_submit_without_user_confirm；return_completed_and_uncompleted_parts\n\n输出必须包含：action_summary、evidence、open_questions、stop_reason\n","# EduSeed 学生提交｜挑战提交闭环（Plugin 版）\n\n本 Skill 是 EduSeed 课程客户端（Course Plugin）的学生侧入口。运行时为技能脚本\n`scripts\u002Fruntime.js`（自包含单文件，直接调平台 HTTP Agent API，**不再走 MCP 连接器**）。\n\n## 首次使用（激活向导，onboarding）\n\n1. 先跑 `license-check` 确认席位状态：\n   - 返回 licensed:true → 正常使用；\n   - 返回 SEAT_NOT_LICENSED \u002F COURSE_NOT_LICENSED → 告诉学生\"该席位未授权，\n     请联系学校管理员开通\"，并给出三个必配项（EDUSEED_SERVER_URL \u002F EDUSEED_API_KEY \u002F EDUSEED_STUDENT_ID）\n     与平台 \u002Fcompanion 页的指引——**不执行任何课程命令**；\n2. 缺配置（CONFIG 类报错）→ 提示学生从平台 \u002Fcompanion 页生成 API Key 并下载配置，\n   把 env 三件套配好再试；\n3. 激活后建议先跑 `list-challenges` 冒烟，确认能看到挑战列表再开始正式使用。\n\n## 运行时调用方式\n\n唯一受支持的方式（CogSeed 内，bash 工具）：\n\n```bash\n\"$COGSEED_NODE\" \"$COGSEED_PC_DIR\u002Fbin\u002Frun-skill.cjs\" eduseed-student-submit runtime -- \u003C命令> '\u003CJSON载荷>'\n```\n\n新版 run_skill 工具等价形式：`{skill_id:\"eduseed-student-submit\", script:\"runtime\", args:[\"\u003C命令>\",\"\u003CJSON载荷>\"]}`\n\n> ⚠️ **不要**用 `node scripts\u002Fruntime.js …` 之类的方式直接跑脚本。`run-skill.cjs` 是宿主\n> 注入运行时凭证的唯一入口，绕过它就拿不到凭证，所有需要鉴权的命令都会 `AUTH_FAILED`。\n\n每次调用 stdout 输出一个 JSON 结果（`{ok, ...}`）。**不得**把多次结果拼进一个 shell 命令的管道再喂给用户，必须逐步读取、逐条解释。\n\n## 凭证由宿主注入（重要：不要自行查找凭证）\n\n`EDUSEED_SERVER_URL` \u002F `EDUSEED_API_KEY` \u002F `EDUSEED_STUDENT_ID` \u002F `EDUSEED_ROLE`\n由 CogSeed **在本次技能运行的那一刻**注入技能进程，随本次运行结束即收回。\n\n因此：\n\n- 在 bash 里 `printenv | grep EDUSEED` **看不到任何东西是正常的**，不代表凭证缺失；\n- **不要**用环境变量判断凭证是否存在；**不要**全盘 `find` \u002F `grep` 搜索凭证文件；\n- **不要**使用桌面、下载目录里的历史 `*-config-*.json`——那可能是别的学号的旧配置；\n- 需要鉴权的命令（`list-challenges` \u002F `get-challenge` \u002F `export-challenge-pack` …）\n  **只用上面那条首选命令**即可，凭证会自动到位；\n- `health` 是免鉴权端点，它通过**不代表**凭证有效，**不能**作为凭证就绪的依据；\n- 若按首选命令仍报 `AUTH_FAILED`，正确处置是引导学生到平台 `\u002Fcompanion` 重新生成\n  API Key；**绝不要**关闭授权校验（例如 `EDUSEED_REQUIRE_LICENSE=0`）。\n\n## 命令面（学生视角，来自 runtime help）\n\n| 命令 | 作用 | 关键载荷 |\n|---|---|---|\n| `list-challenges` | 已发布挑战列表 | — |\n| `get-challenge` | 挑战详情（交付物\u002Frubric\u002F截止） | `{\"challengeId\":\"C03\"}` |\n| `get-challenge-content` | 挑战正文全文（G3：CHALLENGE.md\u002Fchallenge.yaml\u002Frubric.json） | `{\"challengeId\":\"C03\"}` 可选 `workdir` 落盘 |\n| `export-challenge-pack` | 一键导出完整资料包（任务卡+正文+材料，SHA-256 可复核） | `{\"challengeId\":\"C03\",\"workdir\":\"\u002Fabs\u002Fpath\"}` |\n| `list-challenge-materials` | 挑战材料清单（G4，已自动过滤平台 `._*` 垃圾件） | `{\"challengeId\":\"C03\"}` |\n| `download-challenge-materials` | 下载材料到本地工作区（G4，已自动过滤平台 `._*` 垃圾件） | `{\"challengeId\":\"C03\",\"workdir\":\"\u002Fabs\u002Fpath\"}` 可选 `file` |\n| `list-course-materials` | 课程级公共资料清单（P3：体系文档\u002F先修课\u002F群公告与参考资料） | `{\"scope\":\"system-docs\"}`（prereq \u002F reference） |\n| `download-course-materials` | 下载课程级公共资料到本地工作区（P3） | `{\"scope\":\"system-docs\",\"workdir\":\"\u002Fabs\u002Fpath\"}` 可选 `file` |\n| `check-deliverables` | 本地交付物检查（离线，非权威） | `{\"workdir\":\"\u002Fabs\u002Fpath\",\"requiredDeliverables\":\"README.md, src\u002F**\"}` |\n| `prepare-submission` | 预检报告 + 行动项 + 提交草稿（离线） | 同上 + `githubRepoUrl`,`projectTitle` |\n| `submit-project` | 提交（预检→Envelope→task_id） | 见下 |\n| `submit-and-track` | 提交并跟踪完整闭环（output contract） | 见下 |\n| `get-task` | 任务状态轮询 | `{\"taskId\":\"task-xxx\"}` |\n| `list-my-submissions` | 我的提交记录 | — |\n| `get-evaluation` | 评审详情（AI 初评\u002F教师终审\u002F同伴） | `{\"submissionId\":\"sub-xxx\"}` |\n| `get-dashboard` | 进度仪表盘 | — |\n| `get-delta-r` | ΔR 偏差分析（calibration\u002Flearning） | `{\"submissionId\":...}` 或 `{\"challengeId\":...}` |\n| `list-episodes` \u002F `get-episode` \u002F `get-replay-suggestions` | KSTAR 学习记忆 | `{\"episodeId\":...}` 等 |\n| `agent-send` \u002F `agent-inbox` \u002F `agent-contacts` | P3394 师生互通 | `{\"toAgentId\":...,\"text\":...}` |\n| `health` | 平台连接检查 | — |\n| `get-my-binding` | 查询本人 GitHub 绑定状态（提交前预检，未绑定会被平台拒收） | — |\n\n## 九步工作流（继承课程提交技能模板，不可跳过）\n\n### Phase A — 只读校验（步骤 1-4，无后端写入）\n\n1. **validate_submission_inputs** — 必填项存在性\u002FURL 形状；AAR ≠ 自评链接。失败：`INPUT_MISSING` \u002F `INPUT_MALFORMED`\n2. **resolve_student_record** — `health` 确认连接；身份由平台从 x-api-key 解析（不可伪造）。失败：`AUTH_FAILED`\n3. **resolve_github_binding**（2026-09-09，防串作业硬门）— `get-my-binding` 查本人 GitHub 绑定状态：**未绑定 → 立即停止，明确告知学生先去学生端【设置 → GitHub 绑定】填写用户名后再提交，绝不发起 submit-project**（平台对未绑定提交会直接拒收）；已绑定 → 记录绑定的用户名，进入下一步。教师已代填\u002F挑战豁免时同样以 `get-my-binding` 返回为准放行。\n4. **resolve_challenge_record** — `get-challenge` 查挑战；确认 deadline\u002Fstatus 开放。失败：`CHALLENGE_NOT_FOUND` \u002F `CHALLENGE_CLOSED`\n5. **stage_challenge_materials**（G3+G4，2026-09-08）— 若学生要做题且该挑战有材料：`download-challenge-materials` 把材料落到 `\u003Cworkdir>\u002F挑战\u003Cid>_材料\u002F`；需查看挑战正文全文时用 `get-challenge-content`（可选 `workdir` 落到 `\u003Cworkdir>\u002F挑战\u003Cid>_正文\u002F`）。**只落盘、只回报文件清单与路径，绝不把材料内容整读进上下文**；缺材料则跳过（`NO_MATERIALS` 不是失败）。失败：`DOWNLOAD_FAILED`（可让学生稍后重试，不阻塞提交）。平台材料目录混有的 macOS `._*` 垃圾文件已由运行时自动过滤（结果含 `junk_skipped` 计数）。\n6. **validate_artifact_links** — `check-deliverables` + `prepare-submission` 本地通配符检查 + GitHub 指针；完整报告每个检查项。失败（软）：`REPO_PATTERN_MISMATCH` \u002F `README_MISSING`\n\n### 步骤 4.5 — 提交摘要人工确认（MVP User Story，硬性）\n\n在调用 `submit-project` \u002F `submit-and-track` 之前，必须：\n1. 向学生展示**提交摘要**：**提交身份（学号，取自运行时 submit 结果的 studentId，A2-2 硬性）**、**挑战名称（challengeTitle，取自 get-challenge 返回的 title）**、挑战 ID、项目标题、GitHub 仓库、AAR\u002F自评字数、交付物检查结果、缺件清单；\n2. 明确提问：\"将以 \u003C学号> 身份提交，确认吗？（回复'确认'后才会写平台）\"；\n3. **只在学生明确确认后**执行写入。学生未确认\u002F要求修改 → 停止并列出待改项。\n失败行为：`never_submit_without_user_confirm`\n\n\n### 确认卡片（GUI 模式，硬性要求）\n\n**具备 create_artifact 工具时必须使用「确认卡片」，禁止退化为纯文字确认**。仅当卡片创建失败或工具不可用时才允许文字确认，且必须在回复中明确说明原因：\n\n1. 创建 artifact（title=「待确认：提交项目」），含两个文件：\n   - `index.html`：确认卡片宿主模板（附录 A，**原样使用**，不要增删改动）\n   - `confirm-config.json`：`{\"op\":\"submit-project\",\"payload\":{…完整写入载荷…}}`（A2-2 硬性：payload 必须包含 `提交身份` 字段 = 运行时 submit 结果的 studentId；Bug2 硬性：payload 必须包含 `challengeTitle` = get-challenge 返回的 title，与 `challengeId` 并存——卡片会把「挑战名称」与「挑战 ID」分开展示，不得只用裸 ID 充当挑战名）\n2. 对话中会渲染出插件确认面板（载荷摘要 + 确认\u002F取消按钮）；\n3. 等待用户操作：\n   - 收到 `{\"action\":\"plugin-confirm\",\"op\":\"submit-project\",\"payload\":…}` → 用该 payload 执行第 5 步 `submit-project`；\n   - 收到 `{\"action\":\"plugin-cancel\",…}` 或用户文字取消 → 停止写入，按用户意见修改；\n4. 用户未点击时**不得**执行写入。\n\n### 附录 A：确认卡片宿主（index.html 模板）\n\n```html\n\u003C!DOCTYPE html>\n\u003Chtml lang=\"zh-CN\">\n\u003Chead>\n  \u003Cmeta charset=\"utf-8\" \u002F>\n  \u003Ctitle>确认卡片\u003C\u002Ftitle>\n\u003C\u002Fhead>\n\u003Cbody style=\"margin:0;background:transparent\">\n\u003Cscript src=\"__cogseed\u002Fbridge.js\">\u003C\u002Fscript>\n\u003Cscript>\n(function () {\n  'use strict';\n  var frame = document.createElement('iframe');\n  frame.style.cssText = 'width:100%;border:0;display:block;min-height:340px';\n  frame.setAttribute('sandbox', 'allow-scripts allow-same-origin allow-forms');\n  frame.setAttribute('referrerpolicy', 'no-referrer');\n  document.body.appendChild(frame);\n\n  function sendToChat(payload) {\n    if (window.cogseedArtifact && typeof window.cogseedArtifact.send === 'function') {\n      window.cogseedArtifact.send(payload);\n      return;\n    }\n    try { parent.postMessage({ __cogseedArtifact: true, type: 'submit', payload: payload }, '*'); } catch (e) {}\n  }\n\n  fetch('.\u002Fconfirm-config.json')\n    .then(function (r) { if (!r.ok) throw new Error('no config'); return r.json(); })\n    .then(function (c) {\n      var q = new URLSearchParams();\n      q.set('op', String((c && c.op) || ''));\n      q.set('payload', JSON.stringify((c && c.payload) || {}));\n      frame.src = 'cogseed-plugin:\u002F\u002Feduseed-course-client\u002Fui\u002Fconfirm.html?' + q.toString();\n    })\n    .catch(function () { frame.remove(); });\n\n  window.addEventListener('message', function (ev) {\n    var d = ev.data;\n    if (!d || typeof d !== 'object' || d.__cogseedPlugin !== true) return;\n    try { if (ev.source !== frame.contentWindow) return; } catch (e) { return; }\n    if (d.type === 'resize') {\n      var h = Number(d.height);\n      if (isFinite(h) && h > 0) frame.style.height = Math.min(Math.max(h, 120), 900) + 'px';\n      return;\n    }\n    if (d.type === 'confirm') {\n      sendToChat({ action: 'plugin-confirm', op: String(d.op || ''), payload: d.payload });\n      return;\n    }\n    if (d.type === 'cancel') {\n      sendToChat({ action: 'plugin-cancel', op: String(d.op || '') });\n      return;\n    }\n  });\n})();\n\u003C\u002Fscript>\n\u003C\u002Fbody>\n\u003C\u002Fhtml>```\n\n### Phase B — 写入阶段（步骤 5-9）\n\n5. **create_or_update_submission_record** — `submit-project`（载荷：challengeId\u002FgithubRepoUrl\u002FprojectTitle\u002FaarText(≥10字)\u002FselfEvaluationText(≥10字)\u002FisPublic\u002FreviewMode；可选 workdir+requiredDeliverables 触发预检）。返回 task_id\n6. **generate_submission_summary** — `get-task` 轮询**至任务终态**（见下方终态规则）；组装教授向 `summary_markdown`\n> **任务终态规则（硬性）**：`submit-project` 返回 task_id 后，用 `get-task` 轮询\n> **到任务终态为止**（pending → processing → completed \u002F failed），终态后分叉：\n> - `completed`（result 含 submissionId；pendingReview=true 表示 AI 初评异步回填中）→\n>   **立即结束本轮回复**，告诉学生\"提交成功，AI 初评约 1-5 分钟回填，稍后可以问我\n>   「我上次评分多少」，或等飞书「AI 初评完成」通知\"。**禁止再轮询等待\n>   evaluationId \u002F 分数**——评分是异步的，继续等只会拖长回合。\n> - `failed`（result.error 带平台错误文案）→ **如实转告学生该文案**（缺必填项、\n>   仓库\u002F交付物问题等，以平台返回为准），按文案修复后重新提交，再轮询到终态。\n>   错误处理只认平台返回的 error 文案，不臆造、不绕过、不为特定错误另设流程。\n> - 轮询间隔 2-5 秒，单次提交最多轮询约 2 分钟；仍未到终态 → 按最后一次看到的\n>   状态如实说明并结束（pending \u002F processing 表示平台还在处理，**不是失败**，\n>   不要误报失败）。\n7. **trigger_self_evaluation** — 平台自动触发 AI 初评；`get-evaluation` 查分项\u002F优缺点\u002F建议\n8. **update_portfolio_index** — 平台自动生成作品集条目\n9. **notify_professor_or_course_owner** — 平台飞书通知（学生 + 班级群）\n\n## 付费授权（激活门，硬性）\n\n- 除 help\u002Flicense-check\u002Fplugin-version\u002Fhealth\u002F本地预检外，**每个命令执行前运行时都会自动向平台做授权校验**（安装不授权、激活才计数）；\n- 返回 `LICENSE_REQUIRED`（或 SEAT_NOT_LICENSED \u002F COURSE_NOT_LICENSED）时：**立即停止课程操作**，\n  如实告诉学生\"该席位未授权，请联系学校\u002F平台管理员开通\"，**不得尝试绕过、不得改用本地文件瞎编挑战\u002F评分**；\n- `license-check` 命令可主动查询授权状态。\n\n## 版本检查（skill 自动更新，硬性）\n\n- 每次开始课程任务前，先执行 `plugin-version`：\n  - `update_required: true` → **立即停止课程操作**，告诉学生\"插件版本过低，必须升级\"，\n    并按《排障手册》升级步骤执行（`cogseed-pkg update aix-course-elite20`，用 PLUGIN_TOKEN）；\n  - `update_available: true` → 提示学生\"有新版本，建议说「升级课程插件」\"，不阻塞当前任务；\n  - 已是最新 → 继续。\n- 升级完成后再继续原任务；不得用旧版本强行执行被平台要求升级的功能。\n\n## 输出契约\n\n```yaml\noutputs:\n  submission_record_id: string        # 后端记录 ID（经 task 轮询获取）\n  submission_status: enum             # draft|submitted|validated|failed\n  validation_report: {checks:[{name,passed,detail}], passed_count, failed_count}\n  evaluation_record_id: string|null\n  portfolio_update_status: enum       # updated|skipped|failed\n  summary_markdown: string            # 教授向摘要\n```\n\n## 错误分类\n\n| 错误码 | 处理 |\n|---|---|\n| `INPUT_MISSING(field)` | 明确列出缺失字段 |\n| `DUPLICATE_LINK` | AAR 与自评同链接 → 要求区分 |\n| `AUTH_FAILED` \u002F `CHALLENGE_CLOSED` | 报告原因，不重试不绕过 |\n| `ROLE_DENIED` | 学生不可发布\u002F越权（发布是教师命令） |\n\n## 停止规则\n\n用户停止；缺交付物且不补充；平台 401\u002F503；挑战已关闭；**学生未确认提交摘要**。\n\n## 失败行为\n\nnever_invent_submission_content；never_skip_local_check；never_submit_without_aar；\nnever_submit_without_user_confirm；return_completed_and_uncompleted_parts\n\n输出必须包含：action_summary、evidence、open_questions、stop_reason\n",{"name":5,"description":7},"main","6afb98b7a438d4b993ba23f3af1494c862d80378","resources\u002Fbuiltin-packages\u002Feduseed-course-client\u002Fskills\u002Feduseed-student-submit",10,"https:\u002F\u002Fgithub.com\u002Fbonc-ai\u002Fcogseed","https:\u002F\u002Fcogseed.ai","https:\u002F\u002Fgithub.com\u002Fbonc-ai","https:\u002F\u002Fwww.bonc.com.cn\u002F","北京东方国信科技股份有限公司开源组织 · Enterprise open source by BONC","2026-11-13 21:46:31",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add bonc-ai\u002Fcogseed --skill eduseed-student-submit",{"tool":40,"command":41},"bunx","bunx skills add bonc-ai\u002Fcogseed --skill eduseed-student-submit",{"tool":43,"command":44},"pnpm","pnpm dlx skills add bonc-ai\u002Fcogseed --skill eduseed-student-submit","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fbonc-ai\u002Fcogseed\u002Fblob\u002Fmain\u002Fresources\u002Fbuiltin-packages\u002Feduseed-course-client\u002Fskills\u002Feduseed-student-submit\u002FSKILL.md",true,[48],{"path":49,"resourceType":50,"resourceTypeDesc":51,"sizeBytes":52,"sourceHtmlUrl":53},"scripts\u002Fruntime.js","SCRIPT","脚本",721181,"https:\u002F\u002Fgithub.com\u002Fbonc-ai\u002Fcogseed\u002Fblob\u002Fmain\u002Fresources\u002Fbuiltin-packages\u002Feduseed-course-client\u002Fskills\u002Feduseed-student-submit\u002Fscripts\u002Fruntime.js",[55,62,69,76,83,90],{"skillNo":56,"name":57,"nameZh":6,"description":58,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":19},"01M7AVTAEJDDZ3YFV85AK28FWN","sample-supply-chain","供应链样本：安装钩子 + 拼写伪装 + 源覆盖。","https:\u002F\u002Fgithub.com\u002Fbonc-ai\u002Fcogseed\u002Fblob\u002Fmain\u002Fresources\u002Fguardrail\u002Fskill-sentry\u002Ftests\u002Ffixtures\u002Fv2-samples\u002Fsample-supply-chain-skill\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":19},"01M7AVT84YQ5GZDMB9PRTEBV8V","sample-prose-only","纯散文安全守则样本：禁止某行为的说明不等于该行为。","https:\u002F\u002Fgithub.com\u002Fbonc-ai\u002Fcogseed\u002Fblob\u002Fmain\u002Fresources\u002Fguardrail\u002Fskill-sentry\u002Ftests\u002Ffixtures\u002Fv2-samples\u002Fsample-prose-only-skill\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":19},"01M7AVT59NWX4M2EZJKRXMEPGB","sample-obfuscated","混淆载荷样本：解码与执行共现。","https:\u002F\u002Fgithub.com\u002Fbonc-ai\u002Fcogseed\u002Fblob\u002Fmain\u002Fresources\u002Fguardrail\u002Fskill-sentry\u002Ftests\u002Ffixtures\u002Fv2-samples\u002Fsample-obfuscated-skill\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M7AVT246DRNSJ5D9JQRK4QKP","sample-hidden-content","隐藏内容载荷样本：用于回归「不可见字符不做上下文降权」这一不变量。","https:\u002F\u002Fgithub.com\u002Fbonc-ai\u002Fcogseed\u002Fblob\u002Fmain\u002Fresources\u002Fguardrail\u002Fskill-sentry\u002Ftests\u002Ffixtures\u002Fv2-samples\u002Fsample-hidden-content-skill\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M7AVSYR91DFC262VQ23BAZA1","sample-evasion","反规避样本：危险内容只以「不可见字符切断」与「编码后」两种形式出现。","https:\u002F\u002Fgithub.com\u002Fbonc-ai\u002Fcogseed\u002Fblob\u002Fmain\u002Fresources\u002Fguardrail\u002Fskill-sentry\u002Ftests\u002Ffixtures\u002Fv2-samples\u002Fsample-evasion-skill\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":19},"01M7AVSVMGH458JZC3Q454QWTK","sample-agentic","代理运行时风险样本：配置篡改 + 隐蔽指令。","https:\u002F\u002Fgithub.com\u002Fbonc-ai\u002Fcogseed\u002Fblob\u002Fmain\u002Fresources\u002Fguardrail\u002Fskill-sentry\u002Ftests\u002Ffixtures\u002Fv2-samples\u002Fsample-agentic-skill\u002FSKILL.md",[],[]]