// ======== 平台积分台账 ======== // 「我的积分」页 /ssp/#/my/point 背后的接口才是最直接的证据: // GET /ssp/rule/org 各积分规则的每日上限(文档/视频/音频/微课) // POST /ssp/point/history/self 今日积分明细 // 脚本不再假设「学完一门就该 +3」,只把平台真实入账的记录折算成积分。 // // 鉴权:接口认 localStorage.token(登录后由平台写入),不用 cookie。 // 接口不可用(未登录 / 跨域 / 网络)时返回 ok:false,调用方退回本地计数。 import { norm } from './utils.js'; import { pointLabel } from './points.js'; const API = 'https://api-phx-tc.yunxuetang.cn/ssp/'; const RULE_CODES = { doc: 'SB1031', video: 'SB1032', audio: 'SB1033', micro: 'SB1034' }; // 台账里的 nameType 就是平台自己的课件类型:1006 文档 / 1007 视频 / 1008 音频 / 1009 微课 const NAME_TYPES = { 1006: 'doc', 1007: 'video', 1008: 'audio', 1009: 'micro' }; const CACHE_TTL = 20000; const TAGS_KEY = 'yun-xue-tang-point-awards-v1'; const PENDING_TTL = 6 * 60 * 60 * 1000; const NO_AWARD_LIMIT = 3; let cache = null; let inflight = null; let mode = ''; // '' | 'platform' | 'local':首次刷新成功与否决定本次会话的计数方式 let completionsSinceAward = 0; let lastLedgerCount = -1; 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 token() { try { return localStorage.getItem('token') || ''; } catch (e) { return ''; } } export function platformAvailable() { return !!token(); } /** 首次刷新是否已经确定计数方式;未确定前调用方按本地模式处理 */ export function platformMode() { return mode; } export function cachedPlatformPoints() { return cache; } /** 平台连续多少门课没有新增入账记录(用于判断「积分其实已满」) */ export function platformNoAward() { return mode === 'platform' && completionsSinceAward >= NO_AWARD_LIMIT; } // ---- 本地保存「课程名 -> 类型」和「等待对账的完成记录」---- function loadTags(day) { try { const o = JSON.parse(localStorage.getItem(TAGS_KEY) || '{}'); if (o && o.day === day) { return { day: day, titles: o.titles && typeof o.titles === 'object' ? o.titles : {}, pending: Array.isArray(o.pending) ? o.pending : [], unknown: o.unknown && typeof o.unknown === 'object' ? o.unknown : {}, }; } } catch (e) { /* ignore */ } return { day: day, titles: {}, pending: [], unknown: {} }; } function saveTags(t) { try { localStorage.setItem(TAGS_KEY, JSON.stringify(t)); } catch (e) { /* ignore */ } } /** 整门课完成时记下「这门课算哪一类」,等平台台账入账后据此归类 */ export function rememberCourseAward(title, type) { if (!title || !type) return; const t = loadTags(dayKey(Date.now())); t.titles[norm(title)] = type; t.pending.push({ type: type, at: Date.now(), title: norm(title) }); if (t.pending.length > 50) t.pending = t.pending.slice(-50); saveTags(t); } /** 一门课完成了(平台模式下用来判断「连续 N 门没有入账」) */ export function noteCourseCompleted() { if (mode === 'platform') completionsSinceAward++; } /** * 把平台台账折算进本地计数器。纯逻辑,方便离线测试。 * @returns {number} 本次新增计入的条数 */ export function applyLedger(data, tracker, opts = {}) { if (!data || !data.ok) return 0; const t = loadTags(data.day); if (opts.reset) { // 切换到平台模式时丢弃旧口径的本地计数,完全以台账重建 if (typeof tracker.resetCounts === 'function') tracker.resetCounts(); t.unknown = {}; } let added = 0; for (const r of data.records || []) { const id = 'platform:' + r.id; const key = norm(r.remark || ''); // 优先用平台台账自带的 nameType,它比标题/待对账记录都可靠 let type = NAME_TYPES[Number(r.nameType)] || ''; if (!type) type = key && t.titles[key] ? t.titles[key] : ''; if (type) { // 这条记录已经对上类型了,把它对应的待对账记录撤掉,避免后面串号 const j = t.pending.findIndex((p) => p.title === key && p.type === type); if (j >= 0) t.pending.splice(j, 1); } else { // 平台有时用课时名而不是课程名:把它归给最近一次还没对上的完成记录 const i = t.pending.findIndex((p) => Date.now() - (p.at || 0) < PENDING_TTL); if (i >= 0) { type = t.pending[i].type; t.pending.splice(i, 1); } } if (type) { if (tracker.record(type, id)) { added++; console.log('[云学堂助手] 积分 +' + r.point + '(平台入账):' + pointLabel(type) + ' · ' + tracker.summary()); } } else if (!t.unknown[id]) { t.unknown[id] = 1; console.warn('[云学堂助手] 平台积分 +' + r.point + ' 未能归类:' + (r.remark || r.id)); } } saveTags(t); return added; } // ---- 拉取 ---- async function getJson(url, opts) { const res = await fetch(url, opts); if (!res.ok) throw new Error('HTTP ' + res.status); return res.json(); } export async function fetchPlatformPoints(now) { const tk = token(); const at = now || Date.now(); if (!tk) return { ok: false, at: at, reason: 'no-token' }; const day = dayKey(at); // 平台网关要求 source 头(501 = PC 端);缺了会返回 400「请求头 source 为空」 const headers = { 'Content-Type': 'application/json;charset=UTF-8', source: '501', 'x-yxt-product': 'xxv2', token: tk, }; const body = JSON.stringify({ startDate: day + ' 00:00:00', endDate: day + ' 23:59:59', sourceType: -1, optionType: 0, type: 1, userId: '', }); const results = await Promise.all([ getJson(API + 'rule/org', { headers: headers }), getJson(API + 'point/history/self?limit=200&offset=0', { method: 'POST', headers: headers, body: body, }), ]); const rules = results[0]; const ledger = results[1]; const ruleMap = {}; for (const r of (rules && rules.datas) || []) { if (!r || Number(r.enable) !== 1) continue; for (const key of Object.keys(RULE_CODES)) { if (r.code === RULE_CODES[key]) { ruleMap[key] = { cap: Math.max(0, Number(r.times) || 0), point: Math.max(0, Number(r.point) || 0), }; } } } // sourceType 1002 = 在线学习;登录奖励等其它来源不算每日学习积分 const records = ((ledger && ledger.datas) || []).filter((r) => r && r.id && Number(r.point) > 0 && Number(r.sourceType) === 1002); const todayPoints = records.reduce((n, r) => n + (Number(r.point) || 0), 0); const maxPoints = Object.keys(ruleMap).reduce((n, k) => n + ruleMap[k].cap * ruleMap[k].point, 0); return { ok: true, at: at, day: day, rules: ruleMap, records: records, todayPoints: todayPoints, maxPoints: maxPoints, }; } /** * 刷新平台台账并折算进计数器。并发调用共用一个请求;失败不抛错。 * @param {object} tracker points.js 的 tracker(需要 record / resetCounts) * @param {{force?:boolean}} [opts] */ export function refreshPlatformPoints(tracker, opts = {}) { if (!force(opts) && cache && Date.now() - cache.at < CACHE_TTL) { return Promise.resolve(cache); } if (inflight) return inflight; inflight = fetchPlatformPoints().then((data) => { cache = data; if (data.ok) { if (mode !== 'platform') { mode = 'platform'; applyLedger(data, tracker, { reset: true }); } else { applyLedger(data, tracker); } if (data.records.length > lastLedgerCount) completionsSinceAward = 0; lastLedgerCount = data.records.length; } else if (!mode) { mode = 'local'; } return data; }).catch((e) => { cache = { ok: false, at: Date.now(), reason: e && e.message ? e.message : String(e) }; if (!mode) mode = 'local'; return cache; }).finally(() => { inflight = null; }); return inflight; } function force(opts) { return !!(opts && opts.force); } /** 某个类型在平台规则里是否启用/上限多少;没有平台数据时返回 null */ export function platformRule(key) { if (!cache || !cache.ok) return null; return cache.rules[key] || null; } /** 全部启用规则加起来的每日积分上限;没有平台数据时返回 0 */ export function platformMaxPoints() { if (!cache || !cache.ok) return 0; return cache.maxPoints; }