@mo7yw4ng/openape 1.0.0 → 1.0.2

package/esm/src/commands/grades.js

@@ -0,0 +1,121 @@
+import { getBaseDir } from "../lib/utils.js";
+import { getEnrolledCoursesApi, getCourseGradesApi } from "../lib/moodle.js";
+import { createLogger } from "../lib/logger.js";
+import { loadWsToken } from "../lib/token.js";
+import { formatAndOutput } from "../index.js";
+import path from "node:path";
+import fs from "node:fs";
+export function registerGradesCommand(program) {
+    const gradesCmd = program.command("grades");
+    gradesCmd.description("Grade 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 = createLogger(opts.verbose, silent);
+        const baseDir = getBaseDir();
+        const sessionPath = path.resolve(baseDir, ".auth", "storage-state.json");
+        // Check if session exists
+        if (!fs.existsSync(sessionPath)) {
+            log.error("未找到登入 session。請先執行 'openape auth login' 進行登入。");
+            log.info(`Session 預期位置: ${sessionPath}`);
+            return null;
+        }
+        // Try to load WS token
+        const wsToken = loadWsToken(sessionPath);
+        if (!wsToken) {
+            log.error("未找到 WS token。請先執行 'openape auth login' 進行登入。");
+            return null;
+        }
+        return {
+            log,
+            session: {
+                wsToken,
+                moodleBaseUrl: "https://ilearning.cycu.edu.tw",
+            },
+        };
+    }
+    gradesCmd
+        .command("summary")
+        .description("Show grade summary across all courses")
+        .option("--output <format>", "Output format: json|csv|table|silent")
+        .action(async (options, command) => {
+        const output = getOutputFormat(command);
+        const apiContext = await createApiContext(options, command);
+        if (!apiContext) {
+            process.exitCode = 1;
+            return;
+        }
+        const courses = await getEnrolledCoursesApi(apiContext.session);
+        const gradeSummaries = [];
+        for (const course of courses) {
+            const grades = await getCourseGradesApi(apiContext.session, course.id);
+            gradeSummaries.push({
+                courseId: course.id,
+                courseName: course.fullname,
+                grade: grades.grade,
+                gradeFormatted: grades.gradeFormatted,
+                rank: grades.rank,
+                totalUsers: grades.totalUsers,
+            });
+        }
+        // Calculate overall statistics
+        const gradedCourses = gradeSummaries.filter(g => g.grade !== undefined && g.grade !== null && g.grade !== "-");
+        const averageRank = gradeSummaries
+            .filter(g => g.rank !== undefined && g.rank !== null)
+            .reduce((sum, g) => sum + (g.rank || 0), 0) /
+            (gradeSummaries.filter(g => g.rank !== undefined && g.rank !== null).length || 1);
+        const summaryData = {
+            total_courses: courses.length,
+            graded_courses: gradedCourses.length,
+            average_rank: averageRank.toFixed(1),
+            grades: gradeSummaries,
+        };
+        formatAndOutput(summaryData, output, apiContext.log);
+    });
+    gradesCmd
+        .command("course")
+        .description("Show detailed grades for a specific course")
+        .argument("<course-id>", "Course ID")
+        .option("--output <format>", "Output format: json|csv|table|silent")
+        .action(async (courseId, options, command) => {
+        const output = getOutputFormat(command);
+        const apiContext = await createApiContext(options, command);
+        if (!apiContext) {
+            process.exitCode = 1;
+            return;
+        }
+        const courses = await getEnrolledCoursesApi(apiContext.session);
+        const course = courses.find(c => c.id === parseInt(courseId, 10));
+        if (!course) {
+            apiContext.log.error(`Course not found: ${courseId}`);
+            process.exitCode = 1;
+            return;
+        }
+        const grades = await getCourseGradesApi(apiContext.session, course.id);
+        const gradeData = {
+            courseId: grades.courseId,
+            courseName: grades.courseName,
+            grade: grades.grade,
+            gradeFormatted: grades.gradeFormatted,
+            rank: grades.rank,
+            totalUsers: grades.totalUsers,
+            items: grades.items?.map(item => ({
+                name: item.name,
+                grade: item.grade,
+                gradeFormatted: item.gradeFormatted,
+                range: item.range,
+                percentage: item.percentage,
+                weight: item.weight,
+                feedback: item.feedback,
+                graded: item.graded,
+            })),
+        };
+        formatAndOutput(gradeData, output, apiContext.log);
+    });
+}

package/esm/src/commands/materials.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerMaterialsCommand(program: Command): void;
+//# sourceMappingURL=materials.d.ts.map

package/esm/src/commands/materials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materials.d.ts","sourceRoot":"","sources":["../../../src/src/commands/materials.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+BpC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAka/D"}

package/esm/src/commands/materials.js

@@ -0,0 +1,362 @@
+import { getBaseDir } from "../lib/utils.js";
+import { getEnrolledCourses, getEnrolledCoursesApi, getResourcesByCoursesApi } from "../lib/moodle.js";
+import { createLogger } from "../lib/logger.js";
+import { launchAuthenticated } from "../lib/auth.js";
+import { extractSessionInfo } from "../lib/session.js";
+import { closeBrowserSafely } from "../lib/auth.js";
+import { loadWsToken } from "../lib/token.js";
+import path from "node:path";
+import fs from "node:fs";
+export 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 = createLogger(opts.verbose, silent);
+        const baseDir = getBaseDir();
+        const sessionPath = path.resolve(baseDir, ".auth", "storage-state.json");
+        // Check if session exists
+        if (!fs.existsSync(sessionPath)) {
+            log.error("未找到登入 session。請先執行 'openape auth login' 進行登入。");
+            log.info(`Session 預期位置: ${sessionPath}`);
+            return null;
+        }
+        // Try to load WS token
+        const wsToken = loadWsToken(sessionPath);
+        if (!wsToken) {
+            log.error("未找到 WS token。請先執行 'openape auth login' 進行登入。");
+            return null;
+        }
+        return {
+            log,
+            session: {
+                wsToken,
+                moodleBaseUrl: "https://ilearning.cycu.edu.tw",
+            },
+        };
+    }
+    // Helper function to create session context (for download commands)
+    async function createSessionContext(options, command) {
+        const opts = command?.optsWithGlobals ? command.optsWithGlobals() : options;
+        const outputFormat = getOutputFormat(command || { optsWithGlobals: () => ({ output: "json" }) });
+        const silent = outputFormat === "json" && !opts.verbose;
+        const log = createLogger(opts.verbose, silent);
+        const baseDir = getBaseDir();
+        const sessionPath = path.resolve(baseDir, ".auth", "storage-state.json");
+        if (!fs.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 launchAuthenticated(config, log);
+        try {
+            const session = await 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) {
+        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.join(outputDir, sanitizeFilename(resource.course_name));
+            if (!fs.existsSync(courseDir)) {
+                fs.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.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.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.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) => {
+        const apiContext = await createApiContext(options, command);
+        if (!apiContext) {
+            process.exitCode = 1;
+            return;
+        }
+        const classification = options.level === "all" ? undefined : "inprogress";
+        const courses = await getEnrolledCoursesApi(apiContext.session, {
+            classification,
+        });
+        // Get materials via WS API (no browser needed!)
+        const courseIds = courses.map(c => c.id);
+        const apiResources = await 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));
+    });
+    materialsCmd
+        .command("download")
+        .description("Download all materials from a specific course (requires browser)")
+        .argument("<course-id>", "Course ID")
+        .option("--output-dir <path>", "Output directory", "./downloads")
+        .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 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;
+            }
+            // Navigate to course page to find materials
+            await page.goto(`https://ilearning.cycu.edu.tw/course/view.php?id=${course.id}`, { waitUntil: "domcontentloaded" });
+            // Find all resource links
+            const materials = [];
+            const resourceLinks = await page.$$eval('a[href*="/mod/resource/view.php"]', (links) => {
+                return links.map((a) => ({
+                    url: a.href,
+                    name: a.textContent?.trim() || "",
+                }));
+            });
+            for (const link of resourceLinks) {
+                const cmidMatch = link.url.match(/id=(\d+)/);
+                if (cmidMatch) {
+                    materials.push({
+                        course_id: course.id,
+                        course_name: course.fullname,
+                        cmid: cmidMatch[1],
+                        name: link.name,
+                        url: link.url,
+                        modType: "resource",
+                    });
+                }
+            }
+            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 closeBrowserSafely(browser, browserContext);
+        }
+    });
+    materialsCmd
+        .command("download-all")
+        .description("Download all materials from all courses (requires browser)")
+        .option("--output-dir <path>", "Output directory", "./downloads")
+        .option("--level <type>", "Course level: in_progress (default) | all", "in_progress")
+        .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 {
+            const classification = options.level === "all" ? undefined : "inprogress";
+            const courses = await getEnrolledCourses(page, session, log, { classification });
+            log.info(`Scanning ${courses.length} courses for materials...`);
+            const allMaterials = [];
+            for (const course of courses) {
+                await page.goto(`https://ilearning.cycu.edu.tw/course/view.php?id=${course.id}`, { waitUntil: "domcontentloaded" });
+                const resourceLinks = await page.$$eval('a[href*="/mod/resource/view.php"]', (links) => {
+                    return links.map((a) => ({
+                        url: a.href,
+                        name: a.textContent?.trim() || "",
+                    }));
+                });
+                for (const link of resourceLinks) {
+                    const cmidMatch = link.url.match(/id=(\d+)/);
+                    if (cmidMatch) {
+                        allMaterials.push({
+                            course_id: course.id,
+                            course_name: course.fullname,
+                            cmid: cmidMatch[1],
+                            name: link.name,
+                            url: link.url,
+                            modType: "resource",
+                        });
+                    }
+                }
+            }
+            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 closeBrowserSafely(browser, browserContext);
+        }
+    });
+}

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

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerQuizzesCommand(program: Command): void;
+//# sourceMappingURL=quizzes.d.ts.map

package/esm/src/commands/quizzes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quizzes.d.ts","sourceRoot":"","sources":["../../../src/src/commands/quizzes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuL7D"}

package/esm/src/commands/quizzes.js

@@ -0,0 +1,160 @@
+import { getBaseDir } from "../lib/utils.js";
+import { getEnrolledCoursesApi, getQuizzesByCoursesApi } from "../lib/moodle.js";
+import { createLogger } from "../lib/logger.js";
+import { launchAuthenticated } from "../lib/auth.js";
+import { extractSessionInfo } from "../lib/session.js";
+import { closeBrowserSafely } from "../lib/auth.js";
+import { formatAndOutput } from "../index.js";
+import { loadWsToken } from "../lib/token.js";
+import path from "node:path";
+import fs from "node:fs";
+export 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 = createLogger(opts.verbose, silent);
+        const baseDir = getBaseDir();
+        const sessionPath = path.resolve(baseDir, ".auth", "storage-state.json");
+        // Check if session exists
+        if (!fs.existsSync(sessionPath)) {
+            log.error("未找到登入 session。請先執行 'openape auth login' 進行登入。");
+            log.info(`Session 預期位置: ${sessionPath}`);
+            return null;
+        }
+        // Try to load WS token
+        const wsToken = loadWsToken(sessionPath);
+        if (!wsToken) {
+            log.error("未找到 WS token。請先執行 'openape auth login' 進行登入。");
+            return null;
+        }
+        return {
+            log,
+            session: {
+                wsToken,
+                moodleBaseUrl: "https://ilearning.cycu.edu.tw",
+            },
+        };
+    }
+    // Helper function to create session context (for open command only)
+    async function createSessionContext(options, command) {
+        const opts = command?.optsWithGlobals ? command.optsWithGlobals() : options;
+        const outputFormat = getOutputFormat(command || { optsWithGlobals: () => ({ output: "json" }) });
+        const silent = outputFormat === "json" && !opts.verbose;
+        const log = createLogger(opts.verbose, silent);
+        const baseDir = getBaseDir();
+        const sessionPath = path.resolve(baseDir, ".auth", "storage-state.json");
+        if (!fs.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 launchAuthenticated(config, log);
+        try {
+            const session = await 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);
+        const apiContext = await createApiContext(options, command);
+        if (!apiContext) {
+            process.exitCode = 1;
+            return;
+        }
+        const quizzes = await getQuizzesByCoursesApi(apiContext.session, [parseInt(courseId, 10)]);
+        // Note: API doesn't provide completion status, so --available-only shows all
+        if (options.availableOnly) {
+            apiContext.log.warn("--available-only is not supported in API mode, showing all quizzes");
+        }
+        formatAndOutput(quizzes, output, apiContext.log);
+    });
+    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);
+        const apiContext = await createApiContext(options, command);
+        if (!apiContext) {
+            process.exitCode = 1;
+            return;
+        }
+        const classification = options.level === "all" ? undefined : "inprogress";
+        const courses = await getEnrolledCoursesApi(apiContext.session, {
+            classification,
+        });
+        // Get quizzes via WS API (no browser needed!)
+        const courseIds = courses.map(c => c.id);
+        const apiQuizzes = await 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} 個測驗。`);
+        formatAndOutput(allQuizzes, output, apiContext.log);
+    });
+    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 closeBrowserSafely(browser, browserContext);
+        }
+    });
+}

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

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerSkillsCommand(program: Command): void;
+//# sourceMappingURL=skills.d.ts.map

package/esm/src/commands/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../src/src/commands/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6CpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0E5D"}