# Prompt 与个性化（Personalization）管理 API

## Prompt（主提示词）存储位置
- 路径：`api/users/<user>/data/prompts/<name>.txt`
- 内容格式：纯文本

## 个性化存储位置
- 路径：`api/users/<user>/data/personalization/<name>.json`
- 内容格式：JSON，对应原有 personalization 配置结构

## 接口

### 列出 Prompt
`GET /api/v1/prompts`

响应：
```json
{ "success": true, "items": [ { "name": "default", "size": 123, "updated_at": 1769182550.59 } ] }
```

### 获取 Prompt 内容
`GET /api/v1/prompts/{name}`

响应：
```json
{ "success": true, "name": "custom_a", "content": "你的主系统提示..." }
```

### 创建/覆盖 Prompt
`POST /api/v1/prompts`
```json
{ "name": "custom_a", "content": "你的主系统提示内容" }
```
成功返回 `{ "success": true, "name": "custom_a" }`

---

### 列出个性化
`GET /api/v1/personalizations`

### 获取个性化内容
`GET /api/v1/personalizations/{name}`

### 创建/覆盖个性化
`POST /api/v1/personalizations`
```json
{ "name": "biz_mobile", "content": { ... personalization json ... } }
```

---

## 在对话/消息中使用

- `POST /api/v1/conversations` 可选参数：`prompt_name`、`personalization_name`，会写入对话元数据并在后续消息中应用。
- `POST /api/v1/messages` 可选参数：`prompt_name`、`personalization_name`，立即应用并写入元数据。
- 元数据字段：`custom_prompt_name`、`personalization_name`；对话加载时会自动套用对应文件（若不存在则忽略）。

优先级：调用时传入 > 对话元数据 > 默认主 prompt / 默认个性化配置。