feat: initial course-cs50 with hello, mario-less, cash stages

Author: William Yang

.github/workflows/sync.yml

@@ -0,0 +1,32 @@
+# .github/workflows/sync.yml
+#
+# 课程同步到 BootCS API
+# 触发条件：推送到 main 分支 或 手动触发
+
+name: Sync Course
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  sync:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - name: Install dependencies
+        run: npm install js-yaml
+
+      - name: Parse and Sync
+        env:
+          BOOTCS_API_URL: ${{ secrets.BOOTCS_API_URL }}
+          SYNC_SECRET: ${{ secrets.SYNC_SECRET }}
+        run: node scripts/sync-to-api.js

.gitignore

@@ -0,0 +1,19 @@
+# Dependencies
+node_modules/
+
+# Build output
+dist/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Compiled C files
+*.o
+*.exe
+*.out

CONTRIBUTING.md

@@ -0,0 +1,51 @@
+# course-cs50
+
+CS50 课程包，用于 BootCS 平台。
+
+## 结构
+
+```
+course-cs50/
+├── course.yml              # 课程元信息
+├── README.md               # 课程详细介绍
+├── stages/                 # 阶段定义
+│   ├── hello.yml + .md
+│   ├── mario-less.yml + .md
+│   └── cash.yml + .md
+├── checks/                 # 评测脚本 (bootcs-cli 格式)
+│   ├── hello/
+│   ├── mario-less/
+│   └── cash/
+├── starters/               # 起始代码模板
+│   ├── hello/
+│   ├── mario-less/
+│   └── cash/
+└── .github/workflows/
+    └── sync.yml            # 同步到 bootcs-api
+```
+
+## 本地测试
+
+```bash
+# 安装 bootcs-cli
+npm install -g bootcs
+
+# 测试 hello 阶段
+cd starters/hello
+bootcs check ../checks/hello
+```
+
+## 添加新阶段
+
+1. 在 `stages/` 创建 `{slug}.yml` 和 `{slug}.md`
+2. 在 `checks/{slug}/` 创建 `checks.ts`
+3. 在 `starters/{slug}/` 创建起始代码
+4. 在 `course.yml` 的 `stage_order` 中添加 slug
+5. 提交并推送到 main 分支
+
+## 同步配置
+
+需要在仓库 Secrets 中配置：
+
+- `BOOTCS_API_URL`: API 地址
+- `SYNC_SECRET`: 同步密钥

README.md

@@ -0,0 +1,22 @@
+# CS50: Introduction to Computer Science
+
+## 简介
+
+CS50 是哈佛大学的计算机科学入门课程，由 David J. Malan 教授主讲。这门课程涵盖了计算机科学的核心概念，适合零基础学员。
+
+## 学习内容
+
+- **Week 1**: C 语言基础
+- **Week 2**: 数组与字符串
+- **Week 3**: 算法
+- **Week 4**: 内存管理
+- **Week 5**: 数据结构
+
+## 先修要求
+
+无需编程经验。
+
+## 参考资料
+
+- [CS50 官方网站](https://cs50.harvard.edu/)
+- [CS50 Manual](https://manual.cs50.io/)

checks/cash/checks.ts

@@ -0,0 +1,64 @@
+/**
+ * Cash 评测检查
+ *
+ * 迁移自 CS50 problems/cash/__init__.py
+ */
+import { Checks, Check, exists, run } from "bootcs";
+import { compile } from "bootcs/c";
+
+// 生成硬币数量的正则表达式（确保不与其他数字混淆）
+function coins(num: number): string {
+  return `(?<!\\d)${num}(?!\\d)`;
+}
+
+export default class CashChecks extends Checks {
+  @Check({ description: "cash.c exists" })
+  async exists() {
+    exists("cash.c");
+  }
+
+  @Check({ description: "cash.c compiles", dependency: "exists" })
+  async compiles() {
+    await compile("cash.c", { lcs50: true });
+  }
+
+  @Check({ description: "input of 41 yields output of 4", dependency: "compiles" })
+  async test041() {
+    await run("./cash").stdin("41").stdout(coins(4), "4\n").exit(0);
+  }
+
+  @Check({ description: "input of 1 yields output of 1", dependency: "compiles" })
+  async test001() {
+    await run("./cash").stdin("1").stdout(coins(1), "1\n").exit(0);
+  }
+
+  @Check({ description: "input of 15 yields output of 2", dependency: "compiles" })
+  async test015() {
+    await run("./cash").stdin("15").stdout(coins(2), "2\n").exit(0);
+  }
+
+  @Check({ description: "input of 160 yields output of 7", dependency: "compiles" })
+  async test160() {
+    await run("./cash").stdin("160").stdout(coins(7), "7\n").exit(0);
+  }
+
+  @Check({ description: "input of 2300 yields output of 92", dependency: "compiles" })
+  async test230() {
+    await run("./cash").stdin("2300").stdout(coins(92), "92\n").exit(0);
+  }
+
+  @Check({ description: "rejects a negative input like -1", dependency: "compiles" })
+  async test_reject_negative() {
+    await run("./cash").stdin("-1").reject();
+  }
+
+  @Check({ description: 'rejects a non-numeric input of "foo"', dependency: "compiles" })
+  async test_reject_foo() {
+    await run("./cash").stdin("foo").reject();
+  }
+
+  @Check({ description: 'rejects a non-numeric input of ""', dependency: "compiles" })
+  async test_reject_empty() {
+    await run("./cash").stdin("").reject();
+  }
+}

checks/hello/checks.ts

@@ -0,0 +1,29 @@
+/**
+ * Hello 评测检查
+ *
+ * 迁移自 CS50 problems/hello/__init__.py
+ */
+import { Checks, Check, exists, run } from "bootcs";
+import { compile } from "bootcs/c";
+
+export default class HelloChecks extends Checks {
+  @Check({ description: "hello.c exists" })
+  async exists() {
+    exists("hello.c");
+  }
+
+  @Check({ description: "hello.c compiles", dependency: "exists" })
+  async compiles() {
+    await compile("hello.c", { lcs50: true });
+  }
+
+  @Check({ description: "responds to name Emma", dependency: "compiles" })
+  async emma() {
+    await run("./hello").stdin("Emma").stdout("Emma").exit();
+  }
+
+  @Check({ description: "responds to name Rodrigo", dependency: "compiles" })
+  async rodrigo() {
+    await run("./hello").stdin("Rodrigo").stdout("Rodrigo").exit();
+  }
+}

checks/mario-less/checks.ts

@@ -0,0 +1,100 @@
+/**
+ * Mario (Less) 评测检查
+ *
+ * 迁移自 CS50 problems/mario/less/__init__.py
+ */
+import { Checks, Check, exists, include, run, Failure } from "bootcs";
+import { compile } from "bootcs/c";
+import * as fs from "fs";
+
+// 期望输出
+const PYRAMIDS: Record<number, string> = {
+  1: "#\n",
+  2: " #\n##\n",
+  8: "       #\n      ##\n     ###\n    ####\n   #####\n  ######\n #######\n########\n",
+};
+
+function checkPyramid(output: string, expected: string): void {
+  if (output === expected) {
+    return;
+  }
+
+  const outputLines = output.split("\n").filter((line) => line !== "");
+  const expectedLines = expected.split("\n").filter((line) => line !== "");
+
+  let help: string | undefined;
+  if (outputLines.length === expectedLines.length) {
+    if (
+      outputLines.every(
+        (ol, i) => ol.trimEnd() === expectedLines[i]
+      )
+    ) {
+      help = "did you add too much trailing whitespace to the end of your pyramid?";
+    } else if (
+      outputLines.every((ol, i) => ol.slice(1) === expectedLines[i])
+    ) {
+      help = "are you printing an additional character at the beginning of each line?";
+    }
+  }
+
+  throw new Failure(`Expected pyramid does not match output`, { help });
+}
+
+export default class MarioLessChecks extends Checks {
+  @Check({ description: "mario.c exists" })
+  async exists() {
+    exists("mario.c");
+  }
+
+  @Check({ description: "mario.c compiles", dependency: "exists" })
+  async compiles() {
+    await compile("mario.c", { lcs50: true });
+  }
+
+  @Check({ description: "rejects a height of -1", dependency: "compiles" })
+  async test_reject_negative() {
+    await run("./mario").stdin("-1").reject();
+  }
+
+  @Check({ description: "rejects a height of 0", dependency: "compiles" })
+  async test0() {
+    await run("./mario").stdin("0").reject();
+  }
+
+  @Check({ description: "handles a height of 1 correctly", dependency: "compiles" })
+  async test1() {
+    const result = await run("./mario").stdin("1").stdout();
+    checkPyramid(result, PYRAMIDS[1]);
+  }
+
+  @Check({ description: "handles a height of 2 correctly", dependency: "compiles" })
+  async test2() {
+    const result = await run("./mario").stdin("2").stdout();
+    checkPyramid(result, PYRAMIDS[2]);
+  }
+
+  @Check({ description: "handles a height of 8 correctly", dependency: "compiles" })
+  async test8() {
+    const result = await run("./mario").stdin("8").stdout();
+    checkPyramid(result, PYRAMIDS[8]);
+  }
+
+  @Check({
+    description: 'rejects a height of -1, then accepts height of 2',
+    dependency: "compiles",
+  })
+  async test9() {
+    const result = await run("./mario").stdin("-1").reject().stdin("2").stdout();
+    checkPyramid(result, PYRAMIDS[2]);
+  }
+
+  @Check({ description: 'rejects a non-numeric height of "foo"', dependency: "compiles" })
+  async test_reject_foo() {
+    await run("./mario").stdin("foo").reject();
+  }
+
+  @Check({ description: 'rejects a non-numeric height of ""', dependency: "compiles" })
+  async test_reject_empty() {
+    await run("./mario").stdin("").reject();
+  }
+}

course.yml

@@ -0,0 +1,34 @@
+# course.yml
+version: "1.0"
+
+# 课程基本信息
+slug: cs50
+name: "CS50: Introduction to Computer Science"
+description: README.md
+summary: |
+  哈佛大学计算机科学入门课程，涵盖 C、Python、SQL 和 Web 开发。
+
+icon: https://cdn.bootcs.cn/icons/cs50.svg
+difficulty: medium
+status: beta
+
+# 评测配置
+evaluation:
+  image: ghcr.io/bootcs-cn/bootcs-cli:cs50
+  timeout: 120
+
+# 标签
+tags:
+  - c
+  - python
+  - algorithms
+  - data-structures
+
+# 先修课程
+prerequisites: []
+
+# 阶段顺序（决定 position）
+stage_order:
+  - hello
+  - mario-less
+  - cash