Files
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

240 lines
10 KiB
JavaScript
Raw Permalink 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.
#!/usr/bin/env node
/**
* 每日积分(src/points.js)自测:纯数据逻辑,假时钟 + 假存储,不需要浏览器。
*
* 口径一旦错,日志和面板上的「今日积分 12/24」就是假的,而这种错在运行日志里
* 完全看不出来。用假时钟把「每日封顶」「同节不重复计」「跨日清零」「缺内容的类型不阻塞」
* 这些边界钉死。
*
* 用法:
* node dev/tests/points-test.mjs
* npm run test:points
*/
import {
POINT_RULES, POINTS_PER_TASK, MAX_DAILY_POINTS,
detectLessonType, apiTypeKey, createPointsTracker, nextTarget,
} from '../../src/points.js';
let failed = 0;
function ok(cond, name, extra) {
if (cond) console.log(' ✔ ' + name);
else { failed++; console.log(' ✘ ' + name + (extra ? ' → ' + extra : '')); }
}
function eq(actual, expect, name) {
ok(actual === expect, name, '期望 ' + JSON.stringify(expect) + ',实际 ' + JSON.stringify(actual));
}
/** 假存储:只实现 getItem / setItem,跨 tracker 实例复用即验证持久化 */
function fakeStorage() {
const mem = new Map();
return {
getItem: (k) => (mem.has(k) ? mem.get(k) : null),
setItem: (k, v) => { mem.set(k, String(v)); },
removeItem: (k) => { mem.delete(k); },
dump: () => Object.fromEntries(mem),
};
}
/** 假时钟:手动推进 */
function clock(start = new Date(2026, 10, 1, 9, 0, 0).getTime()) {
let t = start;
return {
now: () => t,
tick: (sec) => { t += sec * 1000; },
set: (d) => { t = d.getTime(); },
};
}
function newTracker(c, storage) {
return createPointsTracker({ now: c.now, storage: storage || fakeStorage() });
}
// ---------------------------------------------------------------------------
// 1. 规则与类型识别
// ---------------------------------------------------------------------------
console.log('规则与类型识别');
{
eq(POINTS_PER_TASK, 3, '每条任务 3 分');
eq(MAX_DAILY_POINTS, 24, '每日上限 1+3+2+2 = 8 条 × 3 = 24 分');
eq(POINT_RULES.map((r) => r.key).join(','), 'doc,video,audio,micro', '四类顺序:文档/视频/音频/微课');
eq(detectLessonType({ tag: '视频' }), 'video', '课时标签「视频」');
eq(detectLessonType({ tag: '文档' }), 'doc', '课时标签「文档」');
eq(detectLessonType({ tag: '课件' }), 'doc', '课时标签「课件」按文档算');
eq(detectLessonType({ tag: '音频' }), 'audio', '课时标签「音频」');
eq(detectLessonType({ tag: '微课' }), 'micro', '课时标签「微课」');
eq(detectLessonType({ hash: '#/video/play?kngId=x' }), 'video', '单视频路由');
eq(detectLessonType({ hash: '#/audio/play?kngId=x' }), 'audio', '单音频路由');
eq(detectLessonType({ hash: '#/ppt/play?kngId=x' }), 'doc', '单课件路由按文档算');
eq(detectLessonType({ hash: '#/document/play?kngId=x' }), 'doc', '文档路由');
eq(detectLessonType({ hash: '#/micro/play?kngId=x' }), 'micro', '微课路由');
eq(detectLessonType({ fileType: 'video' }), 'video', '接口 fileType=video');
eq(detectLessonType({ fileType: 'ppt' }), 'doc', '接口 fileType=ppt');
eq(detectLessonType({ tag: '视频', hash: '#/document/play' }), 'doc', '多来源冲突时以路由/精确类型为准(文档优先)');
eq(detectLessonType({ hash: '#/course/play?kngId=x' }), '', '多课时课程容器本身不算类型');
eq(detectLessonType({ tag: '考试' }), '', '考试节点不计积分');
eq(detectLessonType({}), '', '没有信息时返回空(不瞎猜)');
eq(apiTypeKey(1), 'doc', '列表接口 type=1 → 文档');
eq(apiTypeKey(2), 'video', '列表接口 type=2 → 视频');
eq(apiTypeKey(3), 'audio', '列表接口 type=3 → 音频');
eq(apiTypeKey(0), '', 'type=0 是课程容器,不计');
eq(apiTypeKey(99), '', '未知 type 不计');
}
// ---------------------------------------------------------------------------
// 2. 每日封顶:四类各自上限
// ---------------------------------------------------------------------------
console.log('每日封顶');
{
const c = clock();
const p = newTracker(c);
let n = 0;
for (let i = 0; i < 5; i++) if (p.record('doc', 'course-a|doc-' + i)) n++;
eq(n, 1, '文档每天只计 1 次');
eq(p.count('doc'), 1, '文档计数封顶 1');
eq(p.isFull('doc'), true, '文档封顶后 isFull');
eq(p.remaining('doc'), 0, '文档剩余额度 0');
n = 0;
for (let i = 0; i < 6; i++) if (p.record('video', 'course-a|v-' + i)) n++;
eq(n, 3, '视频每天只计 3 次');
n = 0;
for (let i = 0; i < 5; i++) if (p.record('audio', 'a-' + i)) n++;
eq(n, 2, '音频每天只计 2 次');
n = 0;
for (let i = 0; i < 5; i++) if (p.record('micro', 'm-' + i)) n++;
eq(n, 2, '微课每天只计 2 次');
eq(p.totalPoints(), 24, '四类满额 = 24 分');
eq(p.maxPoints(), 24, '每日满分 24');
eq(p.allFull(), true, '四类都满');
}
// ---------------------------------------------------------------------------
// 3. 去重:同一课时重复上报不重复计
// ---------------------------------------------------------------------------
console.log('去重');
{
const c = clock();
const p = newTracker(c);
eq(p.record('video', 'course-a|lesson-1'), true, '第一次记录成功');
eq(p.record('video', 'course-a|lesson-1'), false, '同一课时再次上报不计');
eq(p.count('video'), 1, '计数仍为 1');
eq(p.record('video', 'course-a|lesson-2'), true, '下一节正常计');
eq(p.count('video'), 2, '计数 2');
eq(p.record('video', ''), true, '没有课时 id 时不做去重(按事件计一次)');
eq(p.record('video', ''), false, '无 id 事件也受每日封顶限制');
eq(p.count('video'), 3, '视频封顶 3');
}
// ---------------------------------------------------------------------------
// 4. 跨日清零 + 持久化
// ---------------------------------------------------------------------------
console.log('跨日与持久化');
{
const c = clock();
const storage = fakeStorage();
const p = newTracker(c, storage);
p.record('doc', 'd1');
p.record('video', 'v1');
eq(p.totalPoints(), 6, '当天 2 条 = 6 分');
// 同一份存储、新的 tracker 实例(模拟刷新 / 运行器重启)
const p2 = newTracker(c, storage);
eq(p2.count('doc'), 1, '刷新后计数保留');
eq(p2.record('video', 'v1'), false, '刷新后同节仍不重复计');
// 跨日
c.set(new Date(2026, 10, 2, 0, 0, 5));
const p3 = newTracker(c, storage);
eq(p3.count('doc'), 0, '新的一天文档清零');
eq(p3.totalPoints(), 0, '新的一天积分清零');
eq(p3.record('video', 'v1'), true, '新的一天同一课时可以重新计');
}
// ---------------------------------------------------------------------------
// 5. 可用性:没内容的类型不阻塞「今天已完成」
// ---------------------------------------------------------------------------
console.log('可用性与完成判断');
{
const c = clock();
const p = newTracker(c);
p.record('doc', 'd1');
p.record('audio', 'a1');
p.record('video', 'v1');
p.record('video', 'v2');
p.record('video', 'v3');
// 音频每天 2 次,但全站只有 1 条音频;微课 0 条
const available = { doc: false, video: true, audio: false, micro: false };
eq(p.isFull('audio'), false, '音频只学了 1 次,还没到上限');
eq(p.done(available), true, '剩余额度的类型都没内容 → 今日任务已完成');
eq(p.done({ doc: true, video: true, audio: true, micro: true }), false, '还有可用内容时不算完成');
eq(p.done(), false, '不传可用性时按「都还有内容」处理,不误判完成');
}
// ---------------------------------------------------------------------------
// 6. 选类顺序:文档 → 视频 → 音频 → 微课;跳过已满/无内容
// ---------------------------------------------------------------------------
console.log('选类顺序');
{
const full = {};
const avail = { doc: true, video: true, audio: true, micro: true };
const isFull = (k) => !!full[k];
eq(nextTarget({ isFull, available: avail }).type, 'doc', '第一步先补文档');
full.doc = true;
eq(nextTarget({ isFull, available: avail }).type, 'video', '文档满后学视频');
full.video = true;
eq(nextTarget({ isFull, available: avail }).type, 'audio', '视频满后换音频');
full.audio = true;
eq(nextTarget({ isFull, available: avail }).type, 'micro', '音频满后换微课');
full.micro = true;
eq(nextTarget({ isFull, available: avail }), null, '全满 → 没有可做任务');
// 文档没内容:直接跳过(不能卡在缺内容的类型上)
const f2 = {};
eq(nextTarget({ isFull: (k) => !!f2[k], available: { doc: false, video: true, audio: true, micro: true } }).type, 'video', '文档无内容时跳过');
// 视频靠课程里的课时,不用单独库存;课程也没有时跳过
eq(nextTarget({ isFull: () => false, available: { doc: false, video: false, audio: true, micro: true } }).type, 'audio', '没有可学课程时跳过视频');
}
// ---------------------------------------------------------------------------
// 7. 关闭开关:完全不计数
// ---------------------------------------------------------------------------
console.log('开关');
{
const c = clock();
const p = createPointsTracker({ now: c.now, storage: fakeStorage(), enabled: false });
eq(p.isEnabled(), false, '初始关闭');
eq(p.record('video', 'v1'), false, '关闭时不计分');
eq(p.totalPoints(), 0, '关闭时积分 0');
p.setEnabled(true);
eq(p.record('video', 'v1'), true, '重新开启后可以计分');
eq(p.totalPoints(), 3, '开启后计 3 分');
}
// ---------------------------------------------------------------------------
// 8. 摘要文本
// ---------------------------------------------------------------------------
console.log('摘要');
{
const c = clock();
const p = newTracker(c);
p.record('doc', 'd1');
p.record('video', 'v1');
eq(p.summary(), '今日积分 6/24 · 文档1/1 视频1/3 音频0/2 微课0/2', '摘要含总分与各类进度');
eq(p.snapshot().total, 6, 'snapshot 给运行器用:总分');
eq(p.snapshot().max, 24, 'snapshot 给运行器用:满分');
eq(p.snapshot().progress.length, 4, 'snapshot 给运行器用:四类进度');
}
console.log('');
if (failed) {
console.log('每日积分自测:' + failed + ' 项失败');
process.exit(1);
}
console.log('每日积分自测:全部通过');