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

+1
View File
@@ -59,6 +59,7 @@ node dev/tests/real-test.mjs --keep # 跑完不关浏览器,便于人工复
```bash
npm run test:tui # 面板渲染 / 列宽 / 尺寸自适应
npm run test:study # 学习时长与学分累计口径
npm run test:points # 每日积分:类型识别 / 封顶 / 去重 / 跨天清零 / 选类顺序
```
它用假 stdout 渲染真实帧,逐行量列宽,重点盯五件容易错的事:
+86
View File
@@ -0,0 +1,86 @@
#!/usr/bin/env node
/**
* Bark 完成提醒(runner/notify.mjs)自测:只验证地址拼接与文案,不发真实请求。
*
* 这两块错了都不会让运行器报错——只会在手机上收到一条打不开的链接或看不懂的文案,
* 而且往往要等到真正刷完那一刻才发现。用纯函数把格式钉死。
*
* 用法:
* node dev/tests/notify-test.mjs
* npm run test:notify
*/
import { buildBarkUrl, buildFinishMessage } from '../../runner/notify.mjs';
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));
}
console.log('地址拼接');
{
eq(buildBarkUrl('', 't', 'b'), '', '空地址 = 不推送');
eq(
buildBarkUrl('https://api.day.app/KEY', '任务完成', '积分 15/24'),
'https://api.day.app/KEY/' + encodeURIComponent('任务完成') + '/' + encodeURIComponent('积分 15/24'),
'根地址 + 中文标题/正文按路径段编码'
);
eq(
buildBarkUrl('https://api.day.app/KEY/', 't', 'b', { group: '云学堂', ttl: 600 }),
'https://api.day.app/KEY/t/b?group=' + encodeURIComponent('云学堂') + '&ttl=600',
'结尾斜杠不会拼出双斜杠,group/ttl 追加为查询参数'
);
eq(
buildBarkUrl('https://api.day.app/KEY/{title}/{body}', 't', 'b'),
'https://api.day.app/KEY/t/b',
'带 {title}/{body} 占位符的完整模板'
);
eq(
buildBarkUrl('https://api.day.app/KEY/{title}/{body}?group=example&ttl=600', 't', 'b', { group: 'x', ttl: 1 }),
'https://api.day.app/KEY/t/b?group=example&ttl=600',
'模板里已经有 group/ttl 时不再重复追加'
);
ok(
buildBarkUrl('https://api.day.app/KEY', 'a&b', 'c?d').indexOf('a%26b') > 0,
'特殊字符不会破坏路径'
);
}
console.log('收尾文案');
{
const done = buildFinishMessage({
kind: 'done',
finishReason: '已完成 10 门(达到上限 maxCourses=10)',
completed: 10,
elapsed: 125,
points: { enabled: true, text: '今日积分 15/24 · 文档1/1 视频3/3 音频1/2 微课0/2' },
});
eq(done.title, '云学堂助手:任务完成', '正常完成标题');
ok(done.body.indexOf('今日积分 15/24') === 0, '正文以今日积分开头');
ok(done.body.indexOf('完成 10 门 · 用时 2 分 5 秒') > 0, '完成门数与用时');
ok(done.body.indexOf('达到上限') > 0, '带上结束原因');
eq(buildFinishMessage({ kind: 'stalled' }).title, '云学堂助手:长时间无进展', '卡死标题');
eq(buildFinishMessage({ kind: 'login' }).title, '云学堂助手:登录失败', '登录失败标题');
ok(buildFinishMessage({ kind: 'done', elapsed: 45 }).body.indexOf('用时 45 秒') > 0, '不足一分钟只显示秒');
const noPoints = buildFinishMessage({ kind: 'done', completed: 3, elapsed: 0 });
ok(noPoints.body.indexOf('今日积分') < 0, '积分模式关闭时不硬塞今日积分');
const off = buildFinishMessage({
kind: 'done', completed: 3, elapsed: 0,
points: { enabled: false, text: '今日积分 0/24 · 文档0/1 视频0/3 音频0/2 微课0/2' },
});
ok(off.body.indexOf('今日积分 0/24') < 0 && off.body.indexOf('每日积分模式:关') >= 0,
'enabled=false 时只说明模式已关闭,不贴 0/24');
}
console.log('');
if (failed) {
console.log('✘ ' + failed + ' 项失败');
process.exit(1);
}
console.log('✔ 全部通过');
+239
View File
@@ -0,0 +1,239 @@
#!/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('每日积分自测:全部通过');