Skip to content

Latest commit

 

History

History
211 lines (162 loc) · 6.05 KB

quick-start.md

File metadata and controls

211 lines (162 loc) · 6.05 KB

🚀 快速开始

本指南帮助你在 5 分钟内开始使用 Blade。

当前版本: 0.2.0

安装

# 使用 npm
npm install -g blade-code

# 或使用 pnpm
pnpm add -g blade-code

# 或使用 yarn
yarn global add blade-code

启动

CLI 模式

# 在项目目录下启动
cd /path/to/project
blade

# 或带初始消息启动
blade "帮我分析这个项目的架构"

Web UI 模式（0.2.0 新增）

# 启动 Web UI 并自动打开浏览器
blade web

# 或启动无头服务器（适合远程访问）
blade serve --port 3000 --hostname 0.0.0.0

配置模型

首次启动需配置模型，输入 /model add 启动配置向导：

┌─────────────────────────────────────────────────────────┐
│  📡 选择 Provider                           [搜索]      │
│                                                         │
│  热门 Provider                                          │
│  ▶ Anthropic (🤖) - Claude 系列                         │
│    OpenAI (⚡) - GPT 系列                               │
│    DeepSeek (🌊) - DeepSeek R1 等                       │
│    Google (✨) - Gemini 系列                            │
│    Groq (🚀) - 超快推理                                 │
│    OpenRouter (🔀) - 多模型聚合                         │
│                                                         │
│  更多 Provider（80+）                                   │
│    Azure, AWS Bedrock, Together AI, Fireworks...        │
│                                                         │
│  [↑↓] 选择  [/] 搜索  [Enter] 确认                      │
└─────────────────────────────────────────────────────────┘

3 步完成配置

  1. 选择 Provider - 从 80+ Provider 中选择（支持搜索）
  2. 输入 API Key - 向导会显示环境变量名和文档链接
  3. 选择模型 - 从该 Provider 的内置模型列表中选择

配置完成后，使用 /model 命令切换模型。

自定义 Provider

如果你的 Provider 不在列表中，选择 🔧 自定义 OpenAI Compatible：

  1. 选择 "🔧 自定义 OpenAI Compatible"
  2. 输入 API Key
  3. 输入 Base URL（必填，例如 https://api.example.com/v1）
  4. 输入模型名称

适用于任何兼容 OpenAI API 格式的服务。

基本交互

对话

直接输入问题开始对话：

你: 帮我写一个 React 组件，实现一个带搜索功能的下拉选择器

Blade: 好的，我来帮你创建一个带搜索功能的下拉选择器组件...

@ 文件引用

使用 @ 引用文件，让 AI 了解上下文：

你: @src/components/Button.tsx 帮我添加一个 loading 状态

你: @src/utils/api.ts:10-50 这段代码有什么问题？

常用命令

命令 说明
/help 显示帮助信息
/model 切换/管理模型
/model add 添加新模型（80+ Provider）
/clear 清空对话历史
/compact 压缩上下文
/status 查看当前状态
/config 查看/修改配置

快捷键

快捷键 说明
Enter 发送消息
Shift+Enter 换行
Ctrl+C 中断当前操作
Ctrl+D 退出 Blade
↑/↓ 浏览历史消息
Tab 自动补全

权限控制

Blade 会在执行敏感操作前请求确认：

┌─────────────────────────────────────────────────────────┐
│  🔧 Blade 想要执行以下操作:                              │
│                                                         │
│  工具: Write                                            │
│  文件: src/components/SearchSelect.tsx                  │
│                                                         │
│  [y] 允许  [n] 拒绝  [a] 本次会话全部允许                │
└─────────────────────────────────────────────────────────┘

可以通过配置文件预设权限规则，详见 权限控制。

配置文件

快速配置示例

创建 ~/.blade/config.json：

{
  "currentModelId": "claude",
  "models": [
    {
      "id": "claude",
      "name": "Claude Sonnet 4",
      "provider": "anthropic",
      "apiKey": "sk-ant-api03-xxxxx",
      "model": "claude-sonnet-4-0"
    }
  ]
}

提示: API Key 直接写在配置文件中。推荐使用 /model add 向导配置，会自动处理。

更多 Provider 示例

{
  "models": [
    {
      "id": "deepseek",
      "name": "DeepSeek R1",
      "provider": "openai-compatible",
      "apiKey": "sk-xxxxx",
      "baseUrl": "https://api.deepseek.com/v1",
      "model": "deepseek-reasoner",
      "supportsThinking": true
    },
    {
      "id": "groq",
      "name": "Groq Llama 3.3",
      "provider": "openai-compatible",
      "apiKey": "gsk_xxxxx",
      "baseUrl": "https://api.groq.com/openai/v1",
      "model": "llama-3.3-70b-versatile"
    },
    {
      "id": "openrouter",
      "name": "OpenRouter Claude",
      "provider": "openai-compatible",
      "apiKey": "sk-or-v1-xxxxx",
      "baseUrl": "https://openrouter.ai/api/v1",
      "model": "anthropic/claude-sonnet-4"
    }
  ]
}

下一步