Merge branch 'main' into feat-openclaw

Author: icey-yu

.github/workflows/auto-assign-issue.yml

@@ -16,7 +16,7 @@ jobs:
 
       - name: Assign the issue
         run: |
-          export LETASE_MILESTONES=$(curl 'https://api.github.com/repos/$OWNER/$PEPO/milestones' | jq -r 'last(.[]).title')
+          export LETASE_MILESTONES=$(curl 'https://api.github.com/repos/$OWNER/$REPO/milestones' | jq -r 'last(.[]).title')
           gh issue edit ${{ github.event.issue.number }} --add-assignee "${{ github.event.comment.user.login }}"
           gh issue edit ${{ github.event.issue.number }} --add-label "accepted"
           gh issue comment $ISSUE --body "@${{ github.event.comment.user.login }} Glad to see you accepted this issue🤲, this issue has been assigned to you. I set the milestones for this issue to [$LETASE_MILESTONES](https://github.com/$OWNER/$PEPO/milestones), We are looking forward to your PR!"

.github/workflows/build-ci.yaml

@@ -3,30 +3,34 @@ name: Documentation Deployment
 on:
   push:
     branches:
-      - main  # Trigger the action on push events to the main branch
-    
+      - main
 
 jobs:
   build_and_deploy:
     runs-on: ubuntu-latest
 
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v2
+      uses: actions/checkout@v4
 
     - name: Setup Node.js
-      uses: actions/setup-node@v2
+      uses: actions/setup-node@v4
       with:
-        node-version: '18'
+        node-version: '20'
+
+    - name: Install pnpm
+      uses: pnpm/action-setup@v4
+      with:
+        version: 9
 
     - name: Install dependencies
-      run: npm install
+      run: pnpm install --frozen-lockfile
 
     - name: Build documentation
-      run: npm run build
+      run: pnpm build
 
     - name: Deploy to GitHub Pages
-      uses: peaceiris/actions-gh-pages@v3
+      uses: peaceiris/actions-gh-pages@v4
       with:
         github_token: ${{ secrets.GITHUB_TOKEN }}
         publish_dir: ./build

.github/workflows/main-ci.yaml

@@ -3,7 +3,7 @@ name: Pull Request Checks
 on:
   pull_request:
     branches:
-      - main  # Trigger the action on pull requests to the main branch
+      - main
 
 jobs:
   test:
@@ -16,18 +16,23 @@ jobs:
     - name: Setup Node.js
       uses: actions/setup-node@v4
       with:
-        node-version: 'latest'
+        node-version: '20'
+
+    - name: Install pnpm
+      uses: pnpm/action-setup@v4
+      with:
+        version: 9
 
     - name: Install dependencies
-      run: npm install
+      run: pnpm install --frozen-lockfile
 
     - name: Build documentation
-      run: npm run build
+      run: pnpm build
 
     - name: Lint check
-      run: npm run lint
+      run: pnpm lint
       continue-on-error: true
 
     - name: Type checking
-      run: npm run typecheck
+      run: pnpm typecheck
       continue-on-error: true

.github/workflows/release.yml

@@ -0,0 +1,80 @@
+# OpenIM Docs - Codex Agent Instructions
+
+## Project Overview
+
+This is the OpenIM documentation site built with Docusaurus. It supports two locales:
+- **zh-Hans** (Chinese, default): Source files in `docs/`
+- **en** (English): Translated files in `i18n/en/`
+
+## Translation Task
+
+When asked to translate documentation, follow the rules below.
+
+### Path Mapping
+
+| Source (Chinese) | Target (English) |
+|-----------------|------------------|
+| `docs/sdks/` | `i18n/en/docusaurus-plugin-content-docs-sdks/current/` |
+| `docs/guides/` | `i18n/en/docusaurus-plugin-content-docs-guides/current/` |
+| `docs/restapi/` | `i18n/en/docusaurus-plugin-content-docs-restapi/current/` |
+| `docs/blog/` | `i18n/en/docusaurus-plugin-content-docs-blog/current/` |
+
+### Translation Rules
+
+1. **Keep unchanged**:
+   - All code blocks (` ``` `) content
+   - Frontmatter keys (only translate Chinese values like `title`, `description`)
+   - JSX/MDX component tags (`<Tabs>`, `<TabItem>`, etc.)
+   - Markdown link paths and URLs
+   - Variable names, function names, class names
+   - Import statements
+
+2. **Translate**:
+   - All Chinese text content to natural English
+   - Table headers and cell content (Chinese → English)
+   - Section headings (e.g., `## 功能介绍` → `## Description`)
+   - Inline comments in code examples (Chinese → English)
+
+3. **Common translations** (keep consistent across all files):
+   - 功能介绍 → Description
+   - 返回原型 → Return Prototype
+   - 返回结果 → Return Results
+   - 调用示例 → Call Example
+   - 名称 → Name
+   - 类型 → Type
+   - 描述 → Description
+
+### Sidebar Labels
+
+Sidebar category labels for each docs plugin are translated in **two places**:
+
+1. **`_category_.json`** files in the corresponding `i18n/en/` directory
+2. **`current.json`** files at `i18n/en/docusaurus-plugin-content-docs-*/current.json`
+
+For `current.json`:
+- The **key** stays the same (may contain Chinese category name as identifier)
+- Only the **`message`** field should be translated to English
+- The **`description`** field should also be updated to reflect the English label
+
+Example:
+```json
+{
+  "sidebar.tutorialSidebar.category.用户管理": {
+    "message": "User Management",
+    "description": "The label for category 'User Management' in sidebar 'tutorialSidebar'"
+  }
+}
+```
+
+### New Category Handling
+
+If a new `_category_.json` is added in the source `docs/` directory:
+1. Create the corresponding `_category_.json` in `i18n/en/` with translated `label`
+2. Run `npx docusaurus write-translations --locale en` to regenerate `current.json`
+3. Translate any new Chinese entries in `current.json`
+
+## Verification
+
+After translating, verify:
+1. No Chinese characters remain in translated `message` values
+2. Build succeeds: `pnpm build`

AGENTS.md

@@ -3,7 +3,7 @@ frontend:
   phases:
     preBuild:
       commands:
-        - nvm install 15 && npm ci
+        - nvm install 20 && npm ci
     build:
       commands:
         - npm run build

amplify.yml

@@ -0,0 +1,4 @@
+{
+  "key": "architectural-browser",
+  "label": "Browser"
+}