docker-compose.yml

services:
  cursor2api:
    build:
      context: .
      dockerfile: Dockerfile
    image: cursor2api:latest
    container_name: cursor2api
    restart: unless-stopped
    ports:
      - "3010:3010"
    volumes:
      # 挂载配置文件（可选）——先从 config.yaml.example 复制一份: cp config.yaml.example config.yaml
      # 修改后只需 docker compose restart 即可生效；不挂载则使用内置默认值 + 环境变量
      - ./config.yaml:/app/config.yaml
      # 日志持久化目录（需要在 config.yaml 或环境变量中开启 logging.file_enabled）
      - ./logs:/app/logs
    environment:
      - NODE_ENV=production
      - PORT=3010
      - TIMEOUT=120
      # ⚠️ 部署到海外机器无需代理，如果在国内云，取消注释并填入你的本机 http/socks 代理
      # - PROXY=http://host.docker.internal:7890

      # [可选环境变量] 以下变量如果声明，将会覆盖 config.yaml 中对应的配置：
      - CURSOR_MODEL=google/gemini-3-flash

      # ── API 鉴权 ──
      # 公网部署时强烈建议开启，多个 token 用逗号分隔
      # - AUTH_TOKEN=sk-your-secret-token-1,sk-your-secret-token-2

      # ── Thinking 开关（最高优先级，覆盖 config.yaml） ──
      # true=始终启用思考链, false=强制关闭
      # - THINKING_ENABLED=true

      # ── 历史消息压缩（推荐开启） ──
      # - COMPRESSION_ENABLED=true
      # - COMPRESSION_LEVEL=2

      # ── 自动续写 & 历史消息限制 ──
      # - MAX_AUTO_CONTINUE=0          # 截断后自动续写次数，0=禁用(默认)
      # - MAX_HISTORY_MESSAGES=-1      # 历史消息条数上限，-1=不限制（建议改用 MAX_HISTORY_TOKENS）
      # - MAX_HISTORY_TOKENS=120000    # 示例推荐值；程序内置默认仍为 150000，更保守以减少长输出/长工具参数截断

      # ── 日志持久化（⚠️ 修改后需重启容器生效） ──
      # 方式一：JSONL 文件（日志量小时使用）
      # - LOG_FILE_ENABLED=true
      # - LOG_DIR=./logs
      # 方式二：SQLite（推荐，避免大文件 OOM，支持重启后历史查询）
      # - LOG_DB_ENABLED=true
      # - LOG_DB_PATH=./logs/cursor2api.db

      # ── 浏览器指纹（base64 JSON） ──
      # - FP=eyJ1c2VyQWdlbnQiOiIuLi4ifQ==

      # ── Vision 图片处理 ──
      # 默认使用本地 OCR（零配置），如需外部 Vision API 请在 config.yaml 中修改 vision.mode 为 'api'
      # 并配置 vision.base_url / vision.api_key / vision.model

      # ── 工具模式推荐（Claude Code / Cursor Agent） ──
      # 推荐在 config.yaml 中保持：
      #   tools.schema_mode: compact
      #   tools.description_max_length: 100
      #   tools.passthrough: false
      #   tools.disabled: false
      #
      # Roo Code / Cline 等非 Claude Code 客户端如遇到工具识别冲突，再考虑启用透传模式：
      # - TOOLS_PASSTHROUGH=true

      # ── 工具禁用模式（极致省上下文） ──
      # 完全不注入工具定义和 few-shot，模型凭训练记忆调用工具
      # 仅在极端省上下文场景下再启用，日常推荐保持 false（由 config.yaml 管理）
      # - TOOLS_DISABLED=true

      # ── 上下文压力膨胀（防截断） ──
      # 虚增 input_tokens 让 Claude Code 提前触发自动压缩，有效减少 max_output_token 截断
      # 1.35 = 200K(Claude Code假设窗口) / 150K(Cursor实际窗口)，设 1.0 关闭
      # - CONTEXT_PRESSURE=1.35

      # ── 自适应历史预算 ──
      # 工具数量越多，自动预留越多输出空间（90工具约多留 8K tokens）
      # - TOOLS_ADAPTIVE_BUDGET=true

      # ── 智能截断 ──
      # 按工具类型差异化截断结果（Read/Bash/Search 各用不同头尾比例）
      # - TOOLS_SMART_TRUNCATION=true

      # ── Stealth 代理（绕过 Vercel Bot Protection） ──
      # 镜像已内置 stealth-proxy，设置 ENABLE_STEALTH=true 即可自动启动
      # 无需额外容器，stealth-proxy 在同一容器内运行并自动连接
      - ENABLE_STEALTH=true

      # ── 响应内容清洗 ──
      # 开启后会将响应中 Cursor 身份引用替换为 Claude（默认关闭）
      # - SANITIZE_RESPONSE=true

      # ── 自定义拒绝检测规则 ──
      # 仅支持 config.yaml 配置（无环境变量覆盖），详见 config.yaml.example 中的 refusal_patterns 节