- 按课时类型计分:文档 1 / 视频 3 / 音频 2 / 微课 2,每次 3 分,单日封顶 24 分;满额换类,无内容即停 - 积分计数落 localStorage,跨刷新/重启保留、跨天清零;面板与无头 TUI 都显示今日积分 - 运行器自己收尾时通过 Bark 推送今日积分、完成门数、用时和结束原因;手动停止与 --check 不推送 - 新增 --points-mode / --bark-* 参数及对应 YUN_XUE_TANG_* 环境变量 - 补充 points / notify 离线回归测试与 OpenSpec 配置 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
268 lines
8.2 KiB
JavaScript
268 lines
8.2 KiB
JavaScript
// ======== 每日积分模式 ========
|
||
// 平台按「学习完成」发积分,四类任务各有每日上限:
|
||
// 文档 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,
|
||
};
|
||
}
|