Claude Code Haha 桌面版发布

.env.example

@@ -50,4 +50,4 @@
 # 通用设置（建议始终开启）
 # ============================================================
 DISABLE_TELEMETRY=1
-CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
+CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

.github/workflows/build-desktop-dev.yml

@@ -33,7 +33,7 @@ jobs:
     steps:
       - id: set-matrix
         run: |
-          ALL='[{"platform":"macos-latest","rust_target":"aarch64-apple-darwin","tauri_args":"--target aarch64-apple-darwin","bundles":"app,dmg","label":"macOS-ARM64","artifact_name":"macos-arm64"},{"platform":"macos-latest","rust_target":"x86_64-apple-darwin","tauri_args":"--target x86_64-apple-darwin","bundles":"app,dmg","label":"macOS-x64","artifact_name":"macos-x64"},{"platform":"windows-latest","rust_target":"x86_64-pc-windows-msvc","tauri_args":"","bundles":"nsis,msi","label":"Windows-x64","artifact_name":"windows-x64"},{"platform":"ubuntu-22.04","rust_target":"x86_64-unknown-linux-gnu","tauri_args":"","bundles":"deb,appimage","label":"Linux-x64","artifact_name":"linux-x64"},{"platform":"ubuntu-22.04-arm","rust_target":"aarch64-unknown-linux-gnu","tauri_args":"","bundles":"deb,appimage","label":"Linux-ARM64","artifact_name":"linux-arm64"}]'
+          ALL='[{"platform":"macos-latest","rust_target":"aarch64-apple-darwin","tauri_args":"--target aarch64-apple-darwin","bundles":"app,dmg","label":"macOS-ARM64","artifact_name":"macos-arm64"},{"platform":"macos-latest","rust_target":"x86_64-apple-darwin","tauri_args":"--target x86_64-apple-darwin","bundles":"app,dmg","label":"macOS-x64","artifact_name":"macos-x64"},{"platform":"windows-latest","rust_target":"x86_64-pc-windows-msvc","tauri_args":"","bundles":"nsis,msi","label":"Windows-x64","artifact_name":"windows-x64"},{"platform":"ubuntu-22.04","rust_target":"x86_64-unknown-linux-gnu","tauri_args":"","bundles":"deb","label":"Linux-x64","artifact_name":"linux-x64"},{"platform":"ubuntu-22.04-arm","rust_target":"aarch64-unknown-linux-gnu","tauri_args":"","bundles":"deb","label":"Linux-ARM64","artifact_name":"linux-arm64"}]'
 
           SELECTED="${{ inputs.platforms }}"
           if [ "$SELECTED" = "all" ]; then
@@ -72,6 +72,8 @@ jobs:
           echo "version=$VERSION" >> "$GITHUB_OUTPUT"
 
       # ── 系统依赖 (Linux) ─────────────────────────────────────
+      # libfuse2 是 AppImage 运行时依赖：linuxdeploy 工具链本身是 AppImage 格式，
+      # 运行时需要 libfuse2，Ubuntu 22.04 默认未安装。
       - name: Install Linux dependencies
         if: contains(matrix.platform, 'ubuntu')
         run: |
@@ -81,7 +83,8 @@ jobs:
             libxdo-dev libssl-dev \
             libwebkit2gtk-4.1-dev \
             libayatana-appindicator3-dev \
-            librsvg2-dev patchelf
+            librsvg2-dev patchelf \
+            libfuse2
 
       # ── Bun ──────────────────────────────────────────────────
       - name: Setup Bun
@@ -164,14 +167,14 @@ jobs:
 
           echo "Searching for artifacts in: $SEARCH_DIR"
           if [ -d "$SEARCH_DIR" ]; then
-            find "$SEARCH_DIR" -type f \( \
-              -name "*.dmg" -o -name "*.app" -o \
-              -name "*.exe" -o -name "*.msi" -o \
-              -name "*.deb" -o -name "*.AppImage" -o \
-              -name "*.zip" \
-            \) | while read -r f; do
+            find "$SEARCH_DIR" \
+              \( -type f \( \
+                -name "*.dmg" -o -name "*.exe" -o -name "*.msi" -o \
+                -name "*.deb" -o -name "*.AppImage" -o -name "*.zip" \
+              \) \) -o \
+              \( -type d -name "*.app" \) | while read -r f; do
               echo "  Copying: $(basename "$f")"
-              cp "$f" "$STAGING/"
+              cp -R "$f" "$STAGING/"
             done
           fi
 

.github/workflows/release-desktop.yml

@@ -0,0 +1,191 @@
+name: Release Desktop
+
+on:
+  push:
+    tags: ['v*.*.*']
+  workflow_dispatch:
+    inputs:
+      draft:
+        description: 'Create as draft release'
+        required: false
+        default: true
+        type: boolean
+
+permissions:
+  contents: write
+
+concurrency:
+  group: release-desktop-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  TAURI_SIGNING_PRIVATE_KEY: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY }}
+  TAURI_SIGNING_PRIVATE_KEY_PASSWORD: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY_PASSWORD }}
+
+jobs:
+  build:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          # macOS Apple Silicon
+          - platform: macos-latest
+            rust_target: aarch64-apple-darwin
+            tauri_args: '--target aarch64-apple-darwin'
+            label: macOS-ARM64
+
+          # macOS Intel
+          - platform: macos-latest
+            rust_target: x86_64-apple-darwin
+            tauri_args: '--target x86_64-apple-darwin'
+            label: macOS-x64
+
+          # Linux x64
+          - platform: ubuntu-22.04
+            rust_target: x86_64-unknown-linux-gnu
+            tauri_args: '--bundles deb'
+            label: Linux-x64
+
+          # Linux ARM64
+          - platform: ubuntu-22.04-arm
+            rust_target: aarch64-unknown-linux-gnu
+            tauri_args: '--bundles deb'
+            label: Linux-ARM64
+
+          # Windows x64
+          - platform: windows-latest
+            rust_target: x86_64-pc-windows-msvc
+            tauri_args: ''
+            label: Windows-x64
+
+    runs-on: ${{ matrix.platform }}
+    name: Build (${{ matrix.label }})
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      # ── System dependencies (Linux) ──────────────────────────
+      - name: Install Linux dependencies
+        if: contains(matrix.platform, 'ubuntu')
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y \
+            build-essential \
+            curl \
+            wget \
+            file \
+            libxdo-dev \
+            libssl-dev \
+            libwebkit2gtk-4.1-dev \
+            libayatana-appindicator3-dev \
+            librsvg2-dev \
+            patchelf \
+            libfuse2
+
+      # ── Bun ──────────────────────────────────────────────────
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      # ── Node.js (for tauri-action compatibility) ─────────────
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      # ── Rust ─────────────────────────────────────────────────
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: ${{ matrix.rust_target }}
+
+      - name: Rust cache
+        uses: swatinem/rust-cache@v2
+        with:
+          workspaces: 'desktop/src-tauri -> target'
+          shared-key: ${{ matrix.rust_target }}
+
+      # ── Install dependencies ─────────────────────────────────
+      - name: Install root dependencies
+        run: bun install
+
+      - name: Install desktop dependencies
+        working-directory: desktop
+        run: bun install
+
+      - name: Install adapter dependencies
+        working-directory: adapters
+        run: bun install
+
+      # ── Build sidecars ───────────────────────────────────────
+      - name: Build sidecars
+        working-directory: desktop
+        env:
+          TAURI_ENV_TARGET_TRIPLE: ${{ matrix.rust_target }}
+        run: bun run build:sidecars
+
+      # ── macOS code signing (optional) ────────────────────────
+      - name: Import macOS signing certificate
+        if: contains(matrix.platform, 'macos') && env.APPLE_CERTIFICATE != ''
+        env:
+          APPLE_CERTIFICATE: ${{ secrets.APPLE_CERTIFICATE }}
+          APPLE_CERTIFICATE_PASSWORD: ${{ secrets.APPLE_CERTIFICATE_PASSWORD }}
+        run: |
+          echo "$APPLE_CERTIFICATE" | base64 --decode > certificate.p12
+          security create-keychain -p actions build.keychain
+          security default-keychain -s build.keychain
+          security unlock-keychain -p actions build.keychain
+          security import certificate.p12 -k build.keychain -P "$APPLE_CERTIFICATE_PASSWORD" -T /usr/bin/codesign
+          security set-key-partition-list -S apple-tool:,apple:,codesign: -s -k actions build.keychain
+          rm certificate.p12
+
+      # ── Build Tauri app ──────────────────────────────────────
+      - name: Build Tauri app
+        uses: tauri-apps/tauri-action@v0
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          # macOS signing (leave empty to skip)
+          APPLE_CERTIFICATE: ${{ secrets.APPLE_CERTIFICATE }}
+          APPLE_CERTIFICATE_PASSWORD: ${{ secrets.APPLE_CERTIFICATE_PASSWORD }}
+          APPLE_SIGNING_IDENTITY: ${{ secrets.APPLE_SIGNING_IDENTITY }}
+          APPLE_TEAM_ID: ${{ secrets.APPLE_TEAM_ID }}
+          APPLE_ID: ${{ secrets.APPLE_ID }}
+          APPLE_PASSWORD: ${{ secrets.APPLE_PASSWORD }}
+        with:
+          projectPath: desktop
+          tauriScript: bunx tauri
+          tagName: v__VERSION__
+          releaseName: 'Claude Code Haha v__VERSION__'
+          releaseBody: |
+            ## Claude Code Haha v__VERSION__
+
+            ### Downloads
+
+            | Platform | File |
+            |----------|------|
+            | macOS (Apple Silicon) | `.dmg` |
+            | macOS (Intel) | `.dmg` |
+            | Windows | `.exe` (NSIS installer) |
+            | Linux | `.deb` |
+
+            ### First-time installation
+
+            **macOS**: If you see "app is damaged" or "unidentified developer", run:
+            ```bash
+            xattr -cr /Applications/Claude\ Code\ Haha.app
+            ```
+
+            **Windows**: If SmartScreen blocks the app, click "More info" → "Run anyway".
+
+            ---
+            See [Installation Guide](https://github.com/NanmiCoder/cc-haha/blob/main/docs/desktop/04-installation.md) for details.
+          releaseDraft: ${{ github.event_name == 'workflow_dispatch' && inputs.draft || false }}
+          prerelease: false
+          args: ${{ matrix.tauri_args }}
+
+      # ── Cleanup macOS keychain ───────────────────────────────
+      - name: Cleanup macOS keychain
+        if: contains(matrix.platform, 'macos') && always()
+        run: security delete-keychain build.keychain 2>/dev/null || true

.gitignore

@@ -2,11 +2,63 @@
 .env.*
 !.env.example
 node_modules
+.DS_Store
 
 # Computer Use runtime (auto-generated)
 .runtime/
 extracted-natives/
 
+# Adapter attachment cache (created at runtime by AttachmentStore when
+# running adapter tests or the feishu/telegram adapters locally)
+.lark-attachments/
+.tg-attachments/
+
+# Playwright MCP snapshots & logs
+.playwright-mcp/
+
+# OMX state/logs
+.omx/
+
+# E2E screenshots
+e2e-*.png
+
+# Desktop build output
+desktop/dist/
+desktop/build-artifacts/
+desktop/src-tauri/binaries/
+desktop/src-tauri/target/
+desktop/src-tauri/gen/
+desktop/package-lock.json
+
+# Desktop brand asset candidates (keep only selected ones in public/)
+desktop/brand-assets/
+
+# Claude local config & auto-generated
+.claude/
+
+# Superpowers plans & specs (local only)
+docs/superpowers/
+
+# Temp server/web logs
+.tmp-*.log
+
+# Debug / temp screenshots (root dir only)
+/*.png
+bug_attachments/
+
+# Private keys & credentials
+*.pem
+*.key
+*.p12
+credentials*.json
+
+# TS build cache
+*.tsbuildinfo
+
+# Temp markdown snapshots
+sidebar-snapshot.md
+
 # VitePress
 docs/.vitepress/dist
 docs/.vitepress/cache
+runtime/__pycache__

AGENTS.md

@@ -0,0 +1,24 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+The root package is the Bun-based CLI and local server. Main code lives in `src/`: `entrypoints/` for startup paths, `screens/` and `components/` for the Ink TUI, `commands/` for slash commands, `services/` for API/MCP/OAuth logic, and `tools/` for agent tool implementations. `bin/claude-haha` is the executable entrypoint. The desktop app is isolated in `desktop/` with React UI code in `desktop/src/` and Tauri glue in `desktop/src-tauri/`. Documentation is in `docs/` and builds with VitePress. Treat root screenshots and `docs/images/` as reference assets, not source code.
+
+## Build, Test, and Development Commands
+Install root dependencies with `bun install`, then install desktop dependencies in `desktop/` if you are touching the app UI.
+
+- `./bin/claude-haha` or `bun run start`: run the CLI locally.
+- `SERVER_PORT=3456 bun run src/server/index.ts`: start the local API/WebSocket server used by `desktop/`.
+- `bun run docs:dev` / `bun run docs:build`: preview or build the VitePress docs.
+- `cd desktop && bun run dev`: run the desktop frontend in Vite.
+- `cd desktop && bun run build`: type-check and produce a production web build.
+- `cd desktop && bun run test`: run Vitest suites.
+- `cd desktop && bun run lint`: run TypeScript no-emit checks.
+
+## Coding Style & Naming Conventions
+Use TypeScript with 2-space indentation, ESM imports, and no semicolons to match the existing code. Prefer `PascalCase` for React components, `camelCase` for functions, hooks, and stores, and descriptive file names like `teamWatcher.ts` or `AgentTranscript.tsx`. Keep shared UI in `desktop/src/components/`, API clients in `desktop/src/api/`, and avoid adding new dependencies unless the existing utilities cannot cover the change.
+
+## Testing Guidelines
+Desktop tests use Vitest with Testing Library in a `jsdom` environment. Name tests `*.test.ts` or `*.test.tsx`; colocate focused tests near the file or place broader coverage in `desktop/src/__tests__/`. No coverage gate is configured, so add regression tests for any behavior you change and run the relevant suites before opening a PR.
+
+## Commit & Pull Request Guidelines
+Recent history follows Conventional Commit prefixes such as `feat:`, `fix:`, and `docs:`. Keep subjects imperative and scoped to one change. PRs should explain the user-visible impact, list verification steps, link related issues, and include screenshots for desktop or docs UI changes. Keep diffs reviewable and call out any follow-up work or known gaps.