diff --git a/Images/PixPin_2026-02-24_21-59-43.png b/Images/PixPin_2026-02-24_21-59-43.png new file mode 100644 index 0000000..a5380ee Binary files /dev/null and b/Images/PixPin_2026-02-24_21-59-43.png differ diff --git a/Images/PixPin_2026-02-24_22-00-30.png b/Images/PixPin_2026-02-24_22-00-30.png new file mode 100644 index 0000000..7f07e24 Binary files /dev/null and b/Images/PixPin_2026-02-24_22-00-30.png differ diff --git a/Images/PixPin_2026-02-24_22-01-04.png b/Images/PixPin_2026-02-24_22-01-04.png new file mode 100644 index 0000000..65e845b Binary files /dev/null and b/Images/PixPin_2026-02-24_22-01-04.png differ diff --git a/Images/PixPin_2026-02-24_22-12-42.png b/Images/PixPin_2026-02-24_22-12-42.png new file mode 100644 index 0000000..1e99025 Binary files /dev/null and b/Images/PixPin_2026-02-24_22-12-42.png differ diff --git a/Images/PixPin_2026-02-24_22-13-17.png b/Images/PixPin_2026-02-24_22-13-17.png new file mode 100644 index 0000000..81eaaad Binary files /dev/null and b/Images/PixPin_2026-02-24_22-13-17.png differ diff --git a/Images/PixPin_2026-02-24_22-13-25.png b/Images/PixPin_2026-02-24_22-13-25.png new file mode 100644 index 0000000..567479c Binary files /dev/null and b/Images/PixPin_2026-02-24_22-13-25.png differ diff --git a/Images/add-custom-model.png b/Images/add-custom-model.png new file mode 100644 index 0000000..45c88a4 Binary files /dev/null and b/Images/add-custom-model.png differ diff --git a/Images/aiberm-models.png b/Images/aiberm-models.png new file mode 100644 index 0000000..55b7395 Binary files /dev/null and b/Images/aiberm-models.png differ diff --git a/Images/override-openai-base-url.png b/Images/override-openai-base-url.png new file mode 100644 index 0000000..e897482 Binary files /dev/null and b/Images/override-openai-base-url.png differ diff --git "a/Trae Setup - \345\256\214\345\226\204\347\211\210\357\274\210\344\270\255\350\213\261\346\226\207\357\274\211.docx" "b/Trae Setup - \345\256\214\345\226\204\347\211\210\357\274\210\344\270\255\350\213\261\346\226\207\357\274\211.docx" new file mode 100644 index 0000000..36aa78d Binary files /dev/null and "b/Trae Setup - \345\256\214\345\226\204\347\211\210\357\274\210\344\270\255\350\213\261\346\226\207\357\274\211.docx" differ diff --git a/e --abbrev-ref --symbolic-full-name @{u}' b/e --abbrev-ref --symbolic-full-name @{u}' new file mode 100644 index 0000000..759a3ab --- /dev/null +++ b/e --abbrev-ref --symbolic-full-name @{u}' @@ -0,0 +1,2 @@ +* docs/trae-setup 6158272 docs_update_trae_setup + main  471780c [origin/main: ahead 1] feat_add_Trae_IDE_setup_documentation diff --git a/public/cursor/en/add-custom-model.png b/public/cursor/en/add-custom-model.png new file mode 100644 index 0000000..45c88a4 Binary files /dev/null and b/public/cursor/en/add-custom-model.png differ diff --git a/public/cursor/en/aiberm-models.png b/public/cursor/en/aiberm-models.png new file mode 100644 index 0000000..55b7395 Binary files /dev/null and b/public/cursor/en/aiberm-models.png differ diff --git a/public/cursor/en/override-openai-base-url.png b/public/cursor/en/override-openai-base-url.png new file mode 100644 index 0000000..e897482 Binary files /dev/null and b/public/cursor/en/override-openai-base-url.png differ diff --git a/public/cursor/zh/add-custom-model.png b/public/cursor/zh/add-custom-model.png new file mode 100644 index 0000000..45c88a4 Binary files /dev/null and b/public/cursor/zh/add-custom-model.png differ diff --git a/public/cursor/zh/aiberm-models.png b/public/cursor/zh/aiberm-models.png new file mode 100644 index 0000000..55b7395 Binary files /dev/null and b/public/cursor/zh/aiberm-models.png differ diff --git a/public/cursor/zh/override-openai-base-url.png b/public/cursor/zh/override-openai-base-url.png new file mode 100644 index 0000000..e897482 Binary files /dev/null and b/public/cursor/zh/override-openai-base-url.png differ diff --git a/read_docx.py b/read_docx.py new file mode 100644 index 0000000..7aaaefd --- /dev/null +++ b/read_docx.py @@ -0,0 +1,14 @@ +import docx + +def read_docx(file_path): + doc = docx.Document(file_path) + full_text = [] + for para in doc.paragraphs: + full_text.append(para.text) + return '\n'.join(full_text) + +try: + content = read_docx(r'f:\VibeCoding\aiberm-docs\Trae Setup - 完善版（中英文）.docx') + print(content) +except Exception as e: + print(f"Error reading docx: {e}") diff --git a/src/config/navigation.ts b/src/config/navigation.ts index fb4b048..50a59ab 100644 --- a/src/config/navigation.ts +++ b/src/config/navigation.ts @@ -79,6 +79,16 @@ export const navigation: NavGroup[] = [ { title: { en: 'GUIDES', zh: '指南' }, items: [ + { + id: 'trae', + title: { en: 'Trae Setup', zh: 'Trae 设置' }, + icon: 'terminal', + }, + { + id: 'cursor', + title: { en: 'Cursor Setup', zh: 'Cursor 设置' }, + icon: 'terminal', + }, { id: 'claude-code', title: { en: 'Claude Code Setup', zh: 'Claude Code 设置' }, diff --git a/src/pages/en/cursor.mdx b/src/pages/en/cursor.mdx new file mode 100644 index 0000000..7c2487f --- /dev/null +++ b/src/pages/en/cursor.mdx @@ -0,0 +1,103 @@ +--- +layout: ../../layouts/DocsLayout.astro +title: Cursor Setup +lang: en +activeId: cursor +--- + +import Callout from '../../components/Callout.tsx'; + +# Cursor Setup + +Cursor is an AI-native code editor built on VS Code, designed to increase developer productivity through deeply integrated AI features. By configuring Cursor to use Aiberm, you can access top-tier models like Claude 3.7, GPT-4o, and Gemini 2.5 for code generation, refactoring, and chat. + + +To use Cursor with Aiberm, you need a valid Aiberm API key. If you haven't obtained one yet, please refer to the [Authentication](/docs/en/authentication) page. + + +## What is Cursor? + +Cursor is an editor designed specifically for AI-assisted programming. Its key features include: + +- **Deep Integration**: AI understands your entire codebase, not just the current file. +- **Cursor Tab**: Powerful autocomplete that predicts your next edit. +- **Composer**: An AI interface supporting multi-file editing and complex task generation. +- **Privacy Mode**: Supports local code storage (when used with custom APIs). + +## Configuration Steps + +Follow these steps to configure Cursor to use Aiberm's API: + +### Step 1: Open Model Settings + +1. Open Cursor editor. +2. Click the **Settings** icon (gear) in the top-right corner, or use the shortcut `Ctrl + Shift + J`. +3. In the left settings menu, select **Models**. +4. On the Models page, you may need to click **"View All Models"** or scroll down to the bottom to see all configuration options. + +### Step 2: Configure OpenAI Base URL + +Cursor allows you to add a custom OpenAI-compatible interface. + +1. On the Models page, find the **OpenAI API Key** section. +2. Ensure the toggle is enabled. +3. **Enter API Key**: Fill in your Aiberm API Key (starting with `sk-`). +4. Click **"Override OpenAI Base URL"** below the input box. +5. **Enter Base URL**: Input `https://aiberm.com/v1/`. + + +**Note**: Do **not** append `/models` after `v1` in the Base URL. Cursor will autocomplete it. + + + +Screenshot: Configure API Key and Base URL. + + +![](/docs/cursor/en/override-openai-base-url.png) + +### Step 3: Add Custom Models + +To use specific models provided by Aiberm (such as the latest GPT or Claude versions), you need to manually add them to Cursor. + +1. On the Models page, scroll down to the bottom of the **"Model Names"** list. +2. Click **"+ Add Custom Model"**. + + +Screenshot: Click "Add Custom Model" in Cursor. + + +![](/docs/cursor/en/add-custom-model.png) + +3. **Get Model Names**: Log in to the [Aiberm Console](https://aiberm.com/) and go to the "Models & Pricing" page. +4. Copy the model name you want to use (e.g., `openai/gpt-5.3-codex`). + + +Screenshot: Copy the model name from Aiberm Console. + + +![](/docs/cursor/en/aiberm-models.png) + +5. Paste the copied name into the input box in Cursor and click Add. +6. Ensure the toggle next to your newly added model is **ON**. + + +**Recommended Model Configuration:** +- **Chat**: Use `claude-3-7-sonnet-20250219` or `gpt-4o` for the best chat experience. +- **Composer**: `claude-3-7-sonnet-20250219` excels at handling multi-file complex tasks. + + +### Step 4: Verification + +1. Close the settings page. +2. Use `Ctrl + L` (Windows/Linux) / `Cmd + L` (macOS) to open the chat panel. +3. In the model selector at the bottom of the chat, choose the model you just added (e.g., `claude-3-7-sonnet-20250219`). +4. Enter a test query, such as: "Hello, please write a Quick Sort algorithm in Python." +5. If Cursor responds successfully, your configuration is working! + +## FAQ + +### Can I use Cursor Tab (Autocomplete)? +Cursor Tab (formerly Copilot++) typically relies on Cursor's own model services. While you can configure Chat and Composer to use Aiberm, the Tab feature might require a Cursor Pro subscription or default settings. If you wish to use Aiberm exclusively, we recommend relying primarily on Chat and Composer features. + +### Why are model responses slow? +Please check your network connection and ensure the Base URL is set correctly. Some complex reasoning models (like Claude 3 Opus) may inherently have slower response times. We recommend trying `claude-3-5-sonnet` or `gpt-4o-mini` for faster interactions. diff --git a/src/pages/zh/cursor.mdx b/src/pages/zh/cursor.mdx new file mode 100644 index 0000000..1fd7e3b --- /dev/null +++ b/src/pages/zh/cursor.mdx @@ -0,0 +1,103 @@ +--- +layout: ../../layouts/DocsLayout.astro +title: Cursor 配置 +lang: zh +activeId: cursor +--- + +import Callout from '../../components/Callout.tsx'; + +# Cursor 配置 + +Cursor 是一款基于 VS Code 构建的 AI 原生代码编辑器，旨在通过深度集成的 AI 功能提高开发效率。通过配置 Cursor 使用 Aiberm，你可以调用 Claude 3.7、GPT-4o、Gemini 2.5 等顶级模型进行代码生成、重构和对话。 + + +使用 Cursor 配合 Aiberm 需要有效的 Aiberm API 密钥。如果你还没有获取，请参考 [身份认证](/docs/zh/authentication) 页面。 + + +## 什么是 Cursor？ + +Cursor 是专为 AI 辅助编程设计的编辑器。它的主要特点包括： + +- **深度集成**：AI 能够理解你的整个代码库，不仅仅是当前文件。 +- **Cursor Tab**：强大的自动补全功能，能够预测你的下一次编辑。 +- **Composer**：支持多文件编辑和复杂任务生成的 AI 界面。 +- **隐私模式**：支持将代码仅存储在本地（配合自定义 API 使用）。 + +## 配置步骤 + +按照以下步骤配置 Cursor 使用 Aiberm 的 API： + +### 步骤 1：打开模型设置 + +1. 打开 Cursor 编辑器。 +2. 点击右上角的 **设置 (Settings)** 图标（齿轮状），或者使用快捷键 `Ctrl + Shift + J`。 +3. 在左侧设置菜单中，选择 **Models**（模型）。 +4. 在模型页面，你可能需要点击 **"View All Models"**（查看所有模型）或向下滚动到底部，以找到完整的配置选项。 + +### 步骤 2：配置 OpenAI Base URL + +Cursor 允许你添加自定义的 OpenAI 兼容接口。 + +1. 在 Models 页面，找到 **OpenAI API Key** 部分。 +2. 确保开关已启用。 +3. **填写 API Key**：在输入框中填入你的 Aiberm API Key（以 `sk-` 开头）。 +4. 点击输入框下方的 **"Override OpenAI Base URL"**（覆盖 OpenAI 基础 URL）。 +5. **填写 Base URL**：输入 `https://aiberm.com/v1/`。 + + +**注意**：Base URL 结尾的 `v1` 后面 **不要** 跟 `/models`，Cursor 会自动补全路径。 + + + +截图：配置 API Key 和 Base URL。 + + +![](/docs/cursor/zh/override-openai-base-url.png) + +### 步骤 3：添加自定义模型 + +为了使用 Aiberm 提供的特定模型（如最新版 GPT 或 Claude），你需要手动将它们添加到 Cursor 中。 + +1. 在 Models 页面，向下滚动找到 **"Model Names"** 列表下方。 +2. 点击 **"+ Add Custom Model"**（添加自定义模型）。 + + +截图：在 Cursor 中点击添加自定义模型。 + + +![](/docs/cursor/zh/add-custom-model.png) + +3. **获取模型名称**：登录 [Aiberm 控制台](https://aiberm.com/)，进入“模型与价格”页面。 +4. 复制你想要使用的模型名称（例如 `openai/gpt-5.3-codex`）。 + + +截图：在 Aiberm 控制台复制模型名称。 + + +![](/docs/cursor/zh/aiberm-models.png) + +5. 将复制的名称粘贴到 Cursor 的输入框中，并点击添加。 +6. 确保新添加的模型开关已 **开启 (ON)**。 + + +**推荐模型配置：** +- **Chat**: 推荐使用 `claude-3-7-sonnet-20250219` 或 `gpt-4o` 以获得最佳的对话体验。 +- **Composer**: `claude-3-7-sonnet-20250219` 在处理多文件复杂任务时表现出色。 + + +### 步骤 4：验证配置 + +1. 关闭设置页面。 +2. 使用 `Ctrl + L` (Windows/Linux) / `Cmd + L` (macOS) 打开对话面板。 +3. 在对话框下方的模型选择器中，选择你刚刚添加的模型（例如 `claude-3-7-sonnet-20250219`）。 +4. 输入一个测试问题，例如：“你好，请用 Python 写一个快速排序算法。” +5. 如果 Cursor 成功回复，说明配置成功！ + +## 常见问题 + +### Cursor Tab (自动补全) 能用吗？ +Cursor Tab (原 Copilot++) 通常依赖 Cursor 自己的模型服务。虽然你可以配置 Chat 和 Composer 使用 Aiberm，但 Tab 功能可能需要 Cursor 的 Pro 订阅或默认设置。如果你希望完全使用 Aiberm，建议主要依赖 Chat 和 Composer 功能。 + +### 为什么模型回答很慢？ +请检查你的网络连接，并确保 Base URL 设置正确。某些复杂的推理模型（如 Claude 3 Opus）本身响应速度可能较慢，建议尝试 `claude-3-5-sonnet` 或 `gpt-4o-mini` 进行快速交互。