南工破晓 是一个面向校园学习与个人效率场景的 Android 原生应用。
它采用 Kotlin + Jetpack Compose 构建，并持续以 Agent (智能体) 驱动 的方式进行工程重构与演进。
v1.18.1 (UI Polish & IME Fix — 全局 UI/UX 修复与键盘适配) 现已发布。本次更新对全应用进行了系统性 UI/UX 审查与修复。在 PoxiaoPalette 中新增 warning 语义色（浅色主题棕色 #9A5B34、深色主题亮橙 #FFB74D），替换课表冲突、登录过期、难度星级等 6 处硬编码颜色为 palette 适配色。修复首页快捷入口、课表日期单元格等 4 处 Color.White.copy(alpha=...) 在暗色主题下不可见的问题。修复课表魔法棒按钮 24dp、词库操作按钮 32dp、更多导航行 40dp 等触摸目标低于 Android 推荐 48dp 最小值的问题。为 VocabScreen（6 处）和 HomeVocabModuleCard（4 处）的交互图标补充 contentDescription 无障碍描述。将课表单元格 requiredHeight(108.dp) 改为 heightIn(min=108.dp) 防止大字体模式裁切。将课表魔法棒 emoji 替换为 AutoAwesome Material 图标。修复首页智能体输入框被输入法遮挡的问题：为 ScreenColumn 的 LazyColumn 底部 padding 添加 WindowInsets.ime 感知。清理 VocabScreen（3 个）和 MoreScreenBuilders（1 个）未使用的 import。
v1.18.0 (Vocab Challenge — 四六级/考研单词挑战) 现已发布。本次更新实现了白皮书新构想 B，新增"每日单词"功能模块。在"更多"页面新增"每日单词"入口，点击进入全屏词库管理页面（支持背词/测试/词库管理三个 Tab）。内置 200 个高频词（CET4 80 + CET6 60 + 考研 60），支持 SM-2 间隔重复算法、闪卡翻转背词、英译中选择题测试、自定义词添加/批量导入/导出、按级别筛选与搜索。集成 Gamification 系统（背词 +2 XP，测试答对 +3 XP）。首页新增"每日单词"模块卡片，支持内嵌闪卡翻转与今日进度展示。
v1.17.0 (Research Assistant — 学术文献翻译摘要) 现已发布。本次更新实现了白皮书 Task [17]，新增 RESEARCH_ASSISTANT_SYSTEM_PROMPT，当用户粘贴英文论文摘要或提到"论文"、"文献"等关键词时，AI 自动输出结构化中文文献分析报告（研究目的/方法论/关键发现/局限性/课程关联），用 emoji 标记各部分便于快速扫读。纯 Prompt 工程，零 UI 改动。
v1.16.0 (Rescue Guide — 挂科急救 48h 生存指南) 现已发布。本次更新实现了白皮书 Task [5]，新增"挂科急救"首页模块卡片，内置 20 门哈工深高频挂科课程种子数据（覆盖理学院、计算机学院、电信学院、机械学院、经管学院），支持课程搜索和速成建议展示。新增 RESCUE_GUIDE_SYSTEM_PROMPT，当用户提到"挂科"、"急救"等关键词时，AI 自动生成精确到小时的 48 小时极限复习计划并联动番茄钟。预埋知识库 D 接口，后续灌入历年真题即可无缝联动。
v1.15.0 (Native Document Generation — PPT/Word 一键生成) 现已发布。本次更新实现了白皮书 Task [16]，使用 Apache POI 在 Android 端原生生成 .docx / .pptx 文件，替代了之前的 Markdown 导出方案。支持 Markdown 标题、列表、粗体/斜体、引用等格式解析，生成的文档带有破晓绿色调主题和微软雅黑字体排版。优化了 System Prompt 使 AI 在触发文档生成时自动输出完整的 Markdown 正文。用户点击 ActionPill 后系统直接生成 Office 文件并通过系统查看器打开。
v1.14.0 (Hidden Achievements — 校园隐藏成就) 现已发布。本次更新实现了白皮书 Task [24]，新增 12 个行为/隐藏成就（"初入江湖"、"修仙真人"、"美食探险家"等），基于 SharedPreferences 持久化解锁状态。在任务完成、番茄钟专注、等级提升、首页美食推荐等 6 个事件入口注入成就检查点，解锁时弹出弹簧缩放 + 辉光脉冲庆祝动画。在待办工作台新增可展开"成就墙"面板，已解锁成就高亮显示，隐藏成就未解锁时显示"???"。
v1.13.1 (Academic Jargon De-obfuscator — 学术反黑话) 现已发布。本次更新实现了白皮书 Task [18]，在 MultiAgentRouter 中注入 JARGON_DEOBFUSCATOR_SYSTEM_PROMPT，当用户粘贴超过 50 字的官方通知/公告并包含"翻译"、"人话"、"反黑话"等关键词时，AI 自动将"赋能、抓手、对齐颗粒度"等官话翻译成简洁可执行的白话文，提取时间/地点/行动项并用 emoji 标记。纯 Prompt 工程，零 UI 改动。
v1.13.0 (Food Blind Box — 食堂吃啥) 现已发布。本次更新实现了白皮书 Task [7]，新增"今天吃啥"首页模块卡片，内置 35 个哈工深食堂菜品数据（覆盖荔园一/四食堂、综合楼食堂），基于时间段（早/午/晚/夜宵）智能筛选并随机推荐，支持去重（最近 5 次不重复）。同时注册了 action:order_food 到 ActionPill 系统，AI 可触发外卖拼单弹窗。新增 FoodStore 推荐引擎与 OrderFoodDialog 二维码弹窗组件。
v1.12.0 (Gamification Engine — 哈工深修仙传) 现已发布。本次更新为 Todo 待办系统叠加了修仙主题的 XP / 等级激励引擎。新增 GamificationStore 持久化模块（SharedPreferences + JSON），实现 10 级修仙境界体系（练气期 → 大罗金仙）；在任务完成 (toggleTodoTaskAction) 和专注回写 (recordTodoFocusProgress) 两个入口注入 XP 奖励逻辑，支持按四象限差异化 XP 分配与连续完成天数 bonus；在 TodoOverviewCard 新增 GamificationBar 进度条组件，实时显示当前境界、XP 进度与连续天数；新增 LevelUpCelebrationOverlay 升级庆祝动画（弹簧缩放 + 辉光脉冲 + 粒子轨道 + 触觉反馈）。全部为纯增量功能，不修改现有 Todo 数据模型与业务逻辑。
v1.11.9 (Scroll Performance Optimization) 现已发布。本次更新针对全应用滑动卡顿进行了系统性性能优化。将 10 个文件中 25+ 处函数内 Regex 编译提升为顶层常量（含 MultiAgentRouter 三路由正则），为 6 个页面 11 处缺失 key 的 LazyList 补全稳定标识符，使用 remember 缓存 ExportCenterScreen.buildItems 等重计算并修正 derivedStateOf 用法，为 SmoothSuperellipseShape 添加 Path 尺寸缓存（消除 96 步三角函数重复计算），将 RadarChart 的 Paint 对象从每帧分配移至 remember，缓存 4 处 Brush.verticalGradient Modifier 链，将 rememberHapticManager 从 items 循环内提升至外部，并将 CourseNotesScreen 和 HomeAssistantModuleCard 中 22 处 RoundedCornerShape 提升为文件级常量。全部改动均为内部性能优化，不改变任何 UI 外观和业务功能。
v1.11.8 (Agent Fixes & Local Engine) 现已发布。本次更新修复了由于前期重构导致的大面积 Kotlin 编译报错（如 onSend 参数缺失、TodoFilter 包引入错误等）。此外，作为 Task [28] 的后端引擎延伸，在工作区根目录全新开发了 generate_doc_engine.py 自动化文档生成脚本，彻底实现了从 App 端侧 Action 触发到本地物理 Office 文档生成的全链路基建。
v1.11.7 (Multimodal Vision Engine) 现已发布。本次更新全面落实了极客构想中的 Task [4] 与 Task [16]。完成了端侧图片选择器与多模态负载的 UI 基建，并在底层网络客户端 (VolcengineAgentClient 和 SparkAgentClient) 实现了带有图片信息的 Payload 构建。同时，深度打通了“大模型生成 -> Python Office 排版”的极限交付闭环，并更新了 ActionPill 在文档生成动作触发时的波纹物理动画反馈，标志着本系统开始具备真实世界的视觉感知与生产力输出。
v1.11.6 (Toxic Interview Simulator) 现已发布。本次更新新增实验性压迫感对抗功能。在“界面偏好”中加入 isToxicInterviewMode 全局开关。开启后，App 内将注入极其严厉的 System Prompt 覆盖，强制伴读管家化身为大厂技术面试官，进行无情的漏洞审视与压力测试。同时全局 UI 联动发出红色警告提示，极大丰富了多智能体角色的情感张力。
v1.11.5 (Document Auto-Generation) 现已发布。本次更新新增跨端一键生成 .docx 与 .pptx 能力。基于 Python-docx/pptx 编写了独立的后端排版引擎，支持 Markdown 语法至原生 Office 格式的无缝转换。App 端新增 action:generate_document 指令解析与专属 ActionPill UI，彻底打通了“大模型撰写 -> Python 排版 -> 端侧分享”的极限交付生产力链路。
v1.11.4 (End-to-Cloud Action Sync) 现已发布。本次更新制定并发布了云端 HiAgent 终极版 System Prompt，在端侧完成了全域联动闭环：增加了 action:remember 记忆沙盒写入、action:map_navigation 物理空间导航、以及 [emotion] 情感状态拦截器。同时使用 remember 物理缓存重构了极其耗费 CPU 的正则扫描器，彻底消除了聊天列表上下滑动时的正则重组卡顿。
v1.11.3 (Knowledge Base Refactoring) 现已发布。本次更新彻底重构了云端知识库架构，设计了“12维垂直物理分离”规范，并为解决云端并发与Token溢出限制，开发了专用的 Python 脚本，将 12 维颗粒度文件自动注入 Markdown 锚点与 TOC 目录，合并为 3 大核心基座文件（政策、大纲、经验），实现了零语义串烧的精准召回与端云性能平衡。
v1.10.2 (Agent Network Core & Swipe Stutter Fix) 现已发布。本次更新完成了底层渲染生命周期的终极优化：彻底解决了全面屏手势（如上划返回桌面）时由 GPU 渲染过载导致的系统级过渡动画卡顿（抽搐）问题，通过注入 LocalWindowInfo.current.isWindowFocused 实现了毫秒级 GPU 降级。此外，端侧智能体中枢网络 (MultiAgentRouter) 与火山引擎 (HiAgent) 的网络层已成功闭环，实现了抗 TCP 断连 (EOFException) 的防御性 SSE 流式解析，并在端侧支持 ActionPill 的原生渲染转换。
v1.10.1 (Knowledge Base Compliance & Isolation) 现已发布。本次更新完成了 C库（自救群民间资料）的深度合规清洗与多级分类隔离，彻底剥离了可能触碰红线的严重违规与敏感文件，并重新生成了脱敏且干净的三维知识库压缩包。所有安全合规资料已准备就绪，确保火山 Agent 平台数据输入的纯净性。
v1.10.0 (Multi-Agent Router & Context-Aware AI) 现已发布。本次更新标志着项目从“静态效率工具”全面进化为“全域主动式伴读管家”。我们抛弃了单一模型的限制，自主构建了多智能体路由中枢 (Multi-Agent Router)。系统能够根据用户的意图（闲聊/日程 vs. 高数/代码推理），动态将请求路由至“星火”或“DeepSeek V4 Pro”模型。此外，AI 现已具备本地数据感知 (Context-Awareness) 能力，可基于当前时间、真实课表、待办进度提供千人千面的问候，并通过多模态仪表盘 (Multimodal Dashboard) 自动拦截 AI 输出的 Markdown 并将其原生地渲染为雷达图，彻底实现本地数据联邦与 AI 隐私计算的完美结合。
v1.9.8 (Spatial Physics & Emotion Engine) 现已发布。引入了更极致的空间物理引擎交互，全面铺装了 bouncyClick 弹簧物理触感与液态空状态 (LiquidEmptyState)，并在更多模块下发了基于陀螺仪的视差微交互。
v1.3.0 (Ultimate Calculator) 现已发布。本次更新对标国际顶级 App 的终极交互形态，科学计算器引入全局撤销/重做堆栈 (Undo/Redo Stack) 以防长公式误删；全面引入键盘侧滑输入 (Swipe-on-Keys) 系统，彻底移除了占用空间的二级高级面板，将高级函数（如 sin, cos, ln, 根号, 幂次等）集成至主键盘的滑动交互中，实现操作零层级跃迁。
v1.2.9 (Workspace Header Layout Fix) 现已发布。本次更新针对科学计算器的顶部信息卡片（Workspace Header）进行了空间优化，将其内部的标题与副标题由纵向排列改为横向紧凑排列，大幅缩减了卡片的垂直高度。此修复有效解决了进入各专业计算模块时，顶部卡片过大导致遮挡下方操作面板和输入区的问题，同时恢复了经典的模块命名体系，进一步提升了专业工具的空间利用率和交互视野。
v1.2.8 (Pro Toolchain & Gesture Evolution) 现已发布，标志着全能工具链进入 Pro 时代。全面重构了方程、复数、向量等专业模块，引入极坐标支持与 Durand-Kerner 算法；同时为历史记录注入了侧滑删除等手势交互，实现了对齐国际一流 App 的交互深度。
| 领域 | 核心模块 | 状态与说明 |
|---|---|---|
| 📚 学习主线 | 课表 / 考试周 / 复习计划 | 联动增强：复习任务智能嵌入课表，支持冲突一键调优 (🪄)。 |
| 🎯 执行主线 | 待办 / 专注 / 数据看板 | 闭环写回：番茄钟专注达成后自动同步复习进度与掌握度成长。 |
| 🤖 智能助手 | 简报推送 / 魔法调优 | 多智能体 (MAS)：基于并行专家协程与 DeepSeek 反思协议，实现实时动态推理与服务。 |
| ⚙️ 产品线矩阵 | hitsz / academic / lite | 多版本适配：支持产品线能力裁剪（哈深/通用教务/轻量版）。 |
| 🧮 科学工具 | 极致计算器 | 全域进化：支持 13+ 专业模块，采用 Golden Flow 布局与双主题极致美学。 |
项目建立了一套完整的 UI/UX 规范，确保在任何场景下都能传达出宁静与专注的质感：
- 🌲 森林感中式配色：采用更具生命力与宁静感的森系深色调（如
PineInk,ForestDeep,Ginkgo）。 - 🪟 液态玻璃 2.0 (Liquid Glass)：支持 星辉雾晶 / 冰川透镜 / 流光霓虹 三种高定风格；引入基于低通滤波校准的 陀螺仪物理视幕动效，全局应用动态雾度与内阴影。
- 🌓 Obsidian Neon 双主题：
- Light (iOS-like)：极简白色基调，辅以 ForestGreen 森林绿点缀，清爽通透。
- Dark (Hacker/Obsidian)：深邃黑色背景，辅以 0xFF66FFB2 荧光绿霓虹勾勒，科技感十足。
- 📳 全局触觉反馈 (HapticFeedback)：在计算器按键、列表切换、功能跳转中实装系统级震动反馈，提供真实的物理实体操作感。
⏳ 点击展开完整迭代纪年表
| 阶段 | 代号 | 工程推进与成果 |
|---|---|---|
01-07 |
奠基 | 完成从单体大文件到模块化结构的初步拆分，建立 Git 归档与规范基线。 |
08 |
全域深拆 | 原子级解耦：完成 Scaffold, Todo, Schedule, More 等核心模块的 Thin Shell 改造。 |
09 |
联动增强 | 逻辑闭环 |
10 |
多产品线 | 架构演进 |
| 11 | 多智能体 | 内核升级 |
| 12 | 极致 UI | 视觉升维 |
| 13 | v1.2.0 | 多智能体与液态玻璃 2.0 (MAS & Liquid Glass 2.0) |
| 14 | v1.2.1 | 骨架屏与修复 (Skeleton & Fixes) |
| 15 | v1.2.2 | 陀螺仪调优 (Gyroscope Refinement) |
| 16 | v1.2.3 | 全局组件大一统 (Global Unity) |
| 17 | v1.2.4 | 人机工程学重构 (Ergonomics Overhaul) |
| 18 | v1.2.5 | 便当盒布局 (Bento Box Layout) |
| 19 | v1.2.6 | 黄金流交互革命 (Golden Flow) |
| 20 | v1.2.7 | 黑曜石霓虹进化 (Obsidian Neon) |
| 21 | v1.2.8 | 专业工具链与手势 (Pro Toolchain) |
| 22 | v1.2.9 | 工作区头部修复 (Header Layout Fix) |
| 23 | v1.3.0 | 终极计算器 (Ultimate Calculator) |
| 24 | v1.3.1 | 自然数学引擎 (Natural Math Engine) |
| 25 | v1.3.2 | 感知增强 (Intelligence Awareness) |
| 26 | v1.3.3 | 单位感知计算 (Unit-Aware Computation) |
| 27 | v1.3.5 | 架构稳定性加固 (Stability Refinement) |
| 28 | v1.3.6 | 渲染管线修复 (Pipeline Fix) |
| 29 | v1.3.7 | 历史记录稳定性 (History Stabilization) |
| 30 | v1.3.8 | 可视化网格输入 (Natural Grid Input) |
| 31 | v1.3.9 | 方程可视化革命 (Equation WYSIWYG) |
| 32 | v1.4.1 | 统计数据网格化 (Statistics Data Grid) |
| 33 | v1.5.0 | 灵动屏与视觉升级 (Dynamic Display & UX) |
| 34 | v1.9.0 | UI品质大重构 (De-noise & Systematize) |
| 35 | v1.9.6 | 全局硬编码清零 (Final Whiteout) |
| 36 | v1.9.7 | UI/UX 维度再进化 (Dimension Upgrade) |
| 37 | v1.10.0 | 多智能体与端侧 LUI (Multi-Agent & LUI) |
| 38 | v1.10.1 | 合规知识库清洗 (Compliance Isolation) |
| 39 | v1.10.2 | 全面屏性能黑洞阻断 (Swipe Stutter Fix) |
| 37 | v1.9.8 | 空间与情感物理引擎 (Spatial Physics Engine) |
| 40 | v1.11.0 | 底层性能优化与全局网络引擎 (Global Network Engine) |
| 当前 | v1.18.1 | 全局 UI/UX 修复与键盘适配 (UI Polish & IME Fix) |
| 历史版本 | v1.18.0 | 四六级/考研单词挑战 (Vocab Challenge) |
| 历史版本 | v1.17.0 | 学术文献翻译摘要 (Research Assistant) |
| 历史版本 | v1.16.0 | 挂科急救 48h 生存指南 (Rescue Guide) |
| 历史版本 | v1.15.0 | PPT/Word 一键生成 (Native Document Generation) |
| 历史版本 | v1.14.0 | 校园隐藏成就 (Hidden Achievements) |
| 历史版本 | v1.13.1 | 学术反黑话 · 废话剥离机 (Jargon De-obfuscator) |
| 历史版本 | v1.13.0 | 食堂吃啥 & 外卖拼单盲盒 (Food Blind Box) |
| 历史版本 | v1.12.0 | 修仙引擎：待办激励系统 (Gamification Engine) |
| 历史版本 | v1.11.9 | 全链路滑动性能优化 (Scroll Performance Optimization) |
| 历史版本 | v1.11.8 | 编译修复与本地文档引擎 (Agent Fixes & Local Engine) |
| 历史版本 | v1.11.7 | 极客实验室：多模态视觉解题与极限生产力 (Multimodal Vision Engine) |
| 历史版本 | v1.11.6 | 极客实验室：毒舌面试官模式 (Toxic Interview Simulator) |
| 历史版本 | v1.11.5 | 生产力引擎：一键文档生成 (Document Auto-Generation) |
| 历史版本 | v1.11.4 | 端云双杀全域联动引擎 (End-to-Cloud Action Sync) |
| 历史版本 | v1.11.3 | 知识库合规提纯与解析隔离引擎 (Knowledge Base Refactoring) |
| 历史版本 | v1.11.2 | 意图路由重构与强指令接管 (Fuzzy Routing & God Mode) |
| 历史版本 | v1.11.1 | 多智能体模型感知胶囊 (Multi-Agent Liquid Pill) |
历史版本 |
v1.8.3 | UI重叠与陀螺仪性能修复 (UI & Gyroscope Fixes) |
历史版本 |
v1.8.2 | 手势冲突修复与体验闭环 (Gesture & UX Finalization) |
历史版本 |
v1.8.1 | 深度数学渲染与矩阵演算 (Deep Math & Matrix CAS) |
历史版本 |
v1.8.0.2 | 导包冲突修复 (Import Conflict Patch) |
历史版本 |
v1.8.0.1 | 语法高亮修复补丁 (Syntax Fix Patch) |
历史版本 |
v1.8.0 | 表达式语法高亮系统 (Expression Syntax Highlighting) |
历史版本 |
v1.7.0.1 | 路由类型修复补丁 (Route Type Patch) |
历史版本 |
v1.6.1.1 | 手势引擎作用域修复 (Gesture Scope Patch) |
历史版本 |
v1.6.1 | 液态单位选择器 (Liquid Unit Picker) |
历史版本 |
v1.5.1.1 | 编译稳定性补丁 (Compilation Stability Patch) |
历史版本 |
v1.5.0 | 灵动屏与视觉升级 (Dynamic Display & UX) |
| 分支 / 标签 | 状态 | 适用场景 |
|---|---|---|
main |
[Stable v1.18.1] | 当前生产线：包含四六级/考研单词挑战、全局 UI/UX 修复与键盘适配、学术文献翻译、挂科急救、PPT/Word 生成、隐藏成就、学术反黑话、食堂盲盒、修仙激励引擎、多智能体路由等全部最新能力的稳定版。 |
archive-monolithic |
[Legacy] | 历史归档：未拆分单文件版镜像。 |
v1.1.0-linkage-stable |
[Milestone] | 里程碑锚点：联动增强阶段的精确记录。 |
- 主工程目录:
C:\Users\HCnets\Desktop\AI - 版本迭代说明:
docs/版本说明.md - 多校适配规范:
docs/技术规范-南工破晓.md(第 17 章)
- 完成全域 UI/逻辑 深度拆分解耦。
- 实现学习主线全链路数据联动。
- 接入多智能体协同控制 (Multi-Agent System) 与 UI 动效 2.0 升级。
- 完善多校区 (Multi-School) 适配的具体业务实现。