@protolabsai/proto 0.14.0

package/dist/bundled/qc-helper/docs/integration-vscode.md

@@ -0,0 +1,39 @@
+# 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/IKKwfM-kqNI3OJjM_U8uMCSMAoeEcJhs6VNCQmZxUfk.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.85.0 or higher
+
+### Installation
+
+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.85.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

package/dist/bundled/qc-helper/docs/integration-zed.md

@@ -0,0 +1,72 @@
+# Zed Editor
+
+> Zed Editor provides native support for AI coding assistants through the Agent Client 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 Client 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
+
+#### Install from ACP Registry (Recommend)
+
+1. Install Qwen Code CLI:
+
+```bash
+npm install -g @qwen-code/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 **"Install from Registry"**, find **Qwen Code**, then click **Install**.
+
+   ![ACP Registry](https://img.alicdn.com/imgextra/i4/O1CN0186ybL61EeG35fHFjy_!!6000000000376-2-tps-3056-1705.png)
+
+   ![Qwen Code ACP Installed](https://img.alicdn.com/imgextra/i1/O1CN01OXHhoR1J8irAvjs8F_!!6000000000984-2-tps-1247-703.png)
+
+#### Manual Install
+
+1. Install Qwen Code CLI:
+
+```bash
+npm install -g @qwen-code/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": ["--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

package/dist/bundled/qc-helper/docs/overview.md

@@ -0,0 +1,64 @@
+# Qwen Code overview
+
+[![@qwen-code/qwen-code downloads](https://img.shields.io/npm/dw/@qwen-code/qwen-code.svg)](https://npm-compare.com/@qwen-code/qwen-code)
+[![@qwen-code/qwen-code version](https://img.shields.io/npm/v/@qwen-code/qwen-code.svg)](https://www.npmjs.com/package/@qwen-code/qwen-code)
+
+> Learn about Qwen Code, Qwen's agentic coding tool that lives in your terminal and helps you turn ideas into code faster than ever before.
+
+## Get started in 30 seconds
+
+### Install Qwen Code:
+
+**Linux / macOS**
+
+```sh
+curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.sh | bash
+```
+
+**Windows (Run as Administrator CMD)**
+
+```sh
+curl -fsSL -o %TEMP%\install-qwen.bat https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.bat && %TEMP%\install-qwen.bat
+```
+
+> [!note]
+>
+> It's recommended to restart your terminal after installation to ensure environment variables take effect. If the installation fails, please refer to [Manual Installation](./quickstart#manual-installation) in the Quickstart guide.
+
+### Start using Qwen Code:
+
+```bash
+cd your-project
+qwen
+```
+
+Select **Qwen OAuth (Free)** authentication and follow the prompts to log in. Then let's start with understanding your codebase. Try one of these commands:
+
+```
+what does this project do?
+```
+
+![](https://cloud.video.taobao.com/vod/j7-QtQScn8UEAaEdiv619fSkk5p-t17orpDbSqKVL5A.mp4)
+
+You'll be prompted to log in on first use. That's it! [Continue with Quickstart (5 mins) →](./quickstart)
+
+> [!tip]
+>
+> See [troubleshooting](./support/troubleshooting) if you hit issues.
+
+> [!note]
+>
+> **New VS Code Extension (Beta)**: Prefer a graphical interface? Our new **VS Code extension** provides an easy-to-use native IDE experience without requiring terminal familiarity. Simply install from the marketplace and start coding with Qwen Code directly in your sidebar. Download and install the [Qwen Code Companion](https://marketplace.visualstudio.com/items?itemName=qwenlm.qwen-code-vscode-ide-companion) now.
+
+## What Qwen Code does for you
+
+- **Build features from descriptions**: Tell Qwen Code what you want to build in plain language. It will make a plan, write the code, and ensure it works.
+- **Debug and fix issues**: Describe a bug or paste an error message. Qwen Code will analyze your codebase, identify the problem, and implement a fix.
+- **Navigate any codebase**: Ask anything about your team's codebase, and get a thoughtful answer back. Qwen Code maintains awareness of your entire project structure, can find up-to-date information from the web, and with [MCP](./features/mcp) can pull from external datasources like Google Drive, Figma, and Slack.
+- **Automate tedious tasks**: Fix fiddly lint issues, resolve merge conflicts, and write release notes. Do all this in a single command from your developer machines, or automatically in CI.
+
+## Why developers love Qwen Code
+
+- **Works in your terminal**: Not another chat window. Not another IDE. Qwen Code meets you where you already work, with the tools you already love.
+- **Takes action**: Qwen Code can directly edit files, run commands, and create commits. Need more? [MCP](./features/mcp) lets Qwen Code read your design docs in Google Drive, update your tickets in Jira, or use _your_ custom developer tooling.
+- **Unix philosophy**: Qwen Code is composable and scriptable. `tail -f app.log | qwen -p "Slack me if you see any anomalies appear in this log stream"` _works_. Your CI can run `qwen -p "If there are new text strings, translate them into French and raise a PR for @lang-fr-team to review"`.

package/dist/bundled/qc-helper/docs/quickstart.md

@@ -0,0 +1,273 @@
+# Quickstart
+
+> 👏 Welcome to Qwen Code!
+
+This quickstart guide will have you using AI-powered coding assistance in just a few minutes. By the end, you'll understand how to use Qwen Code for common development tasks.
+
+## Before you begin
+
+Make sure you have:
+
+- A **terminal** or command prompt open
+- A code project to work with
+- A [Qwen Code](https://chat.qwen.ai/auth?mode=register) account
+
+## Step 1: Install Qwen Code
+
+To install Qwen Code, use one of the following methods:
+
+### Quick Install (Recommended)
+
+**Linux / macOS**
+
+```sh
+curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.sh | bash
+```
+
+**Windows (Run as Administrator CMD)**
+
+```sh
+curl -fsSL -o %TEMP%\install-qwen.bat https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.bat && %TEMP%\install-qwen.bat
+```
+
+> [!note]
+>
+> It's recommended to restart your terminal after installation to ensure environment variables take effect.
+
+### Manual Installation
+
+**Prerequisites**
+
+Make sure you have Node.js 20 or later installed. Download it from [nodejs.org](https://nodejs.org/en/download).
+
+**NPM**
+
+```bash
+npm install -g @qwen-code/qwen-code@latest
+```
+
+**Homebrew (macOS, Linux)**
+
+```bash
+brew install qwen-code
+```
+
+## Step 2: Log in to your account
+
+Qwen Code requires an account to use. When you start an interactive session with the `qwen` command, you'll be prompted to log in:
+
+```bash
+# You'll be prompted to log in on first use
+qwen
+```
+
+```bash
+# Follow the prompts to log in with your account
+/auth
+```
+
+Select `Qwen OAuth`, log in to your account and follow the prompts to confirm. Once logged in, your credentials are stored and you won't need to log in again.
+
+> [!note]
+>
+> When you first authenticate Qwen Code with your Qwen account, a workspace called ".qwen" is automatically created for you. This workspace provides centralized cost tracking and management for all Qwen Code usage in your organization.
+
+> [!tip]
+>
+> You can also configure authentication directly from the terminal without starting a session by running `qwen auth`. Use `qwen auth status` to check your current configuration at any time. See the [Authentication](./configuration/auth) page for details.
+
+## Step 3: Start your first session
+
+Open your terminal in any project directory and start Qwen Code:
+
+```bash
+# optiona
+cd /path/to/your/project
+# start qwen
+qwen
+```
+
+You'll see the Qwen Code welcome screen with your session information, recent conversations, and latest updates. Type `/help` for available commands.
+
+## Chat with Qwen Code
+
+### Ask your first question
+
+Qwen Code will analyze your files and provide a summary. You can also ask more specific questions:
+
+```
+explain the folder structure
+```
+
+You can also ask Qwen Code about its own capabilities:
+
+```
+what can Qwen Code do?
+```
+
+> [!note]
+>
+> Qwen Code reads your files as needed - you don't have to manually add context. Qwen Code also has access to its own documentation and can answer questions about its features and capabilities.
+
+### Make your first code change
+
+Now let's make Qwen Code do some actual coding. Try a simple task:
+
+```
+add a hello world function to the main file
+```
+
+Qwen Code will:
+
+1. Find the appropriate file
+2. Show you the proposed changes
+3. Ask for your approval
+4. Make the edit
+
+> [!note]
+>
+> Qwen Code always asks for permission before modifying files. You can approve individual changes or enable "Accept all" mode for a session.
+
+### Use Git with Qwen Code
+
+Qwen Code makes Git operations conversational:
+
+```
+what files have I changed?
+```
+
+```
+commit my changes with a descriptive message
+```
+
+You can also prompt for more complex Git operations:
+
+```
+create a new branch called feature/quickstart
+```
+
+```
+show me the last 5 commits
+```
+
+```
+help me resolve merge conflicts
+```
+
+### Fix a bug or add a feature
+
+Qwen Code is proficient at debugging and feature implementation.
+
+Describe what you want in natural language:
+
+```
+add input validation to the user registration form
+```
+
+Or fix existing issues:
+
+```
+there's a bug where users can submit empty forms - fix it
+```
+
+Qwen Code will:
+
+- Locate the relevant code
+- Understand the context
+- Implement a solution
+- Run tests if available
+
+### Test out other common workflows
+
+There are a number of ways to work with Qwen Code:
+
+**Refactor code**
+
+```
+refactor the authentication module to use async/await instead of callbacks
+```
+
+**Write tests**
+
+```
+write unit tests for the calculator functions
+```
+
+**Update documentation**
+
+```
+update the README with installation instructions
+```
+
+**Code review**
+
+```
+review my changes and suggest improvements
+```
+
+> [!tip]
+>
+> **Remember**: Qwen Code is your AI pair programmer. Talk to it like you would a helpful colleague - describe what you want to achieve, and it will help you get there.
+
+## Essential commands
+
+Here are the most important commands for daily use:
+
+| Command               | What it does                                     | Example                       |
+| --------------------- | ------------------------------------------------ | ----------------------------- |
+| `qwen`                | start Qwen Code                                  | `qwen`                        |
+| `/auth`               | Change authentication method (in session)        | `/auth`                       |
+| `qwen auth`           | Configure authentication from the terminal       | `qwen auth`                   |
+| `qwen auth status`    | Check current authentication status              | `qwen auth status`            |
+| `/help`               | Display help information for available commands  | `/help` or `/?`               |
+| `/compress`           | Replace chat history with summary to save Tokens | `/compress`                   |
+| `/clear`              | Clear terminal screen content                    | `/clear` (shortcut: `Ctrl+L`) |
+| `/theme`              | Change Qwen Code visual theme                    | `/theme`                      |
+| `/language`           | View or change language settings                 | `/language`                   |
+| → `ui [language]`     | Set UI interface language                        | `/language ui zh-CN`          |
+| → `output [language]` | Set LLM output language                          | `/language output Chinese`    |
+| `/quit`               | Exit Qwen Code immediately                       | `/quit` or `/exit`            |
+
+See the [CLI reference](./features/commands) for a complete list of commands.
+
+## Pro tips for beginners
+
+**Be specific with your requests**
+
+- Instead of: "fix the bug"
+- Try: "fix the login bug where users see a blank screen after entering wrong credentials"
+
+**Use step-by-step instructions**
+
+- Break complex tasks into steps:
+
+```
+1. create a new database table for user profiles
+2. create an API endpoint to get and update user profiles
+3. build a webpage that allows users to see and edit their information
+```
+
+**Let Qwen Code explore first**
+
+- Before making changes, let Qwen Code understand your code:
+
+```
+analyze the database schema
+```
+
+```
+build a dashboard showing products that are most frequently returned by our UK customers
+```
+
+**Save time with shortcuts**
+
+- Press `?` to see all available keyboard shortcuts
+- Use Tab for command completion
+- Press ↑ for command history
+- Type `/` to see all slash commands
+
+## Getting help
+
+- **In Qwen Code**: Type `/help` or ask "how do I..."
+- **Documentation**: You're here! Browse other guides
+- **Community**: Join our [GitHub Discussion](https://github.com/QwenLM/qwen-code/discussions) for tips and support

package/dist/bundled/qc-helper/docs/reference/_meta.ts

@@ -0,0 +1,4 @@
+export default {
+  'keyboard-shortcuts': 'Keyboard Shortcuts',
+  'sdk-api': 'SDK API Reference',
+};

package/dist/bundled/qc-helper/docs/reference/keyboard-shortcuts.md

@@ -0,0 +1,72 @@
+# Qwen Code Keyboard Shortcuts
+
+This document lists the available keyboard shortcuts in Qwen Code.
+
+## General
+
+| Shortcut                       | Description                                                                                                           |
+| ------------------------------ | --------------------------------------------------------------------------------------------------------------------- |
+| `Esc`                          | Close dialogs and suggestions.                                                                                        |
+| `Ctrl+C`                       | Cancel the ongoing request and clear the input. Press twice to exit the application.                                  |
+| `Ctrl+D`                       | Exit the application if the input is empty. Press twice to confirm.                                                   |
+| `Ctrl+L`                       | Clear the screen.                                                                                                     |
+| `Ctrl+O`                       | Toggle the display of the debug console.                                                                              |
+| `Ctrl+S`                       | Allows long responses to print fully, disabling truncation. Use your terminal's scrollback to view the entire output. |
+| `Ctrl+T`                       | Toggle the display of tool descriptions.                                                                              |
+| `Shift+Tab` (`Tab` on Windows) | Cycle approval modes (`plan` → `default` → `auto-edit` → `yolo`)                                                      |
+
+## Input Prompt
+
+| Shortcut                                           | Description                                                                                                                         |
+| -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
+| `!`                                                | Toggle shell mode when the input is empty.                                                                                          |
+| `?`                                                | Toggle keyboard shortcuts display when the input is empty.                                                                          |
+| `\` (at end of line) + `Enter`                     | Insert a newline.                                                                                                                   |
+| `Down Arrow`                                       | Navigate down through the input history.                                                                                            |
+| `Enter`                                            | Submit the current prompt.                                                                                                          |
+| `Meta+Delete` / `Ctrl+Delete`                      | Delete the word to the right of the cursor.                                                                                         |
+| `Tab`                                              | Autocomplete the current suggestion if one exists.                                                                                  |
+| `Up Arrow`                                         | Navigate up through the input history.                                                                                              |
+| `Ctrl+A` / `Home`                                  | Move the cursor to the beginning of the line.                                                                                       |
+| `Ctrl+B` / `Left Arrow`                            | Move the cursor one character to the left.                                                                                          |
+| `Ctrl+C`                                           | Clear the input prompt                                                                                                              |
+| `Esc` (double press)                               | Clear the input prompt.                                                                                                             |
+| `Ctrl+D` / `Delete`                                | Delete the character to the right of the cursor.                                                                                    |
+| `Ctrl+E` / `End`                                   | Move the cursor to the end of the line.                                                                                             |
+| `Ctrl+F` / `Right Arrow`                           | Move the cursor one character to the right.                                                                                         |
+| `Ctrl+H` / `Backspace`                             | Delete the character to the left of the cursor.                                                                                     |
+| `Ctrl+K`                                           | Delete from the cursor to the end of the line.                                                                                      |
+| `Ctrl+Left Arrow` / `Meta+Left Arrow` / `Meta+B`   | Move the cursor one word to the left.                                                                                               |
+| `Ctrl+N`                                           | Navigate down through the input history.                                                                                            |
+| `Ctrl+P`                                           | Navigate up through the input history.                                                                                              |
+| `Ctrl+R`                                           | Reverse search through input/shell history.                                                                                         |
+| `Ctrl+Y`                                           | Retry the last failed request.                                                                                                      |
+| `Ctrl+Right Arrow` / `Meta+Right Arrow` / `Meta+F` | Move the cursor one word to the right.                                                                                              |
+| `Ctrl+U`                                           | Delete from the cursor to the beginning of the line.                                                                                |
+| `Ctrl+V` (Windows: `Alt+V`)                        | Paste clipboard content. If the clipboard contains an image, it will be saved and a reference to it will be inserted in the prompt. |
+| `Ctrl+W` / `Meta+Backspace` / `Ctrl+Backspace`     | Delete the word to the left of the cursor.                                                                                          |
+| `Ctrl+X` / `Meta+Enter`                            | Open the current input in an external editor.                                                                                       |
+
+## Suggestions
+
+| Shortcut        | Description                            |
+| --------------- | -------------------------------------- |
+| `Down Arrow`    | Navigate down through the suggestions. |
+| `Tab` / `Enter` | Accept the selected suggestion.        |
+| `Up Arrow`      | Navigate up through the suggestions.   |
+
+## Radio Button Select
+
+| Shortcut           | Description                                                                                                   |
+| ------------------ | ------------------------------------------------------------------------------------------------------------- |
+| `Down Arrow` / `j` | Move selection down.                                                                                          |
+| `Enter`            | Confirm selection.                                                                                            |
+| `Up Arrow` / `k`   | Move selection up.                                                                                            |
+| `1-9`              | Select an item by its number.                                                                                 |
+| (multi-digit)      | For items with numbers greater than 9, press the digits in quick succession to select the corresponding item. |
+
+## IDE Integration
+
+| Shortcut | Description                       |
+| -------- | --------------------------------- |
+| `Ctrl+G` | See context CLI received from IDE |