feat(island,homework,schedule): 灵动岛点开修复+胶囊类型汇总 · 作业看板与未交名单 · 单双周课表与 ClassIsland 课程表导入
一、灵动岛(用户反馈的三处"点不开"全部修复)
- 非紧急叫人:上课时段仍以胶囊保持可见、可点开(不再只进队列导致屏幕上什么都没有);
新增 isOpenable():紧急消息 + 任何"叫人"都允许点开,但普通叫人不会自动展开打断课堂。
- 紧急叫人收起后再点:命中改为"主进程按光标位置兜底校正"(上一轮的 island:set-hit-rect 轮询),
本轮补齐叫人类专项回归(展开 → 收起 → 再次点开)。
- 设置页预览:新增 preview 通道 —— 示例岛直接展开、失焦不收起、30 秒自行消失、关掉不残留。
- 收起态胶囊汇总消息类型:多条时显示「新消息:叫人/作业/通知(共 3 条)」+「点击查看」+ 类型小标签。
- 顺带修掉两个真问题:胶囊态收到新消息会把上一条静默顶掉(现在一律回队);
syncWindow 的上课时段守卫只认"紧急"导致普通叫人被藏掉。
- 性能:岛体矩形上报限流(~10 次/秒 + 尾随补发),修掉每帧 IPC 导致的开合采样骤降。
二、作业(学生端 + Web 教师端)
- 新增**看板模式**:按科目分卡片、点卡片放大全屏、工具栏可切「看板/列表」、
开关「显示时间」、拖「看板字号」(11–28px),偏好持久化到客户端配置 homeworkBoard。
- 去掉「全班标记完成」,改为**未交名单**:勾选没交的同学,其余自动标记已交;
新增 GET/PATCH /api/homeworks/:id/submissions(教师与班级设备可用,普通学生 403)。
三、课表单双周 + ClassIsland 课程表导入
- Schedule 新增 weekParity(ALL/ODD/EVEN)+ 迁移;周视图与上课判定按「第 1 周=单周」过滤,
历史数据默认 ALL 行为不变;Web 手动新增/编辑课表可选单双周,学生端课表打「单周/双周」标签。
- 修复既有 P0 bug:ClassIsland 真实档案里 TimeLayouts 是 "Guid → { Name, Layouts }" 字典,
旧解析器只认数组/.items,导致**真实导出完全导不进来**;现已按真实形态解析(并兼容旧写法),
同时补上 TimeType=3(行动)映射。
- 新增 ClassIsland 课程表(ClassPlan)导入:解析 TimeRule.WeekCountDiv/WeekCountDivTotal → 单双周,
Classes[i] 对齐第 i 个 TimeType=0 的时间点,Subjects 映射科目(缺失自动补建课程),
星期 0=周日 换算为 1=周一 … 7=周日;replace/merge 两种模式,预览只解析不写库。
- 新增维护脚本 packages/server/scripts/apply-parity-column.cjs(手工覆盖 dist 部署时补列用)。
验证:verify:e2e 148/148(新增单双周 12 项 + 课程表导入 5 项)、verify:desktop 71/71(复跑 65/65)、
verify:web 20/20、typecheck / lint / format 全绿;服务端与 Web 已重新打包并部署到本机安装目录。
This commit is contained in:
1 parent
86430c5f4a
commit
b8ef5d8dbb
34 files changed
+2351
-86
No files matched your search
@@ -2,7 +2,14 @@ import fs from 'node:fs';
|
||||
import path from 'node:path';
|
||||
import { app, safeStorage } from 'electron';
|
||||
import { DEFAULT_ISLAND_APPEARANCE, DEFAULT_SERVER_URL, type IslandAppearance } from '@classhelper/shared';
|
||||
import type { DesktopStoredConfig } from '../types/desktop.js';
|
||||
import type { DesktopStoredConfig, HomeworkBoardSettings } from '../types/desktop.js';
|
||||
|
||||
/** 作业页展示偏好默认值(看板 + 不显示时间 + 15px) */
|
||||
const DEFAULT_HOMEWORK_BOARD: HomeworkBoardSettings = {
|
||||
mode: 'board',
|
||||
showTime: false,
|
||||
fontSize: 15,
|
||||
};
|
||||
|
||||
interface PersistedConfig {
|
||||
serverUrl: string;
|
||||
@@ -12,6 +19,8 @@ interface PersistedConfig {
|
||||
tokenEncrypted: boolean;
|
||||
/** 个性化设置:灵动岛外观(向后兼容:旧配置文件没有该字段时用默认值补齐) */
|
||||
island?: Partial<IslandAppearance>;
|
||||
/** 作业页展示偏好(向后兼容:旧配置文件没有该字段时用默认值补齐) */
|
||||
homeworkBoard?: Partial<HomeworkBoardSettings>;
|
||||
}
|
||||
|
||||
const DEFAULT_CONFIG: PersistedConfig = {
|
||||
@@ -20,8 +29,23 @@ const DEFAULT_CONFIG: PersistedConfig = {
|
||||
token: null,
|
||||
tokenEncrypted: false,
|
||||
island: { ...DEFAULT_ISLAND_APPEARANCE },
|
||||
homeworkBoard: { ...DEFAULT_HOMEWORK_BOARD },
|
||||
};
|
||||
|
||||
/** 作业页偏好的合法化(模式白名单、字号夹紧) */
|
||||
function normalizeHomeworkBoard(input?: Partial<HomeworkBoardSettings>): HomeworkBoardSettings {
|
||||
const mode = input?.mode === 'list' ? 'list' : 'board';
|
||||
const rawFont =
|
||||
typeof input?.fontSize === 'number' && Number.isFinite(input.fontSize)
|
||||
? input.fontSize
|
||||
: DEFAULT_HOMEWORK_BOARD.fontSize;
|
||||
return {
|
||||
mode,
|
||||
showTime: input?.showTime === true,
|
||||
fontSize: Math.min(28, Math.max(11, Math.round(rawFont))),
|
||||
};
|
||||
}
|
||||
|
||||
/** 外观字段的合法区间校验(越界值直接夹紧,避免用户配置破坏灵动岛布局) */
|
||||
function normalizeIslandAppearance(input?: Partial<IslandAppearance>): IslandAppearance {
|
||||
const clamp = (value: unknown, min: number, max: number, fallback: number): number => {
|
||||
@@ -99,6 +123,7 @@ function readPersisted(): PersistedConfig {
|
||||
token: typeof parsed.token === 'string' ? parsed.token : null,
|
||||
tokenEncrypted: parsed.tokenEncrypted === true,
|
||||
island: normalizeIslandAppearance(parsed.island),
|
||||
homeworkBoard: normalizeHomeworkBoard(parsed.homeworkBoard),
|
||||
};
|
||||
} catch {
|
||||
return { ...DEFAULT_CONFIG };
|
||||
@@ -119,6 +144,7 @@ export function getConfig(): DesktopStoredConfig {
|
||||
username: persisted.username,
|
||||
token: decryptToken(persisted),
|
||||
island: normalizeIslandAppearance(persisted.island),
|
||||
homeworkBoard: normalizeHomeworkBoard(persisted.homeworkBoard),
|
||||
};
|
||||
}
|
||||
|
||||
@@ -135,6 +161,12 @@ export function saveConfig(patch: Partial<DesktopStoredConfig>): DesktopStoredCo
|
||||
if (patch.island !== undefined) {
|
||||
persisted.island = normalizeIslandAppearance({ ...persisted.island, ...patch.island });
|
||||
}
|
||||
if (patch.homeworkBoard !== undefined) {
|
||||
persisted.homeworkBoard = normalizeHomeworkBoard({
|
||||
...persisted.homeworkBoard,
|
||||
...patch.homeworkBoard,
|
||||
});
|
||||
}
|
||||
if (patch.token !== undefined) {
|
||||
const encrypted = encryptToken(patch.token);
|
||||
persisted.token = encrypted.token;
|
||||
|
||||
@@ -434,7 +434,12 @@ class IslandController {
|
||||
// 上课时段:普通通知(含普通叫人)一律不显示;但紧急通知 / 紧急叫人本来就是必须
|
||||
// 立刻看到的,收起(回缩为胶囊)之后必须能再次点开——否则学生会误以为消息消失了。
|
||||
const showing = this.state.active;
|
||||
if (this.state.inClass && !this.isOpenable(showing)) break;
|
||||
if (this.state.inClass && !this.isOpenable(showing)) {
|
||||
logger.info(
|
||||
`灵动岛:上课时段忽略展开(priority=${showing?.priority ?? '-'} kind=${showing?.kind ?? '-'} id=${showing?.id ?? '-'})`,
|
||||
);
|
||||
break;
|
||||
}
|
||||
// 收起态(胶囊 / 空闲细缝)再次点击必须能打开:
|
||||
// active 为空但队列里还有未看通知时,先把它取出来当"当前通知"再展开,
|
||||
// 否则会出现"岛明明在屏幕上,点了没反应"(部分情况下的收起态无法再次打开)。
|
||||
@@ -448,6 +453,11 @@ class IslandController {
|
||||
}
|
||||
const active = this.state.active;
|
||||
if (active) {
|
||||
if (this.state.mode !== 'expanded') {
|
||||
logger.info(
|
||||
`灵动岛:展开通知 ${active.id}(priority=${active.priority} kind=${active.kind ?? '-'})`,
|
||||
);
|
||||
}
|
||||
this.setState({ mode: 'expanded' });
|
||||
this.scheduleCollapse(
|
||||
this.isImmediate(active)
|
||||
|
||||
@@ -1133,11 +1133,20 @@ async function runIslandChecks(
|
||||
await sleep(ISLAND_TIMEOUTS.pill + 700);
|
||||
const lingered = island.getState();
|
||||
const lingeredVisible = islandWindow?.isVisible() ?? false;
|
||||
// 断言"没有消失"即可:真人可能在这 15 秒里点了岛(那就从胶囊变成展开态),
|
||||
// 但只要还看得见、还是同一条通知,就说明"常驻"成立。
|
||||
record(
|
||||
'收起后胶囊常驻(超时不再消失,随时可再次点开)',
|
||||
collapseBefore.mode === 'pill' && lingered.mode === 'pill' && lingeredVisible,
|
||||
`收起前=${collapseBefore.mode} 超时后=${lingered.mode} 可见=${lingeredVisible}`,
|
||||
collapseBefore.mode === 'pill' &&
|
||||
lingered.mode !== 'hidden' &&
|
||||
lingeredVisible &&
|
||||
lingered.active?.id === 'smoke-collapse-reopen',
|
||||
`收起前=${collapseBefore.mode} 超时后=${lingered.mode} 可见=${lingeredVisible} ` +
|
||||
`active=${lingered.active?.id ?? '-'}`,
|
||||
);
|
||||
// 先确保处于胶囊态(真人在等待期间可能点开过),再验证"命中恢复 + 点击展开"
|
||||
island.handleAction({ action: 'collapse' });
|
||||
await sleep(500);
|
||||
// 命中兜底:把窗口显式置为"穿透",再把光标位置注入到胶囊中心 ——
|
||||
// 主进程每 120ms 按光标校正一次命中,必须自己恢复(这正是"点开再收起后点不开"的兜底修复)。
|
||||
island.setInteractive(false);
|
||||
@@ -2281,24 +2290,27 @@ export async function runSmokeTest(win: BrowserWindow): Promise<void> {
|
||||
record('冒烟收尾:清理登录态', Boolean(cleanup?.ok), String(cleanup?.detail ?? ''));
|
||||
}
|
||||
|
||||
// 托盘与退出清理放在最后:会隐藏主窗口并销毁托盘/灵动岛
|
||||
await runTrayAndShutdownChecks(win, record);
|
||||
|
||||
const failed = results.filter((item) => !item.ok);
|
||||
const passed = results.length - failed.length;
|
||||
console.log(`\n[SMOKE] ${passed}/${results.length} 项通过`);
|
||||
|
||||
const resultFile = process.env.ELECTRON_SMOKE_RESULT;
|
||||
if (resultFile) {
|
||||
/**
|
||||
* 把当前结果落盘 + 打印汇总。
|
||||
* 为什么要写两次:托盘/退出清理用例会真的走一遍"退出应用",进程可能在收尾代码执行前就退出,
|
||||
* 那样 ELECTRON_SMOKE_RESULT 就不会生成(重启校验会误报"结果=-1/0")。
|
||||
* 所以在跑托盘用例之前先写一次,收尾再写一次(覆盖全部用例)。
|
||||
*/
|
||||
const writeResult = (): void => {
|
||||
const failedItems = results.filter((item) => !item.ok);
|
||||
const passedCount = results.length - failedItems.length;
|
||||
console.log(`\n[SMOKE] ${passedCount}/${results.length} 项通过`);
|
||||
const resultFile = process.env.ELECTRON_SMOKE_RESULT;
|
||||
if (!resultFile) return;
|
||||
try {
|
||||
fs.mkdirSync(path.dirname(resultFile), { recursive: true });
|
||||
fs.writeFileSync(
|
||||
resultFile,
|
||||
JSON.stringify(
|
||||
{
|
||||
passed,
|
||||
passed: passedCount,
|
||||
total: results.length,
|
||||
ok: failed.length === 0,
|
||||
ok: failedItems.length === 0,
|
||||
results,
|
||||
finishedAt: new Date().toISOString(),
|
||||
appVersion: app.getVersion(),
|
||||
@@ -2313,7 +2325,15 @@ export async function runSmokeTest(win: BrowserWindow): Promise<void> {
|
||||
} catch (error) {
|
||||
console.error('[SMOKE] 写入结果文件失败', error);
|
||||
}
|
||||
}
|
||||
};
|
||||
|
||||
writeResult();
|
||||
|
||||
// 托盘与退出清理放在最后:会隐藏主窗口并销毁托盘/灵动岛
|
||||
await runTrayAndShutdownChecks(win, record);
|
||||
|
||||
writeResult();
|
||||
|
||||
const failed = results.filter((item) => !item.ok);
|
||||
app.exit(failed.length === 0 ? 0 : 1);
|
||||
}
|
||||
Reference in new issue
Block a user