目录

Qwen Code Assistant 🤖

基于本地Qwen3.5-0.8B模型的智能代码生成工具,包含模型推理服务和VS Code插件两部分。

📁 项目结构

QwenCodeAssistant/
├── model-server/          # Python模型推理服务
│   ├── model_service.py   # 主服务程序
│   ├── start_service.py   # 启动脚本
│   ├── start_service.bat  # Windows批处理启动
│   ├── requirements.txt   # Python依赖
│   └── README.md          # 服务说明文档
├── vscode-extension/      # VS Code插件
│   ├── src/
│   │   ├── extension.js   # 插件入口
│   │   └── panel.js       # 侧边栏面板
│   ├── package.json       # 插件配置
│   ├── build.bat          # 打包脚本
│   └── README.md          # 插件说明文档
├── start_all.bat          # 一键启动脚本
└── README.md              # 本文件

🚀 快速开始

⚠️ 重要提示:路径编码问题

如果你的项目路径包含中文字符(如”2025秋 课程”),请使用以下方式之一启动:

方案1 - Conda环境(推荐Anaconda用户)

cd model-server
start_with_conda.bat

方案2 - 修复版脚本

cd model-server
start_service.bat

方案3 - 手动安装

cd model-server
python install_deps.py
python model_service.py

方式1: 一键启动

# 在项目根目录下运行
start_all.bat

方式2: 分步启动

1. 启动模型服务

cd model-server
python start_service.py
# 或
start_service.bat

服务将运行在: http://127.0.0.1:5000

2. 安装VS Code插件

方式A: 开发模式

cd vscode-extension
# 在VS Code中按F5运行

方式B: 打包安装

cd vscode-extension
build.bat
# 然后在VS Code中安装生成的 .vsix 文件

📋 系统要求

模型服务

  • Python 3.8+
  • 8GB+ RAM(推荐16GB)
  • 约2GB磁盘空间(用于模型文件)

VS Code插件

  • VS Code 1.74.0+

⚙️ 配置说明

模型服务配置

启动参数:

python model_service.py [选项]

选项:
  --model-path PATH    指定模型路径
  --host HOST         服务主机地址 (默认: 127.0.0.1)
  --port PORT         服务端口 (默认: 5000)
  --load-model        启动时加载模型

VS Code插件配置

在VS Code设置中搜索 “Qwen Code Assistant”:

配置项 说明 默认值
serverUrl 模型服务地址 http://127.0.0.1:5000
maxLength 生成代码最大长度 2048
temperature 生成温度 0.7
topP Top-p采样值 0.9

🎯 使用指南

  1. 启动模型服务: 运行 start_service.py
  2. 打开插件面板: 点击VS Code左侧的Qwen图标或使用 Ctrl+Shift+Q
  3. 输入提示词: 描述你想要生成的代码
  4. 生成代码: 点击按钮或按 Ctrl+Enter
  5. 使用代码: 插入编辑器或复制到剪贴板

提示词示例

写一个Python函数计算斐波那契数列
用JavaScript实现一个防抖函数
创建一个React组件显示用户列表,包含姓名、邮箱和操作按钮

🔧 故障排除

模型服务无法启动

问题: 缺少依赖
解决: 确保已安装requirements.txt中的所有依赖

问题: CUDA out of memory
解决: 减小max_length参数,或修改代码使用CPU运行

问题: 找不到模型文件
解决: 确保Qwen3___5-0___8B文件夹在正确位置,或手动指定路径

插件无法连接服务

问题: 连接失败
解决:

  1. 确保模型服务已启动
  2. 检查VS Code设置中的serverUrl配置
  3. 点击插件面板的刷新按钮检查状态

代码生成质量不佳

建议:

  • 提供更详细的描述
  • 调整temperature参数
  • 指定具体的编程语言和框架

📚 API文档

模型服务提供以下REST API:

健康检查

GET /health

代码生成

POST /generate
Content-Type: application/json

{
  "prompt": "写一个Python函数",
  "max_length": 2048,
  "temperature": 0.7,
  "top_p": 0.9
}

模型列表

GET /models

📝 更新日志

v1.0.0 (2026-03-05)

  • 初始版本发布
  • 支持Qwen3.5-0.8B模型
  • 实现基本的代码生成功能
  • 提供VS Code插件界面

📄 许可证

MIT License

🙏 致谢


📚 实践任务:AI4SE工具调研分析

2025年11月10日

主要围绕大模型驱动软件开发,从需求分析、系统设计、编码实现、集成测试、部署运维等不同软件生命周期,调研分析当前业界和开源社区中的智能化支撑工具和服务。每个工具主要包括以下几个方面:

  • (1)工具名称
  • (2)支撑软件开发的阶段<需求分析?设计?代码生成?或者其他>
  • (3)工具链接
  • (4)工具的介绍<可以是相关博客链接或者自己总结撰写>
  • (5)工具评价<本次可以简单使用体验并给出初步评价,后续课程报告可以做深度分析评估>
关于

聚集AI4SE领域,开展开源工具调研分析、新工具开发等实践

21.3 MB
邀请码
    Gitlink(确实开源)
  • 加入我们
  • 官网邮箱:gitlink@ccf.org.cn
  • QQ群
  • QQ群
  • 公众号
  • 公众号

版权所有:中国计算机学会技术支持:开源发展技术委员会
京ICP备13000930号-9 京公网安备 11010802032778号