OpenCursor

环境要求

• VS Code 1.96 或更高版本
• 一个可用的模型来源：支持的账号 / 自有 API Key，或本地 Ollama、llama.cpp
• 首次使用部分功能需联网下载原生运行时或模型文件（离线使用前需先准备好）

安装与启动步骤

1. 1确认 VS Code 版本

   打开 VS Code，在“帮助 → 关于”中确认版本不低于 1.96，否则需先升级编辑器。

2. 2安装扩展

   在 VS Code 扩展市场搜索并安装 OpenCursor Agent；也可从 GitHub Releases 下载 .vsix，用命令面板的“Extensions: Install from VSIX”安装。

3. 3配置模型来源

   打开 OpenCursor 侧边栏进入 Settings，在 Providers 中添加账号或 API 提供商；想用本地模型则在 Providers 中配置 Ollama 或 llama.cpp。

4. 4启用并选择模型

   在 Models 里启用你要用的模型，然后在输入框（composer）中选择该模型，直接描述你的编码任务。

5. 5把代码加入对话

   在编辑器里选中代码，按 Ctrl+L（macOS 为 Cmd+L）即可把选中内容作为上下文加入聊天。

6. 6审查改动结果

   查看工具活动与文件改动，决定保留还是撤销；用权限控制设置哪些操作需要你手动批准。

关键配置

如何确认成功

侧边栏能看到 OpenCursor 面板，Settings 中模型显示已连接，在 composer 发起对话能正常收到回复。

常见问题

注意事项

• 安装前请确认 VS Code 版本 ≥ 1.96，低版本无法安装。
• 优先从 VS Code Marketplace 安装；用 .vsix 离线安装时走命令面板的“Extensions: Install from VSIX”。
• 首次使用某些功能会请求下载运行时或模型文件，建议提前在联网环境准备。
• 对话中 AI 会读写文件、运行命令，务必逐条审查改动并善用权限控制再决定保留或撤销。