logan
ce6d2d1eff
- 环境新增「前置 URL」字段；环境管理弹窗独立配置区 + 说明
- URL 输入改为一体胶囊：前缀块（环境徽标 + 域名，点击进环境管理）+ 分隔线 + 相对路径输入
- 路径以 / 开头（或空）自动拼接当前环境前置 URL；完整 https:// 地址不受影响
- 光标 / 全选只作用于路径，不再误编辑 {{baseUrl}} 文本
- 覆盖 HTTP / GraphQL / SSE 编辑器与发送链路（含自动化测试执行器、代码生成用完整地址）
- 存量数据一次性迁移：{{baseUrl}}/path → /path，baseUrl 变量 → 环境字段（启动 / 导入 / 备份恢复均生效）
- 顶栏切换环境即换前缀；docs 06-env 增前置 URL 章节
- 验证：48 前端用例全绿；本地 E2E（迁移/发送 200/环境切换前缀联动/胶囊几何对齐）+ 近景视觉评审通过
68 lines
2.8 KiB
Markdown
68 lines
2.8 KiB
Markdown
## 前置 URL
|
||
|
||
环境可配置**前置 URL**（如 `https://api.example.com`）。配置后，请求里只需写相对路径：
|
||
|
||
```text
|
||
前置 URL：https://api.example.com
|
||
请求路径：/graphql
|
||
实际请求：https://api.example.com/graphql
|
||
```
|
||
|
||
- URL 输入框会以**前缀块 + 路径**的形式一体展示，前缀部分不可误编辑（点击可跳转环境管理）；
|
||
- **切换环境即自动换成对应服务地址**，无需改请求；
|
||
- 路径以 `/` 开头（或为空）才启用拼接；写完整 `https://…` 地址的请求不受影响；
|
||
- 未配置前置 URL 的环境，请求仍可写完整 URL 或用 `{{变量名}}`。
|
||
|
||
> 历史数据自动迁移：旧的 `{{baseUrl}}/path` 会被自动转为「前置 URL + /path」，`baseUrl` 变量写入环境的前置 URL 字段。
|
||
|
||
## 变量语法
|
||
|
||
在 URL、Params、Headers、Cookies、Body、鉴权字段中，使用双花括号引用变量：
|
||
|
||
```text
|
||
{{baseUrl}}/v1/users?page={{page}}
|
||
Authorization: Bearer {{token}}
|
||
```
|
||
|
||
发送时统一替换为**当前启用环境**中同名变量的值；未定义的变量保留原样，便于发现遗漏。
|
||
|
||
## 切换环境
|
||
|
||
顶栏环境切换器显示**彩色单字徽标 + 环境名 + 变量数**，点击弹出环境列表（当前环境带「当前」标记），一眼防误发；底部可进入「管理环境」或「不使用环境」。
|
||
|
||
## 管理环境
|
||
|
||
顶栏 **环境** 按钮打开管理弹窗（左侧环境列表 + 右侧编辑区）：
|
||
|
||
- **左栏**：环境列表（徽标 + 名称 + 当前标记），底部虚线按钮新建环境。
|
||
- **右栏**：提示条（变量引用语法 + 文档直达）、环境重命名、设为当前 / 取消使用、**复制环境**、删除；变量表支持**按名称 / 描述搜索**、逐行启用停用、内联编辑。
|
||
- 所有修改即时生效并自动保存。
|
||
|
||
## 输入 {{ 自动补全
|
||
|
||
在 URL 输入框或任意「值」输入框键入 `{{`，会弹出当前环境的变量浮层：
|
||
|
||
- ↑↓ 选择、Enter / Tab 插入完整的 `{{变量名}}`；Esc 关闭。
|
||
- 浮层同时显示变量值，选之前即可确认。
|
||
|
||
内置示例环境：
|
||
|
||
| 环境 | baseUrl | token |
|
||
| --- | --- | --- |
|
||
| 正式 | `https://httpbin.org` | demo-token |
|
||
| 本地 | `http://127.0.0.1:8787` | dev-token |
|
||
|
||
## 变量从哪来自动生成
|
||
|
||
| 来源 | 行为 |
|
||
| --- | --- |
|
||
| 导入 OpenAPI / Swagger | `servers` 地址写入 `baseUrl`；路径参数 `{id}` 转为 `{{id}}` 并写入示例值 |
|
||
| 导入 Postman | `collection.variable` 写入当前环境 |
|
||
| 手动输入 | 在环境面板随时增改 |
|
||
|
||
## 实际地址预览
|
||
|
||
URL 含 `{{ }}` 时，编辑器会在 URL 栏下方实时显示替换后的实际地址，切换环境立即更新。
|
||
|
||
> **提示**：路径参数用变量而不是写死，是接口可复用的关键 —— 复制接口后只改变量值即可调试另一个资源。
|