Skip to content

Commit c391a28

Browse files
docs(ci): 补充自动评分系统及运行指引说明
- 在 README.md 中详细说明 CI 自动评分的触发条件及运行步骤 - 在 XiaoKuge.md 添加个人文章检测及作业提交说明 - 在 assignments/lesson1/example-report.md 和 assignments/lesson2/example-report.md 补充作业文件提交与评分工作流运行指引 - 明确首次 Fork 后手动触发工作流的方法和操作流程 - 统一文档中关于自动评分系统的说明,便于学生理解使用
1 parent 597e29b commit c391a28

4 files changed

Lines changed: 52 additions & 4 deletions

File tree

README.md

Lines changed: 20 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -69,5 +69,23 @@ Upstream 这个代码仓用于帮助商业训练营的同学们完成作业。
6969
### 如何查看自己的分数
7070

7171
- 系统每天北京时间早上8点自动运行计算分数
72-
- 每次向仓库push代码时也会触发分数计算
73-
- 可以通过GitHub Actions界面手动触发计算
72+
- 每次向仓库 push 到 main 分支时触发分数计算
73+
- 可在 GitHub Actions 界面手动触发计算(首次 Fork 需手动运行)
74+
75+
#### 自动评分系统(CI)运行说明
76+
- 工作流文件: [.github/workflows/calculate-score.yml](.github/workflows/calculate-score.yml)
77+
- 触发条件:
78+
- 定时:每天 08:00(北京时区,UTC 00:00)
79+
- push:推送到 main 分支
80+
- pull_request:向 main 分支发起或更新 PR(用于课程作业检测)
81+
- 手动:在 Actions 页面使用 Run workflow
82+
- 课程作业检测仅在 PR 事件时执行。请通过 PR 提交作业文件:
83+
- Lesson1:assignments/lesson1/{你的GitHub用户名}.md
84+
- Lesson2:assignments/lesson2/{你的GitHub用户名}.md
85+
- 个人文章检测文件名:仓库根目录 {你的GitHub用户名}.md
86+
87+
#### 首次 Fork 后手动运行指引
88+
1. 打开你 Fork 后的仓库的 GitHub 页面,点击 Actions
89+
2. 左侧选择 Calculate Student Score 工作流
90+
3. 点击 Run workflow,选择分支 main,确认运行
91+
4. 运行完成后在 Jobs 的日志中查看成绩报告

XiaoKuge.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,3 +6,17 @@ Solopreneurs的特点是:
66
1. 他们动作很快,快速Build,快速试错。
77
2. 他们只build自己用的产品。
88
3. 他们的产品不需要维护。
9+
10+
---
11+
12+
## CI 自动评分与运行指引
13+
- 个人文章检测文件名:仓库根目录 {你的GitHub用户名}.md(例如:XiaoKuge.md)
14+
- 课程作业检测仅在 PR 到 main 时执行,请通过 Pull Request 提交作业:
15+
- Lesson1:assignments/lesson1/{你的GitHub用户名}.md
16+
- Lesson2:assignments/lesson2/{你的GitHub用户名}.md
17+
- 自动评分工作流: [.github/workflows/calculate-score.yml](.github/workflows/calculate-score.yml)
18+
- 首次 Fork 后手动运行:
19+
1. 打开你 Fork 后的仓库页面,点击 Actions
20+
2. 选择 “Calculate Student Score” 工作流
21+
3. 点击 “Run workflow”,选择分支 main 并运行
22+
4. 在 Jobs 日志中查看成绩报告

assignments/lesson1/example-report.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,4 +23,12 @@
2323
(指出该商业模式面临的挑战和潜在风险)
2424

2525
### 6. 个人见解
26-
(分享您对该商业模式的看法和思考)
26+
(分享您对该商业模式的看法和思考)
27+
28+
---
29+
30+
## CI 自动评分与运行指引
31+
- 课程作业检测仅在 PR 到 main 时执行,请通过 Pull Request 提交本文件。
32+
- 文件命名:assignments/lesson1/{你的GitHub用户名}.md。
33+
- 自动评分工作流: [.github/workflows/calculate-score.yml](../../.github/workflows/calculate-score.yml)
34+
- 首次 Fork 后:进入 Actions → 选择 “Calculate Student Score” → 点击 “Run workflow” 并选择 main → 在日志中查看成绩。

assignments/lesson2/example-report.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,4 +22,12 @@
2222
- git commit: 提交更改到本地仓库
2323
- git push: 推送更改到远程仓库
2424
- git pull: 从远程仓库拉取最新更改
25-
等其他相关命令的使用体验和理解)
25+
等其他相关命令的使用体验和理解)
26+
27+
---
28+
29+
## CI 自动评分与运行指引
30+
- 课程作业检测仅在 PR 到 main 时执行,请通过 Pull Request 提交本文件。
31+
- 文件命名:assignments/lesson2/{你的GitHub用户名}.md。
32+
- 自动评分工作流: [.github/workflows/calculate-score.yml](../../.github/workflows/calculate-score.yml)
33+
- 首次 Fork 后:进入 Actions → 选择 “Calculate Student Score” → 点击 “Run workflow” 并选择 main → 在日志中查看成绩。

0 commit comments

Comments
 (0)