MMorningstar202604feat: implement P0 UX optimizations - welcome tutorial and better boot experience

2f64c35f创建于 8 天前历史提交

文件	最后提交记录	最后更新时间
README.md	refactor(v0.3.3): 架构大手术 —— 砍 Room / 引擎唯一化 / sha256 强制校验 BREAKING CHANGES: - 移除 Room 数据库及 kapt 插件，退回 DataStore + JSON 单持久化层 * 删除 AppDatabase.kt, Dao.kt, Entities.kt * ViewModels 改用 StateFlow + kotlinx-serialization 读写 JSON 文件 * BackupUtil 从 DataStore/JSON 导出导入，不再依赖 Room * ReviewScheduler 解耦为 SchedulableCard 接口 - Web 前端引擎唯一化 * engine.js 动态 fetch runner.py 替代硬编码字符串 * 修复 _repl_ns → _REPL_NS 变量名错误 - ContentCenter sha256 强制校验 * catalog.json 和 pack 必须提供 sha256 字段，缺失即拒绝加载 - 时区感知连击计算 * ProgressStore.touchStreak 使用 LocalDate.now(ZoneId.systemDefault()) - 文档更新 * PLAN.md 课程数从 10 课提升到 30 课 - 仓库卫生 * 删除已跟踪的 .pyc 文件和 note.txt * 清理构建日志验证: gradle :app:assembleDebug BUILD SUCCESSFUL	9 天前
_httpd.log	refactor(v0.3.3): 架构大手术 —— 砍 Room / 引擎唯一化 / sha256 强制校验 BREAKING CHANGES: - 移除 Room 数据库及 kapt 插件，退回 DataStore + JSON 单持久化层 * 删除 AppDatabase.kt, Dao.kt, Entities.kt * ViewModels 改用 StateFlow + kotlinx-serialization 读写 JSON 文件 * BackupUtil 从 DataStore/JSON 导出导入，不再依赖 Room * ReviewScheduler 解耦为 SchedulableCard 接口 - Web 前端引擎唯一化 * engine.js 动态 fetch runner.py 替代硬编码字符串 * 修复 _repl_ns → _REPL_NS 变量名错误 - ContentCenter sha256 强制校验 * catalog.json 和 pack 必须提供 sha256 字段，缺失即拒绝加载 - 时区感知连击计算 * ProgressStore.touchStreak 使用 LocalDate.now(ZoneId.systemDefault()) - 文档更新 * PLAN.md 课程数从 10 课提升到 30 课 - 仓库卫生 * 删除已跟踪的 .pyc 文件和 note.txt * 清理构建日志验证: gradle :app:assembleDebug BUILD SUCCESSFUL	9 天前
_verify_engine.py	refactor(v0.3.3): 架构大手术 —— 砍 Room / 引擎唯一化 / sha256 强制校验 BREAKING CHANGES: - 移除 Room 数据库及 kapt 插件，退回 DataStore + JSON 单持久化层 * 删除 AppDatabase.kt, Dao.kt, Entities.kt * ViewModels 改用 StateFlow + kotlinx-serialization 读写 JSON 文件 * BackupUtil 从 DataStore/JSON 导出导入，不再依赖 Room * ReviewScheduler 解耦为 SchedulableCard 接口 - Web 前端引擎唯一化 * engine.js 动态 fetch runner.py 替代硬编码字符串 * 修复 _repl_ns → _REPL_NS 变量名错误 - ContentCenter sha256 强制校验 * catalog.json 和 pack 必须提供 sha256 字段，缺失即拒绝加载 - 时区感知连击计算 * ProgressStore.touchStreak 使用 LocalDate.now(ZoneId.systemDefault()) - 文档更新 * PLAN.md 课程数从 10 课提升到 30 课 - 仓库卫生 * 删除已跟踪的 .pyc 文件和 note.txt * 清理构建日志验证: gradle :app:assembleDebug BUILD SUCCESSFUL	9 天前
_verify_web_engine.py	feat: implement P0 UX optimizations - welcome tutorial and better boot experience - Add 4-page welcome tutorial showcasing offline learning, gamification, variable snapshots, and 7-day plan - Fix BootScreen version display to use dynamic BuildConfig.VERSION_NAME instead of hardcoded v0.2 - Improve BootScreen copy from technical jargon to user-friendly messages - Create AppPrefs utility for first launch detection using SharedPreferences - Integrate welcome tutorial into navigation flow (shown only on first launch) - Update bottom tagline from 'OFFLINE READY' to Chinese '完全离线 · 无需网络 · 随时学习'	8 天前
app.js	feat: implement P0 UX optimizations - welcome tutorial and better boot experience - Add 4-page welcome tutorial showcasing offline learning, gamification, variable snapshots, and 7-day plan - Fix BootScreen version display to use dynamic BuildConfig.VERSION_NAME instead of hardcoded v0.2 - Improve BootScreen copy from technical jargon to user-friendly messages - Create AppPrefs utility for first launch detection using SharedPreferences - Integrate welcome tutorial into navigation flow (shown only on first launch) - Update bottom tagline from 'OFFLINE READY' to Chinese '完全离线 · 无需网络 · 随时学习'	8 天前
data.js	refactor(v0.3.3): 架构大手术 —— 砍 Room / 引擎唯一化 / sha256 强制校验 BREAKING CHANGES: - 移除 Room 数据库及 kapt 插件，退回 DataStore + JSON 单持久化层 * 删除 AppDatabase.kt, Dao.kt, Entities.kt * ViewModels 改用 StateFlow + kotlinx-serialization 读写 JSON 文件 * BackupUtil 从 DataStore/JSON 导出导入，不再依赖 Room * ReviewScheduler 解耦为 SchedulableCard 接口 - Web 前端引擎唯一化 * engine.js 动态 fetch runner.py 替代硬编码字符串 * 修复 _repl_ns → _REPL_NS 变量名错误 - ContentCenter sha256 强制校验 * catalog.json 和 pack 必须提供 sha256 字段，缺失即拒绝加载 - 时区感知连击计算 * ProgressStore.touchStreak 使用 LocalDate.now(ZoneId.systemDefault()) - 文档更新 * PLAN.md 课程数从 10 课提升到 30 课 - 仓库卫生 * 删除已跟踪的 .pyc 文件和 note.txt * 清理构建日志验证: gradle :app:assembleDebug BUILD SUCCESSFUL	9 天前
engine.js	feat: implement P0 UX optimizations - welcome tutorial and better boot experience - Add 4-page welcome tutorial showcasing offline learning, gamification, variable snapshots, and 7-day plan - Fix BootScreen version display to use dynamic BuildConfig.VERSION_NAME instead of hardcoded v0.2 - Improve BootScreen copy from technical jargon to user-friendly messages - Create AppPrefs utility for first launch detection using SharedPreferences - Integrate welcome tutorial into navigation flow (shown only on first launch) - Update bottom tagline from 'OFFLINE READY' to Chinese '完全离线 · 无需网络 · 随时学习'	8 天前
gen_data.py	feat: implement P0 UX optimizations - welcome tutorial and better boot experience - Add 4-page welcome tutorial showcasing offline learning, gamification, variable snapshots, and 7-day plan - Fix BootScreen version display to use dynamic BuildConfig.VERSION_NAME instead of hardcoded v0.2 - Improve BootScreen copy from technical jargon to user-friendly messages - Create AppPrefs utility for first launch detection using SharedPreferences - Integrate welcome tutorial into navigation flow (shown only on first launch) - Update bottom tagline from 'OFFLINE READY' to Chinese '完全离线 · 无需网络 · 随时学习'	8 天前
index.html	refactor(v0.3.3): 架构大手术 —— 砍 Room / 引擎唯一化 / sha256 强制校验 BREAKING CHANGES: - 移除 Room 数据库及 kapt 插件，退回 DataStore + JSON 单持久化层 * 删除 AppDatabase.kt, Dao.kt, Entities.kt * ViewModels 改用 StateFlow + kotlinx-serialization 读写 JSON 文件 * BackupUtil 从 DataStore/JSON 导出导入，不再依赖 Room * ReviewScheduler 解耦为 SchedulableCard 接口 - Web 前端引擎唯一化 * engine.js 动态 fetch runner.py 替代硬编码字符串 * 修复 _repl_ns → _REPL_NS 变量名错误 - ContentCenter sha256 强制校验 * catalog.json 和 pack 必须提供 sha256 字段，缺失即拒绝加载 - 时区感知连击计算 * ProgressStore.touchStreak 使用 LocalDate.now(ZoneId.systemDefault()) - 文档更新 * PLAN.md 课程数从 10 课提升到 30 课 - 仓库卫生 * 删除已跟踪的 .pyc 文件和 note.txt * 清理构建日志验证: gradle :app:assembleDebug BUILD SUCCESSFUL	9 天前
style.css	refactor(v0.3.3): 架构大手术 —— 砍 Room / 引擎唯一化 / sha256 强制校验 BREAKING CHANGES: - 移除 Room 数据库及 kapt 插件，退回 DataStore + JSON 单持久化层 * 删除 AppDatabase.kt, Dao.kt, Entities.kt * ViewModels 改用 StateFlow + kotlinx-serialization 读写 JSON 文件 * BackupUtil 从 DataStore/JSON 导出导入，不再依赖 Room * ReviewScheduler 解耦为 SchedulableCard 接口 - Web 前端引擎唯一化 * engine.js 动态 fetch runner.py 替代硬编码字符串 * 修复 _repl_ns → _REPL_NS 变量名错误 - ContentCenter sha256 强制校验 * catalog.json 和 pack 必须提供 sha256 字段，缺失即拒绝加载 - 时区感知连击计算 * ProgressStore.touchStreak 使用 LocalDate.now(ZoneId.systemDefault()) - 文档更新 * PLAN.md 课程数从 10 课提升到 30 课 - 仓库卫生 * 删除已跟踪的 .pyc 文件和 note.txt * 清理构建日志验证: gradle :app:assembleDebug BUILD SUCCESSFUL	9 天前

码上Python · 电脑端（网页版 / Web Client）

手机端（Android）之外的第二端：纯前端网页，浏览器里直接学 Python。和手机端共用同一套课程内容 JSON 与同一份 Python 引擎 runner.py（通过 Pyodide 在浏览器内运行 CPython 3.13），所以判题与变量快照逻辑两端 100% 一致。

如何打开（任选其一）

方式 A：本地静态服务（推荐，最稳）

在本目录下执行：

cd web
python -m http.server 8765

然后在浏览器打开 http://127.0.0.1:8765/ 即可。（当前本机已起好一个，端口 8765，直接开浏览器就能看。）

方式 B：直接双击

双击 index.html 也能开（课程/引擎已内联进 data.js/engine.js，无需 fetch）。注意：Pyodide 内核首次加载需要联网（从 jsdelivr CDN 取 CPython WASM），之后可缓存。

功能

指挥台：29 讲课程列表，点开即学。
课程详情：理论/图示/表格/代码块/随堂问答/排序题/练习全类型渲染。
可运行代码块：点「运行」看终端输出 + 变量快照面板（本 App 独有）。
实战判题：每课 exercise 用 assert 用例判题，通过/失败实时反馈。
神经接口 REPL：有状态会话（↑↓ 历史、变量持续保留）、一键重置。
角斗场：6 个编程挑战，同样 assert 判题。

引擎说明

课程来自 app/src/main/assets/lessons_*.json + challenges.json，由 gen_data.py 生成 data.js（原样内联，零改动手机端源码）。
引擎来自 app/src/main/python/runner.py，由 gen_data.py 生成 engine.js（内联 window.ENGINE_PY）；网页端在 Pyodide 中 runPython(window.ENGINE_PY) 后直接调用 run_code_json / check_exercise_json / repl_exec_json。
重新生成数据：python gen_data.py

已知边界

首次加载需联网取 Pyodide（约 10MB WASM）。要做成完全离线，可把 Pyodide 本地 vendoring 进 vendor/ 并改 index.html 的 indexURL（后续项）。
浏览器内 Python 与手机端同内核、同引擎，行为一致；但本页不含手机端的导航/成就/连击等 Android 专属 UI。