中文实验报告生成
核心目标
按用户提供的实验名称、实验目的和可选材料,创建一个完整实验目录,生成源码、截图和实验报告。报告必须优先写入用户在当前对话中上传或指定的模板对应框、表格单元或文本区域;用户未上传或指定模板时,使用 assets/default-lab-report-template.doc 的版式和样式生成报告。实验报告中模板原本的字体样式不得被修改,且不得出现用户项目的绝对路径。
必填与选填信息
必须获得:
- 实验名称
- 实验目的
可选信息包括:实验编号、姓名/学号/班级/课程名/教师名、实验内容、实验要求、老师上课步骤、环境要求、源代码、运行结果、截图要求、图片生图提示词要求、报告模板、是否需要源码、是否需要路径、是否需要图片。
如果缺少实验名称或实验目的,先向用户补齐。其他字段缺失时按合理默认值完成,不要反复追问。
目录与文件规则
- 在当前工作区或用户指定位置新建实验文件夹,命名为
实验x,例如实验一。 - 如果用户给了实验编号,按编号命名;如果没有编号,扫描现有
实验*文件夹并使用下一个中文序号;仍无法判断时使用实验一。 - 普通模式下在实验文件夹内创建
源码文件夹存放所有代码、配置、数据样例和运行说明;用户明确选择“无源码无路径的图片提示词模式”时,不强制创建源码文件夹,也不要在报告中引用它。 - 如果使用 Playwright 或浏览器截图,在实验文件夹内创建
图片文件夹保存截图。 - 实验报告必须直接保存在新建的实验文件夹中。
- 所有生成的文本、源码、Markdown、JSON、HTML、CSS、JS、Java、Python 等文件均使用 UTF-8 编码。Word 文档内容按 Unicode 写入;若另存为文本/Markdown,必须显式使用 UTF-8。
- 实验报告正文、图注、表格、运行说明和源码位置说明中不得出现用户项目绝对路径,包括盘符路径、用户主目录、工作区路径和
file://路径。 - 报告中如需写源码路径,统一写相对于
源码文件夹的路径,例如src/Main.java、pages/index.html、app.py。不要写E:\...、C:\Users\...或完整工作区路径。
推荐结构:
实验一/
├── 源码/
│ ├── ...
├── 图片/ # 仅在需要截图时创建
│ ├── step-01.png
└── 实验报告.docx 或 实验报告.doc
模板处理
- 用户在当前对话中上传新的
.doc/.docx模板,或上传包含模板的文件夹时,必须优先使用用户本次提供的模板;它覆盖 skill 内置默认模板和历史模板。 - 用户没有在当前对话中上传或指定模板时,复制
assets/default-lab-report-template.doc到实验文件夹作为报告基础,并严格按照该模板的结构、表格、框线、段落和字体样式生成实验报告。 - 必须先检查模板中的表格、文本框、占位文字或标题区域,再把内容写入对应框内。不要把报告内容写成脱离模板的普通文档。
- 如果模板是
.doc且当前环境能用 Word COM、LibreOffice 或其他可靠工具转换为.docx,优先转换后编辑并保留版式;如用户要求保持.doc,完成后再另存回.doc。 - 如果无法自动编辑
.doc的内部结构,先尝试转换;仍失败时说明限制,并尽量生成与模板结构一致的.docx,不要静默丢弃模板版式要求。 - 写入前保留原模板样式、表格边框、页眉页脚和字段顺序。只替换对应框内内容。
- 不得修改实验报告中原本已有的字体样式,包括字体名称、字号、颜色、加粗、斜体、下划线、段前段后、行距、对齐方式和列表缩进。
- 向模板单元格、文本框或段落写入新内容时,继承该位置原有文字或占位符的样式;如果需要新增段落,复制同一区域相邻段落的样式后再写入。
- 插入图片时只调整图片大小和位置以适配模板框,不改变周围文字样式。
- 原模板中已有下划线的位置不得删除下划线,尤其是模板首页的姓名、学号、课程等填空区域。必须在下划线上写字:优先替换下划线占位符或空白占位符为带下划线的新文字;如果只能新增文字,新增文字也必须继承下划线格式。
- 不要为了填写内容把下划线改成普通文字、删除横线、改用冒号后文本或把填空区域重排为新段落。
- 模板中原本已经存在的固定说明文字、标题、注释或适用范围文本不得修改,例如“适用于软件类课程”等已有文本必须原样保留;只有用户明确要求修改这些现有文本时,才允许改动。
- 填写报告时只补充或替换需要填写的内容区域,不要顺手润色、删改或重写模板内的既有说明文字。
- 当用户上传自己的模板时,必须先判断当前实验对应模板中的哪一个表格、哪一个实验区块或哪一组填写区域,只完成该实验对应区域的实验报告内容。
- 用户上传模板后,除当前实验对应的表格或填写区域外,模板中的其他实验内容、其他表格、其他实验编号对应区域、空白区域和说明文字均不得修改。
- 如果模板中包含多个实验共用一份文档,必须根据实验名称、实验编号、相邻标题、表格标题、页签或上下文定位到当前实验所在表格;定位不明确时,先尽量依据模板结构判断,不要批量填写多个实验。
内容编写规则
实验内容
- 用户提供实验内容时,优先使用用户内容,可轻微润色但不得改变要求。
- 如果用户只提供实验名称和实验目的,根据课程领域和实验目的补写实验内容。
- 实验内容格式必须为编号列表:
1. xxxx
2. xxxx
3. xxxx
实验过程及分析
严格按“先写步骤与分析,再贴图”的顺序组织;不得先贴图再解释。每一步建议使用以下顺序:
步骤:说明本步完成的操作。
分析:说明本步的作用、关键逻辑、运行现象或问题处理。
源码位置:写相对于“源码”文件夹的路径,如 src/Main.java 的 main 方法附近。
配图:插入 1-2 张相关图片或运行截图。
- 如果用户提供老师上课步骤、实验过程或课堂操作顺序,必须严格按该顺序写。
- 默认步骤不超过六步;只有用户明确要求更多步骤时才增加。
- 每一步先写简短步骤说明和分析,再写源码位置,最后插入图片。
- “步骤”“分析”“源码位置”等文本段落必须靠左对齐;不要居中、右对齐或两端分散对齐。图片可按模板图片区域排版。
- 每一步与分析只放 1-2 张源码截图或运行截图。
- 源码截图必须指明相对于
源码文件夹的文件路径和代码位置,例如src/Main.java的main方法附近。 - 网页类实验需要优先用 Playwright 运行页面并截图,截图保存到
图片文件夹,再插入报告对应步骤。 - 如果用户明确说不用图片,则不要生成或插入图片,只写源码位置和文字分析。
- 图片文件名、图注和截图说明不得包含绝对路径;如需说明图片来源,可使用相对于实验文件夹的
图片/step-01.png。
环境说明
- 优先使用用户电脑中已经存在且可平替的环境版本。
- 如果老师要求的版本本机没有,但现有版本能完成实验,例如老师要求 JDK 25、本机只有 JDK 8 且代码可运行,应在报告中写本机实际版本,并说明满足本实验运行需求。
- 不要虚构已经安装的环境;如果用户明确要求不需要真实源码/真实运行,则可按报告写作需要合理设定环境。
源码与截图
- 默认需要为实验创建可运行或可展示的源码。
- 如果用户明确说明“不想要源码,只需要写实验报告”,可以自由编写合理实验过程、结果和分析,不创建源码文件夹之外的真实项目代码;如仍创建
源码文件夹,可只放说明文件。 - 如果用户提供源码,优先使用用户源码,不随意重写。
- 截图应清晰、少量、聚焦关键代码或运行结果。不要用大量重复截图填充报告。
无源码无路径的图片提示词模式
当用户明确说明“不需要源码不需要路径”“不用源码不用路径”“只要图片生图提示词”或类似要求时,进入图片提示词模式:
- 不创建或展示真实源码,不在实验报告中写源码位置、文件名或任何路径;即使是相对路径也不要写。
- 按实验步骤生成该步骤应产出的配图生图提示词,每步默认 1-2 条提示词。
- 提示词用于生成“实验报告可用截图”,画面应像真实软件截图,内容聚焦代码编辑、终端运行、浏览器效果、虚拟机操作或实验结果。
- 提示词中不得出现用户姓名、学号、电脑用户名、盘符、绝对路径或项目路径。
- 根据步骤涉及的技术栈选择界面风格:
- Java、JSP、Spring、Java Web、Android Java 等 Java 相关步骤:使用 IntelliJ IDEA 风格界面,包含项目侧边栏、Java 编辑器标签页、运行控制台或测试输出。
- 虚拟机、Linux 服务器、SSH、网络配置、Shell 命令、Hadoop/Spark 集群、Docker 远程终端等虚拟机或远程操作步骤:使用 MobaXterm 风格界面,包含 SSH 会话标签、终端输出和必要的左侧会话/文件区域。
- 前端、HTML/CSS/JavaScript、Vue/React、C 语言、Python、一般脚本或其他未明确指定 IDE 的步骤:使用 VSCode 风格界面,包含资源管理器、代码编辑区、集成终端;前端结果图可额外描述浏览器预览窗口。 - 同一实验包含多种技术时,按每个步骤的主要工具分别选择风格;无法判断时默认使用 VSCode 风格。
- 每条提示词建议包含:界面风格、实验任务、屏幕中可见区域、关键代码/命令/运行结果、画幅比例、清晰度要求,并明确“无真实个人信息、无绝对路径、无水印”。
- 如果仍需写入实验报告,“实验过程及分析”仍按先写步骤与分析再贴图的规则组织,但“配图”处写对应提示词或生成后图片,不写源码位置。
提示词格式:
第 1 步配图提示词:
生成一张 16:9 的 IntelliJ IDEA 风格软件截图,画面展示 Java 实验中创建并运行 xxx 程序,左侧为项目结构,中央编辑区显示简洁的 Java 类和 main 方法,底部运行控制台显示程序输出结果。界面清晰、真实课堂实验截图风格,无真实个人信息、无绝对路径、无水印。
实验体会
实验体会写 150 字左右,使用第一人称或学生报告常用语气。内容应围绕本实验的知识点、遇到的问题、调试过程和收获,不写空泛口号。
执行流程
- 收集并确认实验名称、实验目的、当前对话是否上传新模板、老师步骤、是否需要源码/路径/图片或只要图片生图提示词。
- 如果用户选择“无源码无路径的图片提示词模式”,不要创建或引用源码路径;按步骤生成配图提示词,并在报告中省略源码位置。
- 否则创建
实验x文件夹、源码文件夹,并按需要创建图片文件夹。 - 准备或整理源码,确保生成文本文件使用 UTF-8。
- 运行或检查实验;网页类用 Playwright 截图并保存到
图片。 - 按模板优先级复制并填充模板,把实验名称、目的、内容、环境、过程及分析、实验体会写入对应框内,同时保留原字体样式和原有下划线填空格式。
- 检查报告文件位于实验文件夹中,确认实验过程及分析为“步骤与分析在前、图片在后”,步骤与分析文本左对齐;普通模式下源码位置为相对于
源码文件夹的路径;无源码无路径模式下正文无任何源码位置或路径;正文无用户项目绝对路径,首页等原有下划线区域仍为下划线填空,图片路径、步骤数量、实验体会字数、UTF-8 文件编码和模板字体样式保留情况符合要求。
完成后向用户说明实验文件夹路径、报告文件名、源码文件夹和图片文件夹位置,并说明是否遇到模板转换或截图限制。