Splite docs to developer and user and bring profile link back

This commit is contained in:
Xin Wang
2026-08-07 11:13:45 +08:00
parent 95e04d8c94
commit 7575afaeee
12 changed files with 103 additions and 42 deletions

45
docs-developer/index.mdx Normal file
View File

@@ -0,0 +1,45 @@
---
title: 快速开始
description: 用 Docker 启动本地开发环境,并创建第一个可语音预览的助手。
icon: rocket
---
# 快速开始
## 1. 启动服务
在项目根目录执行:
```bash
docker compose up -d
make db-seed
```
首次启动会构建后端镜像。启动后访问:
- 前端:`http://localhost:3030`
- 后端健康检查:`http://localhost:8000/health`
- 后端接口文档:`http://localhost:8000/docs`
## 2. 配置模型资源
进入「组件库 / 模型资源」选择协议类型并填写连接信息。OpenAI 兼容服务通常需要:
- `values.modelId`:模型标识
- `values.apiUrl`:服务地址
- `secrets.apiKey`:访问密钥
保存前可使用“测试连接”确认可用性。
## 3. 创建助手
进入「创建助手」,绑定需要的模型资源:
- **pipeline**:绑定 LLM、ASR、TTS适合常规语音对话。
- **realtime**:绑定 Realtime 模型,适合端到端语音交互。
保存后,从助手详情页打开语音预览即可测试。
<Note>
浏览器麦克风仅在 localhost 或 HTTPS 下可用。局域网、远程环境请按仓库中的 `deploy/README.md` 配置 HTTPS 与 TURN。
</Note>