feat: add GitHub Actions workflow for automatic API documentation updates

Signed-off-by: James Ding <[email protected]>

Author: twangodev

.github/workflows/docs.yml

@@ -0,0 +1,65 @@
+name: Update Documentation
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  update-docs:
+    name: Generate and Update API Docs
+    runs-on: ubuntu-latest
+    environment: docs
+    steps:
+      - name: Checkout fish-audio-python
+        uses: actions/checkout@v4
+        with:
+          path: sdk
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Install dependencies
+        working-directory: sdk
+        run: uv sync
+
+      - name: Generate API documentation
+        working-directory: sdk
+        run: uv run pydoc-markdown
+
+      - name: Checkout docs
+        uses: actions/checkout@v4
+        with:
+          repository: ${{ vars.DOCS_REPO }}
+          path: docs
+
+      - name: Create module reference directory
+        run: mkdir -p docs/sdk-reference/python/module-reference
+
+      - name: Copy generated documentation
+        run: |
+          cp sdk/build/docs/content/fishaudio/*.md docs/sdk-reference/python/module-reference/
+          cp sdk/build/docs/content/fish_audio_sdk.md docs/sdk-reference/python/module-reference/
+
+      - name: Create Pull Request
+        uses: peter-evans/create-pull-request@v6
+        with:
+          token: ${{ secrets.DOCS_TOKEN }}
+          path: docs
+          commit-message: |
+            chore: update Python SDK API reference
+
+            Auto-generated from fishaudio/fish-audio-python@${{ github.sha }}
+          branch: auto/python-api-docs
+          delete-branch: true
+          sign-commits: true
+          title: "Update Python SDK API Reference"
+          body: |
+            Auto-generated API documentation update from [fish-audio-python@${{ github.sha }}](https://github.com/fishaudio/fish-audio-python/commit/${{ github.sha }})
+
+            ## Changes
+            - Updated API reference documentation for Python SDK
+            - Generated from latest docstrings in the codebase
+
+          labels: |
+            python