feat: prepare v0.3.0 release

Author: wutongci

.github/workflows/ci.yml

@@ -16,8 +16,18 @@ concurrency:
 
 jobs:
   build-macos:
-    name: Build And Package
-    runs-on: macos-latest
+    name: Build macOS Preview (${{ matrix.label }})
+    runs-on: ${{ matrix.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - runner: macos-15
+            label: Apple Silicon
+            artifact_suffix: macos-arm64
+          - runner: macos-15-intel
+            label: Intel
+            artifact_suffix: macos-x64
     steps:
       - name: Checkout
         uses: actions/checkout@v5
@@ -39,13 +49,13 @@ jobs:
           test -f "dist/Lime Pet.app/Contents/Info.plist"
 
       - name: Build release package preview
-        run: ./scripts/package-release.sh --version "0.0.0-ci" --build-number "${{ github.run_number }}"
+        run: ./scripts/package-release.sh --version "0.0.0-ci" --build-number "${{ github.run_number }}" --artifact-suffix "${{ matrix.artifact_suffix }}"
 
       - name: Upload macOS preview artifact
         if: success()
         uses: actions/upload-artifact@v6
         with:
-          name: lime-pet-macos-preview
+          name: lime-pet-${{ matrix.artifact_suffix }}-preview
           path: |
             dist/release/*.zip
             dist/release/*.sha256

.github/workflows/release.yml

@@ -4,9 +4,9 @@ on:
   workflow_dispatch:
     inputs:
       version:
-        description: "发布版本，例如 v0.2.0"
+        description: "发布版本，例如 v0.3.0"
         required: true
-        default: "v0.2.0"
+        default: "v0.3.0"
       source_ref:
         description: "构建所用 Git ref，例如 main 或某个 commit/tag"
         required: false
@@ -65,9 +65,19 @@ jobs:
           fi
 
   package-macos:
-    name: Package macOS Release
-    runs-on: macos-latest
+    name: Package macOS Release (${{ matrix.label }})
+    runs-on: ${{ matrix.runner }}
     needs: meta
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - runner: macos-15
+            label: Apple Silicon
+            artifact_suffix: macos-arm64
+          - runner: macos-15-intel
+            label: Intel
+            artifact_suffix: macos-x64
     steps:
       - name: Checkout
         uses: actions/checkout@v5
@@ -84,12 +94,12 @@ jobs:
           xcodebuild -version
 
       - name: Build release package
-        run: ./scripts/package-release.sh --version "${{ needs.meta.outputs.version }}" --build-number "${{ github.run_number }}"
+        run: ./scripts/package-release.sh --version "${{ needs.meta.outputs.version }}" --build-number "${{ github.run_number }}" --artifact-suffix "${{ matrix.artifact_suffix }}"
 
       - name: Upload release artifact
         uses: actions/upload-artifact@v6
         with:
-          name: lime-pet-${{ needs.meta.outputs.tag }}-macos
+          name: lime-pet-${{ needs.meta.outputs.tag }}-${{ matrix.artifact_suffix }}
           path: |
             dist/release/*.zip
             dist/release/*.sha256
@@ -157,11 +167,17 @@ jobs:
           fetch-depth: 0
           ref: ${{ needs.meta.outputs.target_ref }}
 
-      - name: Download macOS artifact
+      - name: Download macOS Apple Silicon artifact
         uses: actions/download-artifact@v7
         with:
-          name: lime-pet-${{ needs.meta.outputs.tag }}-macos
-          path: artifacts/macos
+          name: lime-pet-${{ needs.meta.outputs.tag }}-macos-arm64
+          path: artifacts/macos-arm64
+
+      - name: Download macOS Intel artifact
+        uses: actions/download-artifact@v7
+        with:
+          name: lime-pet-${{ needs.meta.outputs.tag }}-macos-x64
+          path: artifacts/macos-x64
 
       - name: Download Windows artifact
         uses: actions/download-artifact@v7
@@ -180,7 +196,8 @@ jobs:
             {
               echo "## Lime Pet ${{ needs.meta.outputs.tag }}"
               echo ""
-              echo "- macOS companion app unsigned zip bundle"
+              echo "- macOS Apple Silicon unsigned zip bundle"
+              echo "- macOS Intel unsigned zip bundle"
               echo "- Windows companion NSIS installer"
               echo "- Shared companion protocol across macOS Swift shell and Windows Tauri shell"
               echo "- Version: ${{ needs.meta.outputs.version }}"
@@ -207,7 +224,7 @@ jobs:
           fi
 
           shopt -s nullglob
-          assets=(artifacts/macos/* artifacts/windows/*)
+          assets=(artifacts/macos-arm64/* artifacts/macos-x64/* artifacts/windows/*)
 
           if gh release view "${tag}" --repo "${GITHUB_REPOSITORY}" >/dev/null 2>&1; then
             gh release upload "${tag}" "${assets[@]}" --repo "${GITHUB_REPOSITORY}" --clobber

LICENSE-Live2D.md

@@ -250,7 +250,7 @@
 					"$(inherited)",
 					"@executable_path/../Frameworks",
 				);
-				MARKETING_VERSION = 0.2.0;
+				MARKETING_VERSION = 0.3.0;
 				PRODUCT_BUNDLE_IDENTIFIER = com.lime.pet;
 				PRODUCT_NAME = "Lime Pet";
 				SWIFT_EMIT_LOC_STRINGS = YES;
@@ -269,7 +269,7 @@
 					"$(inherited)",
 					"@executable_path/../Frameworks",
 				);
-				MARKETING_VERSION = 0.2.0;
+				MARKETING_VERSION = 0.3.0;
 				PRODUCT_BUNDLE_IDENTIFIER = com.lime.pet;
 				PRODUCT_NAME = "Lime Pet";
 				SWIFT_EMIT_LOC_STRINGS = YES;

LimePet.xcodeproj/project.pbxproj

@@ -2,6 +2,23 @@ import Foundation
 
 let defaultCompanionEndpoint = "ws://127.0.0.1:45554/companion/pet"
 let companionProtocolVersion = 1
+let petCompanionCapabilities = [
+    "bubble",
+    "movement",
+    "tap-open-chat",
+    "drag-reposition",
+    "reactive-animations",
+    "perch-memory",
+    "dock-presets",
+    "ambient-dialogue",
+    "character-themes",
+    "provider-overview",
+    "provider-sync-request",
+    "open-provider-settings",
+    "multi-tap-actions",
+    "live2d-renderer",
+    "live2d-expressions"
+]
 
 enum PetState: String, CaseIterable, Codable {
     case hidden
@@ -17,13 +34,19 @@ enum CompanionCommandType: String {
     case stateChanged = "pet.state_changed"
     case showBubble = "pet.show_bubble"
     case openChatAnchor = "pet.open_chat_anchor"
+    case providerOverview = "pet.provider_overview"
+    case live2dAction = "pet.live2d_action"
 }
 
 enum CompanionEventType: String {
     case ready = "pet.ready"
     case clicked = "pet.clicked"
     case openChat = "pet.open_chat"
     case dismissed = "pet.dismissed"
+    case requestProviderOverviewSync = "pet.request_provider_overview_sync"
+    case openProviderSettings = "pet.open_provider_settings"
+    case requestPetCheer = "pet.request_pet_cheer"
+    case requestPetNextStep = "pet.request_pet_next_step"
 }
 
 enum IncomingCommand {
@@ -32,6 +55,8 @@ enum IncomingCommand {
     case stateChanged(PetState)
     case showBubble(text: String, autoHideMs: Int?)
     case openChatAnchor
+    case providerOverview(CompanionProviderOverviewPayload)
+    case live2dAction(CompanionLive2DActionPayload)
 }
 
 enum PetIPCConnectionStatus {
@@ -130,6 +155,84 @@ struct BubblePayload: Decodable {
     }
 }
 
+struct CompanionProviderSummary: Decodable {
+    let providerType: String
+    let displayName: String
+    let totalCount: Int
+    let healthyCount: Int
+    let available: Bool
+    let needsAttention: Bool
+
+    enum CodingKeys: String, CodingKey {
+        case providerType = "provider_type"
+        case displayName = "display_name"
+        case totalCount = "total_count"
+        case healthyCount = "healthy_count"
+        case available
+        case needsAttention = "needs_attention"
+    }
+}
+
+struct CompanionProviderOverviewPayload: Decodable {
+    let providers: [CompanionProviderSummary]
+    let totalProviderCount: Int
+    let availableProviderCount: Int
+    let needsAttentionProviderCount: Int
+
+    enum CodingKeys: String, CodingKey {
+        case providers
+        case totalProviderCount = "total_provider_count"
+        case availableProviderCount = "available_provider_count"
+        case needsAttentionProviderCount = "needs_attention_provider_count"
+    }
+}
+
+enum CompanionLive2DExpressionValue: Decodable, Hashable {
+    case index(Int)
+    case tag(String)
+
+    init(from decoder: Decoder) throws {
+        let container = try decoder.singleValueContainer()
+        if let intValue = try? container.decode(Int.self) {
+            self = .index(intValue)
+            return
+        }
+        if let stringValue = try? container.decode(String.self) {
+            self = .tag(stringValue)
+            return
+        }
+        throw DecodingError.typeMismatch(
+            CompanionLive2DExpressionValue.self,
+            DecodingError.Context(
+                codingPath: decoder.codingPath,
+                debugDescription: "Unsupported Live2D expression value"
+            )
+        )
+    }
+}
+
+struct CompanionLive2DActionPayload: Decodable {
+    let expressions: [CompanionLive2DExpressionValue]
+    let emotionTags: [String]
+    let motionGroup: String?
+    let motionIndex: Int?
+
+    enum CodingKeys: String, CodingKey {
+        case expressions
+        case emotionTags = "emotion_tags"
+        case motionGroup = "motion_group"
+        case motionIndex = "motion_index"
+    }
+
+    init(from decoder: Decoder) throws {
+        let container = try decoder.container(keyedBy: CodingKeys.self)
+        expressions = try container.decodeIfPresent([CompanionLive2DExpressionValue].self, forKey: .expressions) ?? []
+        emotionTags = try container.decodeIfPresent([String].self, forKey: .emotionTags) ?? []
+        motionGroup = try container.decodeIfPresent(String.self, forKey: .motionGroup)
+        motionIndex = try container.decodeIfPresent(Int.self, forKey: .motionIndex)
+    }
+}
+
 struct InboundEnvelope {
     let protocolVersion: Int
     let event: String

LimePet/CompanionProtocol.swift

@@ -215,13 +215,19 @@ struct PetCharacterTheme: Identifiable, Codable, Hashable {
     let id: String
     let displayName: String
     let switchBubble: String
+    let renderer: PetRendererKind?
+    let live2d: PetLive2DConfiguration?
     let palettes: PetCharacterStatePalettes
     let motion: PetCharacterMotion
     let dialogue: PetCharacterDialogue
     let accessories: PetCharacterAccessories
     let geometry: PetCharacterGeometry
     let symbols: PetCharacterSymbols
 
+    var rendererKind: PetRendererKind {
+        renderer ?? .sprite
+    }
+
     func palette(for state: PetState) -> PetRenderPalette {
         switch state {
         case .hidden:
@@ -324,6 +330,8 @@ extension PetCharacterTheme {
         id: "lime-scout",
         displayName: "青柠巡游",
         switchBubble: "切换到青柠巡游形态",
+        renderer: .sprite,
+        live2d: nil,
         palettes: PetCharacterStatePalettes(
             idle: PetPaletteTokens(
                 shell: PetColorToken(red: 0.25, green: 0.63, blue: 0.89, alpha: 1),