@mo7yw4ng/openape 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MO7YW4NG
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,97 @@
+# OpenApe CLI (Unofficial)
+
+中原大學 [i-Learning](https://ilearning.cycu.edu.tw/) (Moodle) 平台自動化命令列工具 (CLI)，幫助你快速查詢課程、觀看影片、下載教材。
+
+## 功能特色
+- 📚 **課程資訊**：列出修課清單、成績、課程大綱與進度。
+- 📺 **影片輔助**：列出/下載影片，甚至自動標記為已觀看。
+- 📝 **測驗與教材**：快速查看測驗、下載教材。
+- 💬 **討論區與公告**：在終端機直接閱讀公告與討論區。
+- 📅 **行事曆**：內建行事曆事件查詢與匯出。
+- 🤖 **Agent Skills**：提供 Claude Code 等 Skills 工作流支援。
+
+## 安裝
+
+透過 npm 安裝（[Node.js v18+](https://nodejs.org/)）：
+```bash
+npm install -g openape
+```
+
+## 核心指令
+
+### 登入與驗證 (Authentication)
+第一次使用需要登入，會開啟瀏覽器讓你手動完成登入，隨後會快取 Session 供未來使用。
+```bash
+openape login          # 登入並儲存 session (開啟瀏覽器)
+openape auth status    # 檢查當前登入狀態
+openape auth logout    # 登出並清除 session
+```
+
+### 課程 (Courses)
+```bash
+openape courses list               # 列出所有課程 (支援 --incomplete-only, --level)
+openape courses info <id>          # 顯示特定課程的詳細資訊
+openape courses progress <id>      # 顯示特定課程的進度
+openape courses syllabus <id>      # 顯示課程大綱
+```
+
+### 影片 (Videos)
+```bash
+openape videos list <course-id>      # 列出課程中的影片
+openape videos complete <id>         # 標記特定影片為已觀看
+openape videos complete-all <id>     # 影片批次完成
+openape videos download <id>         # 下載影片
+```
+
+### 測驗與教材 (Quizzes & Materials)
+```bash
+openape quizzes list <course-id>     # 列出特定課程測驗
+openape quizzes list-all             # 列出所有課程測驗
+openape quizzes open <id>            # 開啟特定測驗
+openape materials list-all           # 列出所有可下載教材
+openape materials download <id>      # 下載指定教材
+openape materials download-all       # 批次下載教材
+```
+
+### 成績與其他查詢 (Grades, Forums, Calendar)
+```bash
+openape grades summary               # 顯示學期成績總覽
+openape grades course <id>           # 顯示特定課程成績
+openape forums list <course-id>      # 列出課程論壇
+openape announcements list-all       # 列出所有公告
+openape announcements read <id>      # 閱讀特定公告
+openape calendar events              # 查詢行事曆事件
+openape calendar export              # 匯出事件
+```
+
+### Skills
+讓你的 AI Agent 也可以控制 OpenApe。只需一個指令即可安裝：
+```bash
+openape skills list                  # 查看目前提供的所有 skills
+openape skills install claude        # 為 Claude Code 安裝技能 (支援 claude, codex, opencode)
+openape skills install --all         # 自動偵測環境並安裝給所有支援的 Agent
+```
+也可以透過 `npx skills` 安裝：
+```bash
+npx skills add openape/openape
+```
+
+## 開發
+
+專案使用 [Deno](https://deno.land/) 開發，歡迎一同貢獻：
+
+```bash
+git clone https://github.com/mo7yw4ng/openape && cd openape
+
+# 啟動開發伺服器 (將直接執行 src/index.ts)
+deno task dev
+
+# 編譯成各平台執行檔 (預設輸出到 dist/OpenApe.exe)
+deno task compile
+```
+
+## 版權與授權
+
+此專案之版權規範採用 **MIT License** - 至 [LICENSE](LICENSE) 查看更多相關聲明
+
+> **免責聲明**：本工具為非官方開放原始碼專案，與中原大學官方無關。請斟酌使用腳本輔助功能，避免不當操作（如短時間發送大量請求修改系統狀態）而違反學術倫理或導致帳號遭封鎖。

package/esm/_dnt.polyfills.d.ts

@@ -0,0 +1,24 @@
+declare global {
+    interface ImportMeta {
+        /** A flag that indicates if the current module is the main module that was
+         * called when starting the program under Deno.
+         *
+         * ```ts
+         * if (import.meta.main) {
+         *   // this was loaded as the main module, maybe do some bootstrapping
+         * }
+         * ```
+         */
+        main: boolean;
+        /** A function that returns resolved specifier as if it would be imported
+         * using `import(specifier)`.
+         *
+         * ```ts
+         * console.log(import.meta.resolve("./foo.js"));
+         * // file:///dev/foo.js
+         * ```
+         */
+        resolve(specifier: string): string;
+    }
+}
+export {};

package/esm/_dnt.polyfills.js

@@ -0,0 +1 @@
+export {};

package/esm/_dnt.shims.d.ts

@@ -0,0 +1,5 @@
+import { Deno } from "@deno/shim-deno";
+export { Deno } from "@deno/shim-deno";
+export declare const dntGlobalThis: Omit<typeof globalThis, "Deno"> & {
+    Deno: typeof Deno;
+};

package/esm/_dnt.shims.js

@@ -0,0 +1,61 @@
+import { Deno } from "@deno/shim-deno";
+export { Deno } from "@deno/shim-deno";
+const dntGlobals = {
+    Deno,
+};
+export const dntGlobalThis = createMergeProxy(globalThis, dntGlobals);
+function createMergeProxy(baseObj, extObj) {
+    return new Proxy(baseObj, {
+        get(_target, prop, _receiver) {
+            if (prop in extObj) {
+                return extObj[prop];
+            }
+            else {
+                return baseObj[prop];
+            }
+        },
+        set(_target, prop, value) {
+            if (prop in extObj) {
+                delete extObj[prop];
+            }
+            baseObj[prop] = value;
+            return true;
+        },
+        deleteProperty(_target, prop) {
+            let success = false;
+            if (prop in extObj) {
+                delete extObj[prop];
+                success = true;
+            }
+            if (prop in baseObj) {
+                delete baseObj[prop];
+                success = true;
+            }
+            return success;
+        },
+        ownKeys(_target) {
+            const baseKeys = Reflect.ownKeys(baseObj);
+            const extKeys = Reflect.ownKeys(extObj);
+            const extKeysSet = new Set(extKeys);
+            return [...baseKeys.filter((k) => !extKeysSet.has(k)), ...extKeys];
+        },
+        defineProperty(_target, prop, desc) {
+            if (prop in extObj) {
+                delete extObj[prop];
+            }
+            Reflect.defineProperty(baseObj, prop, desc);
+            return true;
+        },
+        getOwnPropertyDescriptor(_target, prop) {
+            if (prop in extObj) {
+                return Reflect.getOwnPropertyDescriptor(extObj, prop);
+            }
+            else {
+                return Reflect.getOwnPropertyDescriptor(baseObj, prop);
+            }
+        },
+        has(_target, prop) {
+            return prop in extObj || prop in baseObj;
+        },
+    });
+}

package/esm/deno.d.ts

@@ -0,0 +1,23 @@
+declare namespace _default {
+    let name: string;
+    let version: string;
+    let description: string;
+    let license: string;
+    let exports: string;
+    let tasks: {
+        dev: string;
+        compile: string;
+        "build:npm": string;
+    };
+    let imports: {
+        commander: string;
+        "playwright-core": string;
+        "node-html-parser": string;
+    };
+    let nodeModulesDir: string;
+    namespace compilerOptions {
+        let lib: string[];
+    }
+    let unstable: string[];
+}
+export default _default;

package/esm/deno.js

@@ -0,0 +1,22 @@
+export default {
+    "name": "@openape/openape",
+    "version": "1.0.0",
+    "description": "CLI tool for CYCU i-Learning platform",
+    "license": "MIT",
+    "exports": "./src/index.ts",
+    "tasks": {
+        "dev": "deno run --allow-all --sloppy-imports --watch src/index.ts",
+        "compile": "deno compile --allow-all --no-check --sloppy-imports --output dist/OpenApe.exe src/index.ts",
+        "build:npm": "deno run -A src/build_npm.ts"
+    },
+    "imports": {
+        "commander": "npm:commander@^12.1.0",
+        "playwright-core": "npm:playwright-core@^1.48.0",
+        "node-html-parser": "npm:node-html-parser@^6.1.13"
+    },
+    "nodeModulesDir": "auto",
+    "compilerOptions": {
+        "lib": ["ES2022", "DOM", "deno.ns"]
+    },
+    "unstable": ["sloppy-imports"]
+};

package/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@mo7yw4ng/openape",
+  "version": "1.0.0",
+  "description": "CLI tool for CYCU i-Learning platform",
+  "keywords": [
+    "ilearning",
+    "cycu",
+    "cli",
+    "headless",
+    "automation",
+    "playwright"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mo7yw4ng/openape.git"
+  },
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/mo7yw4ng/openape/issues"
+  },
+  "bin": {
+    "openape": "./script/src/index.js"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@deno/shim-deno": "~0.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.9.0"
+  },
+  "_generatedBy": "dnt@0.40.0"
+}

package/script/_dnt.polyfills.d.ts

@@ -0,0 +1,24 @@
+declare global {
+    interface ImportMeta {
+        /** A flag that indicates if the current module is the main module that was
+         * called when starting the program under Deno.
+         *
+         * ```ts
+         * if (import.meta.main) {
+         *   // this was loaded as the main module, maybe do some bootstrapping
+         * }
+         * ```
+         */
+        main: boolean;
+        /** A function that returns resolved specifier as if it would be imported
+         * using `import(specifier)`.
+         *
+         * ```ts
+         * console.log(import.meta.resolve("./foo.js"));
+         * // file:///dev/foo.js
+         * ```
+         */
+        resolve(specifier: string): string;
+    }
+}
+export {};

package/script/_dnt.polyfills.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/script/_dnt.shims.d.ts

@@ -0,0 +1,5 @@
+import { Deno } from "@deno/shim-deno";
+export { Deno } from "@deno/shim-deno";
+export declare const dntGlobalThis: Omit<typeof globalThis, "Deno"> & {
+    Deno: typeof Deno;
+};

package/script/_dnt.shims.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dntGlobalThis = exports.Deno = void 0;
+const shim_deno_1 = require("@deno/shim-deno");
+var shim_deno_2 = require("@deno/shim-deno");
+Object.defineProperty(exports, "Deno", { enumerable: true, get: function () { return shim_deno_2.Deno; } });
+const dntGlobals = {
+    Deno: shim_deno_1.Deno,
+};
+exports.dntGlobalThis = createMergeProxy(globalThis, dntGlobals);
+function createMergeProxy(baseObj, extObj) {
+    return new Proxy(baseObj, {
+        get(_target, prop, _receiver) {
+            if (prop in extObj) {
+                return extObj[prop];
+            }
+            else {
+                return baseObj[prop];
+            }
+        },
+        set(_target, prop, value) {
+            if (prop in extObj) {
+                delete extObj[prop];
+            }
+            baseObj[prop] = value;
+            return true;
+        },
+        deleteProperty(_target, prop) {
+            let success = false;
+            if (prop in extObj) {
+                delete extObj[prop];
+                success = true;
+            }
+            if (prop in baseObj) {
+                delete baseObj[prop];
+                success = true;
+            }
+            return success;
+        },
+        ownKeys(_target) {
+            const baseKeys = Reflect.ownKeys(baseObj);
+            const extKeys = Reflect.ownKeys(extObj);
+            const extKeysSet = new Set(extKeys);
+            return [...baseKeys.filter((k) => !extKeysSet.has(k)), ...extKeys];
+        },
+        defineProperty(_target, prop, desc) {
+            if (prop in extObj) {
+                delete extObj[prop];
+            }
+            Reflect.defineProperty(baseObj, prop, desc);
+            return true;
+        },
+        getOwnPropertyDescriptor(_target, prop) {
+            if (prop in extObj) {
+                return Reflect.getOwnPropertyDescriptor(extObj, prop);
+            }
+            else {
+                return Reflect.getOwnPropertyDescriptor(baseObj, prop);
+            }
+        },
+        has(_target, prop) {
+            return prop in extObj || prop in baseObj;
+        },
+    });
+}

package/script/deno.d.ts

@@ -0,0 +1,23 @@
+declare namespace _default {
+    let name: string;
+    let version: string;
+    let description: string;
+    let license: string;
+    let exports: string;
+    let tasks: {
+        dev: string;
+        compile: string;
+        "build:npm": string;
+    };
+    let imports: {
+        commander: string;
+        "playwright-core": string;
+        "node-html-parser": string;
+    };
+    let nodeModulesDir: string;
+    namespace compilerOptions {
+        let lib: string[];
+    }
+    let unstable: string[];
+}
+export default _default;

package/script/deno.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = {
+    "name": "@openape/openape",
+    "version": "1.0.0",
+    "description": "CLI tool for CYCU i-Learning platform",
+    "license": "MIT",
+    "exports": "./src/index.ts",
+    "tasks": {
+        "dev": "deno run --allow-all --sloppy-imports --watch src/index.ts",
+        "compile": "deno compile --allow-all --no-check --sloppy-imports --output dist/OpenApe.exe src/index.ts",
+        "build:npm": "deno run -A src/build_npm.ts"
+    },
+    "imports": {
+        "commander": "npm:commander@^12.1.0",
+        "playwright-core": "npm:playwright-core@^1.48.0",
+        "node-html-parser": "npm:node-html-parser@^6.1.13"
+    },
+    "nodeModulesDir": "auto",
+    "compilerOptions": {
+        "lib": ["ES2022", "DOM", "deno.ns"]
+    },
+    "unstable": ["sloppy-imports"]
+};

package/script/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

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

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