Files
yun-xue-tang-assistant/src/points.js
T
voidandClaude Sonnet 4.6 0eb4c40629 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>
2026-11-01 22:19:52 +08:00

268 lines
8.2 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.
// ======== 每日积分模式 ========
// 平台按「学习完成」发积分,四类任务各有每日上限:
// 文档 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,
};
}