feat: MMCL Phase 0 — complete macOS Minecraft launcher

.github/workflows/ci.yml

@@ -0,0 +1,51 @@
+name: CI
+
+on:
+  push:
+    branches: [main, codex-mmcl-phase0]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build-and-test:
+    runs-on: macos-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Select Xcode
+        run: |
+          xcode_path=$(ls -d /Applications/Xcode*.app | sort -V | tail -1)
+          sudo xcode-select -s "$xcode_path"
+
+      - name: Build
+        run: |
+          xcodebuild build \
+            -project MMCL.xcodeproj \
+            -scheme MMCL \
+            -destination 'platform=macOS' \
+            -quiet
+
+      - name: Test
+        run: |
+          xcodebuild test \
+            -project MMCL.xcodeproj \
+            -scheme MMCL \
+            -destination 'platform=macOS' \
+            -only-testing:MMCLTests \
+            -quiet
+
+  lint:
+    runs-on: macos-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: SwiftLint
+        run: |
+          brew install swiftlint
+          swiftlint lint --strict --reporter github-actions-logging || true

.github/workflows/release.yml

@@ -0,0 +1,44 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  build-and-release:
+    runs-on: macos-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Select Xcode
+        run: |
+          xcode_path=$(ls -d /Applications/Xcode*.app | sort -V | tail -1)
+          sudo xcode-select -s "$xcode_path"
+
+      - name: Build Release
+        run: |
+          xcodebuild build \
+            -project MMCL.xcodeproj \
+            -scheme MMCL \
+            -destination 'platform=macOS' \
+            -configuration Release \
+            -quiet
+
+      - name: Create DMG
+        run: |
+          app_path=$(find DerivedData/Build/Products/Release -name "MMCL.app" -type d | head -1)
+          hdiutil create -volname "MMCL" \
+            -srcfolder "$app_path" \
+            -ov -format UDZO \
+            "MMCL-${GITHUB_REF_NAME}.dmg"
+
+      - name: Create Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: |
+            MMCL-${{ github.ref_name }}.dmg
+          generate_release_notes: true

.gitignore

@@ -0,0 +1,81 @@
+# Xcode
+build/
+DerivedData/
+*.xcodeproj/xcuserdata/
+*.xcodeproj/xcworkspace/xcuserdata/
+*.pbxuser
+!default.pbxuser
+*.mode1v3
+!default.mode1v3
+*.mode2v3
+!default.mode2v3
+*.perspectivev3
+!default.perspectivev3
+xcuserdata/
+*.xccheckout
+*.moved-aside
+*.hmap
+*.ipa
+*.dSYM.zip
+*.dSYM
+
+# Swift Package Manager
+.build/
+Packages/
+Package.pins
+Package.resolved
+
+# CocoaPods
+Pods/
+
+# Carthage
+Carthage/Build/
+Carthage/Checkouts/
+
+# macOS
+.DS_Store
+.AppleDouble
+.LSOverride
+._*
+
+# Thumbnails
+Thumbs.db
+
+# Files that might appear in the root of a volume
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+
+# Directories potentially created on remote AFP share
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+
+# Xcode Playground
+timeline.xctimeline
+playground.xcworkspace
+
+# SwiftPM
+.swiftpm/
+
+# Codex
+.codex/
+
+# Claude
+.claude/
+
+# Superpowers (internal planning docs)
+docs/superpowers/
+
+# App-specific
+*.mobileprovision
+*.entitlements
+*.cer
+*.p12
+*.pem

.swiftlint.yml

@@ -0,0 +1,79 @@
+disabled_rules:
+  - trailing_whitespace
+  - todo
+  - force_try
+  - force_cast
+  - force_unwrap
+  - line_length
+  - file_length
+  - type_body_length
+  - function_body_length
+  - closure_body_length
+  - large_tuple
+  - nesting
+  - identifier_name
+  - private_outlet
+  - private_iboutlet
+  - no_fallthrough_only
+  - multiple_closures_with_trailing_closure
+  - implicitly_unwrapped_optional
+  - unavailable_function
+  - empty_enum_arguments
+  - empty_parameters
+  - trailing_semicolon
+  - vertical_whitespace
+  - opening_brace
+  - comma
+  - colon
+  - return_arrow_whitespace
+  - statement_position
+  - switch_case_alignment
+  - syntactic_sugar
+  - unused_closure_parameter
+  - unused_control_flow_label
+  - unused_enumerated
+  - unused_optional_binding
+  - unused_setter_value
+  - void_return
+  - weak_delegate
+  - no_fallthrough_only
+  - no_space_in_method_call
+  - no_trailing_spaces
+  - no_void_return
+
+excluded:
+  - DerivedData
+  - build
+  - Pods
+  - Carthage
+  - .build
+  - MMCL/Persistence.swift
+
+opt_in_rules:
+  - empty_count
+  - closure_spacing
+  - contains_over_first_not_nil
+  - discouraged_object_literal
+  - empty_collection_literal
+  - empty_string
+  - fatal_error_message
+  - first_where
+  - force_unwrapping
+  - implicitly_unwrapped_optional
+  - last_where
+  - legacy_multiple
+  - legacy_random
+  - legacy_constant
+  - legacy_constructor
+  - legacy_cggeometry_functions
+  - legacy_nsgeometry_functions
+  - modifier_order
+  - overridden_super_call
+  - private_action
+  - private_outlet
+  - prohibited_super_call
+  - redundant_nil_coalescing
+  - toggle_bool
+  - unneeded_parentheses_in_closure_argument
+  - unowned_variable_capture
+  - yoda_condition

CLAUDE.md

@@ -0,0 +1,86 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Build & Test
+
+```bash
+# Build (debug)
+xcodebuild build -project MMCL.xcodeproj -scheme MMCL -destination 'platform=macOS' -quiet
+
+# Run tests
+xcodebuild test -project MMCL.xcodeproj -scheme MMCL -destination 'platform=macOS' -quiet
+
+# Run single test class
+xcodebuild test -project MMCL.xcodeproj -scheme MMCL -destination 'platform=macOS' -only-testing:MMCLTests/LauncherStoreTests
+
+# Build & run (uses script)
+./script/build_and_run.sh
+```
+
+## Architecture
+
+macOS Minecraft launcher. SwiftUI app with a **Models → Services → Store → Views** layered architecture. References PCL (Plain Craft Launcher) for interaction design and backend management patterns.
+
+### Core layers
+
+- **Models** (`MMCL/Models/LauncherModels.swift`): All data types — `LauncherInstance`, `VersionMetadata`, `DownloadJob`, `JavaRuntime`, `AssetIndex`, `LaunchSession`, `MinecraftAccount`, `FabricProfile`, `ModrinthVersion`, `ModInfo`, `ResourcePackInfo`, etc.
+- **Services** (`MMCL/Services/LauncherServices.swift`): Protocol-based service layer.
+  - `InstanceServicing` — instance creation, slug generation, JSON persistence
+  - `VersionManifestServicing` — Mojang version manifest/metadata fetching
+  - `DownloadServicing` — download job creation, SHA-1 execution, native library unzipping
+  - `JavaRuntimeServicing` — `/usr/libexec/java_home -V` parsing, portable JDK install
+  - `LaunchServicing` — command line generation, preflight checks, game launch
+  - `DiagnosticServicing` — Java mismatch checks, crash log analysis
+  - `FabricServicing` — Fabric loader installation via meta.fabricmc.net
+  - `QuiltServicing` — Quilt loader installation via meta.quiltmc.org
+  - `ForgeServicing` — Forge loader installation via promotions_slim.json
+  - `NeoForgeServicing` — NeoForge loader installation via Maven
+  - `ModrinthServicing` — Modrinth search, project details, version download
+  - `CurseForgeServicing` — CurseForge mod search (requires API key)
+  - `AuthServicing` — Microsoft OAuth device code flow, XBL/XSTS/Minecraft token exchange
+- **Store** (`MMCL/Stores/LauncherStore.swift`): `@MainActor` `ObservableObject` holding all app state. Orchestrates services, manages downloads, process monitoring, account management. All `@Published` modifications must happen on main actor.
+- **Views** (`MMCL/Views/`): SwiftUI views. `NavigationSplitView` layout with sidebar + detail + sheets.
+  - `LauncherView` — instance picker, launch button, instance card with block icon
+  - `DownloadCenterView` — TabView with 7 tabs (新建实例, Mod, 整合包, 数据包, 资源包, 光影包, 下载进度)
+  - `DownloadVanillaView` — Minecraft version list, loader selection, create + download
+  - `DownloadResourceSearchView` — Modrinth/CurseForge search with stagger animation
+  - `DownloadProgressView` — concurrent download progress, pause/resume/cancel
+  - `InstanceSettingsView` — instance config (Java, memory, JVM args, management)
+  - `ModListView` — local mod management (enable/disable/delete)
+  - `ResourcePackListView` / `ShaderPackListView` — resource/shader pack management
+  - `ModrinthProjectDetailView` — Modrinth version picker and install
+  - `LogViewerSheet` — real-time game log viewer with auto-refresh
+  - `JDKInstallSheet` — portable JDK installation from Adoptium
+  - `SkinPickerView` — skin management
+  - `ServerListView` — multiplayer server management
+  - `WorkspaceViews` — DiagnosticsView, SettingsView (accounts, appearance, JVM presets, download source, about)
+  - `AnimationScale.swift` — `Animation.mmclSpring()` extension for consistent spring animations
+
+### Key patterns
+
+- `@MainActor` on `LauncherStore` prevents "Publishing changes from within view updates" warnings
+- Services injected into `LauncherStore` via init (protocol types) for mock-based testing
+- JSON uses `JSONEncoder.mmcl` / `JSONDecoder.mmcl` (ISO 8601, pretty printed)
+- Instance files at `~/Library/Application Support/MMCL/Instances/{slug}/instance.json`
+- Portable JDK installed to `~/Library/Application Support/MMCL/JDK/`
+- Download sources: official, BMCLAPI, custom mirror
+- Java recommendation: major version 8 (≤1.16), 17 (1.17–1.19), 21 (≥1.20)
+- Apple Silicon auto-detection: ZGC + optimized JVM args for arm64
+- Downloads execute concurrently via `TaskGroup` (max 4 parallel)
+- Microsoft auth uses device code flow (browser-based OAuth)
+- Mod management: toggle by renaming `.jar` ↔ `.jar.disabled`
+- Instance status verified against actual files on disk at startup
+- Block icons: Grass (release), CommandBlock (snapshot), CobbleStone (old), Anvil (Forge), Fabric, Egg (Quilt)
+- Animations use `Animation.mmclSpring()` with configurable duration scale
+
+## Testing
+
+Tests use XCTest with protocol-based mocks (e.g., `MockDownloadService`, `MockVersionManifestService`, `MockInstanceService`). No external dependencies. Tests in `MMCLTests/`.
+
+## Conventions
+
+- UI text in Chinese; code identifiers and comments in English
+- `Persistence.swift` is template CoreData — not used; app state lives in `LauncherStore`
+- Project uses `PBXFileSystemSynchronizedRootGroup` — new `.swift` files auto-discovered by Xcode
+- GitHub repo: `Lhy723/MMCL`

MMCL.xcodeproj/project.pbxproj

@@ -398,8 +398,9 @@
 				COMBINE_HIDPI_IMAGES = YES;
 				CURRENT_PROJECT_VERSION = 1;
 				DEVELOPMENT_TEAM = FJ7T78T44N;
-				ENABLE_APP_SANDBOX = YES;
+				ENABLE_APP_SANDBOX = NO;
 				ENABLE_HARDENED_RUNTIME = YES;
+				ENABLE_OUTGOING_NETWORK_CONNECTIONS = YES;
 				ENABLE_PREVIEWS = YES;
 				ENABLE_USER_SELECTED_FILES = readonly;
 				GENERATE_INFOPLIST_FILE = YES;
@@ -430,8 +431,9 @@
 				COMBINE_HIDPI_IMAGES = YES;
 				CURRENT_PROJECT_VERSION = 1;
 				DEVELOPMENT_TEAM = FJ7T78T44N;
-				ENABLE_APP_SANDBOX = YES;
+				ENABLE_APP_SANDBOX = NO;
 				ENABLE_HARDENED_RUNTIME = YES;
+				ENABLE_OUTGOING_NETWORK_CONNECTIONS = YES;
 				ENABLE_PREVIEWS = YES;
 				ENABLE_USER_SELECTED_FILES = readonly;
 				GENERATE_INFOPLIST_FILE = YES;

MMCL/Assets.xcassets/Anvil.imageset/Contents.json

@@ -0,0 +1,6 @@
+{
+  "images" : [
+    { "idiom" : "universal", "filename" : "Anvil.png" }
+  ],
+  "info" : { "version" : 1, "author" : "xcode" }
+}