// ======== 每日积分模式 ======== // 平台按「学习完成」发积分,四类任务各有每日上限: // 文档 1 次 + 视频 3 次 + 音频 2 次 + 微课 2 次,每次 3 分,单日最多 24 分。 // // 这里的口径是「完成一个课时算一次」,不是「完成一整门课」: // · 多课时课程里每学完一节视频/文档/音频/微课,各计一次; // · 单视频/音频/课件播放页学完即计一次; // · 类型识别不出来的课时不猜、不计分; // · 同一天同一课时重复上报(刷新、重进、平台重发)只计一次。 // // 计数落 localStorage 并带日期,跨刷新/运行器重启不丢,跨天自动清零。 // 纯数据逻辑,不碰 DOM,方便脱离浏览器直接测。 export const POINT_RULES = [ { key: 'doc', label: '文档', cap: 1 }, { key: 'video', label: '视频', cap: 3 }, { key: 'audio', label: '音频', cap: 2 }, { key: 'micro', label: '微课', cap: 2 }, ]; export const POINTS_PER_TASK = 3; export const MAX_DAILY_POINTS = POINT_RULES.reduce((n, r) => n + r.cap, 0) * POINTS_PER_TASK; export const LS_POINTS_MODE = 'yun-xue-tang-daily-points-mode'; export const LS_POINTS_STATE = 'yun-xue-tang-daily-points-v1'; // 顺序有讲究:微课/文档/音频在前,视频最后。某一类同时命中多个关键词时, // 按更具体的类型算(例如「微课视频」按微课,而不是按视频)。 const TYPE_MATCHERS = [ ['micro', /微课|micro/i], ['doc', /文档|课件|ppt|document|article/i], ['audio', /音频|audio/i], ['video', /视频|video/i], ]; /** * 识别一个课时的积分类型。 * 优先级:播放页路由 > 接口 fileType > 目录里的 tag-type 文本。 * 多课时课程的路由(#/course/play)不带类型,会落到 tag-type 上。 * 识别不出来返回 '',调用方不应计分。 */ export function detectLessonType(input) { input = input || {}; const sources = [input.hash, input.fileType, input.tag]; for (const src of sources) { if (!src) continue; const s = String(src); for (const pair of TYPE_MATCHERS) { if (pair[1].test(s)) return pair[0]; } } return ''; } /** 列表接口的 type 字段:1=文档/课件 2=视频 3=音频;0 是课程容器,不计。 */ export function apiTypeKey(type) { const n = Number(type); if (n === 1) return 'doc'; if (n === 2) return 'video'; if (n === 3) return 'audio'; return ''; } /** 类型的中文名(日志/面板用);未知类型原样返回 */ export function pointLabel(key) { const rule = POINT_RULES.find((r) => r.key === key); return rule ? rule.label : (key || '未知'); } /** * 选择本轮该补哪一类:按 文档 → 视频 → 音频 → 微课 的顺序, * 跳过已满额和确认没有内容的类型。 * * @param {object} opts * @param {Function} opts.isFull (key) => boolean * @param {object} [opts.available] { doc, video, audio, micro };false = 没内容。 * video 的可用性由调用方根据「还有没有可学的课程」判断。 * @returns {{type:string, kind:'item'|'course'}|null} null = 今日任务已无可做项 */ export function nextTarget(opts) { opts = opts || {}; const isFull = typeof opts.isFull === 'function' ? opts.isFull : () => false; const available = opts.available || {}; for (const rule of POINT_RULES) { if (isFull(rule.key)) continue; if (rule.key === 'video') { // 视频额度靠课程里的视频课时完成,不依赖单条库存 if (available.video !== false) return { type: 'video', kind: 'course' }; continue; } if (available[rule.key]) return { type: rule.key, kind: 'item' }; } return null; } function pad2(n) { return n < 10 ? '0' + n : '' + n; } function dayKey(ms) { const d = new Date(ms); return d.getFullYear() + '-' + pad2(d.getMonth() + 1) + '-' + pad2(d.getDate()); } function blankState(date) { const counts = {}; for (const rule of POINT_RULES) counts[rule.key] = 0; return { date: date, counts: counts, seen: {} }; } function normalizeState(obj) { const state = blankState(obj && obj.date ? String(obj.date) : ''); for (const rule of POINT_RULES) { const n = Number(obj && obj.counts && obj.counts[rule.key]); state.counts[rule.key] = Number.isFinite(n) && n > 0 ? Math.floor(n) : 0; } if (obj && obj.seen && typeof obj.seen === 'object') state.seen = obj.seen; return state; } /** * @param {object} [opts] * @param {Function} [opts.now] 取当前时间(毫秒),测试用假时钟 * @param {object} [opts.storage] getItem/setItem,默认 localStorage * @param {boolean} [opts.enabled] 是否启用积分模式,默认 true * @param {string} [opts.storageKey] */ export function createPointsTracker(opts = {}) { const now = opts.now || (() => Date.now()); const storage = opts.storage !== undefined ? opts.storage : (typeof localStorage !== 'undefined' ? localStorage : null); const storageKey = opts.storageKey || LS_POINTS_STATE; let enabled = opts.enabled !== undefined ? !!opts.enabled : true; let state = load(); rollover(); // 打开页面时如果已经跨天,先清零再用 function load() { try { const raw = storage && storage.getItem(storageKey); if (!raw) return blankState(dayKey(now())); return normalizeState(JSON.parse(raw)); } catch (e) { return blankState(dayKey(now())); } } function save() { try { if (storage) storage.setItem(storageKey, JSON.stringify(state)); } catch (e) { /* 容量不足 / 隐私模式:内存里照常计数 */ } } /** 跨天自动清零;返回是否发生了重置 */ function rollover() { const today = dayKey(now()); if (state.date === today) return false; state = blankState(today); save(); return true; } function ruleOf(key) { return POINT_RULES.find((r) => r.key === key) || null; } function count(key) { return state.counts[key] || 0; } function cap(key) { const rule = ruleOf(key); return rule ? rule.cap : 0; } function isFull(key) { return count(key) >= cap(key); } function remaining(key) { return Math.max(0, cap(key) - count(key)); } /** * 记一次课时完成。 * @param {string} key detectLessonType 的返回值 * @param {string} [lessonId] 当天去重键(建议 courseId|lessonKey);空串表示不去重 * @returns {boolean} 是否真的计入了 */ function record(key, lessonId) { rollover(); if (!enabled) return false; if (!ruleOf(key) || isFull(key)) return false; if (lessonId) { if (state.seen[lessonId]) return false; state.seen[lessonId] = 1; } state.counts[key] = count(key) + 1; save(); return true; } function totalPoints() { let total = 0; for (const rule of POINT_RULES) { total += Math.min(count(rule.key), rule.cap) * POINTS_PER_TASK; } return total; } function maxPoints() { return MAX_DAILY_POINTS; } function allFull() { return POINT_RULES.every((rule) => isFull(rule.key)); } /** * 今日任务是否已完成:四类都满额,或剩余额度的类型都确认没有内容。 * available 缺省时不把「没内容」当成完成依据(避免误停)。 */ function done(available) { return POINT_RULES.every((rule) => isFull(rule.key) || (!!available && available[rule.key] === false)); } function progress() { return POINT_RULES.map((rule) => ({ key: rule.key, label: rule.label, count: Math.min(count(rule.key), rule.cap), cap: rule.cap, })); } function summary() { const parts = progress().map((p) => p.label + p.count + '/' + p.cap); return '今日积分 ' + totalPoints() + '/' + maxPoints() + ' · ' + parts.join(' '); } function snapshot() { return { enabled: enabled, date: state.date, total: totalPoints(), max: maxPoints(), progress: progress(), text: summary(), }; } function setEnabled(on) { enabled = !!on; if (enabled) rollover(); } function isEnabled() { return enabled; } return { record, count, cap, isFull, remaining, totalPoints, maxPoints, allFull, done, progress, summary, snapshot, setEnabled, isEnabled, rollover, }; }