loongcodium · wubzbz · Jan 8, 2026 · Jan 8, 2026 · Jan 8, 2026 · Jan 9, 2026
diff --git a/.github/workflows/update-readme.yml b/.github/workflows/update-readme.yml
@@ -0,0 +1,68 @@
+name: Update Extension Table
+
+on:
+  push:
+    paths:
+      - 'scripts/extensions.csv'
+    branches:
+      - main
+      - '**'
+  pull_request:
+    types: [closed]
+    paths:
+      - 'scripts/extensions.csv'
+
+jobs:
+  update-readme:
+    # If PR is closed but not merged, skip this job.
+    if: github.event_name == 'push' || (github.event_name == 'pull_request' && github.event.pull_request.merged == true)
+
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: write
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+      with:
+        fetch-depth: 0  # Fetch full history to allow push back to repository
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.10'
+
+    - name: Install dependencies
+      run: pip install requests tqdm
+
+    - name: Run update script
+      run: python scripts/update_readme.py
+
+    - name: Check for changes
+      id: git-check
+      run: |
+        if git diff --quiet profile/README.md; then
+          echo "changes=false" >> $GITHUB_OUTPUT
+        else
+          echo "changes=true" >> $GITHUB_OUTPUT
+        fi
+
+    - name: Commit and push changes
+      if: steps.git-check.outputs.changes == 'true'
+      run: |
+        git config --global user.name "github-actions[bot]"
+        git config --global user.email "github-actions[bot]@users.noreply.github.com"
+
+        # Determine branch based on trigger type
+        if [ "${{ github.event_name }}" = "pull_request" ]; then
+          # After PR merge, operate on target branch
+          git checkout ${{ github.event.pull_request.base.ref }}
+        fi
+
+        # Add and commit changes
+        git add profile/README.md
+        git commit -m "docs: update extension table [auto]"
+
+        # Push changes
+        git push origin HEAD:${{ github.ref_name }}
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -0,0 +1,127 @@
+# Contribution Guide
+
+## 1. Overview
+Welcome to contributing to the LoongCodium extension compatibility list!
+
+Before submitting your contribution, please ensure that you:
+-   Adopt a responsible attitude and thoroughly test extension compatibility.
+-   Report extension status accurately.
+-   Provide detailed information for any ported extensions.
+
+## 2. Submitting Contributions
+
+### 2.1 Automatically Generated Extension List
+
+> [!IMPORTANT]
+> The extension list in the README is **automatically generated**. Please do **not** modify the `profile/README.md` file directly.
+
+We employ an automated process to manage the extension list, primarily based on the design philosophy of separating data from presentation. Storing extension information in a structured CSV file makes data maintenance simpler and more suitable for version control, while also providing extensibility for adding new fields in the future (such as test dates, tester information, etc.). In a collaborative setting, modifying CSV file significantly reduces maintenance effort compared to directly editing Markdown tables. The advantages of automation include automatic validation of data format and completeness, real-time fetching of the latest version information for extensions from Open VSX, unified generation of visually appealing version badges and standardized table formatting, as well as automatic alphabetical sorting by extension name.
+
+### 2.2 How It Works
+The project updates the extension list through three key files:
+
+| File | Path | Purpose |
+|------|------|------|
+| **CSV Data File** | `scripts/extensions.csv` | Stores all extension compatibility data. |
+| **Python Script** | `scripts/update_readme.py` | Reads the CSV, fetches extension information, and generates the table. |
+| **GitHub Actions Configuration** | `.github/workflows/update-readme.yml` | Automated workflow that monitors CSV changes and automatically updates the README. |
+
+**Workflow**:
+1. Update `extensions.csv` → 2. GitHub Actions triggers → 3. Runs Python script → 4. Automatically updates `README.md`
+
+### 2.3 Implementation Steps
+
+#### 2.3.1 Fork the Repository and Create a Branch
+1.  **Fork the Repository**: Click the "Fork" button in the upper right corner of the page to create a copy of this repository.
+2.  **Clone the Repository**: Clone your forked repository to your local machine.
+3.  **Create a Feature Branch**: Create a new feature branch based on the `main` branch for your changes.
+
+#### 2.3.2 Update the CSV File
+Edit the `scripts/extensions.csv` file. Each row represents one extension. The column descriptions are as follows:
+
+**`original_id`**: Fill in the extension's identifier from the [Open VSX Registry](https://open-vsx.org/) or the [VSCode Marketplace](https://marketplace.visualstudio.com/VSCode), in the format `publisher.extension`, e.g., `ms-python.python`. Typically, an extension's ID is consistent between the Open VSX Registry and the VSCode Marketplace. In the rare case of inconsistency, the ID from Open VSX should be used. For extensions that exist only in the VSCode Marketplace (e.g., Pylance), use its VSCode Marketplace ID directly.
+
+**`status`**: Use a numeric code from 0 to 3 to indicate the extension's compatibility status.
+-   Status `0` (✅ Working): The extension natively supports LoongArch.
+-   Status `1` (🚀 Ported): The official version does not support it, but there is a community-ported version available.
+-   Status `2` (🔄 Alternative): The official version does not support it, but there is a functionally reliable alternative extension available.
+-   Status `3` (😭 Not Working): The extension currently cannot run on LoongArch and no alternative is available.
+
+**Example 1**: For the Python extension, its ID is `ms-python.python`, and its status is natively available (Working). Therefore, fill it in as follows.
+```csv
+original_id, status, actual_ids, notes
+ms-python.python, 0, ,
+```
+
+**`actual_ids`**: Fill in the extension ID(s) that can actually be installed and used on LoongArch. For cases where `status` is 1 (Ported) or 2 (Alternative), this column should list the ID(s) of the ported or alternative extension(s). If multiple extensions are available, separate them with a vertical bar `|`. For `status` 0 (Working) or 3 (Not Working), this column is usually left empty.
+
+**Example 2**: For the CodeLLDB extension, its ID is `vadimcn.vscode-lldb`. This extension is not available, but there are two alternative extensions: LLDB DAP (ID: `llvm-vs-code-extensions.lldb-dap`) and Native Debug (ID: `webfreak.debug`). Therefore, fill it in as follows.
+```csv
+original_id, status, actual_ids, notes
+vadimcn.vscode-lldb, 2, llvm-vs-code-extensions.lldb-dap|webfreak.debug,
+```
+
+**`notes`**: Fill in remarks or additional information. You can use Markdown formatting. The script automatically adds a prefix for certain statuses: 
+
+- "Works out of the box." for status 0, 
+- "Use XXX instead." for status 1 and 2, and
+- "Unsupported architecture." for status 3. 
+
+Therefore, you do not need to repeat these default descriptions in this column; only provide extra information.
+
+**Example 3**: The unavailable Pylance extension is only provided in the VSCode Marketplace, with ID `ms-python.vscode-pylance`. The alternative extension is BasedPyright (ID: `detachhead.basedpyright`), and an additional note is attached. Therefore, fill it in as follows.
+```csv
+original_id, status, actual_ids, notes
+ms-python.vscode-pylance, 2, detachhead.basedpyright, "See this [discussion](https://github.com/VSCodium/vscodium/discussions/1641)."
+```
+
+#### 2.3.3 Local Testing (Optional)
+If you wish to verify the changes locally:
+1.  **Install Dependencies**:
+    ```bash
+    pip install tqdm requests
+    ```
+2.  **Run the Update Script**:
+    ```bash
+    python scripts/update_readme.py
+    ```
+3.  Check if the updated `profile/README.md` meets your expectations.
+
+#### 2.3.4 Commit Changes
+```bash
+# Stage the modified files
+git add scripts/extensions.csv
+
+# Commit the changes (please use a meaningful commit message)
+git commit -m "docs: Update/Add compatibility info/status for [Extension Name]
+
+- Status: [Working/Ported/Alternative/Not Working]
+- Actual ID(s): [Actual usable extension ID(s)]
+- Notes: [Brief description]"
+
+# Push to your fork
+git push origin docs/extension-name-compatibility-update
+```
+
+> [!NOTE]
+> After performing the commit, GitHub Actions will be triggered in your forked repository. Before submitting the PR to upstream, be sure to check the Actions tab and working branch in your fork to verify that the workflow completed successfully and produced the expected updates.
+
+#### 2.3.5 Create a Pull Request
+On GitHub, navigate to your forked repository, click the "Compare & pull request" button, and create a Pull Request from your feature branch to the `main` branch of the upstream `loongcodium/.github` repository. Please clearly describe the changes and any testing performed. After the PR is merged, GitHub Actions will automatically run the update script and commit the changes to `profile/README.md`.
+
+#### 2.3.6 Frequently Asked Questions (FAQ)
+**Q: What if there's a CSV format error?**  
+A: Ensure the file uses UTF-8 encoding, uses commas to separate columns, **wraps the entire field in double quotes if the text contains commas**, and that the status codes are only 0, 1, 2, or 3.
+
+**Q: What if extension information retrieval fails?**  
+A: Verify the extension ID format is correct (`publisher.extension`), check if the extension exists by visiting the [Open VSX Registry](https://open-vsx.org/), and ensure your network connection is normal.
+
+**Q: What if the GitHub Action fails?**  
+A: Check the detailed logs under the "Actions" tab of the repository to locate the failing step and error message.
+
+**Q: What if the table doesn't update?**  
+A: Ensure `profile/README.md` contains the correct `<!-- table_start -->` and `<!-- table_end -->` markers, the CSV file path is correct, and that the committed changes have triggered the workflow.
+
+**Q: How to report issues or discuss?**  
+A: You can report specific issues by submitting an Issue, or join the [GitHub Discussions](https://github.com/orgs/loongcodium/discussions) to participate. It is recommended to check existing Issues and discussions first to avoid duplication.
+
diff --git a/profile/README.md b/profile/README.md
@@ -13,34 +13,38 @@ Making VSCodium extensions work on LoongArch! We test extensions for compatibili
 - **🔄 Alternative**: Original extension incompatible; a reliable drop-in replacement is available.
 - **😭 Not Working**: Unsupported on LoongArch with no viable alternatives at this time.
 
+<!-- table_start -->
 | Extension Name | Status | Notes | Latest Version |
 |----------------|--------|-------|----------------|
-| [clangd](https://open-vsx.org/extension/llvm-vs-code-extensions/vscode-clangd) | ✅ Working | Requires `clangd` to be installed on the system beforehand. | ![version](https://img.shields.io/badge/dynamic/json?url=https://open-vsx.org/api/llvm-vs-code-extensions/vscode-clangd&query=$.version&label=&color=brightgreen) |
+| [clangd](https://open-vsx.org/extension/llvm-vs-code-extensions/vscode-clangd) | ✅ Working | Works out of the box. Requires `clangd` to be installed on the system beforehand. | ![version](https://img.shields.io/badge/dynamic/json?url=https://open-vsx.org/api/llvm-vs-code-extensions/vscode-clangd&query=$.version&label=&color=brightgreen) |
 | [CodeLLDB](https://open-vsx.org/extension/vadimcn/vscode-lldb) | 🔄 Alternative | Use [LLDB DAP](https://open-vsx.org/extension/llvm-vs-code-extensions/lldb-dap) or [Native Debug](https://open-vsx.org/extension/webfreak/debug) instead. | ![version](https://img.shields.io/badge/dynamic/json?url=https://open-vsx.org/api/llvm-vs-code-extensions/lldb-dap&query=$.version&label=LLDB%20DAP&color=blue) ![version](https://img.shields.io/badge/dynamic/json?url=https://open-vsx.org/api/webfreak/debug&query=$.version&label=Native%20Debug&color=blue) |
 | [Docker DX](https://open-vsx.org/extension/docker/docker) | 🚀 Ported | Use [Docker DX (loong64)](https://open-vsx.org/extension/loong-vsx/docker) instead. | ![version](https://img.shields.io/badge/dynamic/json?url=https://open-vsx.org/api/loong-vsx/docker&query=$.version&label=&color=teal) |
-| [ESLint](https://open-vsx.org/extension/dbaeumer/vscode-eslint) |  ✅ Working | Works out of the box. | ![version](https://img.shields.io/badge/dynamic/json?url=https://open-vsx.org/api/dbaeumer/vscode-eslint&query=$.version&label=&color=brightgreen) |
-| [Even Better TOML](https://open-vsx.org/extension/tamasfe/even-better-toml) | ✅ Working | Once installed, configure `Bundled` to `false`. | ![version](https://img.shields.io/badge/dynamic/json?url=https://open-vsx.org/api/tamasfe/even-better-toml&query=$.version&label=&color=brightgreen) |
-| [Go](https://open-vsx.org/extension/golang/Go) | ✅ Working | Works out of the box, automatically installs related binaries. | ![version](https://img.shields.io/badge/dynamic/json?url=https://open-vsx.org/api/golang/Go&query=$.version&label=&color=brightgreen) |
+| [ESLint](https://open-vsx.org/extension/dbaeumer/vscode-eslint) | ✅ Working | Works out of the box. | ![version](https://img.shields.io/badge/dynamic/json?url=https://open-vsx.org/api/dbaeumer/vscode-eslint&query=$.version&label=&color=brightgreen) |
+| [Even Better TOML](https://open-vsx.org/extension/tamasfe/even-better-toml) | ✅ Working | Works out of the box. Once installed, configure `Bundled` to `false`. | ![version](https://img.shields.io/badge/dynamic/json?url=https://open-vsx.org/api/tamasfe/even-better-toml&query=$.version&label=&color=brightgreen) |
+| [Go](https://open-vsx.org/extension/golang/Go) | ✅ Working | Works out of the box. Automatically installs related binaries. | ![version](https://img.shields.io/badge/dynamic/json?url=https://open-vsx.org/api/golang/Go&query=$.version&label=&color=brightgreen) |
 | [Jupyter](https://open-vsx.org/extension/ms-toolsai/jupyter) | ✅ Working | Works out of the box. | ![version](https://img.shields.io/badge/dynamic/json?url=https://open-vsx.org/api/ms-toolsai/jupyter&query=$.version&label=&color=brightgreen) |
-| Pylance | 🔄 Alternative | Use [BasedPyright](https://open-vsx.org/extension/detachhead/basedpyright) instead. See this [discussion](https://github.com/VSCodium/vscodium/discussions/1641). | ![version](https://img.shields.io/badge/dynamic/json?url=https://open-vsx.org/api/detachhead/basedpyright&query=$.version&label=&color=blue) |
+| [Pylance](https://marketplace.visualstudio.com/items?itemName=ms-python.vscode-pylance) | 🔄 Alternative | Use [BasedPyright](https://open-vsx.org/extension/detachhead/basedpyright) instead. See this [discussion](https://github.com/VSCodium/vscodium/discussions/1641). | ![version](https://img.shields.io/badge/dynamic/json?url=https://open-vsx.org/api/detachhead/basedpyright&query=$.version&label=&color=blue) |
 | [Pylint](https://open-vsx.org/extension/ms-python/pylint) | ✅ Working | Works out of the box. | ![version](https://img.shields.io/badge/dynamic/json?url=https://open-vsx.org/api/ms-python/pylint&query=$.version&label=&color=brightgreen) |
-| [Pyrefly](https://open-vsx.org/extension/facebook/pyrefly) | 🚀 Ported | Use [Pyrefly (loong64)](https://open-vsx.org/extension/loong-vsx/pyrefly) instead. | ![version](https://img.shields.io/badge/dynamic/json?url=https://open-vsx.org/api/loong-vsx/pyrefly&query=$.version&label=&color=teal) |
+| [Pyrefly - Python Language Tooling](https://open-vsx.org/extension/meta/pyrefly) | 🚀 Ported | Use [Pyrefly (loong64)](https://open-vsx.org/extension/loong-vsx/pyrefly) instead. | ![version](https://img.shields.io/badge/dynamic/json?url=https://open-vsx.org/api/loong-vsx/pyrefly&query=$.version&label=&color=teal) |
 | [Python](https://open-vsx.org/extension/ms-python/python) | ✅ Working | Works out of the box. | ![version](https://img.shields.io/badge/dynamic/json?url=https://open-vsx.org/api/ms-python/python&query=$.version&label=&color=brightgreen) |
 | [Python Debugger](https://open-vsx.org/extension/ms-python/debugpy) | 🚀 Ported | Use [Python Debugger for LoongArch](https://open-vsx.org/extension/wubzbz/debugpy) instead. | ![version](https://img.shields.io/badge/dynamic/json?url=https://open-vsx.org/api/wubzbz/debugpy&query=$.version&label=&color=teal) |
 | [Python Environments](https://open-vsx.org/extension/ms-python/vscode-python-envs) | ✅ Working | Works out of the box. | ![version](https://img.shields.io/badge/dynamic/json?url=https://open-vsx.org/api/ms-python/vscode-python-envs&query=$.version&label=&color=brightgreen) |
-| Remote - SSH | 🔄 Alternative | Use [Open Remote - SSH](https://open-vsx.org/extension/jeanp413/open-remote-ssh) instead. | ![version](https://img.shields.io/badge/dynamic/json?url=https://open-vsx.org/api/jeanp413/open-remote-ssh&query=$.version&label=&color=blue) |
+| [Remote - SSH](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-ssh) | 🔄 Alternative | Use [Open Remote - SSH](https://open-vsx.org/extension/jeanp413/open-remote-ssh) instead. | ![version](https://img.shields.io/badge/dynamic/json?url=https://open-vsx.org/api/jeanp413/open-remote-ssh&query=$.version&label=&color=blue) |
 | [Ruff](https://open-vsx.org/extension/charliermarsh/ruff) | 🚀 Ported | Use [Ruff (loong64)](https://open-vsx.org/extension/loong-vsx/ruff) instead. | ![version](https://img.shields.io/badge/dynamic/json?url=https://open-vsx.org/api/loong-vsx/ruff&query=$.version&label=&color=teal) |
 | [rust-analyzer](https://open-vsx.org/extension/rust-lang/rust-analyzer) | 🔄 Alternative | Use [rust-analyzer-no-server](https://open-vsx.org/extension/loong-vsx/rust-analyzer) instead. See [loongcodium/rust-analyzer-no-server](https://github.com/loongcodium/rust-analyzer-no-server). | ![version](https://img.shields.io/badge/dynamic/json?url=https://open-vsx.org/api/loong-vsx/rust-analyzer&query=$.version&label=&color=blue) |
-| [Tinymist Typst](https://open-vsx.org/extension/myriad-dreamin/tinymist) | ✅ Working | Requires `tinymist` to be installed on the system beforehand. | ![version](https://img.shields.io/badge/dynamic/json?url=https://open-vsx.org/api/myriad-dreamin/tinymist&query=$.version&label=&color=brightgreen) |
+| [Tinymist Typst](https://open-vsx.org/extension/myriad-dreamin/tinymist) | ✅ Working | Works out of the box. Requires `tinymist` to be installed on the system beforehand. | ![version](https://img.shields.io/badge/dynamic/json?url=https://open-vsx.org/api/myriad-dreamin/tinymist&query=$.version&label=&color=brightgreen) |
 | [TypeScript + Webpack Problem Matchers](https://open-vsx.org/extension/amodio/tsl-problem-matcher) | ✅ Working | Works out of the box. | ![version](https://img.shields.io/badge/dynamic/json?url=https://open-vsx.org/api/amodio/tsl-problem-matcher&query=$.version&label=&color=brightgreen) |
 | [Typos spell checker](https://open-vsx.org/extension/tekumara/typos-vscode) | 🚀 Ported | Use [Typos spell checker (loong64)](https://open-vsx.org/extension/loong-vsx/typos-vscode) instead. | ![version](https://img.shields.io/badge/dynamic/json?url=https://open-vsx.org/api/loong-vsx/typos-vscode&query=$.version&label=&color=teal) |
+<!-- table_end -->
 
 ## Contributing
 
 - Test extensions and report compatibility
 - Help port extensions to LoongArch
 - Improve documentation
 
+Please read [CONTRIBUTING.md](../CONTRIBUTING.md) for detailed contribution guidelines, including how to update the extension compatibility list.
+
 ## Resources
 
 - [GitHub Discussions](https://github.com/orgs/loongcodium/discussions)