e-GuruPanduan SistemGuru.My Buka App

Cara guna Makmal Kod: Latihan Pengaturcaraan Auto-Semak

Bina soalan Python, JavaScript dan SQL dengan kes ujian tersembunyi, terbitkan ke Portal Murid, dan lihat laporan kelas — langkah demi langkah dengan gambar app sebenar.

Sebelum anda mula

Terbit dan laporan memerlukan kelas dan murid; membina soalan tidak.

  1. Pro
    Pelan Pro atau UltraMakmal Kod dikunci bagi Tetamu dan Percuma.
  2. Wajib
    Jadual Waktu / Senarai muridKelas untuk Terbit dan Laporan kelas (alatKelasSemua).
  3. Wajib
    Portal Murid (kod kelas & PIN)Murid menjawab soalan di Portal Murid.
  4. Pilihan
    IntervensiUntuk Hantar ke Intervensi murid bawah 50 %.
  5. Pro
    Sambungan Google DriveUntuk Hantar ke Drive.
Contoh dalam panduan ini. Rakan sekerja rekaan Cikgu Nurul Aina, Cikgu Siti Zainab (guru Sains Komputer T4, SK 1.4 Struktur Kawalan), dengan tiga soalan rekaan diterbitkan kepada 4 Bestari: Purata tiga markah (Python), Gred markah (if / elif / else) (Python) dan Murid lulus Sains (SQL), serta hantaran rekaan 26 murid. Output jangkaan dijana oleh Python sebenar dalam pelayar.

Apa yang berbeza ikut pelan

Makmal Kod ialah ciri Pro. Ultra menambah AI terus.

Ciri Makmal KodTetamuPercumaProUltra
Bina soalan Python / JavaScript / SQL, kes ujian, terbit— (log masuk) ProYaYa
Laporan kelas, Intervensi, lembaran PDF— ProYaYa
Petunjuk AI——Salin-tampalTerus
Hantar ke Drive (PDF)——YaYa
Murid menjawab di Portal MuridPIN PortalPIN PortalYaYa

TetamuAkses Tetamu & Percuma

Bahagian ini menerangkan apa yang dilihat sebelum naik taraf.

Nombor merah pada setiap gambar sepadan dengan senarai di bawahnya. Klik atau ketik gambar untuk melihatnya dalam saiz penuh.

  1. Langkah 1 Tetamu & Percuma: Makmal Kod ialah ciri Pro

    Dalam hab Tools, kad Makmal Kod bertanda Pro. Tetamu yang menekan Buka mendapat tetingkap Daftar / Log masuk. Guru pelan Percuma melihat kad CIRI PRO dengan butang Lihat Pelan — naik taraf ke Pro atau Ultra untuk membina soalan. Murid tidak memerlukan akaun: mereka menjawab di Portal Murid dengan kod kelas & PIN.

    Kad Makmal Kod dalam hab Tools bertanda Pro, AI pilihan, dengan butang Buka.
    1. Lencana Pro.
    2. Buka.
    Tetingkap Daftar percuma yang muncul bila Tetamu membuka Makmal Kod.
    1. Tujuan log masuk.
    Pelan Percuma: kad CIRI PRO Makmal Kod dengan butang Lihat Pelan.

ProBina, terbit & pantau soalan pengaturcaraan

Semua langkah ini juga sama bagi Ultra.

Nombor merah pada setiap gambar sepadan dengan senarai di bawahnya. Klik atau ketik gambar untuk melihatnya dalam saiz penuh.

  1. Langkah 1 Senarai soalan

    Tools › Subjek Saya (STEM) › Makmal Kod, atau #tools-makmal-kod. Skrin Soalan menyenaraikan soalan anda dengan bahasa, mod, status terbitan, bilangan kes ujian (tersembunyi) dan hantaran murid. + Soalan baharu, Import soalan (.json) (daripada rakan panitia), atau — bila kosong — Muat 3 soalan contoh (bertanda “Contoh — sahkan”). Padam turut memadam hantaran murid (dengan pengesahan).
    Senarai soalan Makmal Kod: tiga soalan Sains Komputer diterbitkan kepada 4 Bestari dengan bilangan ujian dan hantaran.
    1. Soalan / Laporan kelas.
    2. + Soalan baharu.
    3. Import soalan (.json).
    4. Kad soalan — ketik untuk membuka.
    5. Padam.

  2. Langkah 2 Sunting soalan: tajuk, bahasa, arahan

    Tab Sunting: isi Tajuk soalan, pilih Bahasa — Python (Pyodide), JavaScript atau SQL (SQLite) — semuanya dijalankan dalam pelayar murid, tiada pelayan kod. Tulis Arahan dengan format input dan output yang jelas (formula $…$ dibenarkan). Bagi SQL, lipatan Jadual persediaan memuat CREATE TABLE & INSERT yang dijalankan sebelum pertanyaan murid.

    Tab Sunting soalan Gred markah: pautan Senarai, tab Sunting/Terbit/Lembaran, tajuk, bahasa Python, arahan dan lipatan Kod permulaan.
    1. ‹ Senarai.
    2. Tab Sunting · Terbit · Lembaran.
    3. Tajuk soalan.
    4. Bahasa.
    5. Arahan.
    6. Kod permulaan.

  3. Langkah 3 Kod permulaan & penyelesaian guru

    Kod permulaan dipapar kepada murid sebagai titik mula (cth baris membaca input). Penyelesaian guru TIDAK dihantar kepada murid — ia dipakai untuk menjana output jangkaan dan dicetak dalam Versi guru (SULIT). Editor bernombor baris; Tab menginden.
    Editor Kod permulaan dan Penyelesaian guru Python dengan nombor baris.
    1. Kod permulaan (murid).
    2. Penyelesaian guru (rahsia).

  4. Langkah 4 Kes ujian & output jangkaan

    Setiap kes ujian ada Input (satu nilai setiap baris), Output jangkaan dan Markah. Tanda Tersembunyi bagi kes yang murid tidak nampak (output jangkaan kekal di pelayan) — ini menghalang murid “menulis jawapan terus”. Maksimum 30 kes.

    Tekan Jana output jangkaan daripada penyelesaian: penyelesaian guru dijalankan bagi setiap input dan output diisi sendiri (contoh: 85 → A, 72 → B, 40 → C, 12 → D). Kali pertama memuat enjin Python mengambil masa beberapa saat.

    Lipatan Kes ujian: empat ujian, dua tersembunyi, butang Jana output jangkaan dan status dijana bagi 4 ujian.
    1. Tersembunyi (ujian contoh).
    2. Input.
    3. Output jangkaan.
    4. Ujian tersembunyi.
    5. Jana output jangkaan daripada penyelesaian.
    6. Status larian.

  5. Langkah 5 Mod Latihan / Pentaksiran & simpan

    Tetapan mod: Latihan — murid boleh menghantar berulang kali dan melihat petunjuk yang disahkan selepas 2 cubaan; Pentaksiran — Had cubaan (0 = tiada had) dan tiada petunjuk.

    Tekan Simpan soalan. Suntingan yang belum disimpan kekal sebagai draf (pautan “Draf belum disimpan” dalam senarai). Eksport (.json) berkongsi soalan dengan rakan.

    Tetapan mod Latihan/Pentaksiran, butang Simpan soalan dan Eksport json.
    1. Latihan / Pentaksiran.
    2. Simpan soalan.
    3. Eksport (.json).

  6. Langkah 6 Petunjuk dengan AI (Pro: salin-tampal)

    Lipatan Petunjuk (AI): tulis petunjuk sendiri (+ Petunjuk) atau buka Draf petunjuk & kes ujian dengan AI. Pada Pro: 1 · Salin prompt, tampal ke ChatGPT/Gemini, tampal jawapan ke kotak kedua dan tekan 3 · Proses jawapan. AI hanya menerima arahan & penyelesaian anda — tiada data murid.

    Hasil: petunjuk berperingkat (#P1 umum → #P3 hampir lengkap) bertanda Draf AI — belum disemak, dan cadangan input ujian tersembunyi (output dikira semula daripada penyelesaian). Tekan Sahkan pada setiap petunjuk (atau Buang) — soalan tidak boleh diterbitkan selagi ada petunjuk draf.

    Panel AI salin-tampal: Salin prompt, prompt, jawapan AI ditampal dan Proses jawapan.
    1. 1 · Salin prompt.
    2. Prompt.
    3. Jawapan AI ditampal.
    4. 3 · Proses jawapan.
    Tiga petunjuk berperingkat bertanda Draf AI belum disemak dengan butang Sahkan.
    1. Draf AI.
    2. Teks petunjuk (boleh disunting).
    3. Sahkan.

  7. Langkah 7 Terbit ke kelas

    Tab Terbit: tandakan kelas dan tekan Terbit ke kelas (atau Kemas kini terbitan / Tarik balik). Murid kelas itu melihat soalan dalam Portal Murid › Latihan › Makmal Kod, menulis kod dalam pelayar dan disemak serta-merta dengan mesej ralat Bahasa Melayu.

    Tab Terbit: Diterbitkan kepada 4 Bestari, senarai kelas dan butang Kemas kini terbitan.
    1. Status terbitan.
    2. Kelas.
    3. Terbit ke kelas / Kemas kini terbitan.

  8. Langkah 8 Lembaran murid & Versi guru

    Tab Lembaran: Lembaran murid (arahan, kod permulaan, contoh I/O dan ruang jawapan — tanpa penyelesaian & ujian tersembunyi) atau Versi guru (SULIT: semua kes ujian, penyelesaian dan petunjuk disahkan). Muat turun PDF / Word atau Hantar ke Drive.

    Tab Lembaran: Lembaran murid / Versi guru, Muat turun PDF dan pratonton lembaran.
    1. Lembaran murid / Versi guru.
    2. Muat turun PDF.
    3. Pratonton.
    PDF lembaran murid: arahan, kod permulaan dua baris dan contoh input output.

    PDF lembaran murid.

    PDF Versi guru SULIT: tujuh kes ujian termasuk tersembunyi.

    PDF Versi guru (SULIT).

  9. Langkah 9 Laporan kelas

    Skrin Laporan kelas: pilih Kelas — grid murid × soalan menunjukkan ✓ (semua ujian lulus), n/N ujian lulus atau – (belum menghantar), bilangan cubaan dan tarikh, serta peratus keseluruhan (merah bawah 50 %).

    Muat turun PDF laporan bertanda SULIT (nama murid), Excel, Hantar ke Drive (PDF ke Drive anda), dan Hantar ke Intervensi bagi murid bawah 50 %.
    Laporan kelas 4 Bestari: pemilih kelas, bar eksport, Hantar ke Intervensi 3 murid dan grid murid × soalan.
    1. Kelas.
    2. Bar eksport (PDF SULIT).
    3. Hantar ke Intervensi.
    4. Grid keputusan.
    PDF Laporan Makmal Kod 4 Bestari bertanda SULIT.

    PDF laporan (SULIT).

    Tetingkap Berjaya: laporan disimpan ke Google Drive.
    1. Buka Fail di Google Drive.

UltraAI terus

Nombor merah pada setiap gambar sepadan dengan senarai di bawahnya. Klik atau ketik gambar untuk melihatnya dalam saiz penuh.

  1. Langkah 1 AI terus

    Pada Ultra, Draf petunjuk & kes ujian dengan AI menjana terus dengan Baki AI bulan ini — tanpa salin-tampal. Petunjuk tetap berstatus Draf sehingga anda menekan Sahkan, dan output ujian dikira semula daripada penyelesaian anda.

    Panel AI pelan Ultra dengan butang Draf petunjuk dan kes ujian dengan AI serta baki AI.
    1. Draf … dengan AI.
    2. Baki AI bulan ini.

Maklumat penting

Betul vs Salah

Berdasarkan cara sebenar app berfungsi.

Betul

Gabungkan ujian contoh dan tersembunyi (termasuk kes sempadan).

Salah

Semua ujian dipapar kepada murid.

Sebab: Murid boleh mencetak output jangkaan terus tanpa menulis algoritma.

Betul

Jana output jangkaan daripada penyelesaian.

Salah

Menaip output jangkaan secara manual.

Sebab: Satu ruang atau baris baharu tersilap menyebabkan jawapan betul murid ditanda salah.

Betul

Sahkan setiap petunjuk AI sebelum diterbitkan.

Salah

Menerbitkan petunjuk draf.

Sebab: Tool menyekat terbitan; petunjuk AI mungkin terlalu banyak membocorkan jawapan.

Betul

Simpan PDF laporan sebagai dokumen SULIT.

Salah

Mengedar laporan bernama dalam kumpulan WhatsApp.

Sebab: Laporan mengandungi nama murid (PDPA).

Soalan lazim

Di manakah kod murid dijalankan?

Dalam pelayar murid sendiri (Python melalui Pyodide, JavaScript dalam Worker, SQL melalui sql.js) — tiada pelayan kod.

Bolehkah murid melihat ujian tersembunyi?

Tidak. Murid hanya menerima input; output jangkaan kekal di pelayan dan semakan dibuat di sana.

Adakah Makmal Kod percuma?

Tidak — ia ciri Pro dan Ultra. Murid tidak perlu akaun; mereka masuk Portal Murid dengan kod kelas & PIN.

Boleh berkongsi soalan dengan rakan panitia?

Ya — Eksport (.json) dalam tab Sunting, dan rakan menekan Import soalan (.json).

Tool berkaitan

Buka Makmal Kod