src/config/cursor-config.env.example

# =================================================================
# Cursor AI 配置环境变量
# 复制此文件为 cursor-config.env 并根据需要修改配置
# =================================================================

# =================================================================
# 🎯 核心模式设置
# =================================================================

# MAX模式开关 - 启用增强AI能力，提供更深入的分析和建议
CURSOR_MAX_MODE_ENABLED=true

# Agent模式开关 - 启用智能代理功能，可以执行复杂的多步骤任务
CURSOR_AGENT_MODE=true

# 统一模式 - 整合多种功能模式，提供一致的用户体验
CURSOR_UNIFIED_MODE=1

# 聊天模式枚举值 - 控制对话交互的行为模式 (0=简单问答, 1=对话模式, 2=协作模式)
CURSOR_CHAT_MODE_ENUM=2

# 聊天模式字符串 - 自定义聊天模式名称
CURSOR_CHAT_MODE=collaborative

# 预处理模式开关 - 是否在主要处理前进行环境初始化
CURSOR_PREPROCESSING_FLAG=false

# 流式输出模式 - 控制响应是否实时流式输出 (0=关闭, 1=启用)
CURSOR_STREAM_MODE=1

# 思考级别 - AI的思考深度等级 (0-5, 数值越高思考越深入)
CURSOR_THINKING_LEVEL=3

# =================================================================
# 🤖 模型配置选项
# =================================================================

# 默认模型名称 - 指定使用的AI模型
CURSOR_MODEL_NAME=claude-4-sonnet-thinking

# 启用流式响应 - 是否支持实时响应输出
CURSOR_STREAMING_ENABLED=true

# 最大Token数量 - 单次对话的最大token限制 (影响响应长度)
CURSOR_MAX_TOKENS=4096

# 创造性温度参数 - 控制AI响应的创造性 (0.0-2.0, 越高越有创意)
CURSOR_TEMPERATURE=0.7

# 思考模式开关 - 是否显示AI的思考过程
CURSOR_THINKING_MODE=true

# 思考深度级别 - 思考过程的详细程度 (1-10)
CURSOR_THINKING_DEPTH=5

# =================================================================
# 🛠️ Agent能力配置 - 代码相关功能
# =================================================================

# 代码理解能力 - 分析和理解现有代码的能力
CURSOR_CODE_UNDERSTANDING=true

# 代码生成能力 - 自动生成新代码的能力
CURSOR_CODE_GENERATION=true

# 代码重构能力 - 优化和重构现有代码的能力
CURSOR_CODE_REFACTORING=true

# 调试辅助功能 - 帮助查找和修复代码错误
CURSOR_DEBUGGING_ASSISTANCE=true

# 测试代码生成 - 自动生成单元测试和集成测试
CURSOR_TEST_GENERATION=true

# 错误分析能力 - 深度分析错误原因和解决方案
CURSOR_ERROR_ANALYSIS=true

# =================================================================
# 📁 文件操作能力配置
# =================================================================

# 文件读取权限 - 允许AI读取项目文件内容
CURSOR_FILE_READING=true

# 文件写入权限 - 允许AI创建和修改文件 (谨慎开启)
CURSOR_FILE_WRITING=false

# 文件搜索功能 - 在项目中搜索特定文件和内容
CURSOR_FILE_SEARCH=true

# 文件系统访问 - 更广泛的文件系统操作权限 (谨慎开启)
CURSOR_FILESYSTEM_ACCESS=false

# =================================================================
# 📊 项目分析能力配置
# =================================================================

# 项目结构分析 - 分析项目的整体架构和组织结构
CURSOR_PROJECT_ANALYSIS=true

# 依赖关系分析 - 分析项目的依赖关系和模块间的交互
CURSOR_DEPENDENCY_ANALYSIS=true

# 架构分析 - 深度分析软件架构和设计模式
CURSOR_ARCHITECTURE_ANALYSIS=true

# 性能优化建议 - 提供代码和架构的性能优化建议
CURSOR_PERFORMANCE_OPTIMIZATION=true

# 安全分析功能 - 检查代码中的安全漏洞和风险
CURSOR_SECURITY_ANALYSIS=true

# =================================================================
# 📝 文档和注释功能
# =================================================================

# 文档自动生成 - 根据代码自动生成技术文档
CURSOR_DOCUMENTATION_GENERATION=true

# 代码注释生成 - 为代码添加详细的注释说明
CURSOR_COMMENT_GENERATION=true

# =================================================================
# 🧠 思考配置选项
# =================================================================

# 思考深度级别 - 问题分析的深度 (1-10)
CURSOR_DEPTH_LEVEL=5

# 显示思考过程 - 是否在响应中显示AI的思考步骤
CURSOR_SHOW_THINKING=true

# 逐步分析模式 - 将复杂问题分解为步骤处理
CURSOR_STEP_BY_STEP=true

# 推理链展示 - 显示逻辑推理的完整链条
CURSOR_REASONING_CHAINS=true

# 自我验证机制 - AI对自己的答案进行验证和检查
CURSOR_SELF_VERIFICATION=true

# 提供替代方案 - 为问题提供多种解决方案
CURSOR_ALTERNATIVE_APPROACHES=true

# =================================================================
# 📚 上下文配置选项
# =================================================================

# 最大上下文Token数 - 对话中保持的最大上下文长度
CURSOR_MAX_CONTEXT_TOKENS=8192

# 最大处理文件数 - 单次可以分析的最大文件数量
CURSOR_MAX_FILES=50

# 单个文件大小限制 - 每个文件的最大大小(字节)
CURSOR_MAX_FILE_SIZE=1048576

# 对话历史长度 - 保持的对话轮数
CURSOR_CONVERSATION_HISTORY=10

# 包含编辑历史 - 是否在上下文中包含文件编辑历史
CURSOR_INCLUDE_EDIT_HISTORY=true

# 包含项目结构信息 - 是否在上下文中包含完整项目结构
CURSOR_INCLUDE_PROJECT_STRUCTURE=true

# 包含依赖关系信息 - 是否在上下文中包含依赖关系图
CURSOR_INCLUDE_DEPENDENCIES=true

# 启用大上下文处理 - 处理超长文本和复杂项目
CURSOR_LARGE_CONTEXT=1

# =================================================================
# 🔧 外部工具配置
# =================================================================

# Web搜索功能 - 允许AI进行网络搜索获取最新信息
CURSOR_WEB_SEARCH_ENABLED=false

# 代码执行权限 - 允许AI执行代码进行测试 (高风险功能)
CURSOR_CODE_EXECUTION_ENABLED=false

# 外部API调用 - 允许调用第三方API服务
CURSOR_EXTERNAL_API_CALLS=false

# 数据库访问权限 - 允许访问数据库 (高风险功能)
CURSOR_DATABASE_ACCESS=false

# Wiki工具集成 - 集成Wiki知识库查询
CURSOR_WIKI_TOOL=[]

# Web工具集成 - Web相关工具的启用状态
CURSOR_WEB_TOOL=0

# =================================================================
# ⚙️ 高级控制选项
# =================================================================

# 启用所有最大功能 - 开启所有高级功能 (可能影响性能)
CURSOR_ENABLE_MAX_FEATURES=1

# 流式输出控制 - 精细控制流式输出行为
CURSOR_STREAM_CONTROL_FLAG=1

# Token开始标志 - 控制Token处理的开始时机
CURSOR_TOKEN_START_FLAG=1

# Token控制标志 - 高级Token管理选项
CURSOR_TOKEN_CONTROL_FLAG=1

# 会话跟踪 - 跟踪用户会话状态和历史
CURSOR_SESSION_TRACKING_FLAG=1

# =================================================================
# 🎛️ 请求控制标志
# =================================================================

# 主控制标志 - 全局功能开关
CURSOR_CONTROL_FLAG=true

# 指令处理标志 - 如何处理用户指令
CURSOR_INSTRUCTION_FLAG=1

# 模型选择标志 - 动态模型选择控制
CURSOR_MODEL_FLAG=1

# 请求类型标志 - 请求处理方式控制
CURSOR_REQUEST_FLAG=1

# 反馈收集标志 - 是否收集用户反馈数据
CURSOR_FEEDBACK_FLAG=1

# 期望最大Token数 - 响应的期望最大长度
CURSOR_DESIRED_MAX_TOKENS=2048

# 内容格式 - 响应内容的格式类型
CURSOR_CONTENT_FORMAT=markdown

# =================================================================
# 🌐 系统环境配置
# =================================================================

# 客户端时区设置
CURSOR_TIMEZONE=Asia/Shanghai

# 客户端版本号
CURSOR_CLIENT_VERSION=0.50.5

# 配置版本号 - 配置文件的版本标识
CURSOR_CONFIG_VERSION=v1.0.0

# 项目类型标识 - 帮助AI理解项目性质
CURSOR_PROJECT_TYPE=javascript