tronclass-auto 1.0.0

package/README.md

@@ -0,0 +1,75 @@
+# tronclass-auto
+
+自動觀看 eclass / TronClass 影片、填寫表單的 CLI 工具。
+
+## 安裝
+
+```bash
+npm install -g tronclass-auto
+```
+
+## 使用方法
+
+### 自動登入取得 Cookie
+
+```bash
+tronclass login
+```
+
+會自動開啟瀏覽器，手動登入後 Cookie 自動儲存。
+
+### 手動匯入 Cookie
+
+```bash
+tronclass import-cookies "session=xxx; key=value; ..."
+```
+
+### 開始自動觀看
+
+```bash
+tronclass run
+```
+
+### 查看進度
+
+```bash
+tronclass status
+```
+
+### 查看設定
+
+```bash
+tronclass config
+```
+
+## 設定檔
+
+設定檔位於 `~/.eclass-auto/config.json`：
+
+```json
+{
+  "headless": false,
+  "slowMo": 50,
+  "playbackRate": 2,
+  "courses": [
+    "https://eclass.yuntech.edu.tw/course/127331/content#/",
+    "https://eclass.yuntech.edu.tw/course/127343/content#/"
+  ]
+}
+```
+
+## 功能
+
+- 自動偵測已完成 / 未完成的活動
+- 影片 2 倍速 + 靜音播放
+- 已看完的自動跳過，不重複觀看
+- 中斷後重跑自動接續進度（本地 progress.json）
+- 跳過考試，只處理影片
+- 自動登入取得 Cookie（`tronclass login`）
+- Buffering 自動等待、暫停自動重播
+
+## 注意事項
+
+- Cookie 過期後需重新執行 `tronclass login`
+- 自動化工具可能違反學校使用條款，請自行評估
+- 建議先在測試課程驗證功能

package/bin/eclass.js

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+
+const { program } = require('commander');
+const path = require('path');
+
+const pkg = require('../package.json');
+
+program
+  .name('tronclass')
+  .description('自動觀看 eclass/TronClass 影片、填寫表單')
+  .version(pkg.version);
+
+program
+  .command('login')
+  .description('自動開啟瀏覽器登入，完成後自動取得 Cookie')
+  .option('--url <url>', '登入頁面網址', 'https://eclass.yuntech.edu.tw')
+  .action(async (opts) => {
+    const { autoLogin } = require('../src/auth');
+    await autoLogin(opts.url);
+  });
+
+program
+  .command('import-cookies <cookieString>')
+  .alias('ic')
+  .description('手動匯入 Cookie 字串')
+  .action(async (cookieString) => {
+    const { importCookies } = require('../src/auth');
+    importCookies(cookieString);
+  });
+
+program
+  .command('run')
+  .description('開始自動觀看影片')
+  .option('--headless', '無頭模式執行', false)
+  .option('--course <ids>', '指定課程 ID（逗號分隔）', '')
+  .action(async (opts) => {
+    const { run } = require('../src/index');
+    await run(opts);
+  });
+
+program
+  .command('status')
+  .description('查看各課程進度統計')
+  .action(async () => {
+    const { showStatus } = require('../src/index');
+    await showStatus();
+  });
+
+program
+  .command('config')
+  .description('顯示目前設定')
+  .action(() => {
+    const { showConfig } = require('../src/config');
+    showConfig();
+  });
+
+program.parse();

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "tronclass-auto",
+  "version": "1.0.0",
+  "description": "自動觀看 eclass/TronClass 影片、填寫表單的 CLI 工具",
+  "main": "src/index.js",
+  "bin": {
+    "tronclass": "./bin/eclass.js"
+  },
+  "scripts": {
+    "start": "node bin/eclass.js run"
+  },
+  "keywords": ["eclass", "tronclass", "yuntech", "automation", "video"],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "playwright": "^1.40.0",
+    "commander": "^12.0.0",
+    "chalk": "^4.1.2",
+    "open": "^8.4.2"
+  }
+}

package/src/auth.js

@@ -0,0 +1,133 @@
+const fs = require('fs');
+const crypto = require('crypto');
+const chalk = require('chalk');
+const { COOKIE_FILE, SALT_FILE, ensureDir, BASE_URL } = require('./config');
+
+function getKey(password, salt) {
+  return crypto.pbkdf2Sync(password, salt, 480000, 32, 'sha256');
+}
+
+function saveCookies(cookies, password = 'eclass-local-key') {
+  ensureDir();
+  let salt;
+  if (fs.existsSync(SALT_FILE)) {
+    salt = fs.readFileSync(SALT_FILE);
+  } else {
+    salt = crypto.randomBytes(16);
+    fs.writeFileSync(SALT_FILE, salt);
+  }
+  const key = getKey(password, salt);
+  const iv = crypto.randomBytes(16);
+  const cipher = crypto.createCipheriv('aes-256-cbc', key, iv);
+  const data = JSON.stringify(cookies);
+  let encrypted = cipher.update(data, 'utf-8');
+  encrypted = Buffer.concat([encrypted, cipher.final()]);
+  fs.writeFileSync(COOKIE_FILE, Buffer.concat([iv, encrypted]));
+  console.log(chalk.green(`[AUTH] Cookie 已加密儲存 (${cookies.length} 個)`));
+}
+
+function loadCookies(password = 'eclass-local-key') {
+  if (!fs.existsSync(COOKIE_FILE) || !fs.existsSync(SALT_FILE)) {
+    return [];
+  }
+  try {
+    const salt = fs.readFileSync(SALT_FILE);
+    const key = getKey(password, salt);
+    const raw = fs.readFileSync(COOKIE_FILE);
+    const iv = raw.subarray(0, 16);
+    const encrypted = raw.subarray(16);
+    const decipher = crypto.createDecipheriv('aes-256-cbc', key, iv);
+    let decrypted = decipher.update(encrypted);
+    decrypted = Buffer.concat([decrypted, decipher.final()]);
+    const cookies = JSON.parse(decrypted.toString('utf-8'));
+    return cookies;
+  } catch (e) {
+    console.log(chalk.red(`[AUTH] Cookie 解密失敗: ${e.message}`));
+    return [];
+  }
+}
+
+function parseCookieString(cookieStr) {
+  const cookies = [];
+  for (const part of cookieStr.split(';')) {
+    const trimmed = part.trim();
+    if (trimmed.includes('=')) {
+      const idx = trimmed.indexOf('=');
+      const name = trimmed.substring(0, idx).trim();
+      const value = trimmed.substring(idx + 1).trim();
+      cookies.push({
+        name,
+        value,
+        domain: '.yuntech.edu.tw',
+        path: '/'
+      });
+    }
+  }
+  return cookies;
+}
+
+function importCookies(cookieStr) {
+  const cookies = parseCookieString(cookieStr);
+  if (cookies.length === 0) {
+    console.log(chalk.red('[AUTH] 找不到有效的 Cookie'));
+    return;
+  }
+  saveCookies(cookies);
+  console.log(chalk.green(`[AUTH] 匯入 ${cookies.length} 個 Cookie`));
+}
+
+async function autoLogin(baseUrl) {
+  console.log(chalk.cyan('\n=== 自動登入 ==='));
+  console.log(chalk.yellow('將開啟瀏覽器，請手動登入'));
+  console.log(chalk.yellow('登入成功後，Cookie 會自動儲存\n'));
+
+  const { chromium } = require('playwright');
+
+  const browser = await chromium.launch({ headless: false, slowMo: 50 });
+  const context = await browser.newContext();
+  const page = await context.newPage();
+
+  await page.goto(baseUrl, { waitUntil: 'domcontentloaded', timeout: 30000 });
+
+  console.log(chalk.cyan('等待您完成登入...'));
+  console.log(chalk.cyan('（登入後頁面會自動跳轉，Cookie 會自動儲存）'));
+
+  let saved = false;
+  let checkCount = 0;
+
+  const checkInterval = setInterval(async () => {
+    checkCount++;
+    const url = page.url();
+
+    if (!url.includes('login') && !url.includes('auth') && !url.includes('cas')) {
+      if (!saved) {
+        saved = true;
+        const cookies = await context.cookies();
+        const eclassCookies = cookies.filter(c =>
+          c.domain.includes('yuntech.edu.tw') || c.domain.includes('eclass')
+        );
+
+        if (eclassCookies.length > 0) {
+          saveCookies(eclassCookies);
+          console.log(chalk.green(`\n[AUTH] 登入成功！自動取得 ${eclassCookies.length} 個 Cookie`));
+          console.log(chalk.green('[AUTH] 現在可以執行 eclass run 開始自動化\n'));
+        } else {
+          console.log(chalk.yellow('\n[AUTH] 找不到 eclass Cookie，請確認已成功登入'));
+        }
+
+        clearInterval(checkInterval);
+        await browser.close();
+      }
+    }
+
+    if (checkCount > 300) {
+      console.log(chalk.red('\n[AUTH] 等待超時（5分鐘），請重新執行'));
+      clearInterval(checkInterval);
+      await browser.close();
+    }
+  }, 1000);
+}
+
+module.exports = {
+  saveCookies, loadCookies, parseCookieString, importCookies, autoLogin
+};

package/src/config.js

@@ -0,0 +1,82 @@
+const fs = require('fs');
+const path = require('path');
+const chalk = require('chalk');
+
+const CONFIG_DIR = path.join(require('os').homedir(), '.eclass-auto');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+const PROGRESS_FILE = path.join(CONFIG_DIR, 'progress.json');
+const COOKIE_FILE = path.join(CONFIG_DIR, 'cookies.enc');
+const SALT_FILE = path.join(CONFIG_DIR, 'salt.bin');
+
+const BASE_URL = 'https://eclass.yuntech.edu.tw';
+
+const DEFAULT_CONFIG = {
+  headless: false,
+  slowMo: 50,
+  playbackRate: 2,
+  videoTimeout: 600,
+  courses: [],
+  formAnswers: {}
+};
+
+function ensureDir() {
+  if (!fs.existsSync(CONFIG_DIR)) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  }
+}
+
+function loadConfig() {
+  ensureDir();
+  if (fs.existsSync(CONFIG_FILE)) {
+    const raw = fs.readFileSync(CONFIG_FILE, 'utf-8');
+    return { ...DEFAULT_CONFIG, ...JSON.parse(raw) };
+  }
+  return { ...DEFAULT_CONFIG };
+}
+
+function saveConfig(config) {
+  ensureDir();
+  fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), 'utf-8');
+}
+
+function loadProgress() {
+  ensureDir();
+  if (fs.existsSync(PROGRESS_FILE)) {
+    return JSON.parse(fs.readFileSync(PROGRESS_FILE, 'utf-8'));
+  }
+  return {};
+}
+
+function saveProgress(data) {
+  ensureDir();
+  fs.writeFileSync(PROGRESS_FILE, JSON.stringify(data, null, 2), 'utf-8');
+}
+
+function markDone(courseId, activityId) {
+  const p = loadProgress();
+  p[`${courseId}_${activityId}`] = true;
+  saveProgress(p);
+}
+
+function isDone(courseId, activityId) {
+  const p = loadProgress();
+  return `${courseId}_${activityId}` in p;
+}
+
+function showConfig() {
+  const config = loadConfig();
+  console.log(chalk.cyan('\n=== 目前設定 ==='));
+  console.log(`  headless: ${config.headless}`);
+  console.log(`  playbackRate: ${config.playbackRate}x`);
+  console.log(`  courses: ${config.courses.length} 個`);
+  config.courses.forEach((c, i) => console.log(`    ${i + 1}. ${c}`));
+  console.log(`  config: ${CONFIG_FILE}`);
+  console.log(`  progress: ${PROGRESS_FILE}\n`);
+}
+
+module.exports = {
+  CONFIG_DIR, CONFIG_FILE, PROGRESS_FILE, COOKIE_FILE, SALT_FILE,
+  BASE_URL, DEFAULT_CONFIG,
+  ensureDir, loadConfig, saveConfig,
+  loadProgress, saveProgress, markDone, isDone, showConfig
+};

package/src/index.js

@@ -0,0 +1,210 @@
+const re = require;
+const chalk = re('chalk');
+const { loadCookies, autoLogin } = re('./auth');
+const { watchVideo } = re('./video');
+const { loadConfig, saveConfig, markDone, isDone, BASE_URL } = re('./config');
+
+async function getUncompleted(page, courseId) {
+  try {
+    await page.goto(`${BASE_URL}/course/${courseId}/content#/`, {
+      waitUntil: 'domcontentloaded',
+      timeout: 15000
+    });
+  } catch (e) {}
+  await page.waitForTimeout(3000);
+
+  return page.evaluate(() => {
+    const el = document.querySelector('.learning-activities');
+    if (!el) return [];
+    const scope = angular.element(el).scope();
+    if (!scope) return [];
+    const activities = document.querySelectorAll('.learning-activity.sortable');
+    const result = [];
+    activities.forEach((actEl) => {
+      const actScope = angular.element(actEl).scope();
+      if (!actScope || !actScope.activity) return;
+      const a = actScope.activity;
+      let completeness = '';
+      try { completeness = scope.getActivityCompleteness(a); } catch (e) {}
+      if (completeness !== 'full') {
+        result.push({
+          id: a.id,
+          title: (a.title || '').substring(0, 60),
+          type: a.type || ''
+        });
+      }
+    });
+    return result;
+  });
+}
+
+async function processCourse(page, courseId) {
+  let done = 0;
+  let skip = 0;
+
+  const uncompleted = await getUncompleted(page, courseId);
+  const videos = uncompleted.filter(u => u.type === 'online_video');
+
+  const remaining = videos.filter(v => !isDone(courseId, v.id));
+  console.log(chalk.cyan(`  Uncompleted videos: ${videos.length}, already done: ${videos.length - remaining.length}, remaining: ${remaining.length}`));
+
+  for (const act of remaining) {
+    console.log(chalk.white(`\n  -> ${act.title}`));
+    const url = `${BASE_URL}/course/${courseId}/learning-activity/full-screen#/${act.id}`;
+
+    try {
+      await page.goto(url, { waitUntil: 'domcontentloaded', timeout: 15000 });
+    } catch (e) {}
+    await page.waitForTimeout(5000);
+
+    if (!page.url().includes('learning-activity')) {
+      console.log(chalk.yellow('    [WARN] Failed to load activity page, skipping'));
+      skip++;
+      continue;
+    }
+
+    try {
+      const success = await watchVideo(page);
+      if (success) {
+        markDone(courseId, act.id);
+        done++;
+        console.log(chalk.green('    [OK] Saved to progress'));
+      } else {
+        skip++;
+      }
+    } catch (e) {
+      console.log(chalk.red(`    [ERROR] ${e.message}`));
+      skip++;
+    }
+
+    await page.waitForTimeout(2000);
+  }
+
+  console.log(chalk.cyan(`\n  Result: ${done} watched, ${skip} skipped`));
+  return { done, skip };
+}
+
+async function showStatus() {
+  const config = loadConfig();
+  const cookies = loadCookies();
+  if (!cookies.length) {
+    console.log(chalk.red('[ERROR] 沒有 Cookie，請先執行 eclass login 或 eclass import-cookies'));
+    return;
+  }
+
+  const { chromium } = re('playwright');
+  const browser = await chromium.launch({ headless: true, slowMo: 50 });
+  const context = await browser.newContext();
+  await context.addCookies(cookies);
+  const page = await context.newPage();
+
+  await page.goto(BASE_URL, { waitUntil: 'domcontentloaded', timeout: 15000 });
+  await page.waitForTimeout(2000);
+
+  if (page.url().includes('login')) {
+    console.log(chalk.red('[ERROR] Cookie 過期'));
+    await browser.close();
+    return;
+  }
+
+  const courses = config.courses || [];
+  console.log(chalk.cyan('\n=== 課程進度統計 ==='));
+
+  for (const courseUrl of courses) {
+    const match = courseUrl.match(/\/course\/(\d+)\//);
+    const courseId = match ? match[1] : '?';
+    try {
+      const uncompleted = await getUncompleted(page, courseId);
+      const total = uncompleted.length;
+      const videos = uncompleted.filter(u => u.type === 'online_video').length;
+      const exams = uncompleted.filter(u => u.type === 'exam').length;
+      const other = total - videos - exams;
+      console.log(chalk.white(`\n  Course ${courseId}: ${total} uncompleted (${videos} videos, ${exams} exams, ${other} other)`));
+    } catch (e) {
+      console.log(chalk.red(`\n  Course ${courseId}: ERROR - ${e.message}`));
+    }
+  }
+
+  console.log('');
+  await browser.close();
+}
+
+async function run(opts = {}) {
+  const config = loadConfig();
+  const cookies = loadCookies();
+
+  if (!cookies.length) {
+    console.log(chalk.red('[ERROR] 沒有 Cookie'));
+    console.log(chalk.yellow('  請執行: eclass login        （自動取得 Cookie）'));
+    console.log(chalk.yellow('  或:     eclass import-cookies "session=xxx"'));
+    return;
+  }
+
+  if (opts.headless) config.headless = true;
+
+  const { chromium } = re('playwright');
+
+  const browser = await chromium.launch({
+    headless: config.headless,
+    slowMo: config.slowMo || 50
+  });
+  const context = await browser.newContext({
+    viewport: { width: 1280, height: 900 },
+    userAgent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36'
+  });
+  await context.addCookies(cookies);
+  const page = await context.newPage();
+
+  await page.goto(BASE_URL, { waitUntil: 'domcontentloaded', timeout: 15000 });
+  await page.waitForTimeout(2000);
+
+  if (page.url().includes('login')) {
+    console.log(chalk.red('[ERROR] Cookie 過期，請重新執行 eclass login'));
+    await browser.close();
+    return;
+  }
+
+  console.log(chalk.green('[OK] Login verified'));
+
+  let courses = config.courses || [];
+
+  if (opts.course) {
+    const ids = opts.course.split(',').map(s => s.trim());
+    courses = courses.filter(url => ids.some(id => url.includes(id)));
+    if (courses.length === 0) {
+      courses = ids.map(id => `${BASE_URL}/course/${id}/content#/`);
+    }
+  }
+
+  if (!courses.length) {
+    console.log(chalk.yellow('[WARN] 沒有設定課程'));
+    console.log(chalk.yellow('  請編輯 ~/.eclass-auto/config.json 加入 courses'));
+    await browser.close();
+    return;
+  }
+
+  let totalDone = 0;
+  let totalSkip = 0;
+
+  for (let i = 0; i < courses.length; i++) {
+    const courseUrl = courses[i];
+    const match = courseUrl.match(/\/course\/(\d+)\//);
+    const courseId = match ? match[1] : '127331';
+
+    console.log(chalk.cyan(`\n${'='.repeat(50)}`));
+    console.log(chalk.cyan(`Course ${i + 1}/${courses.length} (ID: ${courseId})`));
+    console.log(chalk.cyan(`${'='.repeat(50)}`));
+
+    const result = await processCourse(page, courseId);
+    totalDone += result.done;
+    totalSkip += result.skip;
+  }
+
+  console.log(chalk.cyan(`\n${'='.repeat(50)}`));
+  console.log(chalk.green(`ALL DONE: ${totalDone} watched, ${totalSkip} skipped`));
+  console.log(chalk.cyan(`${'='.repeat(50)}`));
+
+  await browser.close();
+}
+
+module.exports = { run, showStatus };

package/src/video.js

@@ -0,0 +1,111 @@
+const chalk = require('chalk');
+
+function log(msg) {
+  console.log(msg);
+}
+
+async function watchVideo(page) {
+  const hasVideo = await page.evaluate(() => document.querySelector('video') !== null);
+  if (!hasVideo) {
+    log(chalk.yellow('    [VIDEO] No video element'));
+    return false;
+  }
+
+  log(chalk.blue('    [VIDEO] Muted + 2x speed'));
+
+  await page.evaluate(() => {
+    document.querySelectorAll('video').forEach(v => {
+      v.muted = true;
+      v.playbackRate = 2;
+      v.currentTime = 0;
+    });
+  });
+
+  await page.evaluate(() => document.querySelector('video').play());
+  await page.waitForTimeout(2000);
+
+  const isPlaying = await page.evaluate(() => {
+    const v = document.querySelector('video');
+    return v ? !v.paused : false;
+  });
+
+  if (!isPlaying) {
+    log(chalk.yellow('    [VIDEO] Clicking play...'));
+    await page.evaluate(() => {
+      document.querySelectorAll('[class*="play"], .vjs-big-play-button, button').forEach(btn => {
+        if (btn.offsetParent && (btn.className.includes('play') || btn.className.includes('Play'))) {
+          btn.click();
+        }
+      });
+    });
+    await page.waitForTimeout(2000);
+    await page.evaluate(() => document.querySelector('video').play());
+  }
+
+  const duration = await page.evaluate(() => {
+    const v = document.querySelector('video');
+    return v ? v.duration : 0;
+  });
+
+  if (!duration || duration <= 0) {
+    log(chalk.yellow('    [VIDEO] Cannot get duration, waiting 30s...'));
+    await page.waitForTimeout(30000);
+    return true;
+  }
+
+  const waitTime = (duration / 2) + 15;
+  log(chalk.blue(`    [VIDEO] ${Math.floor(duration)}s video, waiting ~${Math.floor(waitTime)}s (2x)`));
+
+  let elapsed = 0;
+  let lastPct = -1;
+  let restartCount = 0;
+
+  while (elapsed < waitTime) {
+    await page.waitForTimeout(5000);
+    elapsed += 5;
+
+    const state = await page.evaluate(() => {
+      const v = document.querySelector('video');
+      if (!v || !v.duration) return { p: 100, e: true, paused: false, stalled: false };
+      return {
+        p: Math.floor((v.currentTime / v.duration) * 100),
+        e: v.ended || v.currentTime >= v.duration - 2,
+        paused: v.paused,
+        stalled: v.readyState < 2
+      };
+    });
+
+    if (state.p > lastPct) {
+      log(chalk.blue(`    [VIDEO] ${state.p}% (${Math.floor(elapsed)}s)`));
+      lastPct = state.p;
+    }
+
+    if (state.e) {
+      log(chalk.green('    [VIDEO] 100% Finished'));
+      break;
+    }
+
+    if (state.stalled) {
+      if (elapsed % 15 === 0) {
+        log(chalk.gray(`    [VIDEO] Buffering... (${Math.floor(elapsed)}s)`));
+      }
+      continue;
+    }
+
+    if (state.paused && elapsed > 5) {
+      restartCount++;
+      if (restartCount > 10) {
+        log(chalk.red('    [VIDEO] Too many restarts, giving up'));
+        return false;
+      }
+      log(chalk.yellow(`    [VIDEO] Paused, restarting (#${restartCount})...`));
+      await page.evaluate(() => document.querySelector('video').play());
+      await page.waitForTimeout(1000);
+    }
+  }
+
+  await page.waitForTimeout(3000);
+  return true;
+}
+
+module.exports = { watchVideo };