学生毕业论文教师批阅与反馈小助手
加载本Skill后，用户的WorkBuddy等AI工具将化身为一名细心且严厉的毕业论文指导专家。为高校教师在进行本/专科毕业设计（论文）指导时，给学生所写论文提供初步意见供教师参考，并在教师审查和修改后酌情使用。本技能采用Python与json库结合多种算法实现多学科多专业的语义分析，提供修改建议，并检测AIGC率及错别字与语病等问题，助力一线教师在毕业论文指导工作提质增效。本skill所有操作在用户本地设备进行，不上传到互联网，请放心使用。
快速上手（30秒）
- 把学生论文文档拖进对话框（Word / WPS 均可，也可直接传压缩包）。
- 对AI说一句自然语言，例如：帮我批阅这篇毕业论文。
- 等待 1–3 分钟，AI 会逐段批阅，产出带批注的
<原文件名>_批阅.docx。
无需记命令、无需配置环境、无需手动安装依赖——首次使用 AI 会自动准备。
怎么触发本技能
只要您的表达里出现“批阅 / 指导 / 检查 + 毕业论文（设计）、学生论文、AIGC率”这类意图，AI 就会自动启用本技能。您可以直接照抄下面任一句话：
| 您想做的事 | 可以这样说 |
|---|---|
| 常规批阅 | 帮我批阅这篇学生毕业论文 |
| 点名用本小助手 | 用毕业论文小助手看看这篇论文有哪些问题 |
| 结合学校规范批阅 | 按学校这份《毕业论文撰写规范》批阅这篇论文（附规范文件） |
| 批量批阅 | 这个压缩包里是我们组学生的论文，帮我逐一批阅 |
| 只看 AIGC 率 | 帮我检测一下这篇论文的 AIGC 率 |
在命令行/终端中也可用 python main.py paper 论文.docx 等方式调用（详见 scripts/README.md）；普通教师用上表话术即可。
使用方式：请提供以下材料
- 学生论文文档（必填，Word 或 WPS 格式）
- 学校指导意见文件（可选，如《毕业论文撰写规范》《指导意见》等）
- 其他要求文件（可选，如评分标准、格式要求等）
您可以添加单个文件，或一次性添加压缩包（包含多份论文时）。
工作流程
第一步：接收文件
AI将您提供的资料暂存为JSON格式，便于后续分析调用。
如果资料不足，您将收到以下选项：
- 暂不提供：由AI按照通用模板提供批阅意见
- 继续提供：补充添加所需文件
第二步：批阅论文（逐自然段 + AIGC 双线反馈）
AI将结合您的要求文件和本技能的方法论，对学生论文做“逐自然段”的细致分析，并对每一段正文做 AIGC 率检测。
批阅前先读取技能内的参考资料（用读取器读取，不要凭经验直接生成）：
python scripts/ref_reader.py skill_workflow
python scripts/ref_reader.py teacher_guidance_methodology
python scripts/ref_reader.py student_writing_methodology
python scripts/ref_reader.py format_standards
批阅维度：
- 规范性检查（格式、引用、结构、错别字、错标点、语病、前后不一致等）
- 学术正确性检查（所研究的问题是否真实问题、理论运用、研究方法、实验/调研方法与数据）
- 写作技巧评估
- AIGC率检测（逐段 + 总结）
- 内容质量评价
分析覆盖摘要、正文各章、参考文献、附录（问卷/访谈提纲）、致谢等全部自然段（目录、章节标题、图注、参考文献条目等非自然段不重复评价）。
每条意见都会标注「分类」与「优先级」：分类取 格式规范 / 引用著录 / 学术质量 / 写作技巧 / 内容完整 / AIGC风险；优先级取 高 / 中 / 低。这样教师一眼就能看出“哪些问题最重要、需要先改”。
多份论文时：AI 逐份分析，把每份的 review.json 与该论文同名命名（如 张××_毕业设计.json），
scripts/batch_processor.py 会自动按文件名配对，逐份插入；未提供逐段意见的论文按通用模板批阅。
分析完成后，AI 将意见整理为结构化数据 review.json：
{
"comments": {
"<段落特征子串>": {
"text": "<详细意见：指出该段具体问题并给出修改示例>",
"category": "格式规范",
"priority": "高"
}
},
"actions": ["<下一步行动建议，可选，1-5 条>"],
"aigc": { "per_paragraph": true, "summary": "<AI撰写的AIGC整体总结>" },
"summary_note": "<可选的总评>"
}
comments的键为“段落特征子串”（从原文中截取的 10–30 字、可唯一定位的连续文本），值为意见对象；意见须详细、具体、可操作（指出该段具体问题并给出修改示例），避免泛泛而谈。兼容写法：值也可直接写成字符串。priority用于驱动文末“优先修改清单”，请务必填写；漏填时按“中”处理。
随后由 scripts/process_paper.py 自动完成排版（教师无需操作）：
- 对每一个被评价的自然段，在其正下方插入批注：红色字体 + 黄色底纹 + 加粗，前缀形如「【批阅意见·格式规范·高】」；
- 对每一段正文自动计算 AIGC 率，在其下方插入蓝色字体标注（如「【AIGC率】本段预估 AI 生成概率约 xx%」），实现 AIGC 逐段反馈；
- 保留原论文的全部内容与字体、图片、版式，绝不删除或重建原文；
- 文末依次追加：「修改意见汇总」（先给优先修改清单，再给按优先级分组的全量详细意见）→「下一步行动建议」→「AIGC率检测总结性反馈」（整体预估 + 高疑似段落列表）→ 空 5 行 →「Skill说明与使用提示」（来自参考资料 footer_note）。
第三步：优化建议
AI将为您提供进一步提质增效的相关建议。
批阅稿长什么样（示例节选）
学生原文（节选）：
> 随着信息技术的快速发展，农村电子商务已成为推动乡村振兴的重要力量。本文通过问卷调查法，对××县的农村电商发展现状进行了分析。
批阅稿中，该段正下方会自动出现两条标注：
> 【批阅意见·引用著录·高】（红字 + 黄底 + 加粗）抽样方法交代不清：只写“问卷调查法”，未说明抽样框、样本量、抽样方式与调查时间，读者无法判断结论的代表性。建议改为“于2025年3—4月，以××县12个乡镇的农村电商从业者为对象，采用分层随机抽样发放问卷300份，回收有效问卷278份（有效率92.7%）”。
>
> 【AIGC率】本段预估 AI 生成概率约 35%（蓝字，置信度：中；平均句长32字；过渡性表述3次）
文末还会集中给出“优先修改清单”（最该先改的若干条）与按优先级分组的全部意见。完整的前后对照示例见 python scripts/ref_reader.py usage_examples --md。
能力边界（重要，请先读）
本技能能做
- 逐自然段给出规范性、学术正确性、写作技巧、内容质量方面的初步意见，供教师参考
- 给出逐段与全文的 AIGC 率启发式预估，并标出高疑似段落
- 结合教师提供的学校规范 / 评分标准文件，做有依据的差异化批阅
- 一次批量处理压缩包内的多份论文
本技能不做（请勿误用）
- 不做查重比对，不能替代知网（CNKI）、维普、Turnitin 等查重报告
- 不替代 CNKI AIGC 检测等权威工具；AIGC 结果为语言特征启发式预估，可能偏高或偏低
- 不直接给出成绩、等级或“是否通过”的最终结论（最终评定权在教师）
- 不自动重排论文格式，只给出格式问题的修改意见
- 不处理设有打开密码 / 受保护的文档、扫描件 PDF、纯图片论文；不适用于中小学作文及非学位论文类文稿
- 不识别学科专业层面的深层错误（如公式推导、专业术语的学科内正误），此类判断需教师复核
文件格式与转换
- 本技能原生处理
.docx。若学生提交的是旧格式.doc/.wps/.wpt，会先调用scripts/convert_doc.py用本机已安装的 Microsoft Word 将其“另存为”.docx，完整保留原文字体、图片与版式后再批阅。 - 若本机未安装 Word 或 COM 不可用，脚本会明确提示您：请在 Word 中“文件 → 另存为 → Word 文档(.docx)”后重新提交。切勿用“纯文本提取”方式重建文档*，那会丢失原论文的全部字体与格式。
- 支持中文路径与中文文件名；输入文件不会被修改，批阅结果另存为新文件。
依赖工具
本技能使用以下Python库：
- python-docx：处理 Word 文档、插入批注、保留原格式
- pywin32（win32com）：调用本机 Microsoft Word 将 .doc/.wps 转换为 .docx（保格式）
- jieba：中文分词和语义分析（AIGC 检测，可选）
所有依赖将在首次使用时自动安装（如未安装）。若安装失败，AI 会给出通俗的提示与解决办法，不需要您编写代码。
常见错误与解决办法（速查）
| 现象 | 原因 | 您可以这样做 |
|---|---|---|
| 提示“需要在 Word 中另存为 .docx” | 提交了 .doc/.wps/.wpt 旧格式，且本机未装 Word |
在 Word/WPS 中打开该文档 → 文件 → 另存为 → 选“Word 文档(*.docx)”，再重新提交 |
| 提示“文件不存在 / 路径打不开” | 文件被移动、改名，或路径填写有误 | 重新把文件拖进对话框即可 |
| 提示“无法打开文档” | 文档设有打开密码、正被 Word 占用，或下载不完整 | 先关掉 Word 中打开的该文档；确认文件能正常双击打开后重试 |
| 处理中途无输出 / 被中断 | 论文过长、网络波动，或工具需更新 | 在对话框输入“请继续完成”；仍无响应请检查网络与工具版本 |
| 批阅意见像“通用模板”口气 | 未提供学校规范 / 评分标准文件 | 补充《毕业论文撰写规范》《评分标准》等文件后重新批阅 |
| AIGC 率与知网结果差距较大 | 本技能为启发式预估，非权威检测 | 以知网 AIGC 检测为准，本结果仅用于快速定位高疑似段落 |
更多疑难请见 faq.md。
注意事项
- 本技能提供的批阅意见仅供教师参考，最终意见由教师审核确定
- 批阅结果会保留原文档格式，仅在指定位置添加红色字体、黄色背景的批注与蓝色字体的 AIGC 标注
- 如涉及多份论文，将逐一处理并分别标注
- 本技能仅用于辅助教师指导，请遵守学术诚信，不得用于代写或规避学术审查
文件结构
references/ 下的资料为技能内部格式，不能直接打开，请统一用 python scripts/ref_reader.py 读取（加 --help 可查看全部可用资料与用法）；scripts/ 下为过程脚本，由 AI 自动调用，教师无需操作。
| 文件 / 目录 | 说明 |
|---|---|
SKILL.md |
技能说明文档（本文件） |
LICENSE.txt |
许可证（CC BY-NC-ND 3.0 CN） |
faq.md |
常见问题解答与常见错误排查 |
requirements.txt |
Python 依赖列表 |
main.py |
主入口脚本 |
package_skill.py |
打包脚本 |
references/skill_workflow.json |
工作流程配置 |
references/teacher_guidance_methodology.json |
教师指导技巧（105条） |
references/student_writing_methodology.json |
学生写作技巧（530条） |
references/format_standards.json |
格式规范要求 |
references/capability_boundaries.json |
能力边界与适用/不适用场景 |
references/error_playbook.json |
常见错误 → 通俗提示 → 解决办法 |
references/usage_examples.json |
批阅效果前后对照示例 |
references/footer_note.json |
Skill说明与使用提示（批阅稿末尾自动追加） |
scripts/ref_reader.py |
参考资料读取器（列出并读取 references/ 下的资料） |
scripts/process_paper.py |
批阅插入引擎（逐段插入红字黄底反馈 + 蓝字AIGC逐段标注 + 文末优先清单/汇总/总结） |
scripts/convert_doc.py |
.doc/.wps 用 Word 转换为 .docx（保留原字体/图片/版式） |
scripts/batch_processor.py |
批量处理（支持压缩包） |
scripts/aigc_detector.py |
AIGC率检测（逐段语言特征启发式） |
scripts/install_deps.py |
依赖安装 |
scripts/README.md |
脚本说明 |
报错处理
为使用体验更佳，建议使用 WorkBuddy 调用本 Skill。本 Skill 运行依赖 python-docx（及其依赖 lxml、Pillow 等）。在 WorkBuddy 等 AI 工具中这些依赖通常已预置；若缺失，AI 工具会自动联网从 PyPI 安装，无需用户通过编写代码等方式干预。用户只需同意 WorkBuddy 的权限请求即可。
如遇对话或输出中断，请按顺序排查：
1. 检查网络连接是否正常；
2. 确认 WorkBuddy 等工具已是最新版本；
3. 在对话框输入：请继续完成。
若仍失败，请对照上方「常见错误与解决办法（速查）」表，或查阅 faq.md 的“常见错误排查”章节。
常见问题（FAQ）
Q1：这个技能是做什么用的？
A1：本技能帮助高校教师对学生的毕业论文（设计）进行批阅，提供规范性检查、学术正确性检查、写作建议、AIGC率检测等反馈意见，供教师参考。适用于本科与专科院校。
Q2：支持哪些文件格式？
A2：支持 Word（.docx、.doc）和 WPS（.wps、.wpt）。可添加单个文件或压缩包（含多份论文）。支持中文路径与中文文件名。不支持设有打开密码的文档、扫描件 PDF 与纯图片论文。
Q3：必须提供学校的指导意见文件吗？
A3：不是必须的。提供了则结合文件要求批阅；未提供则按通用模板批阅（此时批阅意见会明确标注为通用模板口气，建议补充规范文件后重新批阅）。
Q4：批阅意见如何显示？
A4：内容反馈以红色文字、黄色背景出现在对应自然段正下方，并带「分类·优先级」标签；AIGC 逐段标注以蓝色文字出现在该段下方。文末另附「优先修改清单」「修改意见汇总」「下一步行动建议」「AIGC率检测总结性反馈」，便于教师集中审阅。
Q5：AIGC 率检测准确吗？
A5：它是基于语言特征（句长、词汇多样性、过渡词、结构化表述、过度修饰等）的启发式预估，用于快速定位“高疑似段落”，不能替代知网 AIGC 检测等权威工具，最终判定需人工复核。
Q6：批阅后的文件保存在哪里？
A6：保存在输出目录中，文件名形如 <原名>_批阅.docx；原始文件保持不变。
Q7：如何处理多份论文？
A7：打包成压缩包后添加，AI 会逐一处理并分别标注；输出仍为一个压缩包（只含带批阅意见的文档）。
Q8：本技能的许可证是什么？
A8：采用 CC BY-NC-ND 3.0 CN 许可证（署名—非商业性使用—禁止演绎 3.0 中国大陆）。
更多问题（含常见错误排查、反模式清单）请见 faq.md。
