游戳记-POSTA

1. 修改了首页地图点亮机制，目前机制如下，在全国视图下：点亮省级地区。在省级视图下，点亮市级单位。在市级视图下，点亮区县单位。 2. 添加新邮戳/编辑邮戳时，可以增加自定义文字标签，后续可以通过自定义标签快速查看同一类型的邮戳。 3. 邮戳的封面现在支持1:1方框比例的取景框，在识别页面，识别框下方可以手动切换取景框比例。 4. 其他bug修复和性能优化。

本次更新重点优化首次使用、邮戳分类和详情体验： - 首次启动时按需下载邮局静态数据，减小安装包体积，并支持下载进度与异常重试。 - 新增邮戳分类，可在新增、编辑、详情和邮戳列表中查看或筛选普通日戳等类型。 - 重构邮局详情和邮戳详情页面，信息层级更清晰，页面导航更贴近系统交互。 - 优化邮戳与邮局的匹配、进度统计和成就解锁逻辑，减少重复统计和地区错配。 - 修复静态数据更新包大小展示、详情页导航、邮戳保存后派生数据刷新等问题。 ## 新功能 ### 首次启动静态数据下载 - iOS 客户端不再依赖内置大体积静态邮局数据包。 - 首次启动如果本地缺少静态数据，会弹出“下载邮局数据”流程。 - 下载弹窗显示数据版本、包大小、进度百分比和字节进度。 - 下载完成后自动重新进入启动初始化流程，完成数据库打开、索引构建和进度初始化。 - 如果静态数据不可用，应用会进入受限模式，避免在空数据状态下误用核心功能。 ### 邮戳分类 - 新增 `PostmarkCategory` / `stampCategory`，支持为邮戳记录分类。 - 新增邮戳和编辑邮戳页面支持选择邮戳分类。 - 邮戳详情页展示分类标签。 - 邮戳列表支持按分类筛选。 - 未知、空值或旧数据缺失分类时，默认按“普通日戳”处理，保证旧用户数据兼容。 ### 详情页体验 - 邮局详情页改为更清晰的卡片式信息结构，邮戳、位置、地址、电话、营业时间等信息分区展示。 - 邮戳详情页改为系统导航栏样式，并支持从邮戳详情进入关联邮局。 - 抽取共用详情页组件和视觉 token，统一详情页排版。 - 设置页与详情页 sheet 统一使用 `NavigationStack`，系统返回、关闭和标题表现更稳定。 ### 邮戳与邮局匹配 - 新增邮戳到邮局的定位服务，按邮编、名称和地区进行消歧。 - 加强邮局名称匹配，处理空白字符和同邮编不同邮局的场景。 - 进度统计基于更稳定的邮局匹配 key，减少同邮编多网点被误合并的问题。 - 成就、地图迷雾、进度卡会在邮戳新增或编辑后更可靠地刷新。 ## 改进 - 进度列表行使用文字标识替代不稳定图形符号，提升列表可读性和跨系统一致性。 - 静态数据更新弹窗现在能正确展示增量包或全量包大小。 - 静态数据客户端使用新的 manifest 路径。 - 静态数据下载改为 SQLite 全量包路径，配合新的发布流程。 - 邮戳详情和邮局详情的导航、按钮和分类控件布局经过调整，减少嵌套导航导致的异常。 ## 修复 - 修复首次无静态数据时不会自动弹出下载提示的问题。 - 修复下载静态数据后没有重新进入完整启动初始化的问题。 - 修复静态数据增量包大小显示不准确的问题。 - 修复邮戳详情 sheet 缺少系统导航栏的问题。 - 修复设置页导航栈承载不稳定的问题。 - 修复邮戳关联邮局时名称匹配过弱导致的错配或未匹配问题。 - 修复新增、编辑邮戳后地区进度、地图迷雾和成就派生数据刷新不稳定的问题。 ## 兼容性与数据迁移 - iOS 用户数据库新增邮戳分类字段，旧数据默认兼容为“普通日戳”。 - 保留旧邮戳、封面、邮局覆盖和进度数据，不要求用户手动迁移。 - 对缺失分类、未知分类值采用降级显示，避免未来分类扩展导致旧版本崩溃。 - 静态数据从 App 包内资源转为首次启动下载后，已安装用户仍可使用已有本地静态数据；缺失数据的新安装用户会进入下载流程。