Devin.cursorrules：增强Cursor IDE开发体验，将Cursor/Windsurf打造成类Devin智能编程助手

综合介绍

Devin.cursorrules 是一个创新的开源项目，旨在将价格实惠的Cursor或Windsurf IDE（约20美元）转换为类似 Devin 这样强大的AI编程助手。该项目提供了一套完整的配置文件和工具集，能够为IDE注入智能代理AI功能，显著提升开发效率。核心特性包括智能流程规划、自我进化能力、扩展工具使用（支持网页浏览、搜索和基于LLM的分析），以及在Docker容器中实现自动化执行（针对Windsurf用户）。项目采用MIT许可证，允许开发者自由使用和修改。通过简单的配置，开发者可以在短短一分钟内将基础IDE提升为具备高级AI助手功能的强大开发工具。

相关介绍：一小时内将Cursor和Windsurf改造成价值500美元/月的Devin

SVG放大版流程

功能列表

• 智能流程规划和自我进化能力
• 网页抓取功能（基于Playwright，支持JavaScript渲染）
• 搜索引擎集成（集成DuckDuckGo搜索）
• LLM驱动的文本分析（支持自定义模型）
• 自动化执行环境（Windsurf Docker容器支持）
• 完整的单元测试套件
• 跨平台支持（Windows/Unix/macOS）
• 模块化工具集成系统
• 高级网页内容提取和处理
• 异步并发请求处理
• DEBUG日志系统

使用帮助

1. 环境配置

首先需要配置Python虚拟环境，确保项目依赖不会影响系统环境：

# 创建Python虚拟环境
python3 -m venv py310
# 激活虚拟环境
# Windows系统:
.\py310\Scripts\activate
# Unix/macOS系统:
source py310/bin/activate

2. 安装必要组件

项目依赖安装过程：

# 安装所需包
pip install -r requirements.txt
# 安装Playwright的Chromium浏览器（用于网页抓取）
python -m playwright install chromium

3. 配置文件部署

1. 将仓库中的所有文件复制到您的项目目录
2. Cursor用户：
   • .cursorrules文件会被自动加载
   • 无需额外配置
3. Windsurf用户：
   • 需同时使用.windsurfrules和scratchpad.md
   • 确保文件位于正确的目录位置

4. 功能模块使用说明

4.1 网页抓取功能

• 支持JavaScript渲染的网页内容抓取
• 自动处理编码问题，支持国际化内容
• 并发请求处理，提高效率
• 使用示例：

from tools.web_scraper import process_urls
urls = ["https://example.com"]
results = await process_urls(urls)

4.2 搜索引擎集成

• 使用DuckDuckGo后端
• 支持自定义搜索结果数量
• 提供详细的搜索结果信息
• 使用示例：

from tools.search_engine import search
search("your query", max_results=10)

4.3 LLM集成

• 支持自定义LLM服务器
• 默认使用Qwen2.5-32B模型
• 可配置温度参数
• 使用示例：

from tools.llm_api import query_llm
response = query_llm("your prompt")

5. 测试与验证

项目提供完整的测试套件：

# 确保在虚拟环境中
source py310/bin/activate
# 运行所有测试
PYTHONPATH=. python -m unittest discover tests/

6. 故障排除

• 如果LLM服务未配置，相关功能会优雅降级
• 网络问题可查看stderr的DEBUG信息
• 确保Python版本兼容（推荐Python 3.10+）
• 检查依赖包版本是否正确