Matheca for Android v0.1.0

Android 正式包（release 构建，已签名）。

安装：下载 APK 后用手机直接安装。覆盖安装要求包名 com.matheca.app 与签名一致，从旧版 Mathector 迁移需先卸载。

包含：隐私政策与首次启动同意门、启动屏、题目删除撤销、题源选择、品牌图标。

校验：APK 的 SHA256 附在 .sha256 文件里，下载后可自行比对。

注意：桌面端（Windows x64 便携版）不在本次发布内。

Matheca · Windows 与 Android

项目统一使用 Matheca 名称。Android App 与 Windows 桌面版源码现在由同一仓库维护，原仓库历史提交和旧版本继续保留。

下载文件	平台 / 版本	使用方式
Matheca-win32-x64-0.1.0.zip	Windows x64 · 0.1.0	完整解压后运行 Matheca.exe，保留 DLL、resources/ 等运行文件
Matheca-android-0.21.0-debug.apk	Android 8.0+ · 0.21.0	Debug 签名构建
SHA256SUMS.txt	两个平台	下载文件的 SHA256 校验值

源码入口：Windows · Android · 同仓库开发说明。

Windows 版包含本地题库、识别校对、AI 解题任务、题集与文档导出、手机浏览器扫码上传、四套强调色和手动录题保存确认。题目编辑无需过渡动画，确认校对后返回原列表，题库按钮悬停不再展开侧栏。

两端分别保存本地数据，本次整合是统一源码、命名和发布入口；没有新增跨设备实时同步。Android 包 ID、旧类名和旧备份 / 数据目录标识保留以兼容已有安装和题库。

验证记录见 整合发布验证。Android 本次执行构建、39 项单元测试及 APK 签名检查；未执行真机界面测试。Windows 在新打包程序上使用隔离数据验证。

Matheca Android 0.22.0 · 桌面配色对齐

Matheca Android 0.22.0

发布日期：2026-10-19。Android 高中数学题集 App，最低 Android 8.0。

本次更新

Android 配色与桌面 Matheca 的实际实现对齐：默认石墨，另提供雾蓝、陶土、梅紫。进入“我的 → 外观”，可独立选择配色和白天／黑夜／跟随系统，选择立即生效并本地保存。

• 白天沿用桌面的中性灰白背景、石墨正文、浅灰题目卡片和中性年级／知识点标签；主操作、导航、筛选及焦点跟随强调色。已校对、警告、错误保持独立状态色。
• 黑夜保留 Android 现有能力，使用深灰阅读底与浅强调色，主要按钮配深色前景。桌面当前是浅色工作台，黑夜色板为 Android 适配。
• 顶部统计取消亮蓝渐变，继续等宽、紧凑、居中。题干、AI 解答及独立公式预览的文字改为中性色；公式错误也适配黑夜。
• 菜单使用区别于页面与卡片的中性底色，保留圆角、无黑色阴影边框。悬浮按钮跟随配色，保留轻微透明、模糊和回弹。应用图标和系统默认强调色改为石墨。
• 升级默认使用石墨，保留已有明暗模式、接口配置与题库。保留远端的 Matheca 统一命名和旧包 ID 兼容；数据库仍为版本 4，ZIP 备份格式仍为版本 1，同时接受旧 Mathector 格式标识，外观偏好不进入题库备份。

颜色来源、完整角色与界面样例见 配色规范。

下载

下载 Matheca-android-0.22.0-debug.apk。当前为 Debug 构建，与上一版签名相同，可以覆盖安装并保留数据。

• versionCode：22；versionName：0.22.0。
• 大小：25,327,226 字节。
• SHA-256：942BD9BDAC8C12238685252DC11369D56B6848449A3FAE295FF7881EED47CC93。
• APK v2 签名验证通过，证书与上一版一致；模拟器覆盖安装后核对版本为 22／0.22.0。

验证

最终 APK、测试包、41 项单元测试和 lintDebug 构建完成。单元测试 0 失败／0 错误；Lint 0 错误、18 项警告。远端同仓库整合后的最终主构建 34 秒，随后仅重新构建截图和可达性测试包。

新增测试验证桌面颜色契约、八种主题组合的正文／辅助字／标签／主按钮／选中／错误等前景背景配对，普通文字至少 4.5:1，输入边界至少 3:1。白天菜单原先选用的较深浅灰使辅助字接近阈值，调整为桌面的 hover 灰后全部通过。

本次分批通过 7 个独立设备场景：

1. 在独立偏好中验证四种配色持久化、明暗模式独立、已有接口字段和自动解题偏好保留；未知配色回退石墨。
2. 实际设置页切换四种配色 × 两种明暗模式，检查单选语义、48 dp 选择区域、统计文字角色与实时显示；截图等待 KaTeX 字体、DOM 颜色、WebView 可见状态及绘制帧完成。
3. 验证两个主题下题集添加入口、年级菜单选择关闭，以及选题面板下滑收回。
4. 横屏下配色选项可滚动到达，完整露出于底部悬浮导航之上。
5. 约 375 dp 小屏、2.0 倍字号、系统窗口／转场／属性动画均关闭时，配色文字和选择区域保持可用。横屏也检查了相同配置，之后恢复原来的视口、字体及动画偏好。
6. 回归题库、编辑预览和 AI 解答中的行内与独立公式渲染、公式区域点击和预览不追加校对字段。
7. 回归紧凑文档设置保存、输入校验、题集添加按钮实际颜色跟随主题及文字对比度，保留添加与返回流程。

第一轮菜单检查使用 Espresso 返回时遇到原生弹出窗口焦点等待，其他三个新增场景通过；改为显式选择年级后验证菜单关闭，没有修改应用菜单逻辑。随后主题／菜单／公式／题集回归 4 项通过（53.560 秒）。最终 APK 的八组合矩阵专项通过（24.899 秒），字体与横屏专项 2 项通过（10.332 秒）。

共收集 14 张当前版本截图，公开 6 张使用临时数学题与应用示例的界面图。原先的公式加载过渡帧由等待实际绘制后的最终截图替换。本轮不重新生成历史 PDF／DOCX 样张，不调用真实识别服务，不操作真实手机。设备操作限定为 emulator-5554，测试结束恢复外观设置并删除临时题目／题集。未完成厂商真机和平板矩阵；此前其他功能边界继续见 README。

同仓库整合复核

同步时发现远端已合并 Windows 与 Android，原仓库已重命名为 SACO1F/Matheca。本次合入该提交，保留统一名称、备份格式旧名兼容及 Windows 代码；桌面实现与整合提交一致，没有更改桌面应用。Android 使用独立标签 android-v0.22.0，保留现有 Windows 发布与下载。

整合后额外覆盖新、旧两种备份格式标识，以及完整题库在独立空数据库中恢复题目、原图、解答、题集顺序和文档设置。最终设备检查包含上述七个场景和两项备份兼容／恢复检查，共九个不同场景，详见本次验证记录。

整合后首轮九项设备检查八项通过（49.216 秒），紧凑设置的间距断言出现一次失败；未改动应用或测试代码，在相同安装包上单独复测该场景通过（13.913 秒），包括文档字段保存、主题按钮颜色及文字对比度。故九个场景按分批结果记为通过，首轮日志仍保留，不能称为一次全部通过。

Mathector 0.21.0

Mathector 0.21.0

发布日期：2026-10-08。原生 Android 高中数学题集 App，最低 Android 8.0。

本次改动

• 新增完整题库 ZIP 备份与合并恢复。题库右上角“题库备份”和“我的 → 题库导入与导出”均可使用，通过系统文件选择器保存到下载文件夹、用户目录或云盘。卸载前保留 ZIP，重新安装后选择并导入即可继续使用。
• 备份包含题干与子题、独立 LaTeX、分类、收藏／校对标记、AI 解答、可用原图、自定义知识点、题集顺序及文档设置。原图按内容去重，恢复时重建新图片路径和有效解答指纹；缺失原图会明确提示，其他数据保留。接口配置和 Key、应用偏好、后台任务及操作记录不进入备份，恢复不发起识别／解题请求。
• 同编号题目与题集保留本机已有版本，重复导入不会重复添加；新题集可关联本机已有题目。导入前校验备份格式、版本、引用、路径、CRC 和图片 SHA-256，提供数量预览与取消操作。恢复失败回滚新增记录、知识点及原图。
• 缩小题库顶部收录题目／待校对／收藏统计卡片：纵向内边距 12 dp、数字 24 sp、中文 11 sp，标准字号下高度约 68 dp；三列等宽，数字和下方中文沿同一中线居中，白天／黑夜主题适配。

格式、使用步骤与大小限制详见 题库备份说明。源码同步到公开仓库 SACO1F/Mathector，默认分支 main，版本标签 v0.21.0。

安装包

下载 Mathector-0.21.0-debug.apk。本版本为调试构建，与上一版相同签名，可覆盖安装并保留应用数据。

• versionCode：21；versionName：0.21.0。
• 大小：24,818,180 字节。
• SHA-256：1A4C8D28AC4569F79222F34ABC914294B578DCCBFAFC1CE13EFAEF73D9B64025。
• APK Signature Scheme v2 验证通过；数据库版本保持 4。

验证

Debug APK、Android 测试包、39 项单元测试和 lintDebug 均完成，单元测试 0 失败／0 错误，Lint 0 错误／20 项既有警告。初次构建 2 分 36 秒，数量限制统一后的最终增量构建 46 秒。

Android 模拟器 emulator-5554 的第一轮 6 项设备测试全部通过，31.313 秒完成；补测空库／缺失原图和移植恢复回归 2 项通过，6.971 秒完成，覆盖 7 个独立设备场景：

• 在新建独立空数据库、新原图目录和独立知识点偏好中模拟重新安装，验证题干／LaTeX／分类／标记／解答／原图字节／自定义知识点／题集顺序及试卷设置恢复。共享原图只打包一次，有效解答重建指纹、旧解答不被误标为有效，接口偏好不变。
• 合并导入保留本机已修改的题目与无关题目，新的题集仍能关联本机已有题目；再次导入跳过已有题目和题集，保留本机题集名及考试时间。
• 非 ZIP、错误格式、不支持版本、越界路径、缺图及图片内容被改写的备份均在预览前拒绝，现有题库、知识点及文件保持原样。
• 注入数据库写入失败，验证题目、题集和关联事务回滚，新增知识点及原图拷贝也回滚，原始图像保持可用。
• 通过系统 CreateDocument／OpenDocument 合约验证备份保存、数量预览、取消、恢复已删除的临时题目和题集、重复导入，以及“我的”页面的文件选择取消。测试使用受控文件 URI 和选择器结果，不上传实际云盘；确认单题自动解题开关恢复后没有创建解题任务。
• 两种主题下验证统计卡片高度不超过 74 dp、三列等宽、数字和中文文本中心对齐、数量正确；题库备份窗口及我的页面入口可用。
• 空题库可导出并恢复；原图已丢失时明确统计缺失数量，题干、独立公式、已有解答、题集与文档设置仍能恢复。

收集并核对 6 张当前版本界面截图，公开展示白天／黑夜题库、我的备份卡片及黑夜圆角备份窗口。导入预览的全屏截图含打开动画中间帧，仅留在本机验证产物中。公开截图使用临时数学题目和应用示例，不提交题库备份 ZIP 或接口数据。

模拟器覆盖安装后核对 versionCode=21／versionName=0.21.0，签名与上一版相同。恢复验证以独立数据存储和新图像路径模拟重装；设备操作限定为 emulator-5554。本次新增手动备份能力，账户和自动同步仍属于后续规划，既有其他功能边界见 README。

Mathector 0.20.0

Mathector 0.20.0

发布日期：2026-10-07。原生 Android 高中数学题集 App，最低 Android 8.0。

本次改动

• 独立公式输入区增加实时 LaTeX 校对预览，接受裸公式与已有数学分隔符，格式有误时给出校对提示。专用区域明确标注“不参与导出”；不会追加到题目正文预览、题库／题集／选题卡片或练习 PDF／Word。需要导出的公式请放入题干。去除空题干时的独立公式导出兜底，提示补充题干后再导出，保留现有独立公式数据。
• 共用题目卡片同时显示橙色“待校对”或绿色“已校对”；题库新增“已校对”筛选。题目只有显式确认后才标记已校对，修改标题、题干或分类后重新待校对，只修改独立公式或自动解题开关不改变校对状态。顶部和保存提示说明当前状态。
• 校对／编辑及手动录入页的返回、标题、校对状态和圆角确认入口固定在系统状态栏下方；内容在下方独立滚动，键盘弹出时仍能看到并操作顶部入口，白天／黑夜适配。保留草稿自动保存和底部确认按钮，仅填写独立公式无法确认已校对。

源码同步到公开仓库 SACO1F/Mathector，默认分支 main，版本标签 v0.20.0。

安装包

下载 Mathector-0.20.0-debug.apk。本版本为调试构建，与上一版使用相同签名，可覆盖安装并保留应用数据。

• versionCode：20；versionName：0.20.0。
• 大小：24,988,950 字节。
• SHA-256：9F38FC3080895096274CFD20DEC814BF79C962D024F7860E0A730A8FC0002E0F。
• APK Signature Scheme v2 验证通过；数据库版本保持 4。

验证

Debug APK 与 Android 测试包构建成功，34 项单元测试全部通过；Android Lint 0 错误、20 项既有警告。最终增量构建 43 秒，初次完整构建 1 分 50 秒。

Android 模拟器 emulator-5554 的 6 项相关设备测试一次全部通过，耗时 48.417 秒：

• 两种主题下分别打开待校对与已校对题目，滚动到底并继续上划，验证返回／标题、状态、确认按钮坐标保持不变，确认入口触摸区至少 48 dp，滚动区域始终位于顶部下方。
• 待校对／已校对筛选互相排除；已校对题干编辑后立即显示待校对并自动保存，重新确认后恢复已校对。题库、题集及选题面板的标签状态一致。
• 独立公式在白天／黑夜下正常 LaTeX 渲染，编辑后实时更新，非法命令显示校对提示；有分隔符的输入没有重复包裹，返回再打开保留修改，正文预览未混入独立公式，单独改公式不改变已校对状态。
• 手动录入时，顶部在键盘展开后保持原位；仅填写独立公式不能确认，补充题干后可确认并保存。
• 实际导出 PDF 与不含独立公式的基准 PDF 页面像素完全一致；Word 不包含独立公式或额外公式图片。正文中的 LaTeX 在 PDF／Word 继续渲染，正文公式 Word 含一张公式图片。空题干在两种格式下均拒绝以独立公式兜底。生成当前版本专用验证文档，未覆盖历史样张。
• 题库、正文预览及 AI 解答的行内／独立 LaTeX 渲染回归通过，正文预览仍不追加校对区公式。

收集 16 张截图及 3 份当前版本验证文档，核对两种主题的公式校对区、两种主题滚动到底的固定顶部、手动录入键盘和题集状态标签 6 张核心截图。README 展示公式校对和固定顶部的 4 张样例，画面使用临时测试题目。

模拟器覆盖安装后核对 versionCode=20、versionName=0.20.0，签名与上一版相同。没有操作已连接的真实手机，未新增厂商真机、旧系统玻璃回退及真实多模态准确率测试；既有功能边界见 README，本机配置、密钥、缓存与临时文件继续排除在 Git 仓库之外。

Mathector 0.19.0

Mathector 0.19.0

发布日期：2026-10-07。原生 Android 高中数学题集 App，最低 Android 8.0。

本次改动

• 题集模块的“我的题集”标题、副标题及右上角创建入口固定在系统状态栏下方，卡片在下方独立滚动；滑到列表末尾后，三个元素仍保持可见和原位。
• 创建入口改为 Apple 风格“＋ 创建”圆角胶囊：柔和浅蓝底、细蓝边、蓝色图标与文字，48 dp 触摸高度，轻微按压缩放与弹簧回弹。白天／黑夜分别配色，仍打开原有圆角创建窗口，保留名称校验、键盘确认与取消操作。

源码已同步到公开仓库 SACO1F/Mathector，默认分支 main，版本标签 v0.19.0。

安装包

下载 Mathector-0.19.0-debug.apk。本版本为调试构建，与开发机上一版使用相同签名，可覆盖安装并保留应用数据。

• versionCode：19；versionName：0.19.0。
• 大小：24,562,188 字节。
• SHA-256：4B0E447BF5DC23B5487F99496CD74029FCDAE629889097C7C0CB4B2A23FE8A7E。
• APK Signature Scheme v2 验证通过；数据库版本保持 4。

验证

构建 Debug APK 与 Android 测试包，执行单元测试和 lintDebug，1 分 29 秒完成。30 项单元测试全部通过，Android Lint 0 错误、20 项既有警告。

Android 模拟器 emulator-5554 上 5 项相关设备测试一次全部通过，耗时 48.852 秒：

• 新增题集模块固定顶部验证：使用 20 个临时题集，在白天／黑夜主题下连续滑到底，验证标题、副标题、创建按钮坐标不变，列表位于顶部区域下方，创建按钮触摸区至少 48 dp，最后卡片不被底部导航遮挡。从列表末尾打开创建窗口并取消后，题集数量不变；打开题集及返回正常。测试结束后清理临时题集并恢复主题。
• 题集详情回归：长名称与返回按钮固定、列表滚动到底、添加按钮固定与导航安全间距、最后的 PDF／Word 入口完整显示。
• 创建窗口回归：空白名称禁用、去除首尾空格、键盘完成确认、取消和返回不写入、两种主题下标题可读。
• 删除回归：取消、返回与确认；删除题集后原题仍保留在题库。
• 导出格式菜单回归：两种主题下 PDF／Word 选项可用、返回关闭菜单后保持在列表。

收集 17 张最新界面截图，逐张核对列表起始、两种主题列表底部和键盘展开的创建窗口四张核心截图。README 提供两种主题的列表底部样例；创建按钮固定且与卡片操作区区分，创建窗口的确认／取消按钮未被键盘遮挡。

已在模拟器覆盖安装并核对 versionCode=19、versionName=0.19.0，签名与上一版一致。本轮没有操作已连接的真实手机，没有重建历史 PDF／DOCX 样张，未新增厂商真机、旧系统模糊回退及真实多模态准确率测试。既有功能边界见 README；本机配置、密钥、缓存与临时文件继续由 .gitignore 排除。

Mathector 0.18.0

Mathector 0.18.0

发布日期：2026-10-07。原生 Android 高中数学题集 App，最低 Android 8.0。

本次改动

• 移除题库首页“每一道好题，都有自己的位置。”大标题及其占用的空白，保留品牌、简短说明、统计、搜索与筛选入口。
• 题集详情的题集名称与返回按钮固定在系统状态栏下方，题目和文档设置在下方独立滚动。滚到最底部仍可直接返回；长名称最多两行，超出省略，适配白天／黑夜。悬浮添加按钮、底部连续滚动及导出入口间距保留。

源码已同步到公开仓库 SACO1F/Mathector，默认分支 main，版本标签 v0.18.0。

安装包

下载 Mathector-0.18.0-debug.apk。本版本为调试构建，与开发机上一版使用相同签名，可覆盖安装并保留应用数据。

• versionCode：18；versionName：0.18.0。
• 大小：24,562,188 字节。
• SHA-256：920E7036AC29E71877D135CA34D5E06FCB20EDC75710D905461F9692A0D64739。
• APK Signature Scheme v2 验证通过；数据库版本保持 4。

验证

构建 Debug APK、Android 测试包，执行单元测试及 lintDebug，2 分 49 秒完成。30 项单元测试全部通过，Android Lint 0 错误、20 项既有警告。

Android 模拟器 emulator-5554 上 5 项相关设备测试一次全部通过，耗时 95.676 秒：

• CollectionGlassTest：长题集名称在白天／黑夜均固定在页面顶部；滚动中和连续划到底后标题区域及返回按钮坐标不变，返回按钮可直接回到题集列表；题目列表位于标题下方且延伸到页面底部，添加按钮固定并避开系统导航区，最后的 PDF／Word 操作完整可见。继续验证主页面三个模块的加号和选题分类气泡。
• CollectionCardTest：题库／选题／题集共享卡片、标签、真实 WebView 公式与文字颜色、添加、上下移动、移除保留原题，以及固定悬浮按钮。
• CompactWorkspaceTest：紧凑文档设置、输入校验、自动保存、返回后再次打开恢复、蓝底白字与文字对比度。

采集 19 张自动化截图，另获取首页截图及 UI 层级确认指定大标题已移除。逐张核对首页、题集滚动中、白天和黑夜列表底部四张核心截图；README 中提供列表底部的两种主题样例。安装后确认 versionCode=18、versionName=0.18.0，签名与上一版一致。

本轮仅修改首页与题集布局，未重新生成历史 PDF／DOCX 样张，未新增厂商真机、旧系统模糊回退或真实多模态服务准确率测试；既有功能与边界见 README。没有操作已连接的真实手机，本机配置、密钥、缓存及临时文件继续由 .gitignore 排除。

Mathector 0.17.0

Mathector 0.17.0

发布日期：2026-10-07。原生 Android 高中数学题集 App，最低 Android 8.0。

本次改动

圆角气泡使用独立配色：白天浅蓝 #E4EDFF、黑夜灰蓝 #334463，与页面及卡片形成清晰色差。覆盖选题的年级／知识点／难度、题库年级与题目操作、题集排序／移除、导出格式和自定义知识点模块菜单。继续保留 24 dp 圆角，无外阴影或外描边；默认选中蓝色在白天调整为 #285DCF，保留分类色及原有动效。

工程首次发布到公开 GitHub 仓库 SACO1F/Mathector。本地初始化 main 分支，提交完整源码、Gradle Wrapper、Room schema、文档和测试。历史开发记录保留在 README，初次源码导入没有重建此前版本的提交历史。

下载与安装

安装包：Mathector-0.17.0-debug.apk。本版本为调试构建，与开发机此前版本使用相同签名，可覆盖安装并保留应用数据。

• versionCode：17；versionName：0.17.0。
• 大小：24,562,188 字节。
• SHA-256：36DD0CB4A4572D8E532BF06B95D90BEB15963C10EBDCE7F64B8265067FE65DC6。
• APK Signature Scheme v2 验证通过。
• 数据库版本保持 4。

多模态识别需要在 App 的“我的 → 题目识别与接口”中自行填写 HTTPS 地址、模型名和 API Key。仓库与安装包不包含真实服务密钥。

验证

在开发机执行 Debug APK、Android 测试包、单元测试与 Android Lint 构建，52 秒完成。30 项单元测试全部通过；Android Lint 0 错误、20 项既有警告。

Android 模拟器 emulator-5554 上 4 项相关设备测试全部通过，44.162 秒：

• CollectionGlassTest：选题三种菜单，组合筛选与跨主题选中保留，长知识点菜单滚动、边缘留白、系统返回仅关闭气泡，取消不写入题集。
• RoundedOverlayTest：题库年级筛选与收藏操作、菜单返回不误开编辑器；题集排序边界、顺序持久化及移除保留原题；白天／黑夜导出菜单格式可用及关闭后保持在列表。

收集 14 张最新菜单截图；逐张核对其中 6 张知识点、题目操作、导出气泡在两种主题下的截图，底色与背后页面及卡片清晰分离，文字、分类选中状态及圆角正常。README 展示两张知识点菜单截图。验证未操作已连接的真实手机，未重新生成历史 PDF／DOCX 样张。

公开提交检查

提交前检查文件清单与常见密钥／私钥模式，未发现匹配的服务凭据。local.properties、.env 文件、本机 IDE 配置、构建缓存、APK、签名密钥、artifacts 和 tmp 均由 .gitignore 排除。APK 和校验文件单独作为 Release 资源提供，源码中保留离线公式资源及其原许可。

本轮验证针对菜单配色和公开发布；厂商真机、旧系统模糊回退与真实多模态服务准确率未新增测试。既有功能边界及导出／迁移验证记录见根目录 README。