# 管理界面

这是实时交互服务层的配置与调试界面，用于管理助手、模型资源、知识库、工具，以及语音预览、测试和历史记录。项目定位、公开接口与能力状态见[仓库 README](../README.md)和[用户文档](../docs-user/index.mdx)。

## 本地开发

推荐在仓库根目录运行 `docker compose up -d`，界面地址为 `http://localhost:3030`，后端为 `http://localhost:8000`。如需单独运行前端：

```bash
cd frontend
npm ci
npm run dev
```

单独运行时 Next.js 默认监听 `http://localhost:3000`。浏览器默认连接 `http://localhost:8000`；需要其他后端地址时设置 `NEXT_PUBLIC_API_BASE_URL`。后端及数据库仍需单独启动。

## 检查

```bash
npm run lint
npm run test:contracts
npm run build
```

界面中的“Realtime 模型资源”列表包含尚未接通运行时的占位类型；实际可运行的类型与功能限制见[能力状态](../docs-user/status.mdx)。