feat: 每日积分模式与 Bark 完成提醒
- 按课时类型计分:文档 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>
This commit is contained in:
1 parent
17217dbeb1
commit
0eb4c40629
31 files changed
+2954
-21
No files matched your search
+267
@@ -0,0 +1,267 @@
|
||||
// ======== 每日积分模式 ========
|
||||
// 平台按「学习完成」发积分,四类任务各有每日上限:
|
||||
// 文档 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,
|
||||
};
|
||||
}
|
||||
Reference in new issue
Block a user