iflow2api 1.4.7__tar.gz

iflow2api-1.4.7/.dockerignore

@@ -0,0 +1,55 @@
+# Git
+.git
+.gitignore
+
+# Python
+__pycache__
+*.py[cod]
+*$py.class
+*.so
+.Python
+.venv
+venv/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.nox/
+
+# Build artifacts
+dist/
+build/
+*.egg-info/
+*.egg
+.eggs/
+
+# Ruff
+.ruff_cache/
+
+# Documentation
+docs/
+# 保留 README.md（构建需要）
+# *.md
+
+# Development files
+.github/
+.python-version
+CLAUDE.md
+TODO.md
+
+# Build scripts
+build.py
+
+# Misc
+nul
+*.log
+*.tmp

iflow2api-1.4.7/.github/workflows/build.yml

@@ -0,0 +1,305 @@
+name: Build
+
+on:
+  push:
+    branches: ['**']
+    tags:
+      - 'v*'
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  # 版本验证作业
+  verify-version:
+    runs-on: ubuntu-latest
+    outputs:
+      version: ${{ steps.get-version.outputs.version }}
+    
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Get version from pyproject.toml
+        id: get-version
+        run: |
+          VERSION=$(grep -oP '^version\s*=\s*"\K[^"]+' pyproject.toml)
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          echo "pyproject.toml version: $VERSION"
+
+      - name: Get version from version.py
+        id: get-version-py
+        run: |
+          VERSION_PY=$(grep -oP '^__version__\s*=\s*"\K[^"]+' iflow2api/version.py)
+          echo "version_py=$VERSION_PY" >> $GITHUB_OUTPUT
+          echo "version.py version: $VERSION_PY"
+
+      - name: Verify version consistency
+        run: |
+          PYPROJECT_VERSION="${{ steps.get-version.outputs.version }}"
+          VERSION_PY="${{ steps.get-version-py.outputs.version_py }}"
+          
+          if [ "$PYPROJECT_VERSION" != "$VERSION_PY" ]; then
+            echo "::error::Version mismatch! pyproject.toml: $PYPROJECT_VERSION, version.py: $VERSION_PY"
+            exit 1
+          fi
+          echo "✓ Version consistency check passed: $PYPROJECT_VERSION"
+
+      - name: Verify tag version matches pyproject.toml
+        if: startsWith(github.ref, 'refs/tags/v')
+        run: |
+          PYPROJECT_VERSION="${{ steps.get-version.outputs.version }}"
+          TAG_VERSION="${GITHUB_REF#refs/tags/v}"
+          
+          if [ "$PYPROJECT_VERSION" != "$TAG_VERSION" ]; then
+            echo "::error::Tag version ($TAG_VERSION) does not match pyproject.toml version ($PYPROJECT_VERSION)"
+            exit 1
+          fi
+          echo "✓ Tag version matches pyproject.toml: $TAG_VERSION"
+
+  build:
+    needs: verify-version
+    strategy:
+      matrix:
+        include:
+          - os: windows-latest
+            platform: windows
+            artifact: iflow2api.exe
+          - os: macos-latest
+            platform: macos
+            artifact: iflow2api.app
+          - os: ubuntu-latest
+            platform: linux
+            artifact: iflow2api
+
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install flet pystray Pillow
+
+      - name: Install Linux dependencies
+        if: matrix.os == 'ubuntu-latest'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libgtk-3-dev libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev libmpv-dev ninja-build clang python3-gi gir1.2-appindicator3-0.1
+
+      - name: Build with Flet
+        env:
+          PYTHONIOENCODING: utf-8
+          PYTHONUTF8: 1
+        shell: bash
+        run: |
+          echo "y" | flet build ${{ matrix.platform }} --project iflow2api --product iflow2api
+
+      - name: Fix macOS executable permissions
+        if: matrix.os == 'macos-latest'
+        run: |
+          chmod +x build/macos/iflow2api.app/Contents/MacOS/iflow2api
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: iflow2api-${{ matrix.platform }}
+          path: build/${{ matrix.platform }}/
+
+  # Docker 构建和发布（滚动发布策略）
+  # - main 分支推送 -> edge 标签（开发版）
+  # - v* 标签推送 -> 版本号标签 + latest（正式版）
+  docker:
+    needs: verify-version
+    runs-on: ubuntu-latest
+    environment: DOCKERHUB
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Login to Docker Hub
+        if: github.event_name != 'pull_request'
+        uses: docker/login-action@v3
+        with:
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_TOKEN }}
+
+      - name: Login to GitHub Container Registry
+        if: github.event_name != 'pull_request'
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract metadata for edge
+        id: meta-edge
+        if: github.ref == 'refs/heads/main'
+        uses: docker/metadata-action@v5
+        with:
+          images: |
+            ${{ secrets.DOCKERHUB_USERNAME }}/iflow2api
+            ghcr.io/${{ github.repository }}
+          tags: |
+            type=raw,value=edge
+
+      - name: Extract metadata for release
+        id: meta-release
+        if: startsWith(github.ref, 'refs/tags/v')
+        uses: docker/metadata-action@v5
+        with:
+          images: |
+            ${{ secrets.DOCKERHUB_USERNAME }}/iflow2api
+            ghcr.io/${{ github.repository }}
+          # 标签策略：
+          # - v1.1.5 -> 1.1.5, 1.1, latest
+          # - v1.0.5 -> 1.0.5, 1.0
+          # - v2.0.0 -> 2.0.0, 2.0, latest
+          flavor: |
+            latest=auto
+          tags: |
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+
+      - name: Build and push (edge)
+        if: github.ref == 'refs/heads/main'
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          platforms: linux/amd64,linux/arm64
+          push: true
+          tags: ${{ steps.meta-edge.outputs.tags }}
+          labels: ${{ steps.meta-edge.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+
+      - name: Build and push (release)
+        if: startsWith(github.ref, 'refs/tags/v')
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          platforms: linux/amd64,linux/arm64
+          push: true
+          tags: ${{ steps.meta-release.outputs.tags }}
+          labels: ${{ steps.meta-release.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+
+  # PyPI 包构建
+  build-pypi:
+    needs: verify-version
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install build tools and dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build twine
+          pip install flet pystray Pillow
+
+      - name: Build package
+        run: python -m build
+
+      - name: Check package
+        run: python -m twine check dist/*
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: pypi-packages
+          path: dist/
+          retention-days: 1
+
+  # 发布到 TestPyPI（每次推送都执行）
+  publish-testpypi:
+    needs: build-pypi
+    runs-on: ubuntu-latest
+    environment: DOCKERHUB
+    permissions:
+      id-token: write
+    steps:
+      - name: Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: pypi-packages
+          path: dist/
+
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+          password: ${{ secrets.TEST_PYPI_API_KEY }}
+          skip-existing: true
+
+  # 发布到正式 PyPI（仅 tag 触发）
+  publish-pypi:
+    needs: [verify-version, build-pypi]
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+    environment: DOCKERHUB
+    permissions:
+      id-token: write
+    steps:
+      - name: Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: pypi-packages
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_KEY }}
+
+  release:
+    needs: [verify-version, build, docker, publish-pypi]
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+
+    steps:
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: artifacts
+
+      - name: Create archives
+        run: |
+          cd artifacts
+          zip -r iflow2api-windows.zip iflow2api-windows/
+          tar -czvf iflow2api-macos.tar.gz iflow2api-macos/
+          tar -czvf iflow2api-linux.tar.gz iflow2api-linux/
+
+      - name: Create Release
+        uses: softprops/action-gh-release@v1
+        with:
+          files: |
+            artifacts/iflow2api-windows.zip
+            artifacts/iflow2api-macos.tar.gz
+            artifacts/iflow2api-linux.tar.gz
+            artifacts/pypi-packages/*
+          generate_release_notes: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

iflow2api-1.4.7/.gitignore

@@ -0,0 +1,45 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+*.spec
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Claude
+.claude/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Misc
+nul
+*.log
+TODO.md

iflow2api-1.4.7/.python-version

@@ -0,0 +1 @@
+3.13

iflow2api-1.4.7/CLAUDE.md

@@ -0,0 +1,104 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+**iflow2api** 是一个将 iFlow CLI 的 AI 服务暴露为 OpenAI 兼容 API 的代理服务。
+
+核心功能：
+- 自动读取 iFlow 配置文件 (`~/.iflow/settings.json`)
+- 通过特殊 User-Agent (`iFlow-Cli`) 解锁 iFlow CLI 专属模型
+- 提供 OpenAI 兼容的 API 端点
+- 内置 GUI OAuth 登录界面，无需安装 iFlow CLI
+- 支持 OAuth token 自动刷新
+
+## Build & Run Commands
+
+### 环境设置（推荐使用 uv）
+
+```bash
+# 安装 uv (如果未安装)
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# 创建虚拟环境（自动识别 .python-version）
+uv venv
+
+# 安装项目依赖
+uv sync
+
+# 激活虚拟环境（可选，uv run 会自动使用）
+source .venv/bin/activate  # Linux/Mac
+# 或 .venv\Scripts\activate  # Windows
+```
+
+### 运行服务
+
+```bash
+# 使用 uv 运行（推荐）
+uv run python -m iflow2api
+
+# 或激活虚拟环境后直接运行
+python -m iflow2api
+
+# 或指定端口
+uv run python -c "import uvicorn; from iflow2api.app import app; uvicorn.run(app, host='0.0.0.0', port=8001)"
+
+# 测试
+curl http://localhost:8001/health
+curl http://localhost:8001/v1/models
+curl http://localhost:8001/v1/chat/completions -H "Content-Type: application/json" \
+  -d '{"model":"glm-4.7","messages":[{"role":"user","content":"hi"}]}'
+```
+
+## Architecture
+
+```
+iflow2api/
+├── __init__.py          # 包初始化
+├── __main__.py          # CLI 入口
+├── main.py              # 主入口
+├── config.py            # iFlow 配置读取器 (从 ~/.iflow/settings.json)
+├── proxy.py             # API 代理 (添加 user-agent: iFlow-Cli header)
+├── app.py               # FastAPI 应用 (OpenAI 兼容端点)
+├── oauth.py             # OAuth 认证逻辑
+├── oauth_login.py       # OAuth 登录处理器
+├── token_refresher.py   # OAuth token 自动刷新
+├── settings.py          # 应用配置管理
+└── gui.py               # GUI 界面
+```
+
+## Key Implementation Details
+
+### 解锁 iFlow CLI 专属模型
+
+iFlow API 通过 User-Agent header 区分普通 API 调用和 CLI 调用：
+- 普通调用：只能使用 glm-4.6 等基础模型
+- CLI 调用 (`user-agent: iFlow-Cli`)：可使用 glm-4.7, deepseek-r1, kimi-k2 等高级模型
+
+### 配置文件位置
+
+- Windows: `C:\Users\<user>\.iflow\settings.json`
+- Linux/Mac: `~/.iflow/settings.json`
+
+关键字段：
+- `apiKey`: API 密钥
+- `baseUrl`: API 端点 (默认 https://apis.iflow.cn/v1)
+- `selectedAuthType`: 认证类型 (oauth-iflow, api-key, openai-compatible)
+
+## API Endpoints
+
+| 端点 | 方法 | 说明 |
+|------|------|------|
+| `/health` | GET | 健康检查 |
+| `/v1/models` | GET | 获取可用模型列表 |
+| `/v1/chat/completions` | POST | Chat Completions API |
+| `/models` | GET | 兼容端点 |
+| `/chat/completions` | POST | 兼容端点 |
+
+## Dependencies
+
+- FastAPI: Web 框架
+- uvicorn: ASGI 服务器
+- httpx: 异步 HTTP 客户端
+- pydantic: 数据验证

iflow2api-1.4.7/Dockerfile

@@ -0,0 +1,66 @@
+# iFlow2API Dockerfile
+# 多阶段构建，优化镜像大小
+
+# 阶段1: 构建阶段
+FROM python:3.12-slim AS builder
+
+# 安装构���依赖
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    build-essential \
+    && rm -rf /var/lib/apt/lists/*
+
+# 安装 uv 包管理器
+RUN pip install uv
+
+# 设置工作目录
+WORKDIR /app
+
+# 复制依赖文件和 README（pyproject.toml 需要）
+COPY pyproject.toml uv.lock README.md ./
+
+# 使用 uv 安装依赖到虚拟环境
+RUN uv venv /opt/venv
+ENV VIRTUAL_ENV=/opt/venv
+ENV PATH="/opt/venv/bin:$PATH"
+# 使用 uv sync 从 lock 文件安装依赖，--active 使用已存在的虚拟环境
+RUN uv sync --frozen --no-dev --active
+
+# 阶段2: 运行阶段
+FROM python:3.12-slim
+
+# 安装运行时依赖
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    curl \
+    && rm -rf /var/lib/apt/lists/*
+
+# 从构建阶段复制虚拟环境
+COPY --from=builder /opt/venv /opt/venv
+ENV PATH="/opt/venv/bin:$PATH"
+
+# 创建非 root 用户
+RUN useradd --create-home --shell /bin/bash appuser
+
+# 设置工作目录
+WORKDIR /app
+
+# 复制应用代码
+COPY --chown=appuser:appuser . .
+
+# 切换到非 root 用户
+USER appuser
+
+# 设置环境变量
+ENV PYTHONUNBUFFERED=1
+ENV PYTHONDONTWRITEBYTECODE=1
+ENV HOST=0.0.0.0
+ENV PORT=28000
+
+# 暴露端口
+EXPOSE 28000
+
+# 健康检查
+HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
+    CMD curl -f http://localhost:28000/health || exit 1
+
+# 启动命令
+CMD ["python", "-m", "iflow2api.main"]

iflow2api-1.4.7/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kuang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.