详情请见：ImmersingEducation/ImmersingHomeworkreleases/tag/0.3.0.0

方圆作业板（ImmersingHomework）0.3.0.0-beta

发布日期: 2026-09-27

📝 概述

这是 ImmersingHomework 在 0.2.0.0-beta 基础上的新版本。本版本为软件补上了「被外部唤起」的能力：新增 immersinghomework:// 自定义 URL 协议、路由分发与单实例 URL 转发，并支持以纯查询方式在命令行取回指定日期的作业 JSON；同时带来外观样式（跟随系统 / 浅色 / 深色）切换、全新的欢迎向导样式与预置默认科目。构建编排已迁移至 Fallout，并上线 GitHub Actions 发布流水线，桌面三平台与移动端的打包、发版流程实现自动化。

✨ 新功能

URL 协议与路由（新）

自定义 URL 协议 - 支持注册 / 注销 immersinghomework:// 协议，可通过链接直接唤起软件
协议注册开关 - 基础设置页与欢迎向导新增「注册 URL 协议」项，可随时开启或关闭；开机自启与协议注册状态会持久化到设置中
平台实现 - Windows 写入当前用户的注册表项；Linux 生成 ~/.local/share/applications 下的桌面项并通过 xdg-mime 注册处理器；macOS 由应用包的 Info.plist 声明协议，并安装 kAEGetURL 事件处理器接收链接
路由分发 - 支持 immersinghomework://、://open、://app（显示主窗口）与 ://settings（打开设置窗口）；未注册的路由会记录警告而非静默失败
单实例 URL 转发 - 已有实例运行时，新进程通过命名管道（管道名按用户隔离）把 URL 转发给已有实例后退出，避免重复启动
homework 查询路由 - immersinghomework://homework?date=yyyy-MM-dd（缺省为当天）可无需已有实例，直接从磁盘读取作业并以格式化 JSON 输出到标准输出；此模式下日志只写文件，不污染标准输出，便于被脚本或其它程序调用

外观与界面

外观样式切换 - 新增「跟随系统 / 浅色 / 深色」三档主题，可在设置中即时切换
主题适配重构 - 主窗口、作业卡片、空状态提示、存储管理对话框、欢迎向导、设置窗口与异常窗口改用 FluentAvalonia 主题动态资源，移除写死的浅色主题与硬编码颜色，深浅色下均正常显示
欢迎向导（OOBE）全新样式 - 改为顶部标题栏 + 内容区 + 底部步骤栏布局，底部显示当前步骤与「上一步 / 下一步」按钮

其它

预置默认科目 - 首次使用即预置语文、数学、英语、物理、化学、生物、政治、历史、地理、体育
更新应用图标 - 桌面端与移动端同步更换新图标

🔧 修复

修复 Launcher 编译时未同步最新的主程序文件：改为在编译后整体复制主程序输出目录，确保 Launcher 携带的主程序始终是最新构建
修复 Launcher 与桌面发布脚本的若干构建问题

📦 构建与分发

构建编排迁移至 Fallout - 新增 build/、build.sh、build.ps1 与 .fallout/ 配置，移除旧的 scripts/publish-desktop.sh
打包类型 - 支持 Portable、DotNetSingleFile、WindowsInstaller、LinuxDeb、LinuxRpm、LinuxAppImage、MacOSAppBundle、MacOSDmg、MacOSPkg
自动化发布流水线（新） - 新增 GitHub Actions 工作流，向 main 推送以 release x.x.x.x 开头的提交即可发布（或在 Actions 页面手动触发）
- 并行构建 Windows / Linux / macOS 桌面产物、Android APK 与 iOS IPA
- 自动校验各工程版本号与发布版本是否一致
- 自动以 CHANGELOG/<版本>.md 作为 Release Notes，并创建草稿 Release 供人工确认后发布
- Android versionCode 与 iOS CFBundleVersion 由版本号推导，保证随版本单调递增
- APK / IPA 支持通过仓库 Secrets 配置签名；未配置签名时仍会构建并给出提示
Launcher 工程补充包元数据（版本、作者、描述、仓库地址、许可证等），并纳入解决方案

📦 分发说明

桌面端：Windows / Linux / macOS 的安装包与便携包由流水线自动构建并附在 Release 中，仍以手动下载安装的方式分发
移动端：Android 分发 APK，iOS 分发 IPA（未配置签名 Secrets 时提供未签名产物，需自行签名后安装）
自动更新基础设施已就位，但本版本暂未启用自动更新（更新设置页仍处于隐藏状态），请留意后续版本

🐛 已知问题

本版本为手动分发测试版，可能存在一些问题，欢迎反馈！