MakerShelf 2.1

MakerShelf 2.1

MakerShelf 2.1 新增已有归档恢复，解决更新或重装后模型库为空、原文件仍在磁盘上时的恢复问题，并提供统一的打包与发布脚本。

主要更新

• 新增「找回已有模型」：在设置中重新选择原 MakerShelf 归档总目录，恢复模型、封面、文件关联和介绍，无需重新复制或下载。
• 空模型库提供恢复入口；目录授权仍有效且索引为空或无法读取时，启动后自动尝试恢复一次。
• 兼容旧版站点下载的精简资料和本地模型完整资料；后续站点下载改为保存完整资料。
• 按模型 ID 合并，避免重复卡片；根据文件实际位置恢复路径，支持原归档目录整体搬家后的恢复。
• 损坏索引先备份再重建，保存失败回滚内存状态；缺失文件、损坏资料或重复 ID 给出恢复提示。
• 新增中文打包和发布推送脚本；本地与 GitHub Actions 共用通用架构打包流程。
• 修复 Anaconda 同名 codesign 导致登录辅助程序打包失败的问题，固定使用 Apple 工具入口。

更新后找回模型

1. 打开「设置 → 存储与下载 → 找回已有模型」。
2. 点击「选择原目录并恢复」，选择以前包含「本地模型」「中文站」或「国际站」的归档总目录。
3. 等待扫描结束，查看恢复结果，再点击「查看模型库」。已经选择了正确目录时，可以直接「扫描当前目录」。

恢复不会复制、移动或改写原归档文件。普通散装文件夹或没有有效 metadata.json 的目录，仍需通过「添加模型 → 本地模型」整理。旧版归档从未保存过、且原索引也已丢失的分类等信息，使用默认值并提示。

系统与安装

• macOS 14 或更新版本，支持 Apple Silicon 与 Intel；构建号为 12。
• 下载 MakerShelf-2.1-unsigned-macOS.zip，同页提供 .sha256 校验文件。解压后将 MakerShelf.app 放入「应用程序」。
• ZIP 包含 App、LICENSE 和 NOTICE，由 GitHub Actions 从 v2.1 标签构建。
• 安装包没有 Developer ID 签名和 Apple 公证，macOS 可能限制直接打开；也可使用 Xcode 15 或更新版本从源码运行。

已知边界与验证

• 归档恢复仅处理 MakerShelf 归档，不是普通模型目录的批量导入。
• 缺失、损坏或多份相同 ID 的归档会提示并跳过；扫描有条目数量、目录深度和资料体积限制，详情见 README。
• STEP / STP 可保存原文件，暂不支持几何预览；STL / OBJ 为固定视角静态图片。
• MakerWorld 站点接口可能变化；下载队列暂不跨应用重启恢复。
• 本次发布整理完成源码、脚本语法和工程配置静态检查，未在本机重新编译或运行测试；真实归档恢复、账号下载及升级体验仍需在目标设备验收。

完整改动参见 2.1 更新日志。

MakerShelf 2.0

MakerShelf 2.0

MakerShelf 2.0 更新原生模型管理界面，增加文件预览与运行日志，改善本地编辑、图片归档和账号持久保存。

主要更新

• 模型库、下载任务、详情与编辑页统一界面；支持完整图文介绍和窄窗口详情。
• 3MF 读取包内图片，STL / OBJ 生成静态几何预览，支持放大、重试及用作本地模型封面。
• STL 分块读取完整网格，改善抽面造成的破碎表面；自动居中、多方向光照，预算充足时启用超采样抗锯齿。
• 修复 STEP / STP 错用 STL 封面的问题；不支持预览的文件明确显示格式占位。
• 新增本地运行日志，支持搜索、筛选、复制和导出；新增 STL 像素预算和超时设置。
• 展示图片优先压缩为 WebP；改善封面候选、编辑刷新与临时文件清理。
• 改善登录钥匙串持久访问与错误提示，提供重新保存登录状态入口。
• 整理开源目录，docs 仅保留发布流程和功能梳理。

系统与安装

• macOS 14 或更新版本，支持 Apple Silicon 与 Intel。
• 源码运行需要 Xcode 15 或更新版本。
• 安装资产由 GitHub Actions 生成，文件名为 MakerShelf-2.0-unsigned-macOS.zip，附带 .sha256 校验文件。
• 此构建没有 Developer ID 签名和 Apple 公证；系统可能限制直接打开，也可使用 Xcode 从源码运行。
• 初次使用请在「设置」选择归档目录，并连接需要使用的 MakerWorld 站点。

已知边界

• STEP / STP 可保存原文件，暂不支持几何预览；STL / OBJ 为固定视角静态图片。
• 完整网格需要多次读取，复杂模型会降低预览分辨率；超过预算或超时可调整设置后重试。
• MakerWorld 网页接口可能变化；账号收藏和部分文件下载依赖对应站点登录。
• 下载队列不跨应用重启恢复，已归档文件与模型库索引会保留。
• 本次发布整理未在本机重新编译或运行测试；真实账号下载、大模型画面和性能仍需在目标设备验收。

完整改动参见 2.0 更新日志。

MakerShelf 1.0

MakerShelf 1.0

MakerShelf 1.0 是首个公开版本，提供原生 SwiftUI macOS 模型资料库，以及 MakerWorld 模型的本地归档流程。

主要功能

• 支持 MakerWorld 中文站与国际站。
• 导入当前账号收藏和发布模型。
• 按用户名、数字 UID 或作者主页链接读取公开发布模型。
• 下载模型文件，并归档介绍、作者信息和展示图片。
• 新建和编辑自己的本地模型。
• Native Glass 主界面、网格 / 列表浏览、搜索和筛选。

环境要求

• macOS 14 或更新版本
• Xcode 15 或更新版本（从源码运行）

安装

Release 附带由 GitHub Actions 重新构建的 MakerShelf-1.0-unsigned-macOS.zip 和 SHA-256 文件。当前自动构建没有 Developer ID 签名和 Apple 公证，macOS 可能阻止直接打开；熟悉源码构建的用户也可以下载源码后，用 Xcode 打开 MakerShelf.xcodeproj 运行。

已知限制

• MakerWorld 没有公开稳定的开发者 API，站点调整可能影响导入和下载。
• 当前账号收藏和模型文件下载需要在应用内完成对应站点登录。
• 付费、积分、地区和版权限制仍由 MakerWorld 决定，应用不会绕过。
• 下载任务暂不跨应用重启恢复。

完整改动参见 CHANGELOG.md。