SmartPromptor
一个智能提示词增强和Python错误监控的VSCode/Cursor插件,集成MCP (Model Context Protocol) 服务。
功能特性
1. 智能提示词增强
- MCP服务集成: 通过本地MCP服务器提供智能提示词增强
- 实时优化: 自动优化用户输入的提示词,提供更精确的AI响应
- 上下文感知: 基于当前项目和文件上下文进行智能增强
2. 🛠️ MCP工具可选择配置
- 个性化工具选择: 用户可以根据需求选择启用的MCP提示词增强工具
- 首次设置向导: 插件安装后自动显示友好的配置引导界面
- 可视化配置面板: 提供直观的WebView配置界面,支持实时状态监控
- 快速配置选项: 通过命令面板快速选择和配置工具
- 分类管理: 工具按功能分类(开发、调试、管理、文档、分析)便于管理
- 动态工具注册: 只加载用户启用的工具,提升性能和响应速度
- 简化操作界面: 提示词模板配置界面专注于核心功能,移除冗余操作按钮,提供更清晰的用户体验
3. 可配置的MCP工具
- 🚀 功能创新增强 - 防止硬编码和假数据的新功能开发(默认启用)
- 🐛 Bug分析修复 - 系统性问题分析和精确修复方案(默认启用)
- ✅ 任务完成助手 - 自动化收尾工作和文档更新(默认启用)
- 📝 文档更新助手 - 智能识别和更新项目文档(默认启用)
- 🔍 项目分析助手 - 代码分析和知识沉淀(默认启用)
- 🔒 方案固化助手 - 防止确认方案被意外修改(可选启用)
界面优化: 提示词模板配置界面已优化简化,专门展示上述专业化功能模块,移除了通用的"加载默认"按钮,减少界面复杂度,用户可通过"重置"和"保存"按钮完成所有必要操作。
4. 多语言错误监控
- 实时错误捕获: 自动监控多种编程语言的脚本错误
- 智能错误分析: 基于MCP服务的错误分析和修复建议
- 支持语言: Python、JavaScript、TypeScript、Java、C#、Go等
安装指南
前置要求
- VSCode 1.85.0+ 或 Cursor 最新版本
- Node.js 18.0+
- Python 3.8+(用于错误监控功能)
1. 插件安装
# 通过VSCode市场安装
# 或者从本地安装
code --install-extension smart-promptor-x.x.x.vsix
2. MCP服务器配置
插件首次启动时会自动配置MCP服务器,或手动配置:
{
"mcpServers": {
"smart-promptor-mcp": {
"command": "node",
"args": ["path/to/mcp_server/mcp_server.js"],
"env": {
"SMART_PROMPTOR_CONFIG": "path/to/config.json"
}
}
}
}
3. 工具配置
- 打开VSCode/Cursor
- 按下
Ctrl+Shift+P
(Windows/Linux) 或 Cmd+Shift+P
(macOS)
- 输入 "SmartPromptor: 配置MCP工具"
- 在弹出的配置面板中选择需要启用的工具
使用指南
基本用法
- 智能提示词增强: 在编辑器中输入提示词,插件会自动检测并提供优化建议
- 错误监控: 运行脚本时自动捕获错误并提供修复建议
- 工具配置: 通过配置面板自定义启用的MCP工具
高级功能
- 上下文感知: 插件会根据当前文件类型和项目结构提供相关建议
- 批量处理: 支持对多个文件进行批量分析和优化
- 自定义规则: 可以配置自定义的提示词优化规则
配置选项
MCP工具配置
{
"smart-promptor.mcpTools": {
"enhance_feature_innovation": true,
"enhance_bug_analysis_and_fix": true,
"enhance_task_completion": true,
"enhance_documentation_update": true,
"enhance_project_analysis": true,
"enhance_solution_consolidation": false
}
}
错误监控配置
{
"smart-promptor.errorMonitoring": {
"enabled": true,
"languages": ["python", "javascript", "typescript"],
"autoFix": false,
"logLevel": "info"
}
}
提示词模板配置
- 自定义模板: 支持为不同场景创建自定义提示词模板
- 模板管理: 通过配置界面管理和编辑提示词模板
- 简化操作: 配置界面提供"重置"和"保存"功能,操作简洁高效
故障排除
常见问题
MCP服务器连接失败
- 检查Node.js版本是否满足要求
- 确认MCP服务器配置路径正确
- 查看输出面板中的错误日志
提示词增强不工作
- 确认已启用相关MCP工具
- 检查网络连接
- 重启VSCode/Cursor
错误监控不生效
- 确认Python环境配置正确
- 检查sitecustomize.py是否正确安装
- 查看错误监控日志
日志和调试
- 日志位置: 插件会在
logs/
目录下生成详细的运行日志
- 调试模式: 可以通过设置
"smart-promptor.debug": true
启用详细日志
- 错误报告: 遇到问题时,请查看输出面板中的错误信息
开发和贡献
开发环境搭建
# 克隆项目
git clone https://github.com/your-repo/smart-promptor.git
cd smart-promptor
# 安装依赖
npm install
# 启动开发模式
npm run dev
项目结构
SmartPromptor/
├── src/ # 源代码
│ ├── extension.ts # 插件入口
│ ├── services/ # 服务层
│ └── webview/ # WebView组件
├── mcp_server/ # MCP服务器
├── templates/ # 错误监控模板
└── docs/ # 文档
贡献指南
- Fork 项目
- 创建功能分支
- 提交代码变更
- 发起Pull Request
许可证
本项目基于 MIT 许可证开源。详见 LICENSE 文件。
更新日志
v1.5.4
- ✨ 优化提示词模板配置界面,移除"加载默认"按钮,简化用户操作流程
- 🔧 改进WebView界面的用户体验,减少界面复杂度
- 📝 更新配置面板的操作说明文本
v1.5.3
- 🔧 修复MCP服务器连接稳定性问题
- ✨ 新增多用户配置支持
- 📝 完善文档和使用指南
v1.5.2
- 🐛 修复错误监控在某些环境下不工作的问题
- ✨ 增强提示词优化算法
- 🔧 改进配置界面的响应性能
支持和反馈
SmartPromptor - 让AI编程更智能、更高效!