@mo7yw4ng/openape 1.0.3 → 1.0.4

package/README.md

@@ -8,9 +8,10 @@
 ## 功能特色
 - 📚 **課程資訊**：列出修課清單、成績、課程大綱與進度。
 - 📺 **影片輔助**：列出/下載影片，甚至自動標記為已觀看。
-- 📝 **測驗與教材**：快速查看測驗、下載教材。
-- 💬 **討論區與公告**：閱讀公告與討論區。
+- 📝 **測驗與教材**：快速進行測驗、下載教材。
+- 💬 **討論區與公告**：閱讀公告、討論區、發表回覆。
 - 📅 **行事曆**：內建行事曆事件查詢與匯出。
+- ✅ **作業繳交**：查詢作業、檢查繳交狀態、上傳檔案並繳交。
 - 🤖 **Agent Skills**：提供 Claude Code 等 Skills 工作流支援。
 
 ## 安裝
@@ -60,27 +61,51 @@ openape videos download <id>         # 下載影片
 ```bash
 openape quizzes list <course-id>     # 列出特定課程測驗
 openape quizzes list-all             # 列出所有課程測驗
-openape quizzes open <id>            # 開啟特定測驗
+openape quizzes start <quiz-id>      # 開始測驗
+openape quizzes info <attempt-id>    # 查看測驗題目
+openape quizzes save <attempt-id> '<answers>' # 儲存測驗答案
 openape materials list-all           # 列出所有可下載教材
 openape materials download <id>      # 下載指定教材
 openape materials download-all       # 批次下載教材
+openape materials complete <id>      # 標記教材為已完成
+openape materials complete-all       # 批次標記教材為已完成
 ```
 
 ### 成績與其他查詢 (Grades, Forums, Calendar)
 ```bash
 openape grades summary               # 顯示學期成績總覽
 openape grades course <id>           # 顯示特定課程成績
-openape forums list <course-id>      # 列出課程論壇
+openape forums list                  # 列出進行中課程的討論區
+openape forums list-all              # 列出所有討論區
+openape forums discussions <forum-id>      # 列出討論區中的討論串
+openape forums posts <discussion-id>       # 列出討論串中的貼文
+openape forums reply <post-id> <subject> <message>  # 回覆貼文
+openape forums post <forum-id> <subject> <message>  # 發起新討論
+openape forums delete <post-id>      # 刪除討論貼文
 openape announcements list-all       # 列出所有公告
 openape announcements read <id>      # 閱讀特定公告
 openape calendar events              # 查詢行事曆事件
 openape calendar export              # 匯出事件
 ```
 
+### 作業與檔案上傳 (Assignments & Upload)
+```bash
+# 作業查詢與繳交
+openape assignments list <course-id>       # 列出課程作業
+openape assignments list-all               # 列出所有作業 (支援 --level all)
+openape assignments status <assignment-id> # 檢查作業繳交狀態
+openape assignments submit <assignment-id> # 繳交作業
+  --text "內容"                            # 線上文字繳交
+  --file-id <draft-id>                     # 使用已上傳的檔案 ID
+  --file <path>                            # 直接上傳檔案並繳交
+
+# 檔案上傳至草稿區
+openape upload file <path>                 # 上傳檔案取得 draft ID
+```
+
 ### Skills
 讓你的 AI Agent 也可以控制 OpenApe。只需一個指令即可安裝：
 ```bash
-openape skills list                  # 查看目前提供的所有 skills
 openape skills install claude        # 為 Claude Code 安裝技能 (支援 claude, codex, opencode)
 openape skills install --all         # 自動偵測環境並安裝給所有支援的 Agent
 ```

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "@openape/openape",
-    "version": "1.0.3",
+    "version": "1.0.4",
     "description": "CLI tool for CYCU i-Learning platform",
     "license": "MIT",
     "exports": "./src/index.ts",

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

@@ -1 +1 @@
-{"version":3,"file":"announcements.d.ts","sourceRoot":"","sources":["../../../src/src/commands/announcements.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqBpC,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqJnE"}
+{"version":3,"file":"announcements.d.ts","sourceRoot":"","sources":["../../../src/src/commands/announcements.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqBpC,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoJnE"}

package/esm/src/commands/announcements.js

@@ -1,4 +1,4 @@
-import { getBaseDir } from "../lib/utils.js";
+import { getBaseDir, formatTimestamp } from "../lib/utils.js";
 import { getSiteInfoApi, getMessagesApi, getDiscussionPostsApi } from "../lib/moodle.js";
 import { createLogger } from "../lib/logger.js";
 import { loadWsToken } from "../lib/token.js";
@@ -77,27 +77,26 @@ export function registerAnnouncementsCommand(program) {
         allAnnouncements.sort((a, b) => b.createdAt - a.createdAt);
         // Apply limit
         let filteredAnnouncements = allAnnouncements.slice(0, limit);
-        const output = {
+        console.log(JSON.stringify({
             status: "success",
             timestamp: new Date().toISOString(),
             level: options.level,
-            announcements: filteredAnnouncements.map(a => ({
+            total_announcements: allAnnouncements.length,
+            shown: filteredAnnouncements.length,
+        }));
+        for (const a of filteredAnnouncements) {
+            console.log(JSON.stringify({
                 course_id: a.course_id,
                 course_name: a.course_name,
                 id: a.id,
                 subject: a.subject,
                 author: a.author,
                 author_id: a.authorId,
-                created_at: new Date(a.createdAt * 1000).toISOString(),
-                modified_at: new Date(a.modifiedAt * 1000).toISOString(),
+                created_at: formatTimestamp(a.createdAt),
+                modified_at: formatTimestamp(a.modifiedAt),
                 unread: a.unread,
-            })),
-            summary: {
-                total_announcements: allAnnouncements.length,
-                shown: filteredAnnouncements.length,
-            },
-        };
-        console.log(JSON.stringify(output));
+            }));
+        }
     });
     announcementsCmd
         .command("read")
@@ -125,8 +124,8 @@ export function registerAnnouncementsCommand(program) {
                 subject: firstPost.subject,
                 author: firstPost.author,
                 author_id: firstPost.authorId,
-                created_at: new Date(firstPost.created * 1000).toISOString(),
-                modified_at: new Date(firstPost.modified * 1000).toISOString(),
+                created_at: formatTimestamp(firstPost.created),
+                modified_at: formatTimestamp(firstPost.modified),
                 message: firstPost.message,
             },
         };

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

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

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

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

package/esm/src/commands/assignments.js

@@ -0,0 +1,230 @@
+import { getOutputFormat, formatFileSize, formatMoodleDate } from "../lib/utils.js";
+import { getEnrolledCoursesApi, getAssignmentsByCoursesApi, getSubmissionStatusApi, saveSubmissionApi, uploadFileApi } from "../lib/moodle.js";
+import { createApiContext } from "../lib/auth.js";
+import { formatAndOutput } from "../index.js";
+import path from "node:path";
+import fs from "node:fs/promises";
+export function registerAssignmentsCommand(program) {
+    const assignmentsCmd = program.command("assignments");
+    assignmentsCmd.description("Assignment operations");
+    assignmentsCmd
+        .command("list")
+        .description("List assignments in a 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 apiAssignments = await getAssignmentsByCoursesApi(apiContext.session, [parseInt(courseId, 10)]);
+        const assignments = apiAssignments.map(a => ({
+            id: a.id,
+            courseName: courseId,
+            name: a.name,
+            url: a.url,
+            cmid: a.cmid,
+            duedate: formatMoodleDate(a.duedate),
+            cutoffdate: formatMoodleDate(a.cutoffdate),
+            allowSubmissionsFromDate: formatMoodleDate(a.allowSubmissionsFromDate),
+        }));
+        apiContext.log.info(`\n找到 ${assignments.length} 個作業。`);
+        formatAndOutput(assignments, output, apiContext.log);
+    });
+    assignmentsCmd
+        .command("list-all")
+        .description("List all assignments 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 assignments via WS API (no browser needed!)
+        const courseIds = courses.map(c => c.id);
+        const apiAssignments = await getAssignmentsByCoursesApi(apiContext.session, courseIds);
+        // Build a map of courseId -> course for quick lookup
+        const courseMap = new Map(courses.map(c => [c.id, c]));
+        const allAssignments = [];
+        for (const a of apiAssignments) {
+            const course = courseMap.get(a.courseId);
+            if (course) {
+                allAssignments.push({
+                    id: a.id,
+                    courseName: course.fullname,
+                    name: a.name,
+                    url: a.url,
+                    cmid: a.cmid,
+                    duedate: formatMoodleDate(a.duedate),
+                    cutoffdate: formatMoodleDate(a.cutoffdate),
+                    allowSubmissionsFromDate: formatMoodleDate(a.allowSubmissionsFromDate),
+                });
+            }
+        }
+        apiContext.log.info(`\n總計發現 ${allAssignments.length} 個作業。`);
+        formatAndOutput(allAssignments, output, apiContext.log);
+    });
+    // ── Submission Status ───────────────────────────────────────────────────────
+    assignmentsCmd
+        .command("status")
+        .description("Check assignment submission status")
+        .argument("<assignment-id>", "Assignment instance ID (from list-all)")
+        .option("--output <format>", "Output format: json|csv|table|silent")
+        .action(async (assignmentId, options, command) => {
+        const output = getOutputFormat(command);
+        const apiContext = await createApiContext(options, command);
+        if (!apiContext) {
+            process.exitCode = 1;
+            return;
+        }
+        const id = parseInt(assignmentId, 10);
+        apiContext.log.info("檢查繳交狀態...");
+        const status = await getSubmissionStatusApi(apiContext.session, id);
+        // Build status data object
+        const statusData = {
+            submitted: status.submitted,
+            submitted_text: status.submitted ? "已繳交" : "尚未繳交",
+            graded: status.graded,
+            graded_text: status.graded ? "已評分" : "尚未評分",
+            last_modified: status.lastModified ? new Date(status.lastModified * 1000).toISOString() : null,
+            last_modified_text: status.lastModified ? new Date(status.lastModified * 1000).toLocaleString("zh-TW") : null,
+            grader: status.grader,
+            grade: status.grade,
+            feedback: status.feedback,
+            files: status.extensions.map(f => ({
+                filename: f.filename,
+                filesize: f.filesize,
+                filesize_kb: formatFileSize(f.filesize),
+            })),
+        };
+        formatAndOutput(statusData, output, apiContext.log);
+    });
+    // ── Submit Assignment ────────────────────────────────────────────────────────
+    assignmentsCmd
+        .command("submit")
+        .description("Submit an assignment (online text or file)")
+        .argument("<assignment-id>", "Assignment instance ID (from list-all)")
+        .option("--text <content>", "Online text content to submit")
+        .option("--file-id <id>", "Draft file ID from file upload")
+        .option("--file <path>", "Upload and submit a file directly")
+        .option("--output <format>", "Output format: json|csv|table|silent")
+        .action(async (assignmentId, options, command) => {
+        const output = getOutputFormat(command);
+        const apiContext = await createApiContext(options, command);
+        if (!apiContext) {
+            process.exitCode = 1;
+            return;
+        }
+        const id = parseInt(assignmentId, 10);
+        // Check submission status first
+        const status = await getSubmissionStatusApi(apiContext.session, id);
+        let fileUploaded;
+        let cancelled = false;
+        if (status.submitted) {
+            const confirm = await promptConfirm("此作業已經繳交！確定要重新繳交嗎？(y/N): ");
+            if (!confirm) {
+                cancelled = true;
+            }
+        }
+        if (cancelled) {
+            const cancelResult = {
+                success: false,
+                cancelled: true,
+                message: "Submission cancelled by user",
+            };
+            formatAndOutput(cancelResult, output, apiContext.log);
+            return;
+        }
+        // Validate options
+        if (!options.text && !options.fileId && !options.file) {
+            const errorResult = {
+                success: false,
+                error: "請提供 --text、--file-id 或 --file 選項。",
+            };
+            formatAndOutput(errorResult, output, apiContext.log);
+            process.exitCode = 1;
+            return;
+        }
+        let fileId = options.fileId ? parseInt(options.fileId, 10) : undefined;
+        // Upload file if --file option is provided
+        if (options.file) {
+            const resolvedPath = path.resolve(options.file);
+            // Check if file exists
+            try {
+                await fs.access(resolvedPath);
+            }
+            catch {
+                const errorResult = {
+                    success: false,
+                    error: `檔案不存在: ${options.file}`,
+                };
+                formatAndOutput(errorResult, output, apiContext.log);
+                process.exitCode = 1;
+                return;
+            }
+            const stats = await fs.stat(resolvedPath);
+            const fileSizeKB = formatFileSize(stats.size);
+            const uploadResult = await uploadFileApi(apiContext.session, resolvedPath);
+            if (!uploadResult.success) {
+                const errorResult = {
+                    success: false,
+                    error: `檔案上傳失敗: ${uploadResult.error}`,
+                };
+                formatAndOutput(errorResult, output, apiContext.log);
+                process.exitCode = 1;
+                return;
+            }
+            fileId = uploadResult.draftId;
+            fileUploaded = {
+                filename: path.basename(resolvedPath),
+                filesize: stats.size,
+                filesize_kb: formatFileSize(stats.size),
+                draft_id: fileId,
+            };
+        }
+        // Submit
+        const result = await saveSubmissionApi(apiContext.session, id, {
+            onlineText: options.text ? { text: options.text } : undefined,
+            fileId: fileId,
+        });
+        const submitResult = {
+            success: result.success,
+            assignment_id: id,
+            submitted: !!result.success,
+            online_text: !!options.text,
+            file_uploaded: fileUploaded,
+            file_id: fileId ?? null,
+            error: result.success ? undefined : result.error,
+            message: result.success ? "Assignment submitted successfully" : result.error,
+        };
+        formatAndOutput(submitResult, output, apiContext.log);
+        if (!result.success) {
+            process.exitCode = 1;
+        }
+    });
+}
+/**
+ * Prompt user for yes/no confirmation.
+ */
+async function promptConfirm(prompt) {
+    const readline = await import("node:readline");
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question(prompt, (answer) => {
+            rl.close();
+            resolve(/^y/i.test(answer));
+        });
+    });
+}

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

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/src/commands/auth.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoQtD"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/src/commands/auth.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuRtD"}

package/esm/src/commands/auth.js

@@ -2,7 +2,8 @@ import { getBaseDir } from "../lib/utils.js";
 import { chromium } from "playwright-core";
 import { createLogger } from "../lib/logger.js";
 import { findEdgePath } from "../lib/auth.js";
-import { saveSesskey, acquireWsToken, saveWsToken } from "../lib/token.js";
+import { saveSesskey, acquireWsToken, saveWsToken, loadWsToken } from "../lib/token.js";
+import { getSiteInfoApi } from "../lib/moodle.js";
 import path from "node:path";
 import fs from "node:fs";
 export function registerCommand(program) {
@@ -211,6 +212,25 @@ export function registerCommand(program) {
                         exists: false
                     }
                 };
+                // Try to get user info from WS API
+                try {
+                    const wsToken = loadWsToken(sessionPath);
+                    if (wsToken) {
+                        const session = {
+                            wsToken,
+                            moodleBaseUrl: "https://ilearning.cycu.edu.tw"
+                        };
+                        const siteInfo = await getSiteInfoApi(session);
+                        result.user = {
+                            userid: siteInfo.userid,
+                            username: siteInfo.username,
+                            fullname: siteInfo.fullname
+                        };
+                    }
+                }
+                catch {
+                    // WS token might not be available or expired, skip user info
+                }
                 console.log(JSON.stringify(result, null, 2));
             }
             catch {

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

@@ -1 +1 @@
-{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../../src/src/commands/calendar.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoM9D"}
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../../src/src/commands/calendar.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmM9D"}

package/esm/src/commands/calendar.js

@@ -1,4 +1,4 @@
-import { getBaseDir } from "../lib/utils.js";
+import { getBaseDir, formatTimestamp } from "../lib/utils.js";
 import { getEnrolledCoursesApi, getCalendarEventsApi } from "../lib/moodle.js";
 import { createLogger } from "../lib/logger.js";
 import { loadWsToken } from "../lib/token.js";
@@ -91,29 +91,28 @@ export function registerCalendarCommand(program) {
         if (options.upcoming) {
             filteredEvents = allEvents.filter(e => e.timestart > now);
         }
-        const output = {
+        console.log(JSON.stringify({
             status: "success",
             timestamp: new Date().toISOString(),
-            events: filteredEvents.map(e => ({
+            total_events: allEvents.length,
+            upcoming: allEvents.filter(e => e.timestart > now).length,
+            by_type: allEvents.reduce((acc, e) => {
+                acc[e.eventtype] = (acc[e.eventtype] || 0) + 1;
+                return acc;
+            }, {}),
+        }));
+        for (const e of filteredEvents) {
+            console.log(JSON.stringify({
                 id: e.id,
                 name: e.name,
                 description: e.description,
                 course_id: e.courseid,
                 event_type: e.eventtype,
-                start_time: new Date(e.timestart).toISOString(),
-                end_time: e.timeduration ? new Date(e.timestart + e.timeduration / 1000).toISOString() : null,
+                start_time: formatTimestamp(e.timestart),
+                end_time: e.timeduration ? formatTimestamp(e.timestart + Math.floor(e.timeduration / 1000)) : null,
                 location: e.location,
-            })),
-            summary: {
-                total_events: allEvents.length,
-                upcoming: allEvents.filter(e => e.timestart > now).length,
-                by_type: allEvents.reduce((acc, e) => {
-                    acc[e.eventtype] = (acc[e.eventtype] || 0) + 1;
-                    return acc;
-                }, {}),
-            },
-        };
-        console.log(JSON.stringify(output));
+            }));
+        }
     });
     calendarCmd
         .command("export")
@@ -161,8 +160,8 @@ export function registerCalendarCommand(program) {
                 description: e.description,
                 course_id: e.courseid,
                 event_type: e.eventtype,
-                start_time: new Date(e.timestart).toISOString(),
-                end_time: e.timeduration ? new Date(e.timestart + e.timeduration / 1000).toISOString() : null,
+                start_time: formatTimestamp(e.timestart),
+                end_time: e.timeduration ? formatTimestamp(e.timestart + Math.floor(e.timeduration / 1000)) : null,
                 location: e.location,
             })),
             summary: {

package/esm/src/commands/courses.js

@@ -1,4 +1,4 @@
-import { getBaseDir } from "../lib/utils.js";
+import { getBaseDir, formatTimestamp } from "../lib/utils.js";
 import { getEnrolledCoursesApi } from "../lib/moodle.js";
 import { createLogger } from "../lib/logger.js";
 import { loadWsToken } from "../lib/token.js";
@@ -111,8 +111,8 @@ export function registerCoursesCommand(program) {
             courseId: course.id,
             courseName: course.fullname,
             progress: course.progress ?? 0,
-            startDate: course.startdate ? new Date(course.startdate * 1000).toISOString() : null,
-            endDate: course.enddate ? new Date(course.enddate * 1000).toISOString() : null,
+            startDate: course.startdate ? formatTimestamp(course.startdate) : null,
+            endDate: course.enddate ? formatTimestamp(course.enddate) : null,
         };
         formatAndOutput(progressData, output, apiContext.log);
     });

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

@@ -1 +1 @@
-{"version":3,"file":"forums.d.ts","sourceRoot":"","sources":["../../../src/src/commands/forums.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6P5D"}
+{"version":3,"file":"forums.d.ts","sourceRoot":"","sources":["../../../src/src/commands/forums.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmBpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkX5D"}