feat: replace cloud translation with local Argos

Author: ryosukeeeeee

.github/workflows/pages.yml

@@ -18,7 +18,7 @@ jobs:
   deploy:
     name: Build and deploy
     runs-on: ubuntu-latest
-    timeout-minutes: 15
+    timeout-minutes: 45
     environment:
       name: github-pages
       url: ${{ steps.deployment.outputs.page_url }}
@@ -35,19 +35,27 @@ jobs:
           node-version: 24
           cache: yarn
 
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+          cache: pip
+          cache-dependency-path: requirements-i18n.txt
+
       - name: Install dependencies
         run: corepack yarn install --frozen-lockfile
 
+      - name: Install offline translation engine
+        run: python -m pip install --disable-pip-version-check -r requirements-i18n.txt
+
+      - name: Restore Argos language model
+        uses: actions/cache@v5
+        with:
+          path: ~/.local/share/argos-translate
+          key: argos-${{ runner.os }}-zh-en-1.9
+
       - name: Synchronize English documentation
-        env:
-          AZURE_TRANSLATOR_KEY: ${{ secrets.AZURE_TRANSLATOR_KEY }}
-          AZURE_TRANSLATOR_REGION: ${{ vars.AZURE_TRANSLATOR_REGION }}
-        run: |
-          if [ -z "$AZURE_TRANSLATOR_KEY" ]; then
-            echo "::warning::AZURE_TRANSLATOR_KEY is not configured; using the checked-in English pages."
-            exit 0
-          fi
-          corepack yarn translate
+        run: corepack yarn translate
 
       - name: Build site
         run: corepack yarn build
@@ -67,8 +75,8 @@ jobs:
       - name: Save generated English documentation
         run: |
           git add -- docs/uk
-          if [ -f .i18n-cache/azure-en.json ]; then
-            git add -- .i18n-cache/azure-en.json
+          if [ -f .i18n-cache/argos-zh-en.json ]; then
+            git add -- .i18n-cache/argos-zh-en.json
           fi
           if git diff --cached --quiet; then
             exit 0

.gitignore

@@ -1,5 +1,8 @@
 node_modules/
 dist/
+__pycache__/
+.venv*/
+.argos-runtime/
 *.log
 .env
 .env.*

.i18n-cache/argos-zh-en.json

@@ -2,26 +2,43 @@
 
 中文 `docs` 目录是本站内容的唯一来源。`docs/uk` 中的英文 Markdown 由构建流程生成，请不要直接编辑。
 
-## 首次启用
+## 实现方式
 
-1. 在 Azure 中创建单服务 **Translator** 资源，区域选择 **Global**，定价层选择 **Free F0**。
-2. 在资源的 **Keys and Endpoint** 页面复制其中一个密钥。
-3. 打开 GitHub 仓库的 **Settings → Secrets and variables → Actions**。
-4. 新建名为 `AZURE_TRANSLATOR_KEY` 的 Repository secret，并填入 Azure Translator 密钥。
-5. 如果资源不是 Global 区域，再创建名为 `AZURE_TRANSLATOR_REGION` 的 Repository variable，值为资源区域代码。
-6. 在 GitHub Actions 中手动运行一次 **Deploy documentation**，或推送一次中文文档修改。
+翻译完全使用开源的 [Argos Translate](https://github.com/argosopentech/argos-translate) 在本地完成，不调用在线翻译 API，也不需要注册账号、添加密钥或绑定付款方式。
 
-密钥只提供给 GitHub Actions，不会写入仓库、生成文件或浏览器代码。
+- 翻译引擎：Argos Translate 1.11.0（MIT）
+- 语言模型：`translate-zh_en` 1.9
+- 运行位置：开发者本机或 GitHub Actions Runner
+- 外部请求：仅在首次安装时下载 Python 依赖和开源语言模型
+- 后续运行：只翻译未命中仓库缓存的新增或修改段落
+
+GitHub Actions 会缓存语言模型，并把生成的英文页面与 `.i18n-cache/argos-zh-en.json` 一并提交回仓库。无需配置 Repository secret 或 variable。
 
 ## 同步规则
 
 - 新增中文 Markdown：创建同路径英文页面。
-- 修改中文 Markdown：只请求翻译没有命中段落缓存的内容。
+- 修改中文 Markdown：只翻译没有命中段落缓存的内容。
 - 删除中文 Markdown：删除同路径英文页面。
-- 移动或重命名：表现为删除旧英文页面并创建新页面。
+- 移动或重命名：删除旧英文页面并创建新页面。
 - 代码块、行内代码、链接目标、图片地址和 HTML 注释保持原样。
 - 根路径文档链接自动增加 `/uk` 前缀。
-- `i18n.config.json` 中的 Arch Linux 术语保持原文。
-- API 请求失败时不写入部分翻译，也不会部署不完整版本。
+- `i18n.config.json` 中配置的项目品牌名称保持原文。
+- 翻译失败时不写入部分结果，也不会部署不完整版本。
+
+## 本地运行
+
+首次运行先安装 Python 依赖：
+
+```bash
+python -m pip install -r requirements-i18n.txt
+```
+
+然后执行：
+
+```bash
+yarn translate
+```
+
+第一次运行会自动下载固定版本的中英语言模型。以后日常只需要维护中文文档；英文页面和翻译缓存由自动化流程维护。
 
-本地拥有 Azure Translator 密钥时，可以设置 `AZURE_TRANSLATOR_KEY` 环境变量后运行 `yarn translate`。区域资源还需设置 `AZURE_TRANSLATOR_REGION`；Global 资源可以省略。日常只需维护中文文档，英文生成文件和 `.i18n-cache` 缓存由 GitHub Actions 提交。
+如果系统中的 Python 命令不是 `python` 或 `python3`，可以通过 `ARGOS_PYTHON` 环境变量指定解释器路径。