From 805e5f92c1137bdd3696754a881e24d0cb8e0329 Mon Sep 17 00:00:00 2001
From: yiliang114 <1204183885@qq.com>
Date: Thu, 20 Nov 2025 10:41:23 +0800
Subject: [PATCH] =?UTF-8?q?docs(readme):=20=E6=B7=BB=E5=8A=A0=20VS=20Code?=
 =?UTF-8?q?=20=E6=89=A9=E5=B1=95=E7=9B=B8=E5=85=B3=E4=BF=A1=E6=81=AF?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 在主 README 中添加 VS Code 扩展部分，介绍扩展的功能和用途
- 更新 VS Code 扩展的 README，详细说明调试和开发指南
- 优化扩展开发流程说明，提供两种调试选项
---
 README.md                               |  6 +++++
 packages/vscode-ide-companion/README.md | 31 ++++++++++++++++++-------
 2 files changed, 29 insertions(+), 8 deletions(-)

diff --git a/README.md b/README.md
index 4c4396ec..61c58657 100644
--- a/README.md
+++ b/README.md
@@ -88,6 +88,12 @@ npm install -g .
 brew install qwen-code
 ```
 
+## VS Code Extension
+
+In addition to the CLI tool, Qwen Code also provides a **VS Code extension** that brings AI-powered coding assistance directly into your editor with features like file system operations, native diffing, interactive chat, and more.
+
+> 📦 The extension is currently in development. For installation, features, and development guide, see the [VS Code Extension README](./packages/vscode-ide-companion/README.md).
+
 ## Quick Start
 
 ```bash
diff --git a/packages/vscode-ide-companion/README.md b/packages/vscode-ide-companion/README.md
index c411027c..2814255b 100644
--- a/packages/vscode-ide-companion/README.md
+++ b/packages/vscode-ide-companion/README.md
@@ -38,25 +38,40 @@ To debug and develop this extension locally:
    pnpm install
    ```
 
-3. **Open the extension in VS Code**
+3. **Start debugging**
+
+   You have two options:
+
+   **Option A: Debug from Project Root (Recommended)**
+
+   ```bash
+   code .  # Open the project root in VS Code
+   ```
+   - Open the `packages/vscode-ide-companion/src/extension.ts` file
+   - Open Debug panel (`Ctrl+Shift+D` or `Cmd+Shift+D`)
+   - Select **"Launch Companion VS Code Extension"** from the debug dropdown
+   - Press `F5` to launch Extension Development Host
+
+   **Option B: Debug from Extension Directory**
 
    ```bash
    cd packages/vscode-ide-companion
-   code .
+   code .  # Open the extension directory in VS Code
    ```
+   - Open the `src/extension.ts` file
+   - Open Debug panel (`Ctrl+Shift+D` or `Cmd+Shift+D`)
+   - Select **"Run Extension"** from the debug dropdown
+   - Press `F5` to launch Extension Development Host
 
-4. **Start debugging**
-   - Press `F5` or click "Run and Debug" from the sidebar
-   - Select "Run Extension" from the debug configuration dropdown
-   - This will open a new "Extension Development Host" window with the extension loaded
+   > 💡 **Tip**: Option A is recommended if you need to debug both the extension and core packages together.
 
-5. **Make changes and reload**
+4. **Make changes and reload**
    - Edit the source code in the original VS Code window
    - To see your changes, reload the Extension Development Host window by:
      - Pressing `Ctrl+R` (Windows/Linux) or `Cmd+R` (macOS)
      - Or clicking the "Reload" button in the debug toolbar
 
-6. **View logs and debug output**
+5. **View logs and debug output**
    - Open the Debug Console in the original VS Code window to see extension logs
    - In the Extension Development Host window, open Developer Tools with `Help > Toggle Developer Tools` to see webview logs