# 快速上手：REPL

本頁說明如何執行 ToriiDB 內附的 REPL，並以 OpenAI API key 啟用向量指令。

## 執行 REPL

```bash
go run cmd/test/main.go
# 或
make test
```

REPL 以 `store.New` 開啟 `./temp`（不經過 daemon）：

```text
toriidb[0]> SET counter 1
OK
toriidb[0]> INCR counter
2
toriidb[0]> SET user {"name":"Torii","profile":{"level":1}}
OK
toriidb[0]> GET user.profile.level
1
toriidb[0]> SELECT 1
OK
toriidb[1]> KEYS *
(empty list)
```

輸入 `quit` 或 `exit` 結束。`SIGINT` 與 `SIGTERM` 會先關閉 store 再結束 process。

## 啟用向量操作

```bash
export OPENAI_API_KEY="your-api-key"
go run cmd/test/main.go
```

```text
SET article:1 Redis-style embedded storage VECTOR
SET article:2 JSON document database VECTOR
VSEARCH embedded vector search LIMIT 2
VSIM article:1 article:2
```

向量在 `SET` 回傳後於背景附加，因此新項目會稍後才可被搜尋到。

## 建置與測試

| 指令 | 動作 |
|---|---|
| `go build ./...` | 建置所有套件 |
| `go vet ./...` | 靜態分析 |
| `make test` | 執行 REPL |
| `make unit` | `go test ./core/... -count=1 -cover` |
| `make embed` | 執行 OpenAI embedding 整合測試 |

Makefile 在存在本地 `.env` 時會 `include` 並 `export`；Go 程式本身不載入 `.env`。

## 相關頁面

- [指令摘要](/zh/cli-reference)
- [附加向量](/zh/vector-search)
- [API Key](/zh/configuration-api-key)