THEIA 0.5.1

THEIA v0.5.1

重点更新

启动性能与体验

• 增加 THEIA 品牌启动画面（深色背景 + "THEIA" 文字 + 旋转动画），消除启动时的黑屏等待
• 校历刷新、培养计划 PDF 解析等重型初始化移至后台执行，不阻塞窗口出现
• 主窗口在渲染器首次绘制后才显示，彻底消除窗口创建时的暗色闪烁
• 启动耗时埋点记录到诊断日志，便于后续分析瓶颈

抢课系统

• 选课推荐不再依赖 EvidenceRegistry，改为按培养方案学分缺口推荐课程
• 修复正方选课提交字段（do_jxb_id 而非 jxb_id）
• 修复网络课程选课过滤（kch 而非 kch_id）

教室查询

• 修复 N2155 教室查询接口（cdjy/cdjy_cxKxcdlb.html）
• 过滤器使用内部 ID（名称 → 无结果，ID → 正常）
• 前端下拉框传递 ID 而非显示名称
• 缓存策略：教室每天信息不变，使用缓存；场馆状态实时拉取

IRIS（QQ 伴侣）

• 教室查询：支持单节次（theia classroom 1）和节次范围（theia classroom 3-5）
• 场馆查询：返回图片表格，排序按楼梯优先 + 升序，时间段显示为范围（如"3-4"）
• 单实例锁增加心跳机制，避免进程 PID 重用导致启动失败
• 修复图片回复未捕获异常、模板字符串错误等

Ultimate 模式

• 修复 Ultra 模型 403 失败后 Agent 一直转圈的问题：适配器发射 tool: { type: 'error', name: 'ultra' } 事件，前端重置状态并显示错误
• Token 显示修复：从仅显示输出改为分别显示"输入 X · 输出 Y tokens"

全量代码评审修复

• 本地 API：Electron I/O 临时文件写入错误重试、敏感列过滤不同步、limit 默认值、HTML 转义、顶层 try/catch
• 学期排序：数值比较而非 localeCompare（"2026-12" 应在 "2026-3" 之后）
• 场馆状态：并发拉取代替串行（3 并发，12-24s → 2-4s），批量写入代替逐次
• 教室查询：bitmask OR 运算、去重、空数组归一化、参数解析、座位数校验
• 渲染器：图片尺寸限制、data-URL 长度检查、80ms 固定延迟移除
• IRIS 配置 Token 填充、本地时区 weekday 修正

稳定性与兼容性

• Windows 11 25H2 卸载文件锁定修复：等待 store 操作完成后再退出
• 启动失败对话框：单实例锁冲突 / 启动异常时弹出错误提示而非静默退出
• 单实例锁心跳：每 30 秒刷新锁文件，60 秒未刷新视为过期

MOTION 场馆

• 公开匿名 GET，无需 Cookie
• 详情页 detailUrl 携带 xq/xm 参数选择具体场馆，不传 venue=activity
• 并发拉取（最多 3 个同时），单次批量写入 store

MCP 集成

• 支持通过 theia:install-mcp-clients 安装 MCP 客户端
• 在 %USERPROFILE%\.cursor\mcp.json 中注册 THEIA 顾问工具

发布文件

• release-bin/THEIA-0.5.1-x64-win.exe — Windows x64 NSIS 安装包，248,775,952 bytes，SHA-256 D5F347AFCE7BF37309300D267514AC1BE402D31B24F0AC844FBD83E753FFFF04
• release-bin/THEIA-0.5.1-source.zip — 带 SOURCE-MANIFEST.json 的源码归档，109,425,571 bytes，SHA-256 D9D4D744C7DDF5CB87C775A2427B5D4B5FEFD392908CD3FC751E95F352002FAF
• release-bin/THEIA-0.5.1-x64-win.exe.blockmap — electron-builder 更新块映射，266,399 bytes，SHA-256 217A9350C688C26A709069E92CAD36BA57B1274E0DA25FB006578593011E3A29

源码归档 manifest 校验结果：459 个源文件，verified: true。

验证

• npm test：通过
• npx tsc -b --pretty false：通过
• npm run dist:installer：通过，生成安装包、blockmap 和源码归档

分发说明

当前构建未配置可公开验证的 Authenticode 证书，安装包状态为 NotSigned；Windows 可能显示未知发布者提示。发布前请核对上面的 SHA-256。

THEIA v0.5.0

THEIA v0.5.0

重点更新

• Agent、学业分析和数据质量链路统一使用当前快照与受限只读工具；未配置模型服务时，界面会明确提示 Agent 暂不可用。
• CAS 登录后分别验证 JWGLXT 与 THEOL 会话；教务 API 失败时按来源回退到现有浏览器 SSO，并保留来源状态。
• 成绩页使用规范化计算 GPA，同时保留学校提供的 GPA；认证、同步、模型配置和打包回归均采用受限并发测试。
• 发布包继续排除凭据、Cookie、运行期缓存、诊断文件和实验抓取脚本。

发布文件

• release-bin/THEIA-0.5.0-x64-win.exe — Windows x64 NSIS 安装包，268,291,346 bytes，SHA-256 66D2AF7DDE177F53F4CC07055C32BE9C29E6E0B268503A633267A933352E62E5
• release-bin/THEIA-0.5.0-source.zip — 带 SOURCE-MANIFEST.json 的源码归档，128,433,682 bytes，SHA-256 663249FF83B4B8D05A03F614FA0E96FEA2D2CAE63D096034FA8684EDF16373F9
• release-bin/THEIA-0.5.0-x64-win.exe.blockmap — electron-builder 更新块映射，281,931 bytes，SHA-256 CE54DFDDDBDD1A4D5EC8E64CB48529DBB4BA5085086179410C1FBFA45331BBB1

源码归档 manifest 校验结果：400 个源文件，verified: true。

验证

• npm test：812/812 通过，脚本固定使用 node --test --test-concurrency=4 tests/*.test.mjs
• npm run lint：通过
• npx tsc -b --pretty false：通过
• npm run dist:installer：通过，生成安装包、blockmap 和源码归档
• npm run smoke:packaged：通过，schema: theia-packaged-smoke/v1、ok: true、preloadErrors: []
• 安装包、源码归档和 blockmap 已执行 SHA-256 校验；源码归档已再次执行 manifest 校验

分发说明

当前构建未配置可公开验证的 Authenticode 证书，安装包状态为 NotSigned；Windows 可能显示未知发布者提示。发布前请核对上面的 SHA-256。真实校园登录、真实 Provider 网络请求和人工桌面验收不由离线 packaged smoke 代替。

THEIA v0.4.2

THEIA v0.4.2

中文

重点更新

• 学业顾问加入本地数据质量、学业风险、日程、课程决策、证据追溯和显式披露控制；模型调用仍由用户自行配置，并只在用户确认的范围内使用本地数据。
• 学业数据、统一认证浏览器会话和可选教务 API 的失败恢复及数据来源标记得到补强，保留本地优先与只读边界。
• 安装包增加离线冒烟验证；源码归档通过清单校验，排除凭据、Cookie、运行期缓存、诊断和实验抓取脚本。
• 项目采用 MIT 许可证，并补充安全报告与分发兼容性说明。

发布文件

• THEIA-0.4.2-x64-win.exe: Windows x64 安装包。
• THEIA-0.4.2-source.zip: 可复现、带清单的源码归档。

安全与验证

• 本版本没有可公开验证的 Authenticode 签名。Windows 可能显示未知发布者提示；请仅从官方 Release 下载，并校验 Release 中公布的 SHA-256。
• MIT 仅适用于 THEIA 的源代码，不授权学校服务、第三方商标或用户数据。
• THEIA 不是学校官方系统，任何课程、考试、选课或作业信息均应以学校系统为准。

English

Highlights

• Academic Advisor adds local data quality, academic risk, agenda, course-decision, evidence-traceability, and explicit disclosure controls. Model use remains user-configured and limited to user-approved local context.
• Recovery and provenance for academic data, browser SSO sessions, and the optional academic API are strengthened while retaining local-first, read-only boundaries.
• The installer receives offline smoke coverage. The source archive is manifest-verified and excludes credentials, cookies, runtime caches, diagnostics, and experimental crawlers.
• THEIA is released under the MIT License with security-reporting and distribution-compatibility documentation.

Release Files

• THEIA-0.4.2-x64-win.exe: Windows x64 installer.
• THEIA-0.4.2-source.zip: manifest-backed reproducible source archive.

Security and Verification

• This release has no publicly verifiable Authenticode signature. Windows may show an unknown-publisher prompt; download only from the official Release and verify the published SHA-256 values.
• MIT covers THEIA source code only. It does not grant rights to school services, third-party trademarks, or user data.
• THEIA is not an official university system. Verify all course, exam, enrollment, and assignment information with the school system.

THEIA 0.4.1

THEIA 0.4.1 首个公开版本。

主要内容：

• 本地优先的教务、北化在线THEOL、邮箱、校历与课程工作台
• 完整的同步明细、日志和单项重试
• 学业进度树、课程统计与可复现 GPA 计算
• GPA 使用去重后的计入课程并显示四位小数
• 修复校历两份 PDF 在内置阅读器中的打开失败
• 确定性 AI 顾问 P0 基础、证据链和隐私安全导出

验证：

• npm test: 363/363
• npm run lint
• npm run build
• npm run smoke:packaged

安装器 SHA-256：
A28B017DA34C36A09AA2833CE7C493B08B4504342F45E5F39720BD1A656EEA66

源码包 SHA-256：
7A01360EF68B735D2A229C0560112BA1492D6479637BE009B7B5D37A50C5556D