feat: AIBridge Rust 重构（agn-sdk v1 -> aibridge v2.0.0）

.env.example

@@ -1,20 +1,33 @@
-# Agnes AI
-AGN_AGNES_API_KEY=your-agnes-api-key
-AGN_AGNES_BASE_URL=https://api.agnes.ai/v1
+# AIBridge 真实 API 测试环境变量
+#
+# ⚠️ 重要：本文件是模板（.env.example），可上传 GitHub。
+#    实际 API key 请填在 .env 文件里（已 gitignore，不会上传 GitHub）。
+#
+# 用法：
+# 1. cp .env.example .env
+# 2. 在 .env 填入真实 API key（等号右边）
+# 3. python examples/test_real_providers.py
+#
+# 测试脚本会从 .env 读 key，并用 list_models() 实时拉取真实 model 名字（model 经常变，不硬编码）。
 
-# OpenAI
-AGN_OPENAI_API_KEY=your-openai-api-key
+# Agnes AI（https://agnes.ai）
+AGNES_API_KEY=
+AGNES_BASE_URL=https://api.agnes.ai/v1
 
-# Azure OpenAI
-AGN_AZURE_API_KEY=your-azure-api-key
-AGN_AZURE_BASE_URL=https://your-resource.openai.azure.com/openai/deployments/your-deployment
-AGN_AZURE_API_VERSION=2024-02-15-preview
+# OpenAI（https://platform.openai.com）
+OPENAI_API_KEY=
+OPENAI_BASE_URL=https://api.openai.com/v1
 
-# Runway
-AGN_RUNWAY_API_KEY=your-runway-api-key
+# Google Gemini（https://ai.google.dev）
+GEMINI_API_KEY=
+GEMINI_BASE_URL=https://generativelanguage.googleapis.com/v1beta
 
-# Pika
-AGN_PIKA_API_KEY=your-pika-api-key
+# 火山引擎 CV / 方舟（https://www.volcengine.com）
+# base_url 固定 https://ark.cn-beijing.volces.com/api/v3（agent plan/coding plan/普通 api 都是订阅计划，地址统一）
+VOLCENGINE_CV_API_KEY=
+VOLCENGINE_CV_BASE_URL=https://ark.cn-beijing.volces.com/api/v3
 
-# Stability AI
-AGN_STABILITY_API_KEY=your-stability-api-key
+# 火山方舟接入点 ID（在控制台「模型推理」创建接入点获取，形如 ep-2024xxxxxx-xxxxx）
+# 图像模型（doubao-seedream）和视频模型（doubao-seedance）各创建一个接入点
+VOLCENGINE_IMAGE_ENDPOINT=
+VOLCENGINE_VIDEO_ENDPOINT=

.github/workflows/ci.yml

@@ -0,0 +1,267 @@
+# AIBridge CI 矩阵
+#
+# 对应设计文档第 12.3 节：平台（linux/macos/windows × amd64/arm64）× 语言。
+# 共 6 个 job：Rust 核心+ffi / Python / Node / Go / JVM / .NET。
+# 触发：push 到 feat/aibridge-rust-rewrite + 所有 PR。
+#
+# 说明：
+# - 不实际发布（无 token），仅验证跨平台构建 + 产出 artifact 供下载。
+# - cargo 用 Swatinem/rust-cache 缓存；npm 由 setup-node 缓存；gradle 由 setup-gradle 缓存。
+# - ubuntu-24.04-arm 提供 linux arm64 runner；macos-x64 runner 已弃用（24h 超时），仅保留 macos-arm64。
+
+name: CI
+
+on:
+  push:
+    branches: [feat/aibridge-rust-rewrite]
+  pull_request:
+
+env:
+  CARGO_TERM_COLOR: always
+  CARGO_NET_RETRY: 3
+
+jobs:
+  # ──────────────────────────────────────────────────────────────────────────
+  # 1. Rust 核心 + ffi（跨平台 build + test）
+  # ──────────────────────────────────────────────────────────────────────────
+  rust-core-ffi:
+    name: Rust 核心+ffi (${{ matrix.label }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            label: linux-x64
+          - os: ubuntu-24.04-arm
+            label: linux-arm64
+          - os: macos-latest
+            label: macos-arm64
+          - os: windows-latest
+            label: windows-x64
+    steps:
+      - uses: actions/checkout@v4
+      - name: 安装 Rust 工具链
+        uses: dtolnay/rust-toolchain@stable
+      - name: 缓存 cargo
+        uses: Swatinem/rust-cache@v2
+      - name: cargo build（core + ffi）
+        run: cargo build -p aibridge-core -p aibridge-ffi
+      - name: cargo test（core + ffi）
+        run: cargo test -p aibridge-core -p aibridge-ffi
+
+  # ──────────────────────────────────────────────────────────────────────────
+  # 2. Python 绑定（maturin build wheel）
+  #    macOS 产 universal2 wheel（同时含 amd64+arm64）
+  # ──────────────────────────────────────────────────────────────────────────
+  python-bindings:
+    name: Python wheel (${{ matrix.label }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            label: linux-x64
+          - os: ubuntu-24.04-arm
+            label: linux-arm64
+          - os: macos-latest
+            label: macos-universal2
+          - os: windows-latest
+            label: windows-x64
+    steps:
+      - uses: actions/checkout@v4
+      - name: 安装 Rust 工具链
+        uses: dtolnay/rust-toolchain@stable
+      - name: 添加 macOS universal2 交叉编译 target
+        if: matrix.label == 'macos-universal2'
+        run: rustup target add x86_64-apple-darwin aarch64-apple-darwin
+      - name: 缓存 cargo
+        uses: Swatinem/rust-cache@v2
+      - name: 安装 Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - name: 安装 maturin
+        run: pip install maturin
+      - name: maturin build wheel
+        shell: bash
+        run: |
+          if [ "${{ matrix.label }}" = "macos-universal2" ]; then
+            # universal2: maturin 分别编译 x86_64/aarch64-apple-darwin 后 lipo 合并
+            # （maturin 1.x 不支持 --universal2 标志，改用 --target universal2-apple-darwin）
+            maturin build --manifest-path crates/aibridge-python/Cargo.toml --release --target universal2-apple-darwin
+          else
+            maturin build --manifest-path crates/aibridge-python/Cargo.toml --release
+          fi
+      - name: 上传 wheel 产物
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-wheel-${{ matrix.label }}
+          path: target/wheels/*.whl
+          if-no-files-found: warn
+
+  # ──────────────────────────────────────────────────────────────────────────
+  # 3. Node 绑定（napi build .node）
+  # ──────────────────────────────────────────────────────────────────────────
+  node-bindings:
+    name: Node .node (${{ matrix.label }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            label: linux-x64
+          - os: ubuntu-24.04-arm
+            label: linux-arm64
+          - os: macos-latest
+            label: macos-arm64
+          - os: windows-latest
+            label: windows-x64
+    steps:
+      - uses: actions/checkout@v4
+      - name: 安装 Rust 工具链
+        uses: dtolnay/rust-toolchain@stable
+      - name: 缓存 cargo
+        uses: Swatinem/rust-cache@v2
+      - name: 安装 Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+          cache-dependency-path: crates/aibridge-node/package-lock.json
+      - name: npm install
+        run: |
+          cd crates/aibridge-node
+          npm install
+      - name: napi build
+        run: |
+          cd crates/aibridge-node
+          npx napi build --platform --release
+      - name: 上传 .node 产物
+        uses: actions/upload-artifact@v4
+        with:
+          name: node-binary-${{ matrix.label }}
+          path: crates/aibridge-node/*.node
+          if-no-files-found: warn
+
+  # ──────────────────────────────────────────────────────────────────────────
+  # 4. Go 绑定（cargo build ffi + go build，CGO）
+  #    windows CGO 标记为 experimental（失败不阻断 CI）
+  # ──────────────────────────────────────────────────────────────────────────
+  go-bindings:
+    name: Go 绑定 (${{ matrix.label }})
+    runs-on: ${{ matrix.os }}
+    continue-on-error: ${{ matrix.experimental }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            label: linux-x64
+            experimental: false
+          - os: macos-latest
+            label: macos-arm64
+            experimental: false
+          - os: windows-latest
+            label: windows-x64
+            experimental: true
+    steps:
+      - uses: actions/checkout@v4
+      - name: 安装 Rust 工具链
+        uses: dtolnay/rust-toolchain@stable
+      - name: 缓存 cargo
+        uses: Swatinem/rust-cache@v2
+      - name: 安装 Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: '1.26'
+          cache: false
+      - name: 构建 libaibridge (ffi, release)
+        shell: bash
+        run: |
+          if [ "${{ matrix.label }}" = "windows-x64" ]; then
+            # Windows: 用 GNU target 编译，避免 MSVC 产 .lib 与 Go MinGW gcc 链接不兼容
+            # （Go CGO 在 Windows 用 MinGW gcc；MSVC 运行时符号如 __chkstk 它找不到）
+            rustup target add x86_64-pc-windows-gnu
+            cargo build -p aibridge-ffi --release --target x86_64-pc-windows-gnu
+            # GNU target 产 libaibridge.dll.a（import lib）+ aibridge.dll，拷到 Go cgo 默认查找的 target/release
+            cp target/x86_64-pc-windows-gnu/release/libaibridge.dll.a target/release/ 2>/dev/null || \
+              cp target/x86_64-pc-windows-gnu/release/libaibridge.a target/release/ 2>/dev/null || true
+            cp target/x86_64-pc-windows-gnu/release/aibridge.dll target/release/ 2>/dev/null || true
+          else
+            cargo build -p aibridge-ffi --release
+          fi
+      - name: go build + vet (CGO)
+        shell: bash
+        env:
+          CGO_ENABLED: '1'
+          LIBAIBRIDGE_DIR: ${{ github.workspace }}/target/release
+        run: |
+          cd bindings/go
+          case "$(uname -s)" in
+            Darwin) export DYLD_LIBRARY_PATH="$LIBAIBRIDGE_DIR" ;;
+            Linux)  export LD_LIBRARY_PATH="$LIBAIBRIDGE_DIR" ;;
+          esac
+          go build ./...
+          go vet ./...
+
+  # ──────────────────────────────────────────────────────────────────────────
+  # 5. JVM 绑定（cargo build ffi + gradle build，动态库打进 jar）
+  # ──────────────────────────────────────────────────────────────────────────
+  jvm-bindings:
+    name: JVM 绑定 (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    steps:
+      - uses: actions/checkout@v4
+      - name: 安装 Rust 工具链
+        uses: dtolnay/rust-toolchain@stable
+      - name: 缓存 cargo
+        uses: Swatinem/rust-cache@v2
+      - name: 安装 Java
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: '21'
+      - name: 配置 Gradle
+        uses: gradle/actions/setup-gradle@v4
+      - name: 构建 libaibridge (ffi, release)
+        run: cargo build -p aibridge-ffi --release
+      - name: gradle build（含 native 进 jar）
+        shell: bash
+        run: |
+          cd bindings/jvm
+          ./gradlew build -PembedNative=true
+
+  # ──────────────────────────────────────────────────────────────────────────
+  # 6. .NET 绑定（cargo build ffi + dotnet build，动态库打进 NuGet）
+  # ──────────────────────────────────────────────────────────────────────────
+  dotnet-bindings:
+    name: .NET 绑定 (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    steps:
+      - uses: actions/checkout@v4
+      - name: 安装 Rust 工具链
+        uses: dtolnay/rust-toolchain@stable
+      - name: 缓存 cargo
+        uses: Swatinem/rust-cache@v2
+      - name: 安装 .NET SDK
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: '8.0.x'
+      - name: 构建 libaibridge (ffi, release)
+        run: cargo build -p aibridge-ffi --release
+      - name: dotnet build
+        shell: bash
+        run: |
+          cd bindings/dotnet/AIBridge
+          dotnet build

.gitignore

@@ -144,3 +144,14 @@ Thumbs.db
 # Project specific
 output/
 *.egg-info/
+
+# Rust（target/ 已在上方忽略）
+# Cargo.lock 提交以保证可复现构建（workspace 含 cdylib 产物）
+
+# Node / napi-rs
+node_modules/
+*.node
+
+# 原生库发布产物（target/ 外的）
+*.dylib
+*.dll

AGENTS.md

@@ -2,6 +2,10 @@
 
 > 本文件是 Agent 执行任务时必须首先加载和理解的项目指南，包含项目目标、架构、规范、验收标准等关键信息。
 
+> ⚠️ **Rust 重构进行中**：本项目正在用 Rust 重构为跨语言 SDK `aibridge`（分支 `feat/aibridge-rust-rewrite`）。
+> 接手 Rust 重构工作请先读 **[docs/PROGRESS.md](docs/PROGRESS.md)**（完整进度 + 接手指南）+ [设计文档](docs/superpowers/specs/2026-07-07-aibridge-rust-rewrite-design.md) + [实现计划](docs/superpowers/plans/2026-07-07-aibridge-implementation-plan.md)。
+> 本文档（AGENTS.md）描述的是 Python 旧版（agn-sdk v1），Rust 新版以 PROGRESS.md + 设计文档为准。
+
 ---
 
 ## 1. 项目概述