#!/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('每日积分自测:全部通过');