Merge pull request #166 from zouyonghe/feat/wiki-sync-ci

feat: sync docs content to astrbot wiki

Author: zouyonghe

.github/workflows/sync-wiki.yml

@@ -0,0 +1,67 @@
+name: sync wiki
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - v4
+    paths:
+      - '.github/workflows/sync-wiki.yml'
+      - 'scripts/sync_docs_to_wiki.py'
+      - 'tests/test_sync_docs_to_wiki.py'
+      - 'zh/**'
+      - 'en/**'
+
+concurrency:
+  group: sync-wiki-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  sync:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+
+    steps:
+      - name: Validate manual ref
+        if: github.event_name == 'workflow_dispatch' && github.ref != 'refs/heads/v4'
+        run: |
+          echo "This workflow only publishes from refs/heads/v4. Re-run it from the v4 branch."
+          exit 1
+
+      - name: Check out docs repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Run sync unit tests
+        run: python -m unittest discover -s tests -p 'test_sync_docs_to_wiki.py' -v
+
+      - name: Validate internal doc links
+        run: python scripts/sync_docs_to_wiki.py --source-root . --check-links-only
+
+      - name: Clone AstrBot wiki
+        env:
+          WIKI_TOKEN: ${{ secrets.ASTRBOT_WIKI_TOKEN }}
+        run: |
+          test -n "$WIKI_TOKEN"
+          git clone "https://x-access-token:${WIKI_TOKEN}@github.com/AstrBotDevs/AstrBot.wiki.git" wiki
+
+      - name: Generate wiki pages
+        run: python scripts/sync_docs_to_wiki.py --source-root . --wiki-root wiki
+
+      - name: Commit and push wiki changes
+        working-directory: wiki
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git add .
+          if git diff --cached --quiet; then
+            echo "No wiki changes to push"
+            exit 0
+          fi
+          git commit -m "docs: sync wiki from AstrBot-docs"
+          git push

en/dev/plugin.md

@@ -1 +1 @@
-本页面已经迁移至 [插件基础开发](/dev/star/plugin)。
+This page has moved to [AstrBot Plugin Development Guide](/en/dev/star/plugin-new).

en/dev/star/guides/ai.md

@@ -5,7 +5,7 @@ AstrBot provides built-in support for multiple Large Language Model (LLM) provid
 
 You can use the LLM / Agent interfaces provided by AstrBot to implement your own intelligent agents.
 
-Starting from version `v4.5.7`, we've made significant improvements to the way LLM providers are invoked. We recommend using the new approach, which is more concise and supports additional features. Of course, you can still use the [legacy invocation method](/dev/star/plugin#ai).
+Starting from version `v4.5.7`, we've made significant improvements to the way LLM providers are invoked. We recommend using the new approach, which is more concise and supports additional features. The legacy invocation method remains documented in the previous Chinese-only guide.
 
 ## Getting the Chat Model ID for the Current Session
 

en/use/plugin.md

@@ -4,4 +4,4 @@ Starting from version `3.4.0`, AstrBot renamed plugins to `Star`. AstrBot is a h
 
 Use `/plugin` to view all plugins. You can also manage installed plugins in the admin panel.
 
-If you want to develop your own plugin, see [Implement a Plugin in a Few Lines of Code](/dev/star/plugin).
+If you want to develop your own plugin, see [AstrBot Plugin Development Guide](/en/dev/star/plugin-new).