Cursor Assistant - 纯Python实现
一个智能的Cursor助手工具，使用Python标准库实现，无需安装额外依赖。
🎯 功能特性
- 智能文件拦截 - 自动拦截Cursor生成的无用文件（如.md、.txt、test_等），在命令行显示内容
- 自动代码同步 - 当Cursor生成后端代码时，自动同步到服务器
- 命令智能重定向 - 自动识别后端命令并重定向到服务器执行
- 一次配置，永久使用 - 配置一次后，自动监控Cursor的所有操作
🚀 快速开始
1. 安装插件
python install.py
2. 配置服务器信息
编辑配置文件 ~/.cursor_assistant.json：
{
"server": {
"host": "你的服务器地址",
"port": 22,
"username": "你的用户名",
"password": "你的密码",
"work_dir": "服务器工作目录"
}
}
3. 启动插件
python start.py
4. 自动监控
插件将自动：
- 监控当前目录的文件变化
- 拦截无用文件并显示内容
- 自动同步有用文件到服务器
- 重定向后端命令到服务器执行
📋 使用说明
自动化工作流程
- 首次运行：程序检测到未配置，提示你编辑配置文件
- 配置完成：程序自动进入监控模式
- 日常使用：直接运行程序，自动进入监控模式
- 重新配置：编辑配置文件
~/.cursor_assistant.json 即可重新配置
首次运行提示
🚀 Cursor Assistant 首次运行
==================================================
📋 请先配置服务器信息，然后重启插件
🔧 配置步骤:
1. 打开配置文件: ~/.cursor_assistant.json
2. 修改以下字段:
- host: 你的服务器地址
- username: 你的用户名
- password: 你的密码
- work_dir: 服务器工作目录
📁 配置文件位置: ~/.cursor_assistant.json
💡 配置完成后，插件将自动开始监控
⚠️ 请配置完成后重新启动插件
文件拦截规则
默认拦截以下类型的文件：
.md 文件（Markdown文档）.txt 文件（文本文件）test_ 开头的文件（测试文件）__pycache__ 目录.git 目录
自动同步
- 当检测到新文件时，自动使用
scp 命令同步到服务器
- 只同步不在拦截列表中的文件
- 同步到配置的服务器工作目录
命令重定向
- 使用
ssh 命令在服务器上执行命令
- 自动切换到服务器工作目录
- 显示命令执行结果
🔧 配置说明
配置文件位置：~/.cursor_assistant.json
{
"server": {
"host": "192.168.1.100",
"port": 22,
"username": "root",
"password": "password",
"work_dir": "/var/www/html"
},
"local": {
"monitor_dir": "/path/to/your/project",
"exclude_files": [".md", ".txt", "test_", "__pycache__", ".git"]
},
"auto_sync": true,
"command_redirect": true
}
📝 使用场景
场景1：首次配置
🚀 Cursor Assistant 启动
==================================================
📋 首次运行，请选择操作:
1. 配置服务器信息
2. 查看配置说明
0. 退出
请选择 (0-2): 1
🔧 配置后端服务器信息
==================================================
服务器地址 (例: 192.168.1.100): 192.168.1.100
用户名: root
密码: ******
服务器工作目录 (例: /var/www/html): /var/www/html
✅ 服务器配置已保存
🔍 测试服务器连接...
✅ 服务器连接正常
✅ 配置完成，开始自动监控...
场景2：日常使用（已配置）
🚀 Cursor Assistant 启动
==================================================
✅ 检测到已有配置，进入自动监控模式
💡 如需重新配置，请删除配置文件: ~/.cursor_assistant.json
🚀 Cursor Assistant - 自动监控模式
==================================================
✅ 配置完成，开始自动监控...
💡 提示：按 Ctrl+C 停止监控
👀 开始监控目录: /path/to/your/project
🎯 监控模式: 自动拦截无用文件，同步后端代码
场景3：拦截无用文件
🚫 拦截文件: README.md
============================================================
# 项目说明
这是一个示例项目...
============================================================
💡 这是一个被拦截的文件，内容已显示在命令行
是否删除此文件? (y/N): y
✅ 文件已删除
场景4：自动同步代码
🆕 检测到新文件: app.py
📤 同步文件到服务器: app.py
✅ 文件同步成功
场景5：命令重定向
🎯 检测到后端命令: python app.py
🔄 重定向到服务器执行...
🖥️ 在服务器执行: python app.py
✅ 命令执行成功
输出: 服务器启动成功
⚠️ 注意事项
- 依赖要求：需要系统安装
ssh 和 scp 命令
- 权限要求：需要SSH访问服务器的权限
- 网络要求：需要能够访问配置的服务器地址
- 文件监控：监控当前工作目录，按Ctrl+C停止
🛠️ 技术实现
- 纯Python标准库：无需安装额外依赖
- 文件监控：使用
os.walk() 定期扫描目录
- SSH连接：使用
subprocess 调用系统SSH命令
- 配置管理：使用JSON文件存储配置
- 跨平台：支持Windows、Linux、macOS
📄 许可证
MIT License
