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:
voidandClaude Sonnet 4.6 committed 2026-11-01 22:19:52 +08:00
1 parent 17217dbeb1
commit 0eb4c40629
31 files changed
+2954 -21

No files matched your search

+267
View File
@@ -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,
};
}