From 936a72e784487da7f89c8cfafd8ca26fca719977 Mon Sep 17 00:00:00 2001 From: HsiangNianian Date: Fri, 31 Jul 2026 01:39:56 +0800 Subject: [PATCH] docs(release): prepare Alpha 7 --- .changes/alpha7-docs.md | 5 ++ .changes/alpha7-fixtures.md | 7 +++ .changes/alpha7-instance-library.md | 7 +++ .changes/alpha7-launch-readiness.md | 7 +++ .changes/alpha7-monaco.md | 7 +++ README.CN.md | 9 ++-- README.md | 9 ++-- .../docs/content/en/manual/features/index.mdx | 27 ++++------ .../content/en/manual/getting-started.mdx | 47 ++++++++-------- packages/docs/content/en/manual/index.mdx | 9 ++-- packages/docs/content/en/manual/meta.json | 2 +- .../content/en/manual/releases/alpha-7.mdx | 49 +++++++++++++++++ .../docs/content/en/manual/releases/meta.json | 4 ++ .../docs/content/zh/manual/features/index.mdx | 27 ++++------ .../content/zh/manual/getting-started.mdx | 53 +++++++++---------- packages/docs/content/zh/manual/index.mdx | 9 ++-- packages/docs/content/zh/manual/meta.json | 2 +- .../content/zh/manual/releases/alpha-7.mdx | 49 +++++++++++++++++ .../docs/content/zh/manual/releases/meta.json | 4 ++ 19 files changed, 236 insertions(+), 97 deletions(-) create mode 100644 .changes/alpha7-docs.md create mode 100644 .changes/alpha7-fixtures.md create mode 100644 .changes/alpha7-instance-library.md create mode 100644 .changes/alpha7-launch-readiness.md create mode 100644 .changes/alpha7-monaco.md create mode 100644 packages/docs/content/en/manual/releases/alpha-7.mdx create mode 100644 packages/docs/content/en/manual/releases/meta.json create mode 100644 packages/docs/content/zh/manual/releases/alpha-7.mdx create mode 100644 packages/docs/content/zh/manual/releases/meta.json diff --git a/.changes/alpha7-docs.md b/.changes/alpha7-docs.md new file mode 100644 index 00000000..d8c6eb05 --- /dev/null +++ b/.changes/alpha7-docs.md @@ -0,0 +1,5 @@ +--- +"@dropout/docs": "patch:fix" +--- + +Publish bilingual Alpha 7 release notes and align installation, navigation, feature, and migration guidance with shipped behavior. diff --git a/.changes/alpha7-fixtures.md b/.changes/alpha7-fixtures.md new file mode 100644 index 00000000..af9802f6 --- /dev/null +++ b/.changes/alpha7-fixtures.md @@ -0,0 +1,7 @@ +--- +"dropout": "patch:feat" +"@dropout/ui": "patch:feat" +"@dropout/docs": "patch:feat" +--- + +Add deterministic browser fixtures, route code splitting, accessibility checks, and reviewed cross-platform visual regression baselines. diff --git a/.changes/alpha7-instance-library.md b/.changes/alpha7-instance-library.md new file mode 100644 index 00000000..32b92e17 --- /dev/null +++ b/.changes/alpha7-instance-library.md @@ -0,0 +1,7 @@ +--- +"dropout": "patch:feat" +"@dropout/ui": "patch:feat" +"@dropout/docs": "patch:feat" +--- + +Add a searchable and sortable instance library with scalable views, progressive readiness, detail workflows, and guarded management actions. diff --git a/.changes/alpha7-launch-readiness.md b/.changes/alpha7-launch-readiness.md new file mode 100644 index 00000000..9539a6e5 --- /dev/null +++ b/.changes/alpha7-launch-readiness.md @@ -0,0 +1,7 @@ +--- +"dropout": "patch:feat" +"@dropout/ui": "patch:feat" +"@dropout/docs": "patch:feat" +--- + +Redesign Home as a state-driven launch readiness, progress, logging, and recovery command center. diff --git a/.changes/alpha7-monaco.md b/.changes/alpha7-monaco.md new file mode 100644 index 00000000..d03ed4a8 --- /dev/null +++ b/.changes/alpha7-monaco.md @@ -0,0 +1,7 @@ +--- +"dropout": "patch:feat" +"@dropout/ui": "patch:feat" +"@dropout/docs": "patch:feat" +--- + +Replace the raw configuration textarea with a locally bundled, schema-aware Monaco JSON editor and safe editing workflows. diff --git a/README.CN.md b/README.CN.md index 4c01ff79..98313275 100644 --- a/README.CN.md +++ b/README.CN.md @@ -58,12 +58,14 @@ Rust 核心负责副作用。React UI 调用 Tauri 命令并渲染状态。文 - **Microsoft 认证** - 设备代码 OAuth、Minecraft Services 登录、令牌刷新和账户持久化。 - **离线账户** - 支持本地账户，便于测试或离线使用。 -- **实例系统** - 隔离游戏目录，并支持实例备注、内存覆盖、Java 参数、版本和加载器状态。 +- **启动指挥中心** - 依据真实就绪检查，用同一个主操作完成登录、修复、下载、启动、停止和失败恢复。 +- **实例库** - 支持搜索、排序、网格/列表视图、渐进就绪检查、当前实例详情和带保护的管理操作。 +- **实例系统** - 隔离游戏目录，并支持实例备注、内存与 Java 覆盖、版本、加载器、模组、存档和迁移入口。 - **Minecraft 版本管理** - 安装、校验、列出、删除并启动本地版本。 - **Fabric 和 Forge 支持** - 发现加载器版本，并为模组实例提供安装流程。 - **Java 管理** - 本地 Java 检测、兼容性检查、Adoptium 目录查询、下载、恢复和取消。 - **并发下载** - 资源和依赖库队列、进度事件和恢复路径。 -- **配置编辑器** - 查看和编辑原始 JSON/TOML 启动器配置。 +- **配置编辑器** - 使用本地打包的 Monaco 编辑 JSON，并提供 Schema 诊断、格式化、键盘保存和放弃更改保护。 - **发布动态** - 在主页展示 GitHub Release 更新。 - **游戏助手** - 可选的本地或 OpenAI 兼容助手，用于日志、崩溃和配置问题。 @@ -190,7 +192,8 @@ UI 的长期状态位于 `packages/ui/src/models/`，页面位于 `packages/ui/s - [ ] 内置模组管理器 - [ ] 自定义游戏目录选择 - [ ] 启动器自动更新 -- [x] 从 PCL、HMCL、MultiMC、Prism Launcher 和其他配置导入 +- [x] 从 PCL、HMCL、MultiMC 和 Prism Launcher 进行基础发现与复制式导入 +- [ ] 迁移冲突预览、取消、回滚和结构化兼容性报告 公开路线图见 。 diff --git a/README.md b/README.md index 6d06bbf4..fe706253 100644 --- a/README.md +++ b/README.md @@ -58,12 +58,14 @@ The Rust core owns side effects. The React UI invokes Tauri commands and renders - **Microsoft authentication** - device-code OAuth flow, Minecraft Services login, token refresh, and persisted account state. - **Offline accounts** - local accounts for testing or non-network play. -- **Instance system** - isolated game directories with per-instance notes, memory overrides, Java arguments, version, and loader state. +- **Launch command center** - one state-driven action for sign-in, repair, download, launch, stop, and failure recovery, backed by real readiness checks. +- **Instance library** - searchable and sortable grid/list views, progressive readiness, active-instance details, and guarded management actions. +- **Instance system** - isolated game directories with per-instance notes, memory and Java overrides, version, loader, mods, saves, and migration entry points. - **Minecraft version management** - install, verify, list, delete, and launch local versions. - **Fabric and Forge support** - loader version discovery plus installer flows for modded instances. - **Java management** - local Java detection, compatibility checks, Adoptium catalog lookup, downloads, resume, and cancellation. - **Concurrent downloads** - asset/library queues with progress events and recovery paths. -- **Configuration editor** - inspect and edit raw JSON/TOML launcher configuration. +- **Configuration editor** - edit launcher JSON with locally bundled Monaco, schema diagnostics, formatting, keyboard save, and discard protection. - **Release feed** - GitHub release notes surfaced on the home screen. - **Game assistant** - optional local or OpenAI-compatible helper for logs, crashes, and configuration questions. @@ -190,7 +192,8 @@ The UI keeps long-lived state in `packages/ui/src/models/`, renders routes from - [ ] Built-in mods manager - [ ] Custom game directory selection - [ ] Launcher auto-updater -- [x] Import from PCL, HMCL, MultiMC, Prism Launcher, and other profiles +- [x] Basic discovery and copy-based import from PCL, HMCL, MultiMC, and Prism Launcher +- [ ] Migration conflict previews, cancellation, rollback, and structured compatibility reports The public roadmap is tracked at . diff --git a/packages/docs/content/en/manual/features/index.mdx b/packages/docs/content/en/manual/features/index.mdx index 882561d6..9d1b2443 100644 --- a/packages/docs/content/en/manual/features/index.mdx +++ b/packages/docs/content/en/manual/features/index.mdx @@ -30,15 +30,10 @@ DropOut is packed with features designed for both casual players and power users href="instances" description="Isolated game environments with independent configs" /> - - @@ -65,7 +60,7 @@ DropOut is packed with features designed for both casual players and power users | Mods Manager | Planned | Enable/disable mods in launcher | | Launcher Auto-update | Planned | Self-updating mechanism | | Custom Game Directory | Planned | Choose game files location | -| Import Profiles | Planned | Import from MultiMC/Prism | +| Launcher Migration | Preview | Basic PCL/HMCL/MultiMC/Prism discovery and copy import | ## Performance Features @@ -90,7 +85,7 @@ DropOut is packed with features designed for both casual players and power users ## User Interface Features ### Modern Design -- Dark mode enforced for eye comfort +- Light and dark themes with readable launch-state contrast - Particle background effects - Clean, distraction-free layout - Responsive design @@ -163,11 +158,11 @@ Built-in [Monaco configuration editor](/docs/manual/features/config-editor) with - Mod compatibility checking - Version management -### Profile Import -- Import from MultiMC -- Import from Prism Launcher -- Import from other launchers -- Preserve settings and saves +### Migration Compatibility +- Preview imported, skipped, unsupported, and conflicting content +- Preserve launcher-specific metadata and overrides +- Add cancellation, rollback, and compatibility reports +- Keep source launcher data unchanged ### Launcher Auto-update - Background update checks diff --git a/packages/docs/content/en/manual/getting-started.mdx b/packages/docs/content/en/manual/getting-started.mdx index 385f8a56..24295ac4 100644 --- a/packages/docs/content/en/manual/getting-started.mdx +++ b/packages/docs/content/en/manual/getting-started.mdx @@ -11,22 +11,23 @@ DropOut is a modern, reproducible, and developer-grade Minecraft launcher built ### Download Pre-built Binaries -Download the latest release for your platform from the [Releases](https://github.com/HsiangNianian/DropOut/releases) page. +Download the latest prerelease for your platform from the [HydroRoll Team releases](https://github.com/HydroRoll-Team/DropOut/releases) page. Alpha builds are intended for testing, so export important instances before upgrading. -| Platform | Files | -| -------------- | ------------------- | -| Linux x86_64 | `.deb`, `.AppImage` | -| Linux ARM64 | `.deb`, `.AppImage` | -| macOS ARM64 | `.dmg` | -| Windows x86_64 | `.msi`, `.exe` | -| Windows ARM64 | `.msi`, `.exe` | +| Platform | Release asset | +| -------------- | -------------------- | +| Linux x86_64 | `.deb`, `.AppImage` | +| Linux ARM64 | `.deb`, `.AppImage` | +| macOS x86_64 | `.dmg` | +| macOS ARM64 | `.dmg` | +| Windows x86_64 | NSIS `.exe` installer | +| Windows ARM64 | NSIS `.exe` installer | ### Linux Installation #### Using .deb Package ```bash -sudo dpkg -i dropout_*.deb +sudo dpkg -i Dropout_*.deb # Fix dependencies if needed sudo apt-get install -f ``` @@ -34,8 +35,8 @@ sudo apt-get install -f #### Using AppImage ```bash -chmod +x dropout_*.AppImage -./dropout_*.AppImage +chmod +x Dropout_*.AppImage +./Dropout_*.AppImage ``` ### macOS Installation @@ -46,16 +47,9 @@ chmod +x dropout_*.AppImage ### Windows Installation -#### Using .msi Installer - -1. Double-click the `.msi` file -2. Follow the installation wizard -3. Launch DropOut from the Start Menu - -#### Using .exe Portable - -1. Double-click the `.exe` file -2. DropOut will run directly without installation +1. Double-click the architecture-appropriate `-setup.exe` installer. +2. Follow the installation wizard. +3. Launch DropOut from the Start Menu. ## First Launch @@ -136,9 +130,14 @@ DropOut calculates the Java and file checks with the same backend rules used by href="/docs/manual/features/mod-loaders" description="Install and manage Fabric and Forge" /> + @@ -163,6 +162,6 @@ DropOut calculates the Java and file checks with the same backend rules used by If you encounter issues: -- Check the [Troubleshooting Guide](/docs/troubleshooting) -- Report bugs on [GitHub Issues](https://github.com/HsiangNianian/DropOut/issues) +- Check the [Troubleshooting Guide](/docs/manual/troubleshooting) +- Report bugs on [GitHub Issues](https://github.com/HydroRoll-Team/DropOut/issues) - Join our community discussions diff --git a/packages/docs/content/en/manual/index.mdx b/packages/docs/content/en/manual/index.mdx index bcb8d88b..313494c8 100644 --- a/packages/docs/content/en/manual/index.mdx +++ b/packages/docs/content/en/manual/index.mdx @@ -36,12 +36,12 @@ This launcher is built for players who value control, transparency, and long-ter /> @@ -52,7 +52,10 @@ This launcher is built for players who value control, transparency, and long-ter Built with Rust and Tauri for minimal resource usage and fast startup times. ### Modern UI -Clean, distraction-free interface with React 19, shadcn/ui, Tailwind CSS 4, and particle effects. +State-driven launch command center, scalable instance library, light/dark themes, and responsive layouts at the supported desktop window sizes. + +### Safe Configuration +Locally bundled Monaco JSON editor with schema diagnostics, formatting, keyboard save, and unsaved-change protection. ### Secure Authentication Microsoft OAuth 2.0 with device code flow and offline authentication support. diff --git a/packages/docs/content/en/manual/meta.json b/packages/docs/content/en/manual/meta.json index 56c5ceb1..663717d3 100644 --- a/packages/docs/content/en/manual/meta.json +++ b/packages/docs/content/en/manual/meta.json @@ -1,4 +1,4 @@ { "title": "User Manual", - "pages": ["index", "getting-started", "features", "troubleshooting"] + "pages": ["index", "getting-started", "releases", "features", "troubleshooting"] } diff --git a/packages/docs/content/en/manual/releases/alpha-7.mdx b/packages/docs/content/en/manual/releases/alpha-7.mdx new file mode 100644 index 00000000..e791e15d --- /dev/null +++ b/packages/docs/content/en/manual/releases/alpha-7.mdx @@ -0,0 +1,49 @@ +--- +title: 0.2.0-alpha.7 — UX Foundation +description: Launch readiness, a scalable instance library, Monaco configuration editing, and reproducible UI validation. +--- + +# 0.2.0-alpha.7 — UX Foundation + +Alpha 7 turns DropOut's core launcher surfaces into an inspectable daily workflow. It is a prerelease: back up or export important instances before upgrading, and report regressions on [GitHub Issues](https://github.com/HydroRoll-Team/DropOut/issues). + +## Highlights + +### Launch from real readiness + +Home is now a launch command center. One primary action follows the current account, instance, game files, loader, Java, memory, download, and process state. The same screen exposes recovery actions, aggregate download progress, live output, recent failures, and Minecraft logs. + +### Navigate large instance libraries + +The instance library adds name/content search, sorting, persistent grid/list views, progressive readiness checks, and an active detail workspace. Management actions include edit, duplicate, export, migrate, open directory, mod shortcuts, and guarded deletion with recovery guidance. + +### Edit JSON safely with Monaco + +The advanced configuration editor now bundles Monaco and its JSON worker locally. Schema diagnostics, formatting, Ctrl/Command+S, reset, cursor/validation status, immediate theme/language application, and unsaved-change protection work without a CDN. + +### Reproduce UI states before shipping + +Development fixtures cover empty, ready, downloading, running, failed, migration, and scaled instance-library states without requiring Tauri services. The Alpha 7 gate exercises 108 UI checks with keyboard/accessibility coverage and reviewed dark/light screenshots at both the 1024×768 default and 905×575 minimum window sizes on macOS and Linux. + +## Upgrade and migration notes + +- Existing DropOut configuration and instances are reused; Alpha 7 does not intentionally change their storage format. +- Basic PCL, HMCL, MultiMC, and Prism discovery/import remains available from **Library actions** and copies selected game content into a DropOut-managed instance. +- Full conflict preview, cancellation, rollback, launcher-specific compatibility reporting, and broader cross-platform migration fixtures are scheduled for Alpha 8. +- Export an instance before destructive changes when its saves, mods, packs, or configuration cannot be recreated. + +## Release assets + +| Platform | Assets | +| --- | --- | +| Linux x86_64 / ARM64 | `.deb`, `.AppImage` | +| macOS x86_64 / ARM64 | `.dmg` | +| Windows x86_64 / ARM64 | NSIS `-setup.exe` | + +## Known limitations + +- Alpha builds may change behavior and data contracts before the stable release. +- Launcher auto-update and the complete in-launcher mods manager are not finished. +- Migration is a preview workflow until the Alpha 8 compatibility milestone is complete. + +Continue with the [launch workflow](/docs/manual/getting-started), [instance library](/docs/manual/features/instances), or [Monaco configuration editor](/docs/manual/features/config-editor). diff --git a/packages/docs/content/en/manual/releases/meta.json b/packages/docs/content/en/manual/releases/meta.json new file mode 100644 index 00000000..d8958ec6 --- /dev/null +++ b/packages/docs/content/en/manual/releases/meta.json @@ -0,0 +1,4 @@ +{ + "title": "Release Notes", + "pages": ["alpha-7"] +} diff --git a/packages/docs/content/zh/manual/features/index.mdx b/packages/docs/content/zh/manual/features/index.mdx index b47deabe..be5e37b5 100644 --- a/packages/docs/content/zh/manual/features/index.mdx +++ b/packages/docs/content/zh/manual/features/index.mdx @@ -30,15 +30,10 @@ DropOut 功能丰富，既适合休闲玩家也适合高级用户。本指南涵 href="instances" description="具有独立配置的隔离游戏环境" /> - - @@ -65,7 +60,7 @@ DropOut 功能丰富，既适合休闲玩家也适合高级用户。本指南涵 | 模组管理器 | 计划中 | 在启动器中启用/禁用模组 | | 启动器自动更新 | 计划中 | 自我更新机制 | | 自定义游戏目录 | 计划中 | 选择游戏文件位置 | -| 导入配置文件 | 计划中 | 从 MultiMC/Prism 导入 | +| 启动器迁移 | 预览 | 基础发现并复制导入 PCL/HMCL/MultiMC/Prism 实例 | ## 性能功能 @@ -90,7 +85,7 @@ DropOut 功能丰富，既适合休闲玩家也适合高级用户。本指南涵 ## 用户界面功能 ### 现代设计 -- 强制暗色模式保护眼睛 +- 提供亮色与暗色主题，并保证启动状态对比度 - 粒子背景效果 - 简洁、无干扰的布局 - 响应式设计 @@ -163,11 +158,11 @@ DropOut 功能丰富，既适合休闲玩家也适合高级用户。本指南涵 - 模组兼容性检查 - 版本管理 -### 配置文件导入 -- 从 MultiMC 导入 -- 从 Prism Launcher 导入 -- 从其他启动器导入 -- 保留设置和存档 +### 迁移兼容性 +- 导入前预览已包含、跳过、不支持和冲突的内容 +- 保留启动器专属元数据与覆盖设置 +- 增加取消、回滚和兼容性报告 +- 保证源启动器数据不被修改 ### 启动器自动更新 - 后台更新检查 diff --git a/packages/docs/content/zh/manual/getting-started.mdx b/packages/docs/content/zh/manual/getting-started.mdx index b76eee6d..134e007b 100644 --- a/packages/docs/content/zh/manual/getting-started.mdx +++ b/packages/docs/content/zh/manual/getting-started.mdx @@ -11,22 +11,23 @@ DropOut 是一个使用 Tauri v2 构建的现代化、可复现、开发者级 ### 下载预编译二进制文件 -从[发布页面](https://github.com/HsiangNianian/DropOut/releases)下载适合你平台的最新版本。 +从 [HydroRoll Team 发布页面](https://github.com/HydroRoll-Team/DropOut/releases)下载适合你平台的最新预发布版本。Alpha 版本用于测试，升级前请先导出重要实例。 -| 平台 | 文件 | -| -------------- | ------------------- | -| Linux x86_64 | `.deb`, `.AppImage` | -| Linux ARM64 | `.deb`, `.AppImage` | -| macOS ARM64 | `.dmg` | -| Windows x86_64 | `.msi`, `.exe` | -| Windows ARM64 | `.msi`, `.exe` | +| 平台 | 发布产物 | +| -------------- | --------------------- | +| Linux x86_64 | `.deb`、`.AppImage` | +| Linux ARM64 | `.deb`、`.AppImage` | +| macOS x86_64 | `.dmg` | +| macOS ARM64 | `.dmg` | +| Windows x86_64 | NSIS `.exe` 安装程序 | +| Windows ARM64 | NSIS `.exe` 安装程序 | ### Linux 安装 #### 使用 .deb 包 ```bash -sudo dpkg -i dropout_*.deb +sudo dpkg -i Dropout_*.deb # 如果需要，修复依赖 sudo apt-get install -f ``` @@ -34,8 +35,8 @@ sudo apt-get install -f #### 使用 AppImage ```bash -chmod +x dropout_*.AppImage -./dropout_*.AppImage +chmod +x Dropout_*.AppImage +./Dropout_*.AppImage ``` ### macOS 安装 @@ -46,16 +47,9 @@ chmod +x dropout_*.AppImage ### Windows 安装 -#### 使用 .msi 安装程序 - -1. 双击 `.msi` 文件 -2. 按照安装向导操作 -3. 从开始菜单启动 DropOut - -#### 使用 .exe 便携版 - -1. 双击 `.exe` 文件 -2. DropOut 将直接运行，无需安装 +1. 双击与系统架构对应的 `-setup.exe` 安装程序。 +2. 按照安装向导操作。 +3. 从开始菜单启动 DropOut。 ## 首次启动 @@ -121,14 +115,19 @@ DropOut 使用与真实启动命令相同的后端规则计算 Java 和文件状 ## 下一步 - - + + - + + ## 系统要求 @@ -151,6 +150,6 @@ DropOut 使用与真实启动命令相同的后端规则计算 Java 和文件状 如果遇到问题： -- 查看[故障排除指南](/docs/troubleshooting) -- 在 [GitHub Issues](https://github.com/HsiangNianian/DropOut/issues) 上报告 bug +- 查看[故障排除指南](/zh/docs/manual/troubleshooting) +- 在 [GitHub Issues](https://github.com/HydroRoll-Team/DropOut/issues) 上报告 bug - 加入我们的社区讨论 diff --git a/packages/docs/content/zh/manual/index.mdx b/packages/docs/content/zh/manual/index.mdx index 411c9428..e02f4b76 100644 --- a/packages/docs/content/zh/manual/index.mdx +++ b/packages/docs/content/zh/manual/index.mdx @@ -36,12 +36,12 @@ DropOut 是一个使用 Tauri v2 构建的现代 Minecraft 启动器，专为重 /> @@ -52,7 +52,10 @@ DropOut 是一个使用 Tauri v2 构建的现代 Minecraft 启动器，专为重 使用 Rust 和 Tauri 构建，资源占用最小，启动速度极快。 ### 现代化界面 -简洁、无干扰的界面，使用 React 19、shadcn/ui、Tailwind CSS 4 和粒子效果。 +以状态驱动的启动指挥中心、可扩展实例库、亮/暗主题，以及适配桌面窗口尺寸的响应式布局。 + +### 安全配置 +本地打包的 Monaco JSON 编辑器，提供 Schema 诊断、格式化、键盘保存和未保存更改保护。 ### 安全认证 微软 OAuth 2.0 设备代码流和离线认证支持。 diff --git a/packages/docs/content/zh/manual/meta.json b/packages/docs/content/zh/manual/meta.json index cc3767a9..2991edad 100644 --- a/packages/docs/content/zh/manual/meta.json +++ b/packages/docs/content/zh/manual/meta.json @@ -3,7 +3,7 @@ "pages": [ "index", "getting-started", - "architecture", + "releases", "features", "troubleshooting" ] diff --git a/packages/docs/content/zh/manual/releases/alpha-7.mdx b/packages/docs/content/zh/manual/releases/alpha-7.mdx new file mode 100644 index 00000000..96c20d45 --- /dev/null +++ b/packages/docs/content/zh/manual/releases/alpha-7.mdx @@ -0,0 +1,49 @@ +--- +title: 0.2.0-alpha.7 — UX 基础 +description: 启动就绪、可扩展实例库、Monaco 配置编辑与可复现 UI 验证。 +--- + +# 0.2.0-alpha.7 — UX 基础 + +Alpha 7 将 DropOut 的核心启动器界面整理为可检查的日常工作流。这仍是预发布版本：升级前请备份或导出重要实例，并在 [GitHub Issues](https://github.com/HydroRoll-Team/DropOut/issues) 报告回归问题。 + +## 主要变化 + +### 基于真实就绪状态启动 + +主页现在是启动指挥中心。唯一的主操作会依据账户、实例、游戏文件、加载器、Java、内存、下载和进程状态切换；同一界面还提供恢复操作、汇总下载进度、实时输出、最近失败记录和 Minecraft 日志入口。 + +### 管理大型实例库 + +实例库新增名称/内容搜索、排序、持久化网格/列表视图、渐进就绪检查和当前实例详情工作区。管理操作包含编辑、复制、导出、迁移、打开目录、模组快捷入口，以及带恢复提示的删除确认。 + +### 使用 Monaco 安全编辑 JSON + +高级配置编辑器现在会在本地打包 Monaco 及其 JSON Worker。无需 CDN 即可使用 Schema 诊断、格式化、Ctrl/Command+S、重置、光标/校验状态、主题/语言即时应用和未保存更改保护。 + +### 发版前复现 UI 状态 + +开发 fixture 无需 Tauri 服务即可覆盖空状态、就绪、下载、运行、失败、迁移和不同规模实例库。Alpha 7 门禁包含 108 项 UI 检查、键盘/无障碍覆盖，以及 macOS 与 Linux 上 1024×768 默认窗口和 905×575 最小窗口的亮/暗截图基线。 + +## 升级与迁移说明 + +- 现有 DropOut 配置和实例会继续使用；Alpha 7 不会有意修改其存储格式。 +- **实例库操作**仍提供 PCL、HMCL、MultiMC 和 Prism 的基础发现/导入，并将所选游戏内容复制到 DropOut 管理的实例。 +- 完整冲突预览、取消、回滚、启动器专属兼容性报告和更完整的跨平台迁移 fixture 计划在 Alpha 8 完成。 +- 如果存档、模组、资源包或配置无法重建，请在破坏性操作前先导出实例。 + +## 发布产物 + +| 平台 | 产物 | +| --- | --- | +| Linux x86_64 / ARM64 | `.deb`、`.AppImage` | +| macOS x86_64 / ARM64 | `.dmg` | +| Windows x86_64 / ARM64 | NSIS `-setup.exe` | + +## 已知限制 + +- Alpha 阶段的行为和数据契约在稳定版前仍可能调整。 +- 启动器自动更新和完整的内置模组管理器尚未完成。 +- Alpha 8 兼容性里程碑完成前，迁移仍属于预览工作流。 + +继续阅读[启动流程](/zh/docs/manual/getting-started)、[实例库](/zh/docs/manual/features/instances)或 [Monaco 配置编辑器](/zh/docs/manual/features/config-editor)。 diff --git a/packages/docs/content/zh/manual/releases/meta.json b/packages/docs/content/zh/manual/releases/meta.json new file mode 100644 index 00000000..a6c2fccc --- /dev/null +++ b/packages/docs/content/zh/manual/releases/meta.json @@ -0,0 +1,4 @@ +{ + "title": "发布说明", + "pages": ["alpha-7"] +}