PY//NOW v0.3.4 - Bug 修复与体验优化补丁
发布日期: 2026-08-29
类型: 修订版本（Patch Release）
基于: v0.3.3
🎯 更新概述
v0.3.4 是针对 v0.3.3 UX 优化功能的快速补丁发布，修复了 6 个关键问题并补充了 2 个基础设施组件，确保首次启动体验、错误提示和分享功能的稳定性和可维护性。
🐛 Bug 修复
1. 欢迎教程编译错误修复
- 问题: WelcomeTutorial 缺少 NeonButton 导入导致无法编译
- 影响: 首次启动时应用可能崩溃
- 修复: 添加正确的组件导入
2. 欢迎流程逻辑优化
- 问题: 用户在欢迎教程中途退出会导致下次重复显示
- 影响: 用户体验不佳，可能被误认为 bug
- 修复: 进入欢迎页面即标记为已完成，防止重复显示
3. 智能错误消息格式修复
- 问题: ConsoleResult 中 SmartErrorMessage 缩进错误
- 影响: 可能导致代码逻辑错误
- 修复: 修正代码缩进和括号位置
4. 页面指示器动态化
- 问题: 欢迎教程页面指示器硬编码为 4
- 影响: 增减页面时需要手动修改多处
- 修复: 改为动态读取 pages.size
✨ 功能改进
1. 统一常量管理 (AppConstants.kt)
新增集中式常量文件，管理：
- 应用版本信息 (VERSION_NAME, VERSION_CODE)
- GitHub 仓库地址
- 分享标签 (#PY_NOW #Python学习)
优势:
- 单点修改，全局生效
- 避免硬编码和拼写错误
- 便于版本管理和审计
2. 国际化框架预留 (I18n.kt)
建立多语言支持基础架构：
- 支持中文、英文、日文
- 基于系统语言自动切换
- 易于扩展其他语言
当前状态: 框架已就绪，后续可逐步迁移 UI 字符串
3. 代码规范化
- BootScreen 使用 AppConstants.VERSION_NAME 替代硬编码
- ShareHelper 使用常量替代硬编码 URL 和标签
- 所有新增文件遵循项目代码规范
📊 技术统计
| 指标 | 数值 |
|---|---|
| 修复 Bug 数 | 6 |
| 新增文件 | 2 (AppConstants.kt, I18n.kt) |
| 修改文件 | 6 |
| 代码行数变化 | +379 / -13 |
| CI 通过率 | 100% ✅ |
🔄 升级建议
从 v0.3.3 升级
- 推荐: 所有 v0.3.3 用户立即升级
- 原因: 修复了可能导致重复显示欢迎教程的逻辑问题
- 数据迁移: 无需迁移，完全兼容
从更早版本升级
- 建议先升级到 v0.3.3，再升级到 v0.3.4
- 或直接升级到 v0.3.4（包含所有 v0.3.3 功能）
🧪 测试重点
升级后请验证以下功能：
-
首次启动
- 全新安装后显示 4 页欢迎教程
- 完成或跳过教程后不再显示
- 中途退出应用后再次启动不重复显示
-
错误提示
- 运行有错误的代码显示友好的中文提示
- 提示包含具体的修复建议
-
分享功能
- 点击"分享成就"正常弹出分享对话框
- 分享内容包含正确的版本号和链接
-
版本号显示
- BootScreen 显示 "v0.3.3"（来自 AppConstants）
📝 已知限制
- I18n 框架已建立但尚未在 UI 中实际使用
- 欢迎教程内容仍为硬编码中文，未来版本将迁移到 I18n
🔗 相关链接
感谢使用 PY//NOW！
如有问题或建议，请访问我们的 GitHub 仓库提交 Issue。