Logan.Li
3cb9545121
- 官网源码归拢到 homepage/（index/pricing/terms/license + content/ + assets/ + docs-assets/），
删除程序内 go:embed 的 server/internal/{site,docs}，后端仅静态托管 homepage/dist 做本地预览
- 新增独立静态页 /license（授权与激活）：交付与激活四步（邮件交付授权码）、
在线授权码 LIC- 与离线许可证 LICOFF- 对比、授权服务器 licence.rlwj.cn 通信范围说明、
授权类型与价格、10 条授权 FAQ
- tools/homepage-build 支持可选单页，产出 <name>.html 与 <name>/index.html
- 导航/页脚接入 /license，跨页锚点补 / 前缀，页脚底栏文案同步为静态站口径
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 栏下方实时显示替换后的实际地址，切换环境立即更新。
|
||
|
||
> **提示**：路径参数用变量而不是写死，是接口可复用的关键 —— 复制接口后只改变量值即可调试另一个资源。
|