48 lines
1.4 KiB
Markdown
48 lines
1.4 KiB
Markdown
|
# Cursor CLI stream-json 格式
|
|||
|
|
|
|||
|
|
## 實際輸出格式（已確認）
|
|||
|
|
|
|||
|
|
NDJSON（每行一個 JSON）。
|
|||
|
|
|
|||
|
|
### 1. System Init
|
|||
|
|
```json
|
|||
|
|
{"type":"system","subtype":"init","apiKeySource":"login","cwd":"/path","session_id":"uuid","model":"Auto","permissionMode":"default"}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 2. User Message
|
|||
|
|
```json
|
|||
|
|
{"type":"user","message":{"role":"user","content":[{"type":"text","text":"prompt text"}]},"session_id":"uuid"}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3. Assistant Message（可能多次出現）
|
|||
|
|
```json
|
|||
|
|
{"type":"assistant","message":{"role":"assistant","content":[{"type":"text","text":"response text"}]},"session_id":"uuid","timestamp_ms":1776157308323}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 4. Result（最後一行）
|
|||
|
|
```json
|
|||
|
|
{"type":"result","subtype":"success","duration_ms":10208,"duration_api_ms":10208,"is_error":false,"result":"OK","session_id":"uuid","request_id":"uuid","usage":{"inputTokens":0,"outputTokens":122,"cacheReadTokens":5120,"cacheWriteTokens":14063}}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 轉換規則
|
|||
|
|
|
|||
|
|
| Cursor type | 行為 |
|
|||
|
|
|-------------|------|
|
|||
|
|
| system | 忽略（初始化訊息）|
|
|||
|
|
| user | 忽略（echo 回用戶訊息）|
|
|||
|
|
| assistant | 提取 message.content[].text → OpenAI delta.content |
|
|||
|
|
| result (success) | 提取 usage → OpenAI usage，發送 finish_reason:"stop" |
|
|||
|
|
| result (error) | 發送錯誤 chunk |
|
|||
|
|
|
|||
|
|
## CLI 參數
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
agent -p "prompt" \
|
|||
|
|
--output-format stream-json \
|
|||
|
|
--stream-partial-output \
|
|||
|
|
--trust \
|
|||
|
|
--model "model-name"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
注意：需要 `--trust` 才能在非互動模式執行。
|