Skip to content

quick-start.md

Latest commit

 

History

History
178 lines (130 loc) · 5.25 KB

quick-start.md

File metadata and controls

178 lines (130 loc) · 5.25 KB
Raw

🚀 快速开始

本指南帮助你在 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 (🔀) - 多模型聚合                         │
│                                                         │
│  更多 pi-ai Provider                                    │
│    Azure, AWS Bedrock, Together AI, Fireworks...        │
│                                                         │
│  [↑↓] 选择  [/] 搜索  [Enter] 确认                      │
└─────────────────────────────────────────────────────────┘

3 步完成配置

  1. 选择 Provider - 从 pi-ai catalog 中选择
  2. 输入 API Key - 向导会显示环境变量名和文档链接
  3. 选择模型 - 从该 Provider 的内置模型列表中选择

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

自定义 Provider

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

  1. 选择 "🔧 自定义 OpenAI Compatible"
  2. 输入 API Key
  3. 尚未配置时输入 Provider 凭证
  4. 输入模型名称

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

基本交互

对话

直接输入问题开始对话：

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

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

@ 文件引用

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

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

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

常用命令

命令 说明
/help 显示帮助信息
/model 切换/管理模型
/model add 从 pi-ai catalog 添加模型
/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",
      "displayName": "Claude Sonnet",
      "provider": "anthropic",
      "model": "claude-sonnet-4-5"
    }
  ]
}

凭证存储在 ~/.blade/auth.json，推荐通过 /model add 配置。

更多 Provider 和模型可直接在 TUI 或 Web 的 pi-ai catalog 中选择。

下一步