@mo7yw4ng/openape 1.0.0

package/script/src/commands/materials.js

@@ -0,0 +1,423 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerMaterialsCommand = void 0;
+const utils_js_1 = require("../lib/utils.js");
+const moodle_js_1 = require("../lib/moodle.js");
+const logger_js_1 = require("../lib/logger.js");
+const auth_js_1 = require("../lib/auth.js");
+const session_js_1 = require("../lib/session.js");
+const auth_js_2 = require("../lib/auth.js");
+const token_js_1 = require("../lib/token.js");
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+function registerMaterialsCommand(program) {
+    const materialsCmd = program.command("materials");
+    materialsCmd.description("Material/resource operations");
+    // Helper to get output format from global or local options
+    function getOutputFormat(command) {
+        const opts = command.optsWithGlobals();
+        return opts.output || "json";
+    }
+    // Pure API context - no browser required (fast!)
+    async function createApiContext(options, command) {
+        const opts = command?.optsWithGlobals ? command.optsWithGlobals() : options;
+        const outputFormat = getOutputFormat(command || { optsWithGlobals: () => ({ output: "json" }) });
+        const silent = outputFormat === "json" && !opts.verbose;
+        const log = (0, logger_js_1.createLogger)(opts.verbose, silent);
+        const baseDir = (0, utils_js_1.getBaseDir)();
+        const sessionPath = path_1.default.resolve(baseDir, ".auth", "storage-state.json");
+        // Check if session exists
+        if (!fs_1.default.existsSync(sessionPath)) {
+            return null;
+        }
+        // Try to load WS token
+        const wsToken = (0, token_js_1.loadWsToken)(sessionPath);
+        if (!wsToken) {
+            return null;
+        }
+        return {
+            log,
+            session: {
+                wsToken,
+                moodleBaseUrl: "https://ilearning.cycu.edu.tw",
+            },
+        };
+    }
+    // Helper function to create session context
+    async function createSessionContext(options, command) {
+        // Get global options if command is provided (for --verbose, --silent flags)
+        const opts = command?.optsWithGlobals ? command.optsWithGlobals() : options;
+        // Auto-enable silent mode for JSON output (unless --verbose is also set)
+        const outputFormat = getOutputFormat(command || { optsWithGlobals: () => ({ output: "json" }) });
+        const silent = outputFormat === "json" && !opts.verbose;
+        const log = (0, logger_js_1.createLogger)(opts.verbose, silent);
+        // Determine session path
+        const baseDir = (0, utils_js_1.getBaseDir)();
+        const sessionPath = path_1.default.resolve(baseDir, ".auth", "storage-state.json");
+        // Check if session exists
+        if (!fs_1.default.existsSync(sessionPath)) {
+            log.error("未找到登入 session。請先執行 'openape auth login' 進行登入。");
+            log.info(`Session 預期位置: ${sessionPath}`);
+            return null;
+        }
+        // Create minimal config
+        const config = {
+            username: "",
+            password: "",
+            courseUrl: "",
+            moodleBaseUrl: "https://ilearning.cycu.edu.tw",
+            headless: !options.headed,
+            slowMo: 0,
+            authStatePath: sessionPath,
+            ollamaBaseUrl: "",
+        };
+        log.info("啟動瀏覽器...");
+        const { browser, context, page } = await (0, auth_js_1.launchAuthenticated)(config, log);
+        try {
+            const session = await (0, session_js_1.extractSessionInfo)(page, config, log);
+            return { log, page, session, browser, context };
+        }
+        catch (err) {
+            await context.close();
+            await browser.close();
+            throw err;
+        }
+    }
+    // Helper to sanitize filenames
+    function sanitizeFilename(name) {
+        // Remove or replace invalid characters
+        return name.replace(/[<>:"/\\|?*]/g, "_").replace(/\s+/g, "_");
+    }
+    // Helper to download a single resource
+    async function downloadResource(page, resource, outputDir, log) {
+        try {
+            // Only download resource type (skip url)
+            if (resource.modType !== "resource") {
+                log.debug(`  Skipping ${resource.modType}: ${resource.name}`);
+                return null;
+            }
+            // Create course directory
+            const courseDir = path_1.default.join(outputDir, sanitizeFilename(resource.course_name));
+            if (!fs_1.default.existsSync(courseDir)) {
+                fs_1.default.mkdirSync(courseDir, { recursive: true });
+            }
+            // Navigate to resource page
+            log.debug(`  Downloading: ${resource.name}`);
+            await page.goto(resource.url, { waitUntil: "domcontentloaded", timeout: 30000 });
+            // Try to find download link on the page
+            const downloadLinks = await page.$$eval('a[href*="forcedownload=1"]', (links) => links.map((a) => a.href));
+            if (downloadLinks.length === 0) {
+                log.warn(`    No download link found for: ${resource.name}`);
+                return null;
+            }
+            // Download the first available file
+            const downloadUrl = downloadLinks[0];
+            // Extract filename from URL or use resource name
+            const urlObj = new URL(downloadUrl);
+            const filenameParam = urlObj.searchParams.get("filename");
+            let filename = filenameParam || sanitizeFilename(resource.name);
+            // Add extension if missing
+            if (resource.mimetype && !path_1.default.extname(filename)) {
+                const extMap = {
+                    "application/pdf": ".pdf",
+                    "application/vnd.ms-powerpoint": ".ppt",
+                    "application/vnd.openxmlformats-officedocument.presentationml.presentation": ".pptx",
+                    "application/msword": ".doc",
+                    "application/vnd.openxmlformats-officedocument.wordprocessingml.document": ".docx",
+                    "application/vnd.ms-excel": ".xls",
+                    "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": ".xlsx",
+                    "application/zip": ".zip",
+                    "image/jpeg": ".jpg",
+                    "image/png": ".png",
+                };
+                if (extMap[resource.mimetype]) {
+                    filename += extMap[resource.mimetype];
+                }
+            }
+            const outputPath = path_1.default.join(courseDir, filename);
+            // Trigger download
+            const downloadPromise = page.waitForEvent("download", { timeout: 30000 });
+            await page.goto(downloadUrl, { waitUntil: "domcontentloaded" });
+            const download = await downloadPromise;
+            // Save file
+            await download.saveAs(outputPath);
+            const stats = fs_1.default.statSync(outputPath);
+            log.success(`    Downloaded: ${filename} (${(stats.size / 1024).toFixed(1)} KB)`);
+            return {
+                filename,
+                path: outputPath,
+                size: stats.size,
+                course_id: resource.course_id,
+                course_name: resource.course_name,
+            };
+        }
+        catch (err) {
+            log.warn(`    Failed to download ${resource.name}: ${err instanceof Error ? err.message : String(err)}`);
+            return null;
+        }
+    }
+    materialsCmd
+        .command("list-all")
+        .description("List all materials/resources across all courses")
+        .option("--level <type>", "Course level: in_progress (default) | all", "in_progress")
+        .option("--output <format>", "Output format: json|csv|table|silent")
+        .action(async (options, command) => {
+        // Try pure API mode (no browser, fast!)
+        const apiContext = await createApiContext(options, command);
+        if (apiContext) {
+            try {
+                const classification = options.level === "all" ? undefined : "inprogress";
+                const courses = await (0, moodle_js_1.getEnrolledCoursesApi)(apiContext.session, {
+                    classification,
+                });
+                // Get materials via WS API (no browser needed!)
+                const courseIds = courses.map(c => c.id);
+                const apiResources = await (0, moodle_js_1.getResourcesByCoursesApi)(apiContext.session, courseIds);
+                // Build a map of courseId -> course for quick lookup
+                const courseMap = new Map(courses.map(c => [c.id, c]));
+                const allMaterials = [];
+                for (const resource of apiResources) {
+                    const course = courseMap.get(resource.courseId);
+                    if (course) {
+                        allMaterials.push({
+                            course_id: resource.courseId,
+                            course_name: course.fullname,
+                            cmid: resource.cmid,
+                            name: resource.name,
+                            url: resource.url,
+                            modType: resource.modType,
+                            mimetype: resource.mimetype,
+                            filesize: resource.filesize,
+                            modified: resource.modified,
+                        });
+                    }
+                }
+                const output = {
+                    status: "success",
+                    timestamp: new Date().toISOString(),
+                    level: options.level,
+                    materials: allMaterials.map(m => ({
+                        course_id: m.course_id,
+                        course_name: m.course_name,
+                        id: m.cmid,
+                        name: m.name,
+                        type: m.modType,
+                        mimetype: m.mimetype,
+                        filesize: m.filesize,
+                        modified: m.modified ? new Date(m.modified * 1000).toISOString() : null,
+                        url: m.url,
+                    })),
+                    summary: {
+                        total_courses: courses.length,
+                        total_materials: allMaterials.length,
+                        by_type: allMaterials.reduce((acc, m) => {
+                            acc[m.modType] = (acc[m.modType] || 0) + 1;
+                            return acc;
+                        }, {}),
+                    },
+                };
+                console.log(JSON.stringify(output));
+                return;
+            }
+            catch (e) {
+                // API failed, fall through to browser mode
+                const msg = e instanceof Error ? e.message : String(e);
+                console.error(`// API mode failed: ${msg}, trying browser mode...`);
+            }
+        }
+        // Fallback to browser mode
+        const context = await createSessionContext(options, command);
+        if (!context) {
+            process.exitCode = 1;
+            return;
+        }
+        const { log, page, session, browser, context: browserContext } = context;
+        try {
+            // Map level to classification
+            const classification = options.level === "all" ? undefined : "inprogress";
+            const courses = await (0, moodle_js_1.getEnrolledCourses)(page, session, log, { classification });
+            const allMaterials = [];
+            for (const course of courses) {
+                const resources = await (0, moodle_js_1.getResourcesInCourse)(page, session, course.id, log);
+                for (const resource of resources) {
+                    allMaterials.push({
+                        course_id: course.id,
+                        course_name: course.fullname,
+                        cmid: resource.cmid,
+                        name: resource.name,
+                        url: resource.url,
+                        modType: resource.modType,
+                        mimetype: resource.mimetype,
+                        filesize: resource.filesize,
+                        modified: resource.modified,
+                    });
+                }
+            }
+            const output = {
+                status: "success",
+                timestamp: new Date().toISOString(),
+                level: options.level,
+                materials: allMaterials.map(m => ({
+                    course_id: m.course_id,
+                    course_name: m.course_name,
+                    id: m.cmid,
+                    name: m.name,
+                    type: m.modType,
+                    mimetype: m.mimetype,
+                    filesize: m.filesize,
+                    modified: m.modified ? new Date(m.modified * 1000).toISOString() : null,
+                    url: m.url,
+                })),
+                summary: {
+                    total_courses: courses.length,
+                    total_materials: allMaterials.length,
+                    by_type: allMaterials.reduce((acc, m) => {
+                        acc[m.modType] = (acc[m.modType] || 0) + 1;
+                        return acc;
+                    }, {}),
+                },
+            };
+            console.log(JSON.stringify(output));
+        }
+        finally {
+            await (0, auth_js_2.closeBrowserSafely)(browser, browserContext);
+        }
+    });
+    materialsCmd
+        .command("download")
+        .description("Download all materials from a specific course")
+        .argument("<course-id>", "Course ID")
+        .option("--output-dir <path>", "Output directory", "./downloads")
+        .option("--output <format>", "Output format: json|csv|table|silent")
+        .action(async (courseId, options, command) => {
+        const context = await createSessionContext(options, command);
+        if (!context) {
+            process.exitCode = 1;
+            return;
+        }
+        const { log, page, session, browser, context: browserContext } = context;
+        try {
+            const courses = await (0, moodle_js_1.getEnrolledCourses)(page, session, log);
+            const course = courses.find(c => c.id === parseInt(courseId, 10));
+            if (!course) {
+                log.error(`Course not found: ${courseId}`);
+                process.exitCode = 1;
+                return;
+            }
+            const resources = await (0, moodle_js_1.getResourcesInCourse)(page, session, course.id, log);
+            const materials = resources.map(r => ({
+                course_id: course.id,
+                course_name: course.fullname,
+                cmid: r.cmid,
+                name: r.name,
+                url: r.url,
+                modType: r.modType,
+                mimetype: r.mimetype,
+                filesize: r.filesize,
+                modified: r.modified,
+            }));
+            log.info(`Found ${materials.length} materials in course: ${course.fullname}`);
+            const downloadedFiles = [];
+            for (const material of materials) {
+                const result = await downloadResource(page, material, options.outputDir, log);
+                if (result) {
+                    downloadedFiles.push(result);
+                }
+            }
+            const summary = {
+                total_materials: materials.length,
+                downloaded: downloadedFiles.length,
+                skipped: materials.length - downloadedFiles.length,
+                total_size: downloadedFiles.reduce((sum, f) => sum + f.size, 0),
+            };
+            const output = {
+                status: "success",
+                timestamp: new Date().toISOString(),
+                downloaded_files: downloadedFiles.map(f => ({
+                    filename: f.filename,
+                    path: f.path,
+                    size: f.size,
+                    course_id: f.course_id,
+                    course_name: f.course_name,
+                })),
+                summary,
+            };
+            console.log(JSON.stringify(output));
+        }
+        finally {
+            await (0, auth_js_2.closeBrowserSafely)(browser, browserContext);
+        }
+    });
+    materialsCmd
+        .command("download-all")
+        .description("Download all materials from all courses")
+        .option("--output-dir <path>", "Output directory", "./downloads")
+        .option("--level <type>", "Course level: in_progress (default) | all", "in_progress")
+        .option("--output <format>", "Output format: json|csv|table|silent")
+        .action(async (options, command) => {
+        const context = await createSessionContext(options, command);
+        if (!context) {
+            process.exitCode = 1;
+            return;
+        }
+        const { log, page, session, browser, context: browserContext } = context;
+        try {
+            // Map level to classification
+            const classification = options.level === "all" ? undefined : "inprogress";
+            const courses = await (0, moodle_js_1.getEnrolledCourses)(page, session, log, { classification });
+            log.info(`Scanning ${courses.length} courses for materials...`);
+            const allMaterials = [];
+            for (const course of courses) {
+                const resources = await (0, moodle_js_1.getResourcesInCourse)(page, session, course.id, log);
+                for (const resource of resources) {
+                    allMaterials.push({
+                        course_id: course.id,
+                        course_name: course.fullname,
+                        cmid: resource.cmid,
+                        name: resource.name,
+                        url: resource.url,
+                        modType: resource.modType,
+                        mimetype: resource.mimetype,
+                        filesize: resource.filesize,
+                        modified: resource.modified,
+                    });
+                }
+            }
+            log.info(`Found ${allMaterials.length} materials across ${courses.length} courses`);
+            const downloadedFiles = [];
+            for (const material of allMaterials) {
+                const result = await downloadResource(page, material, options.outputDir, log);
+                if (result) {
+                    downloadedFiles.push(result);
+                }
+            }
+            const summary = {
+                total_courses: courses.length,
+                total_materials: allMaterials.length,
+                downloaded: downloadedFiles.length,
+                skipped: allMaterials.length - downloadedFiles.length,
+                total_size: downloadedFiles.reduce((sum, f) => sum + f.size, 0),
+            };
+            const output = {
+                status: "success",
+                timestamp: new Date().toISOString(),
+                downloaded_files: downloadedFiles.map(f => ({
+                    filename: f.filename,
+                    path: f.path,
+                    size: f.size,
+                    course_id: f.course_id,
+                    course_name: f.course_name,
+                })),
+                summary,
+            };
+            console.log(JSON.stringify(output));
+        }
+        finally {
+            await (0, auth_js_2.closeBrowserSafely)(browser, browserContext);
+        }
+    });
+}
+exports.registerMaterialsCommand = registerMaterialsCommand;

package/script/src/commands/quizzes.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerQuizzesCommand(program: Command): void;

package/script/src/commands/quizzes.js

@@ -0,0 +1,228 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerQuizzesCommand = void 0;
+const utils_js_1 = require("../lib/utils.js");
+const moodle_js_1 = require("../lib/moodle.js");
+const logger_js_1 = require("../lib/logger.js");
+const auth_js_1 = require("../lib/auth.js");
+const session_js_1 = require("../lib/session.js");
+const auth_js_2 = require("../lib/auth.js");
+const index_js_1 = require("../index.js");
+const token_js_1 = require("../lib/token.js");
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+function registerQuizzesCommand(program) {
+    const quizzesCmd = program.command("quizzes");
+    quizzesCmd.description("Quiz operations");
+    function getOutputFormat(command) {
+        const opts = command.optsWithGlobals();
+        return opts.output || "json";
+    }
+    // Pure API context - no browser required (fast!)
+    async function createApiContext(options, command) {
+        const opts = command?.optsWithGlobals ? command.optsWithGlobals() : options;
+        const outputFormat = getOutputFormat(command || { optsWithGlobals: () => ({ output: "json" }) });
+        const silent = outputFormat === "json" && !opts.verbose;
+        const log = (0, logger_js_1.createLogger)(opts.verbose, silent);
+        const baseDir = (0, utils_js_1.getBaseDir)();
+        const sessionPath = path_1.default.resolve(baseDir, ".auth", "storage-state.json");
+        // Check if session exists
+        if (!fs_1.default.existsSync(sessionPath)) {
+            return null;
+        }
+        // Try to load WS token
+        const wsToken = (0, token_js_1.loadWsToken)(sessionPath);
+        if (!wsToken) {
+            return null;
+        }
+        return {
+            log,
+            session: {
+                wsToken,
+                moodleBaseUrl: "https://ilearning.cycu.edu.tw",
+            },
+        };
+    }
+    // Helper function to create session context
+    async function createSessionContext(options, command) {
+        // Get global options if command is provided (for --verbose, --silent flags)
+        const opts = command?.optsWithGlobals ? command.optsWithGlobals() : options;
+        // Auto-enable silent mode for JSON output (unless --verbose is also set)
+        const outputFormat = getOutputFormat(command || { optsWithGlobals: () => ({ output: "json" }) });
+        const silent = outputFormat === "json" && !opts.verbose;
+        const log = (0, logger_js_1.createLogger)(opts.verbose, silent);
+        const baseDir = (0, utils_js_1.getBaseDir)();
+        const sessionPath = path_1.default.resolve(baseDir, ".auth", "storage-state.json");
+        if (!fs_1.default.existsSync(sessionPath)) {
+            log.error("未找到登入 session。請先執行 'openape auth login' 進行登入。");
+            return null;
+        }
+        const config = {
+            username: "",
+            password: "",
+            courseUrl: "",
+            moodleBaseUrl: "https://ilearning.cycu.edu.tw",
+            headless: !options.headed,
+            slowMo: 0,
+            authStatePath: sessionPath,
+            ollamaBaseUrl: "",
+        };
+        log.info("啟動瀏覽器...");
+        const { browser, context, page } = await (0, auth_js_1.launchAuthenticated)(config, log);
+        try {
+            const session = await (0, session_js_1.extractSessionInfo)(page, config, log);
+            return { log, page, session, browser, context };
+        }
+        catch (err) {
+            await context.close();
+            await browser.close();
+            throw err;
+        }
+    }
+    quizzesCmd
+        .command("list")
+        .description("List quizzes in a course")
+        .argument("<course-id>", "Course ID")
+        .option("--available-only", "Show only available quizzes")
+        .option("--output <format>", "Output format: json|csv|table|silent")
+        .action(async (courseId, options, command) => {
+        const output = getOutputFormat(command);
+        // Try pure API mode (no browser, fast!)
+        const apiContext = await createApiContext(options, command);
+        if (apiContext) {
+            try {
+                const quizzes = await (0, moodle_js_1.getQuizzesByCoursesApi)(apiContext.session, [parseInt(courseId, 10)]);
+                // Filter by available only if requested (API returns all, no completion status)
+                // Note: API doesn't provide completion status, so --available-only won't work in API mode
+                if (options.availableOnly) {
+                    apiContext.log.warn("--available-only is not supported in API mode, showing all quizzes");
+                }
+                (0, index_js_1.formatAndOutput)(quizzes, output, apiContext.log);
+                return;
+            }
+            catch (e) {
+                // API failed, fall through to browser mode
+                const msg = e instanceof Error ? e.message : String(e);
+                console.error(`// API mode failed: ${msg}, trying browser mode...`);
+            }
+        }
+        // Fallback to browser mode
+        const context = await createSessionContext(options, command);
+        if (!context) {
+            process.exitCode = 1;
+            return;
+        }
+        const { log, page, session, browser, context: browserContext } = context;
+        try {
+            const quizzes = await (0, moodle_js_1.getQuizzesInCourse)(page, session, parseInt(courseId, 10), log);
+            let filteredQuizzes = quizzes;
+            if (options.availableOnly) {
+                filteredQuizzes = quizzes.filter(q => !q.isComplete);
+            }
+            (0, index_js_1.formatAndOutput)(filteredQuizzes, output, log);
+        }
+        finally {
+            await (0, auth_js_2.closeBrowserSafely)(browser, browserContext);
+        }
+    });
+    quizzesCmd
+        .command("list-all")
+        .description("List all available quizzes across all courses")
+        .option("--level <type>", "Course level: in_progress (default) | all", "in_progress")
+        .option("--output <format>", "Output format: json|csv|table|silent")
+        .action(async (options, command) => {
+        const output = getOutputFormat(command);
+        // Try pure API mode (no browser, fast!)
+        const apiContext = await createApiContext(options, command);
+        if (apiContext) {
+            try {
+                const classification = options.level === "all" ? undefined : "inprogress";
+                const courses = await (0, moodle_js_1.getEnrolledCoursesApi)(apiContext.session, {
+                    classification,
+                });
+                // Get quizzes via WS API (no browser needed!)
+                const courseIds = courses.map(c => c.id);
+                const apiQuizzes = await (0, moodle_js_1.getQuizzesByCoursesApi)(apiContext.session, courseIds);
+                // Build a map of courseId -> course for quick lookup
+                const courseMap = new Map(courses.map(c => [c.id, c]));
+                const allQuizzes = [];
+                for (const q of apiQuizzes) {
+                    const course = courseMap.get(q.courseId);
+                    if (course) {
+                        allQuizzes.push({
+                            courseName: course.fullname,
+                            name: q.name,
+                            url: q.url,
+                            cmid: q.cmid,
+                            isComplete: q.isComplete,
+                        });
+                    }
+                }
+                apiContext.log.info(`\n總計發現 ${allQuizzes.length} 個測驗。`);
+                (0, index_js_1.formatAndOutput)(allQuizzes, output, apiContext.log);
+                return;
+            }
+            catch (e) {
+                // API failed, fall through to browser mode
+                const msg = e instanceof Error ? e.message : String(e);
+                console.error(`// API mode failed: ${msg}, trying browser mode...`);
+            }
+        }
+        // Fallback to browser mode
+        const context = await createSessionContext(options, command);
+        if (!context) {
+            process.exitCode = 1;
+            return;
+        }
+        const { log, page, session, browser, context: browserContext } = context;
+        try {
+            const classification = options.level === "all" ? undefined : "inprogress";
+            const courses = await (0, moodle_js_1.getEnrolledCourses)(page, session, log, { classification });
+            const allQuizzes = [];
+            for (const course of courses) {
+                const quizzes = await (0, moodle_js_1.getQuizzesInCourse)(page, session, course.id, log);
+                for (const q of quizzes) {
+                    allQuizzes.push({
+                        courseName: course.fullname,
+                        name: q.name,
+                        url: q.url,
+                        cmid: q.cmid,
+                        isComplete: q.isComplete,
+                    });
+                }
+            }
+            log.info(`\n總計發現 ${allQuizzes.length} 個測驗。`);
+            (0, index_js_1.formatAndOutput)(allQuizzes, output, log);
+        }
+        finally {
+            await (0, auth_js_2.closeBrowserSafely)(browser, browserContext);
+        }
+    });
+    quizzesCmd
+        .command("open")
+        .description("Open a quiz URL in browser (manual mode)")
+        .argument("<quiz-url>", "Quiz URL")
+        .option("--headed", "Run browser in visible mode (default: true)")
+        .action(async (quizUrl, options, command) => {
+        const context = await createSessionContext({ ...options, headed: true }, command);
+        if (!context) {
+            process.exitCode = 1;
+            return;
+        }
+        const { log, page, browser, context: browserContext } = context;
+        try {
+            log.info(`導航至測驗頁面: ${quizUrl}`);
+            await page.goto(quizUrl, { waitUntil: "domcontentloaded" });
+            log.info("瀏覽器已開啟，請手動完成測驗。");
+            log.info("按 Ctrl+C 關閉瀏覽器。");
+            await new Promise(() => { });
+        }
+        finally {
+            await (0, auth_js_2.closeBrowserSafely)(browser, browserContext);
+        }
+    });
+}
+exports.registerQuizzesCommand = registerQuizzesCommand;

package/script/src/commands/skills.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerSkillsCommand(program: Command): void;