# 🚀 三分钟上手 Leaper Agent

从零到一个会进化的 AI Agent，只要三分钟。

---

## 你需要准备

- **Node.js** 20 或以上
- **模型**（选一个就行）：
  - [Ollama](https://ollama.com) — 本地跑，不花钱
  - OpenAI 的 API Key
  - Anthropic 的 API Key

---

## 第一步：装上

```bash
npm install -g leaper-agent
```

装完验证一下：

```bash
leaper --help
```

---

## 第二步：创建 Agent

拿 **CEO 教练**举例：

```bash
mkdir my-ceo-coach && cd my-ceo-coach
leaper init -t ceo-coach
```

会生成这些文件：

```
my-ceo-coach/
├── leaper.yaml       # 配置（用什么模型、接什么渠道）
├── EGO.md            # 人格（"我是谁"）
├── IDENTITY.md       # 身份信息
├── USER.md           # 用户信息
├── MEMORY.md         # 初始记忆
├── AGENTS.md         # 协作规则
├── FRAMEWORKS.md     # 思维框架
└── ONBOARDING.md     # 引导流程
```

---

## 第三步：选模型

打开 `leaper.yaml`，改成你能用的模型：

### 本地 Ollama（推荐新手，不花一分钱）

先把模型拉下来：

```bash
ollama pull qwen2.5:7b
```

然后配置：

```yaml
name: AI CEO Coach
provider:
  provider: ollama
  model: qwen2.5:7b
  baseUrl: http://localhost:11434/v1
```

### OpenAI

```yaml
name: AI CEO Coach
provider:
  provider: openai
  model: gpt-4o
  apiKey: sk-你的key
```

### Anthropic Claude

```yaml
name: AI CEO Coach
provider:
  provider: anthropic
  model: claude-sonnet-4-20250514
  apiKey: sk-ant-你的key
```

### 其他 OpenAI 兼容的 API

```yaml
name: AI CEO Coach
provider:
  provider: openai
  model: 模型名
  apiKey: 你的key
  baseUrl: https://你的地址/v1
```

---

## 第四步：开聊

```bash
leaper chat
```

```
Loading agent from /path/to/my-ceo-coach...
Agent ready. Type your message (Ctrl+C to exit).

You: 我刚拿到天使轮，下一步该怎么走？

Agent: 恭喜！在给建议之前，我想先了解几件事：
1. 你的核心产品是什么？有没有找到 PMF？
2. 这轮融了多少？够烧几个月？
3. 团队几个人？最缺什么？
...
```

🎉 **跑起来了。**

---

## 想让别人也能用？接 Telegram

### 1. 建 Bot

找 Telegram 的 [@BotFather](https://t.me/BotFather)，发 `/newbot`，拿到 Token。

### 2. 配上

`leaper.yaml` 里加：

```yaml
channels:
  - type: telegram
    token: "你的Bot Token"
```

### 3. 跑起来

```bash
leaper run
```

现在 Telegram 里就能跟你的 Agent 聊天了。

---

## 接其他渠道

### Discord

```yaml
channels:
  - type: discord
    token: "你的discord bot token"
    applicationId: "你的app id"
```

### 飞书

```yaml
channels:
  - type: feishu
    appId: "你的app id"
    appSecret: "你的app secret"
```

### HTTP 接口

```yaml
channels:
  - type: web
    port: 3000
```

调用：

```bash
curl -X POST http://localhost:3000/chat \
  -H "Content-Type: application/json" \
  -d '{"message": "你好"}'
```

总共 19 个渠道可以接，详见 [README.md](README.md)。

---

## 它怎么越用越强

Leaper 的进化是自动的，你不用做任何事：

| 用了多久 | 发生什么 |
|----------|---------|
| **10 次对话** | Agent 开始从对话里提炼有用的经验 |
| **50 次对话** | 自动生成可复用的技能（比如"融资建议流程"） |
| **100 次对话** | 多个技能开始协同、Agent 越来越懂你的风格、开始自我质疑提高准确性 |

---

## 自己从头建 Agent

不想用模板？空白开始：

```bash
mkdir my-agent && cd my-agent
leaper init
```

编辑 `EGO.md` 写你想要的人格：

```markdown
# 我是谁
你是一个资深 Python 后端架构师，专注性能优化。

# 性格
- 严谨，代码质量第一
- 用 benchmark 说话，不扯虚的
- 反对过度设计

# 说话风格
- 先给结论，再展开
- 代码比理论有说服力
```

就这样，你的 Agent 就有性格了。

---

## 常见问题

**本地模型太慢？**
CPU 跑 7B 大概要一分钟。有 GPU 就是几秒的事。嫌慢直接用 OpenAI 或 Claude。

**支持中文吗？**
完全支持。人格、对话、技能都可以全中文。

**数据安全吗？**
用 Ollama 的话，所有数据都在你机器上，不发到任何外部服务。

**能同时接好几个渠道吗？**
能。`leaper.yaml` 里 `channels` 数组加多个就行，同一个 Agent 同时服务。

---

## 接下来

- 📖 看 [README.md](README.md) 了解全部能力
- 🧬 了解[六层进化引擎](README.md#六层进化引擎)
- 🔧 看看 [30 多个内置工具](README.md#内置工具)

---

<p align="center">
  <b>Leaper Agent</b> — 自驱进化智能体引擎<br>
  <em>The agent runtime that learns, adapts, and evolves.</em><br><br>
  <a href="https://deepleaper.com">跃盟科技 Deepleaper</a> 出品
</p>