feat: 每日积分改以平台积分台账为准

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

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
voidandClaude Sonnet 4.6 committed 2026-11-02 20:43:40 +08:00
1 parent f41fc72fe2
commit 18c5e5a3be
15 files changed
+1042 -141

No files matched your search

+255
View File
@@ -0,0 +1,255 @@
// ======== 平台积分台账 ========
// 「我的积分」页 /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;
}