feat: 支持 Windows、macOS 和 Linux 跨平台悬浮窗

.github/workflows/ci.yml

@@ -0,0 +1,85 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches:
+      - '**'
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    steps:
+      - name: Check out source
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+
+      - name: Set up .NET 10
+        uses: actions/setup-dotnet@a98b56852c35b8e3190ac28c8c2271da59106c68 # v6.0.0
+        with:
+          dotnet-version: '10.0.x'
+
+      - name: Run core regression tests
+        run: dotnet run --project tests/CoreTests.csproj -c Release --nologo
+
+      - name: Run Avalonia regression tests
+        run: dotnet run --project tests/AppTests.csproj -c Release --nologo
+
+  build:
+    needs: test
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - runner: windows-latest
+            runtime: win-x64
+            shell: pwsh
+          - runner: macos-15
+            runtime: osx-arm64
+            shell: bash
+          - runner: macos-15-intel
+            runtime: osx-x64
+            shell: bash
+          - runner: ubuntu-latest
+            runtime: linux-x64
+            shell: bash
+    runs-on: ${{ matrix.runner }}
+    timeout-minutes: 30
+    defaults:
+      run:
+        shell: ${{ matrix.shell }}
+    steps:
+      - name: Check out source
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+
+      - name: Set up .NET 10
+        uses: actions/setup-dotnet@a98b56852c35b8e3190ac28c8c2271da59106c68 # v6.0.0
+        with:
+          dotnet-version: '10.0.x'
+
+      - name: Run legacy WPF hidden tray lifecycle tests (Windows only)
+        if: runner.os == 'Windows'
+        run: dotnet run --project tests/TrayLifecycleTests.csproj -c Release --nologo -- --never-show
+
+      - name: Build portable application
+        if: runner.os == 'Windows'
+        run: ./build.ps1 -Runtime ${{ matrix.runtime }} -Portable
+
+      - name: Build portable application
+        if: runner.os != 'Windows'
+        run: PORTABLE=1 ./build.sh ${{ matrix.runtime }}
+
+      - name: Upload build artifact
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
+        with:
+          name: CodexTpsFloat-ci-${{ matrix.runtime }}-${{ github.sha }}
+          path: app
+          if-no-files-found: error
+          retention-days: 14

.github/workflows/release.yml

@@ -1,4 +1,4 @@
-name: Release portable Windows app
+name: Release cross-platform app
 
 on:
   push:
@@ -13,12 +13,9 @@ concurrency:
   cancel-in-progress: false
 
 jobs:
-  release:
-    runs-on: windows-latest
+  validate:
+    runs-on: ubuntu-latest
     timeout-minutes: 20
-    defaults:
-      run:
-        shell: pwsh
     steps:
       - name: Check out tagged source
         uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
@@ -30,38 +27,97 @@ jobs:
 
       - name: Check tag matches application version
         run: |
-          [xml]$project = Get-Content src/CodexTpsFloat.csproj -Raw
-          $version = $project.Project.PropertyGroup.Version
-          if ($env:GITHUB_REF_NAME -cne "v$version") {
-            throw "Tag $env:GITHUB_REF_NAME does not match application version v$version."
-          }
+          version="$(dotnet msbuild src/App/CodexTpsFloat.App.csproj -nologo -getProperty:Version)"
+          test "$GITHUB_REF_NAME" = "v$version"
 
       - name: Run core regression tests
         run: dotnet run --project tests/CoreTests.csproj -c Release --nologo
 
-      - name: Run hidden tray lifecycle tests
+      - name: Run Avalonia regression tests
+        run: dotnet run --project tests/AppTests.csproj -c Release --nologo
+
+  release:
+    needs: validate
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - runner: windows-latest
+            runtime: win-x64
+            shell: pwsh
+          - runner: macos-15
+            runtime: osx-arm64
+            shell: bash
+          - runner: macos-15-intel
+            runtime: osx-x64
+            shell: bash
+          - runner: ubuntu-latest
+            runtime: linux-x64
+            shell: bash
+    runs-on: ${{ matrix.runner }}
+    timeout-minutes: 30
+    defaults:
+      run:
+        shell: ${{ matrix.shell }}
+    steps:
+      - name: Check out tagged source
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+
+      - name: Set up .NET 10
+        uses: actions/setup-dotnet@a98b56852c35b8e3190ac28c8c2271da59106c68 # v6.0.0
+        with:
+          dotnet-version: '10.0.x'
+
+      - name: Run core regression tests
+        run: dotnet run --project tests/CoreTests.csproj -c Release --nologo
+
+      - name: Run legacy WPF hidden tray lifecycle tests (Windows only)
+        if: runner.os == 'Windows'
         run: dotnet run --project tests/TrayLifecycleTests.csproj -c Release --nologo -- --never-show
 
       - name: Build portable application
-        run: ./build.ps1 -Portable
+        if: runner.os == 'Windows'
+        run: ./build.ps1 -Runtime ${{ matrix.runtime }} -Portable
+
+      - name: Build portable application
+        if: runner.os != 'Windows'
+        run: PORTABLE=1 ./build.sh ${{ matrix.runtime }}
 
-      - name: Package portable ZIP and checksum
+      - name: Package portable archive and checksum
         id: package
+        if: runner.os == 'Windows'
         run: |
           $assetDirectory = Join-Path $env:RUNNER_TEMP 'release-assets'
           $stagingDirectory = Join-Path $env:RUNNER_TEMP 'portable-package'
           New-Item -ItemType Directory -Path $assetDirectory, $stagingDirectory | Out-Null
           Copy-Item -LiteralPath 'app/CodexTpsFloat.exe', 'README.md', 'PRIVACY.md', 'THIRD-PARTY-NOTICES.md' -Destination $stagingDirectory
           Copy-Item -LiteralPath 'licenses' -Destination $stagingDirectory -Recurse
-          $archiveName = "CodexTpsFloat-$env:GITHUB_REF_NAME-win-x64-portable.zip"
+          $archiveName = "CodexTpsFloat-$env:GITHUB_REF_NAME-${{ matrix.runtime }}-portable.zip"
           $archivePath = Join-Path $assetDirectory $archiveName
           Compress-Archive -Path "$stagingDirectory/*" -DestinationPath $archivePath -CompressionLevel Optimal
           $hash = (Get-FileHash -LiteralPath $archivePath -Algorithm SHA256).Hash.ToLowerInvariant()
           "$hash  $archiveName" | Set-Content -LiteralPath "$archivePath.sha256" -Encoding ascii
           "directory=$assetDirectory" >> $env:GITHUB_OUTPUT
           "archive=$archivePath" >> $env:GITHUB_OUTPUT
 
+      - name: Package portable archive and checksum
+        id: package_unix
+        if: runner.os != 'Windows'
+        run: |
+          asset_directory="$RUNNER_TEMP/release-assets"
+          staging_directory="$RUNNER_TEMP/portable-package"
+          mkdir -p "$asset_directory" "$staging_directory"
+          cp app/CodexTpsFloat README.md PRIVACY.md THIRD-PARTY-NOTICES.md "$staging_directory/"
+          cp -R licenses "$staging_directory/"
+          archive_name="CodexTpsFloat-$GITHUB_REF_NAME-${{ matrix.runtime }}-portable.tar.gz"
+          archive_path="$asset_directory/$archive_name"
+          tar -czf "$archive_path" -C "$staging_directory" .
+          (cd "$asset_directory" && shasum -a 256 "$archive_name" > "$archive_name.sha256")
+          echo "directory=$asset_directory" >> "$GITHUB_OUTPUT"
+          echo "archive=$archive_path" >> "$GITHUB_OUTPUT"
+
       - name: Smoke test extracted portable application
+        if: runner.os == 'Windows'
         env:
           PORTABLE_ARCHIVE: ${{ steps.package.outputs.archive }}
         run: |
@@ -88,11 +144,49 @@ jobs:
             throw 'Portable snapshot incorrectly reports an aborted session as unsupported.'
           }
 
+      - name: Smoke test extracted portable application
+        if: runner.os != 'Windows'
+        env:
+          PORTABLE_ARCHIVE: ${{ steps.package_unix.outputs.archive }}
+        run: |
+          smoke_directory="$RUNNER_TEMP/portable-smoke"
+          fixture_directory="$RUNNER_TEMP/fixture-codex-home"
+          session_directory="$fixture_directory/sessions"
+          mkdir -p "$smoke_directory" "$session_directory"
+          tar -xzf "$PORTABLE_ARCHIVE" -C "$smoke_directory"
+          cat > "$session_directory/aborted.jsonl" <<'EOF'
+          {"type":"event_msg","timestamp":"2026-10-14T00:00:00Z","payload":{"type":"task_started","turn_id":"smoke-turn"}}
+          {"type":"event_msg","timestamp":"2026-10-14T00:00:01Z","payload":{"type":"token_count","info":null}}
+          {"type":"event_msg","timestamp":"2026-10-14T00:00:02Z","payload":{"type":"turn_aborted","turn_id":"smoke-turn"}}
+          EOF
+          snapshot_path="$RUNNER_TEMP/portable-snapshot.json"
+          "$smoke_directory/CodexTpsFloat" --codex-home "$fixture_directory" --snapshot-json "$snapshot_path"
+          python3 - "$snapshot_path" <<'PY'
+          import json, sys
+          snapshot = json.load(open(sys.argv[1]))
+          if (snapshot["Files"], snapshot["InvalidLines"], snapshot["UnsupportedFiles"], snapshot["ReadFailures"]) != (1, 0, 0, 0):
+              raise SystemExit("Portable snapshot incorrectly reports an aborted session as unsupported.")
+          PY
+
+      - name: Upload release artifact
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
+        with:
+          name: CodexTpsFloat-${{ github.ref_name }}-${{ matrix.runtime }}
+          path: ${{ runner.os == 'Windows' && steps.package.outputs.directory || steps.package_unix.outputs.directory }}
+
+  publish:
+    needs: release
+    runs-on: ubuntu-latest
+    steps:
+      - name: Download release artifacts
+        uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
+        with:
+          path: release-assets
+          merge-multiple: true
+
       - name: Publish GitHub Release
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           GH_REPO: ${{ github.repository }}
-          RELEASE_ASSET_DIRECTORY: ${{ steps.package.outputs.directory }}
         run: |
-          $assets = @(Get-ChildItem -LiteralPath $env:RELEASE_ASSET_DIRECTORY -File | Select-Object -ExpandProperty FullName)
-          gh release create $env:GITHUB_REF_NAME @assets --verify-tag --title "Codex TPS $env:GITHUB_REF_NAME" --notes-from-tag --latest
+          gh release create "$GITHUB_REF_NAME" release-assets/* --verify-tag --title "Codex TPS $GITHUB_REF_NAME" --notes-from-tag --latest

Directory.Build.props

@@ -0,0 +1,5 @@
+<Project>
+  <PropertyGroup>
+    <Version>1.1.3</Version>
+  </PropertyGroup>
+</Project>

PRIVACY.md

@@ -2,7 +2,7 @@
 
 应用在本机只读 Codex 日志，不调用网络服务，也不上传提示词、回答正文或凭据。日志解析只保留统计所需的结构字段和用量计数。运行过程会短暂读取日志文本，但不会将正文保存在报告或本工具的持久化数据中。
 
-本机 `app/data/settings.json` 包含日志目录、窗口位置和界面偏好，可能含用户名或目录信息。程序目录中的真实预览图和实机验收记录可能包含使用时间、用量、文件数量等信息。
+本机设置文件包含日志目录、窗口位置和界面偏好，可能含用户名或目录信息。Windows 便携版的设置位于程序旁的 `data/settings.json`；macOS 和 Linux 使用用户的应用程序数据目录下的 `CodexTpsFloat/settings.json`。源码目录中的真实预览图和实机验收记录可能包含使用时间、用量、文件数量等信息。
 
 这些内容已由 `.gitignore` 排除：运行程序与本机配置、构建缓存、真实预览图、实机验收记录、日志、数据库及导出报告。仓库只保存源码、依赖锁文件、构建脚本、通用测试和文档。