From 903113d7490ac936b6ae194b21debf4e685dfd70 Mon Sep 17 00:00:00 2001
From: pomelo-nwu <czynwu@outlook.com>
Date: Thu, 11 Dec 2025 15:45:09 +0800
Subject: [PATCH] feat: add integration

---
 docs/users/_meta.ts              |  4 +--
 docs/users/integration-vscode.md | 45 ++++++++++++++++++++++++++
 docs/users/integration-zed.md    | 54 ++++++++++++++++++++++++++++++++
 3 files changed, 101 insertions(+), 2 deletions(-)

diff --git a/docs/users/_meta.ts b/docs/users/_meta.ts
index c8304b17..a44167cf 100644
--- a/docs/users/_meta.ts
+++ b/docs/users/_meta.ts
@@ -10,9 +10,9 @@ export default {
     type: 'separator',
     title: 'Outside of the terminal', // Title is optional
   },
-  'integration-github-action': 'Github Action',
-  'integration-vscode': 'VSCode Extension',
+  'integration-vscode': 'Visual Studio Code',
   'integration-zed': 'Zed IDE',
+  'integration-github-action': 'Github Actions',
   'Code with Qwen Code': {
     type: 'separator',
     title: 'Code with Qwen Code', // Title is optional
diff --git a/docs/users/integration-vscode.md b/docs/users/integration-vscode.md
index e69de29b..e827df26 100644
--- a/docs/users/integration-vscode.md
+++ b/docs/users/integration-vscode.md
@@ -0,0 +1,45 @@
+# Visual Studio Code
+
+> The VS Code extension (Beta) lets you see Qwen's changes in real-time through a native graphical interface integrated directly into your IDE, making it easier to access and interact with Qwen Code.
+
+<br/>
+
+<video src="https://cloud.video.taobao.com/vod/JnvYMhUia2EKFAaiuErqNpzWE9mz3odG76vArAHNg94.mp4" controls width="800">
+  Your browser does not support the video tag.
+</video>
+
+### Features
+
+- **Native IDE experience**: Dedicated Qwen Code sidebar panel accessed via the Qwen icon
+- **Auto-accept edits mode**: Automatically apply Qwen's changes as they're made
+- **File management**: @-mention files or attach files and images using the system file picker
+- **Conversation history**: Access to past conversations
+- **Multiple sessions**: Run multiple Qwen Code sessions simultaneously
+
+### Requirements
+
+- VS Code 1.98.0 or higher
+
+### Installation
+
+1. Install Qwen Code CLI:
+
+   ```bash
+   npm install -g qwen-code
+   ```
+
+2. Download and install the extension from the [Visual Studio Code Extension Marketplace](https://marketplace.visualstudio.com/items?itemName=qwenlm.qwen-code-vscode-ide-companion).
+
+## Troubleshooting
+
+### Extension not installing
+
+- Ensure you have VS Code 1.98.0 or higher
+- Check that VS Code has permission to install extensions
+- Try installing directly from the Marketplace website
+
+### Qwen Code not responding
+
+- Check your internet connection
+- Start a new conversation to see if the issue persists
+- [File an issue on GitHub](https://github.com/qwenlm/qwen-code/issues) if the problem continues
diff --git a/docs/users/integration-zed.md b/docs/users/integration-zed.md
index e69de29b..5a2fa7e5 100644
--- a/docs/users/integration-zed.md
+++ b/docs/users/integration-zed.md
@@ -0,0 +1,54 @@
+# Zed Editor
+
+> Zed Editor provides native support for AI coding assistants through the Agent Control Protocol (ACP). This integration allows you to use Qwen Code directly within Zed's interface with real-time code suggestions.
+
+![Zed Editor Overview](https://img.alicdn.com/imgextra/i1/O1CN01aAhU311GwEoNh27FP_!!6000000000686-2-tps-3024-1898.png)
+
+### Features
+
+- **Native agent experience**: Integrated AI assistant panel within Zed's interface
+- **Agent Control Protocol**: Full support for ACP enabling advanced IDE interactions
+- **File management**: @-mention files to add them to the conversation context
+- **Conversation history**: Access to past conversations within Zed
+
+### Requirements
+
+- Zed Editor (latest version recommended)
+- Qwen Code CLI installed
+
+### Installation
+
+1. Install Qwen Code CLI:
+
+   ```bash
+   npm install -g qwen-code
+   ```
+
+2. Download and install [Zed Editor](https://zed.dev/)
+
+3. In Zed, click the **settings button** in the top right corner, select **"Add agent"**, choose **"Create a custom agent"**, and add the following configuration:
+
+```json
+"Qwen Code": {
+  "type": "custom",
+  "command": "qwen",
+  "args": ["--experimental-acp"],
+  "env": {}
+}
+```
+
+![Qwen Code Integration](https://img.alicdn.com/imgextra/i1/O1CN013s61L91dSE1J7MTgO_!!6000000003734-2-tps-2592-1234.png)
+
+## Troubleshooting
+
+### Agent not appearing
+
+- Run `qwen --version` in terminal to verify installation
+- Check that the JSON configuration is valid
+- Restart Zed Editor
+
+### Qwen Code not responding
+
+- Check your internet connection
+- Verify CLI works by running `qwen` in terminal
+- [File an issue on GitHub](https://github.com/qwenlm/qwen-code/issues) if the problem persists