CodeShell VSCode 插件常见问题解决方案

CodeShell VSCode 插件常见问题解决方案

codeshell-vscode An intelligent coding assistant plugin for Visual Studio Code, developed based on CodeShell 项目地址: https://gitcode.com/gh_mirrors/co/codeshell-vscode

项目基础介绍

CodeShell VSCode 插件是一个基于 CodeShell 大模型开发的智能编码助手插件，支持 Visual Studio Code。该插件主要用于帮助开发者提高编程效率，支持多种编程语言，包括 Python、Java、C++/C、JavaScript、Go 等。它提供了代码补全、代码解释、代码优化、注释生成、对话问答等功能。

新手使用注意事项及解决方案

1. 环境要求不满足

问题描述：
新手在使用 CodeShell VSCode 插件时，可能会遇到环境要求不满足的问题，例如 Node.js 版本低于 v18 或 Visual Studio Code 版本低于 1.68.1。

解决步骤：

1. 检查 Node.js 版本：
   打开终端，输入以下命令检查 Node.js 版本：

   node -v
   

   如果版本低于 v18，请访问 Node.js 官网 下载并安装最新版本的 Node.js。

2. 检查 Visual Studio Code 版本：
   打开 Visual Studio Code，点击左下角的齿轮图标，选择“关于”选项，查看当前版本。如果版本低于 1.68.1，请访问 Visual Studio Code 官网 下载并安装最新版本。

2. 模型服务未启动

问题描述：
新手在安装插件后，可能会遇到模型服务未启动的问题，导致插件无法正常工作。

解决步骤：

1. 下载模型：
   从 Hugging Face Hub 下载 CodeShell-7B-Chat-int4 模型，并将其放置在 llama_cpp_for_codeshell/models 文件夹中。

2. 启动模型服务：
   在终端中进入 llama_cpp_for_codeshell 目录，执行以下命令启动模型服务：

   ./server -m ./models/codeshell-chat-q4_0.gguf --host 127.0.0.1 --port 8080
   

3. 检查服务状态：
   使用浏览器访问 http://127.0.0.1:8080，确认模型服务是否正常运行。

3. 插件安装失败

问题描述：
新手在安装 CodeShell VSCode 插件时，可能会遇到安装失败的问题。

解决步骤：

1. 检查网络连接：
   确保网络连接正常，能够访问 GitHub 和 npm 仓库。

2. 清理缓存：
   在终端中执行以下命令清理 npm 缓存：

   npm cache clean --force
   

3. 重新安装插件：
   在终端中进入 codeshell-vscode 目录，执行以下命令重新安装插件：

   npm install
   npm exec vsce package
   

4. 手动安装插件：
   生成的 .vsix 文件可以通过 Visual Studio Code 的扩展管理界面手动安装。

通过以上步骤，新手可以顺利解决在使用 CodeShell VSCode 插件时遇到的常见问题，确保插件能够正常运行并提高编程效率。

codeshell-vscode An intelligent coding assistant plugin for Visual Studio Code, developed based on CodeShell 项目地址: https://gitcode.com/gh_mirrors/co/codeshell-vscode