Files
yun-xue-tang-assistant/src/points-platform.js
T
voidandClaude Sonnet 4.6 18c5e5a3be feat: 每日积分改以平台积分台账为准
- 新增 points-platform:读取 /ssp/#/my/point 背后的 rule/org 与 point/history/self
- 整门课完成不再直接 +3,等平台真的入账后按 nameType 归类计数
- 平台今日学习积分达到上限,或连续 3 门确有学习内容却未入账时收尾
- 接口不可用(未登录/跨域/网络)时退回本地计数,面板额外显示平台台账
- 新增离线回归测试与只读探测脚本

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-11-02 20:43:40 +08:00

256 lines
8.5 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// ======== 平台积分台账 ========
// 「我的积分」页 /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;
}