官网内容质量升级:基于代码真实功能重写卖点与文档

先做全量功能盘点(编辑器/测试/Mock/AI/导入导出/服务端/桌面授权),再对齐内容:
- 落地页:hero 副标与药丸补 AI 用例/Cron 定时/智能 Mock;「为什么选」4→8 卡
  (新增 自动化测试闭环/AI 生成用例/智能 Mock 双引擎/内网文档分享);功能区 6→12 卡
  (新增 测试/AI/智能 Mock/历史重放/系统代理/文档快照);对比表 +3 行(断言/AI/Cron);
  定价卡对齐 3/5 台与真实权益;新增 bot/list-checks/flask/clock 图标
- 文档:03-界面导览 重写为活动栏时代(含授权徽章/空间切换);16-测试 补 5 段 Cron
  章节(示例/15s 巡检/30 条日志/防重入)与 JSON 报告格式;14-Mock 补 61 条规则数、
  独立端口 8798/OPSXAPI_MOCK_ADDR、Mock 管理页、Bearer 与来源控制、一键建 Mock
- 新增 21-授权与激活 文档(试用条款/LIC- vs LICOFF-/解绑/离线容忍/防伪)并注册目录
- 21 页文档全量重建;7 页零断链验证 + DOM 结构核验(卡片/图标/药丸计数)通过
This commit is contained in:
logan committed 2026-10-16 11:47:45 +08:00
1 parent 904a85ab7f
commit cdaba44373
32 files changed
+265 -80

No files matched your search

+3 -1
View File
@@ -124,6 +124,8 @@
<div class="nav-group">
<div class="nav-group-title">参考</div>
<a class="nav-link" href="/docs/license">授权与激活</a>
<a class="nav-link" href="/docs/server-api">服务端 API 参考</a>
<a class="nav-link" href="/docs/faq">常见问题</a>
@@ -199,7 +201,7 @@
<a class="pn prev" href="/docs/ai"><span class="pn-label">← 上一页</span><span class="pn-title">AI 助手</span></a>
<a class="pn next" href="/docs/server-api"><span class="pn-label">下一页 →</span><span class="pn-title">服务端 API 参考</span></a>
<a class="pn next" href="/docs/license"><span class="pn-label">下一页 →</span><span class="pn-title">授权与激活</span></a>
</div>
+2
View File
@@ -124,6 +124,8 @@
<div class="nav-group">
<div class="nav-group-title">参考</div>
<a class="nav-link" href="/docs/license">授权与激活</a>
<a class="nav-link" href="/docs/server-api">服务端 API 参考</a>
<a class="nav-link" href="/docs/faq">常见问题</a>
+2
View File
@@ -124,6 +124,8 @@
<div class="nav-group">
<div class="nav-group-title">参考</div>
<a class="nav-link" href="/docs/license">授权与激活</a>
<a class="nav-link" href="/docs/server-api">服务端 API 参考</a>
<a class="nav-link" href="/docs/faq">常见问题</a>
+2
View File
@@ -124,6 +124,8 @@
<div class="nav-group">
<div class="nav-group-title">参考</div>
<a class="nav-link" href="/docs/license">授权与激活</a>
<a class="nav-link" href="/docs/server-api">服务端 API 参考</a>
<a class="nav-link" href="/docs/faq">常见问题</a>
+2
View File
@@ -124,6 +124,8 @@
<div class="nav-group">
<div class="nav-group-title">参考</div>
<a class="nav-link" href="/docs/license">授权与激活</a>
<a class="nav-link" href="/docs/server-api">服务端 API 参考</a>
<a class="nav-link" href="/docs/faq">常见问题</a>
+2
View File
@@ -124,6 +124,8 @@
<div class="nav-group">
<div class="nav-group-title">参考</div>
<a class="nav-link" href="/docs/license">授权与激活</a>
<a class="nav-link" href="/docs/server-api">服务端 API 参考</a>
<a class="nav-link active" href="/docs/faq">常见问题</a>
+2
View File
@@ -124,6 +124,8 @@
<div class="nav-group">
<div class="nav-group-title">参考</div>
<a class="nav-link" href="/docs/license">授权与激活</a>
<a class="nav-link" href="/docs/server-api">服务端 API 参考</a>
<a class="nav-link" href="/docs/faq">常见问题</a>
+2
View File
@@ -124,6 +124,8 @@
<div class="nav-group">
<div class="nav-group-title">参考</div>
<a class="nav-link" href="/docs/license">授权与激活</a>
<a class="nav-link" href="/docs/server-api">服务端 API 参考</a>
<a class="nav-link" href="/docs/faq">常见问题</a>
+2
View File
@@ -124,6 +124,8 @@
<div class="nav-group">
<div class="nav-group-title">参考</div>
<a class="nav-link" href="/docs/license">授权与激活</a>
<a class="nav-link" href="/docs/server-api">服务端 API 参考</a>
<a class="nav-link" href="/docs/faq">常见问题</a>
+2
View File
@@ -124,6 +124,8 @@
<div class="nav-group">
<div class="nav-group-title">参考</div>
<a class="nav-link" href="/docs/license">授权与激活</a>
<a class="nav-link" href="/docs/server-api">服务端 API 参考</a>
<a class="nav-link" href="/docs/faq">常见问题</a>
+46 -27
View File
@@ -124,6 +124,8 @@
<div class="nav-group">
<div class="nav-group-title">参考</div>
<a class="nav-link" href="/docs/license">授权与激活</a>
<a class="nav-link" href="/docs/server-api">服务端 API 参考</a>
<a class="nav-link" href="/docs/faq">常见问题</a>
@@ -138,8 +140,35 @@
<h1 class="page-title">界面导览</h1>
<div class="page-meta">更新于 2026-09-17</div>
<article class="md">
<p>OpsxAPI 主界面分为五个区域:</p>
<h2 id="sec-1">顶栏</h2>
<p>OpsxAPI 主界面由「活动栏 + 顶栏 + 侧栏 + 标签页 + 编辑区」组成:</p>
<h2 id="sec-1">活动栏(最左窄栏)</h2>
<table>
<thead>
<tr>
<th>元素</th>
<th>作用</th>
</tr>
</thead>
<tbody>
<tr>
<td>空间徽标(顶部)</td>
<td>切换 本地空间 / 我的空间 / 团队空间;云端空间显示同步状态点</td>
</tr>
<tr>
<td>接口 / 历史 / 测试 / 文档 / Mock</td>
<td>主导航:接口工作台、请求历史、自动化测试、接口文档、Mock 管理</td>
</tr>
<tr>
<td>授权徽章</td>
<td>试用倒计时或已授权状态,点击进入 设置 → 授权</td>
</tr>
<tr>
<td>设置 / 账号</td>
<td>设置中心;账号菜单(团队管理、立即同步、退出登录)</td>
</tr>
</tbody>
</table>
<h2 id="sec-2">顶栏</h2>
<table>
<thead>
<tr>
@@ -150,37 +179,26 @@
<tbody>
<tr>
<td>+ 新建</td>
<td>快捷创建各协议请求 / 目录(默认建在第一个集合)</td>
<td>六种协议请求 / 目录(默认建在第一个集合)</td>
</tr>
<tr>
<td>导入 / 导出</td>
<td>打开数据导入、导出对话框</td>
<td>数据导入(十种格式)与导出对话框</td>
</tr>
<tr>
<td>环境选择器</td>
<td>切换当前环境(变量随之生效),「⚙ 环境」管理环境与变量</td>
</tr>
<tr>
<td>🌙 / ☀️</td>
<td>明暗主题切换</td>
</tr>
<tr>
<td>⋯</td>
<td>设置(主题、超时、重置工作区)</td>
<td>切换当前环境(变量与前置 URL 随之生效),可直达环境管理</td>
</tr>
</tbody>
</table>
<h2 id="sec-2">左侧集合树</h2>
<h2 id="sec-3">左侧栏(接口 | 历史 分段)</h2>
<ul>
<li>点击请求 → 在标签页中打开;点击目录 → 展开 / 折叠。</li>
<li><strong>右键</strong>任意节点:新建、重命名、复制、导出、删除。</li>
<li><strong>拖拽</strong>请求或目录到另一个目录,即可移动(支持跨集合)。</li>
<li>顶部搜索框按名称 / 方法 / URL 实时过滤。</li>
<li>底部为<strong>历史记录</strong>:显示最近请求的状态码与耗时,点击可回跳到对应接口。</li>
<li><strong>接口</strong>:集合树 — 点击请求在标签页打开,目录展开 / 折叠;<strong>右键</strong> 新建 / 重命名 / 复制 / 导出 / 删除;<strong>拖拽</strong>移动(支持跨集合);顶部搜索实时过滤。</li>
<li><strong>历史</strong>:最近请求自动归档(状态码 / 耗时),点击回跳对应接口,支持一键清空。</li>
</ul>
<h2 id="sec-3">标签页栏</h2>
<h2 id="sec-4">标签页栏</h2>
<p>同时打开多个接口,中键或 × 关闭;右键支持「关闭其他 / 关闭全部」。正在连接中的实时协议标签会显示呼吸圆点。</p>
<h2 id="sec-4">请求编辑区(上半部分)</h2>
<h2 id="sec-5">请求编辑区(上半部分)</h2>
<p>按协议呈现不同编辑器:</p>
<table>
<thead>
@@ -216,7 +234,7 @@
</tr>
</tbody>
</table>
<h2 id="sec-5">响应区(下半部分)</h2>
<h2 id="sec-6">响应区(下半部分)</h2>
<ul>
<li><strong>HTTP / GraphQL</strong>:响应体(Pretty JSON 高亮)、Raw、响应头,右上角状态 / 耗时 / 大小 / 复制。</li>
<li><strong>实时协议</strong>:分色消息日志(接收 · 绿、发送 · 蓝、系统 · 灰、错误 · 红),顶部实时统计收发条数与连接时长。</li>
@@ -244,11 +262,12 @@
<aside class="toc">
<div class="toc-title">本页目录</div>
<nav class="toc-nav">
<a class="toc-l2" href="#sec-1">顶栏</a>
<a class="toc-l2" href="#sec-2">左侧集合树</a>
<a class="toc-l2" href="#sec-3">标签页栏</a>
<a class="toc-l2" href="#sec-4">请求编辑区(上半部分)</a>
<a class="toc-l2" href="#sec-5">响应区(下半部分)</a>
<a class="toc-l2" href="#sec-1">活动栏(最左窄栏)</a>
<a class="toc-l2" href="#sec-2">顶栏</a>
<a class="toc-l2" href="#sec-3">左侧栏(接口 | 历史 分段)</a>
<a class="toc-l2" href="#sec-4">标签页栏</a>
<a class="toc-l2" href="#sec-5">请求编辑区(上半部分)</a>
<a class="toc-l2" href="#sec-6">响应区(下半部分)</a>
</nav>
<button class="print-btn" id="print-btn"><svg class="i"><use href="#i-printer"/></svg> 打印 / 导出 PDF</button>
+2
View File
@@ -124,6 +124,8 @@
<div class="nav-group">
<div class="nav-group-title">参考</div>
<a class="nav-link" href="/docs/license">授权与激活</a>
<a class="nav-link" href="/docs/server-api">服务端 API 参考</a>
<a class="nav-link" href="/docs/faq">常见问题</a>
+2
View File
@@ -124,6 +124,8 @@
<div class="nav-group">
<div class="nav-group-title">参考</div>
<a class="nav-link" href="/docs/license">授权与激活</a>
<a class="nav-link" href="/docs/server-api">服务端 API 参考</a>
<a class="nav-link" href="/docs/faq">常见问题</a>
+8 -2
View File
@@ -124,6 +124,8 @@
<div class="nav-group">
<div class="nav-group-title">参考</div>
<a class="nav-link" href="/docs/license">授权与激活</a>
<a class="nav-link" href="/docs/server-api">服务端 API 参考</a>
<a class="nav-link" href="/docs/faq">常见问题</a>
@@ -145,11 +147,11 @@
<li><strong>智能匹配</strong> —— 开启后按<strong>字段名</strong>自动套用规则表(<code>username</code> → 姓名、<code>email</code> → 邮箱…),一行不用写。</li>
</ol>
<h2 id="sec-1">开启与配置</h2>
<p>顶栏 <strong>⋯ → Mock 数据</strong>(或「设置 → Mock 数据」):</p>
<p>「设置 → 数据生成」(或请求编辑器的 Mock 工具按钮):</p>
<ul>
<li><strong>启用 Mock 数据</strong>:总开关,关闭后 <code>@</code> 表达式按普通文本原样发送;</li>
<li><strong>智能 Mock 匹配</strong>:JSON Body 字段值未写表达式时,按字段名匹配规则自动生成;</li>
<li><strong>智能匹配规则表</strong>:数据类型(string / number / integer / boolean)、匹配方式(通配符 / 完全匹配 / 正则)、匹配规则(如 <code>*name*</code>)、Mock 表达式、备注与启用开关,支持搜索、新增、删除与恢复默认。</li>
<li><strong>智能匹配规则表</strong>:内置 <strong>61 条</strong>默认规则(用户名、邮箱、手机号、价格、时间戳……),数据类型(string / number / integer / boolean)、匹配方式(通配符 / 完全匹配 / 正则)、匹配规则(如 <code>*name*</code>)、Mock 表达式、备注与启用开关,支持搜索、新增、删除与恢复默认。</li>
</ul>
<p>规则<strong>从上到下</strong>匹配,先命中先用;类型需与 JSON 字段实际类型一致(KV 参数一律按 string 匹配)。</p>
<h2 id="sec-2">表达式速查</h2>
@@ -285,6 +287,10 @@ page = @integer(1, 10)
</ol>
<p>特点:</p>
<ul>
<li><strong>独立监听端口</strong>:Mock 服务默认跑在 <code>0.0.0.0:8798</code>(可用环境变量 <code>OPSXAPI_MOCK_ADDR</code> 修改),与主服务 8787 分离,内网同事按 <code>http://本机内网IP:8798/mock/{地址}{路径}</code> 直连;</li>
<li><strong>Mock 管理页</strong>:活动栏「Mock」视图集中管理已发布路由 —— 方法 / 路径 / 状态码 / 响应格式 / 延迟(0–5s)/ 启用开关,支持保存草稿、一键发布全部、试运行与 GET /demo 示例;</li>
<li><strong>访问控制</strong>:可开启 Bearer 密钥校验(只存摘要、可随时替换);来源默认仅本机与内网网段,公网访问需显式设置 <code>OPSXAPI_MOCK_ALLOW_PUBLIC=1</code>;</li>
<li><strong>一键建 Mock</strong>:HTTP 编辑器可「用本次响应创建 Mock」,把真实返回直接变成 Mock 模板;</li>
<li><strong>每次请求随机生成</strong>:响应模板里的 <code>@cname</code>、<code>@integer(...)</code> 等表达式由服务端实时求值;</li>
<li>发布时自动把智能 Mock 规则烘焙进模板(开启智能匹配时);</li>
<li>非 GET 接口可用 <code>?_method=POST</code> 快速验证;延迟最高 5 秒,用于模拟慢接口 / loading 态。</li>
+2
View File
@@ -124,6 +124,8 @@
<div class="nav-group">
<div class="nav-group-title">参考</div>
<a class="nav-link" href="/docs/license">授权与激活</a>
<a class="nav-link" href="/docs/server-api">服务端 API 参考</a>
<a class="nav-link" href="/docs/faq">常见问题</a>
+2
View File
@@ -124,6 +124,8 @@
<div class="nav-group">
<div class="nav-group-title">参考</div>
<a class="nav-link" href="/docs/license">授权与激活</a>
<a class="nav-link" href="/docs/server-api">服务端 API 参考</a>
<a class="nav-link" href="/docs/faq">常见问题</a>
+1 -1
View File
@@ -1 +1 @@
[{"Slug":"intro","Title":"产品介绍","Group":"开始使用","Text":"OpsxAPI 是一款 本地优先 的专业接口工作台,面向运维与开发,把 HTTP、GraphQL、WebSocket、SSE、Socket.IO、MQTT 六种协议的调试放进同一个窗口。 无需注册、无需联网同步,数据全部保存在本地浏览器(localStorage),导出备份随时带走。 功能总览 能力 说明 六种协议 HTTP / GraphQL / WebSocket / SSE / Socket.IO / MQTT 集合管理 目录树、搜索、右键菜单、拖拽移动、多标签页 多环境变量 、 全局替换,一键切换环境 数据导入 OpenAPI/Swagger、Postman、Apifox、Apipost、cURL、HAR、Insomnia、Hoppscotch、Markdown 等 数据导出 OpenAPI 3.0、Postman v2.1、Markdown 文档、全量备份 代码生成 cURL / JavaScript fetch / Python requests / Go net/http 代理能力 本地 Gin 代理绕开 CORS;WebSocket 隧道支持自定义握手 Header 双端形态 浏览器(Web)与桌面端(Tauri)共用同一套界面 支持的协议与场景 协议 典型场景 特色 HTTP / REST 调试 REST 接口、运维平台 API 7 种方法、6 种请求体、3 种鉴权 GraphQL 查询网关、中台接口 Query + Variables 独立编辑 WebSocket 实时推送、行情、IM 自定义握手 Header(经本地隧道) SSE AI 流式输出、监控事件流 直连失败自动切代理、断点续传 Socket.IO Node 实时应用 事件监听、emit 参数、path/auth 配置 MQTT IoT 设备、消息总线 通配符订阅、QoS、自动重连 为什么选 OpsxAPI 数据主权 :所有集合、环境、历史保存在本机,不经过任何第三方服务器。 开箱即用 : 一条命令启动;首次打开自带覆盖全部协议的示例集合。 工程友好 :导入自动建目录、路径参数自动转变量;导出即标准 OpenAPI,可回流 Apifox / Swagger 生态。 轻量克制 :一个 Go 二进制 + 一份前端,资源占用小,内网可部署。 提示 :想快速感受?直接看下一章《快速开始》,30 秒发出第一个请求。"},{"Slug":"quickstart","Title":"快速开始","Group":"开始使用","Text":"环境要求 组件 版本 用途 Node.js ≥ 20 Web 前端(Vite) Go ≥ 1.23 本地代理服务(Gin) Rust + Cargo 可选 仅编译桌面端(Tauri)时需要 启动 看到下面的输出即可打开浏览器: 命令 说明 浏览器版(推荐) 桌面窗口(Tauri,共用同一 UI) Web + 桌面一起开 / 查看状态 / 停止 30 秒发出第一个请求 1. 打开 \u003chttp://127.0.0.1:5173 ,左侧是内置的「示例集合」。 2. 点击 HTTP · httpbin → 获取请求回显 。 3. 点击右上角 发送 。 4. 下方响应区显示 、耗时与 JSON 高亮响应体 —— 完成! 桌面端(可选) 桌面端复用同一份界面与数据通道,HTTP 请求走 Tauri 原生网络栈,不依赖浏览器 CORS。 提示 :首次打开会自动创建两个环境(正式 / 本地)和一个覆盖全部协议的示例集合,可随时在「设置」中重置。"},{"Slug":"interface","Title":"界面导览","Group":"开始使用","Text":"OpsxAPI 主界面分为五个区域: 顶栏 元素 作用 + 新建 快捷创建各协议请求 / 目录(默认建在第一个集合) 导入 / 导出 打开数据导入、导出对话框 环境选择器 切换当前环境(变量随之生效),「⚙ 环境」管理环境与变量 🌙 / ☀️ 明暗主题切换 ⋯ 设置(主题、超时、重置工作区) 左侧集合树 点击请求 → 在标签页中打开;点击目录 → 展开 / 折叠。 右键 任意节点:新建、重命名、复制、导出、删除。 拖拽 请求或目录到另一个目录,即可移动(支持跨集合)。 顶部搜索框按名称 / 方法 / URL 实时过滤。 底部为 历史记录 :显示最近请求的状态码与耗时,点击可回跳到对应接口。 标签页栏 同时打开多个接口,中键或 × 关闭;右键支持「关闭其他 / 关闭全部」。正在连接中的实时协议标签会显示呼吸圆点。 请求编辑区(上半部分) 按协议呈现不同编辑器: 协议 标签页 HTTP Params · Body · Headers · Cookies · Auth · 说明 GraphQL Query · Variables · Headers · Auth WebSocket 消息 · 握手配置 · 说明 SSE 事件流 · 连接配置 · 说明 Socket.IO 事件 · 连接配置 · 说明 MQTT 消息 · Broker / 订阅 · 发布 · 说明 响应区(下半部分) HTTP / GraphQL :响应体(Pretty JSON 高亮)、Raw、响应头,右上角状态 / 耗时 / 大小 / 复制。 实时协议 :分色消息日志(接收 · 绿、发送 · 蓝、系统 · 灰、错误 · 红),顶部实时统计收发条数与连接时长。"},{"Slug":"http","Title":"发送 HTTP 请求","Group":"请求调试","Text":"发送请求 1. 选择方法(GET / POST / PUT / PATCH / DELETE / HEAD / OPTIONS)。 2. 输入 URL,支持 形式的变量(见《环境与变量》)。 3. 点击 发送 ,Line truncated
[{"Slug":"intro","Title":"产品介绍","Group":"开始使用","Text":"OpsxAPI 是一款 本地优先 的专业接口工作台,面向运维与开发,把 HTTP、GraphQL、WebSocket、SSE、Socket.IO、MQTT 六种协议的调试放进同一个窗口。 无需注册、无需联网同步,数据全部保存在本地浏览器(localStorage),导出备份随时带走。 功能总览 能力 说明 六种协议 HTTP / GraphQL / WebSocket / SSE / Socket.IO / MQTT 集合管理 目录树、搜索、右键菜单、拖拽移动、多标签页 多环境变量 、 全局替换,一键切换环境 数据导入 OpenAPI/Swagger、Postman、Apifox、Apipost、cURL、HAR、Insomnia、Hoppscotch、Markdown 等 数据导出 OpenAPI 3.0、Postman v2.1、Markdown 文档、全量备份 代码生成 cURL / JavaScript fetch / Python requests / Go net/http 代理能力 本地 Gin 代理绕开 CORS;WebSocket 隧道支持自定义握手 Header 双端形态 浏览器(Web)与桌面端(Tauri)共用同一套界面 支持的协议与场景 协议 典型场景 特色 HTTP / REST 调试 REST 接口、运维平台 API 7 种方法、6 种请求体、3 种鉴权 GraphQL 查询网关、中台接口 Query + Variables 独立编辑 WebSocket 实时推送、行情、IM 自定义握手 Header(经本地隧道) SSE AI 流式输出、监控事件流 直连失败自动切代理、断点续传 Socket.IO Node 实时应用 事件监听、emit 参数、path/auth 配置 MQTT IoT 设备、消息总线 通配符订阅、QoS、自动重连 为什么选 OpsxAPI 数据主权 :所有集合、环境、历史保存在本机,不经过任何第三方服务器。 开箱即用 : 一条命令启动;首次打开自带覆盖全部协议的示例集合。 工程友好 :导入自动建目录、路径参数自动转变量;导出即标准 OpenAPI,可回流 Apifox / Swagger 生态。 轻量克制 :一个 Go 二进制 + 一份前端,资源占用小,内网可部署。 提示 :想快速感受?直接看下一章《快速开始》,30 秒发出第一个请求。"},{"Slug":"quickstart","Title":"快速开始","Group":"开始使用","Text":"环境要求 组件 版本 用途 Node.js ≥ 20 Web 前端(Vite) Go ≥ 1.23 本地代理服务(Gin) Rust + Cargo 可选 仅编译桌面端(Tauri)时需要 启动 看到下面的输出即可打开浏览器: 命令 说明 浏览器版(推荐) 桌面窗口(Tauri,共用同一 UI) Web + 桌面一起开 / 查看状态 / 停止 30 秒发出第一个请求 1. 打开 \u003chttp://127.0.0.1:5173 ,左侧是内置的「示例集合」。 2. 点击 HTTP · httpbin → 获取请求回显 。 3. 点击右上角 发送 。 4. 下方响应区显示 、耗时与 JSON 高亮响应体 —— 完成! 桌面端(可选) 桌面端复用同一份界面与数据通道,HTTP 请求走 Tauri 原生网络栈,不依赖浏览器 CORS。 提示 :首次打开会自动创建两个环境(正式 / 本地)和一个覆盖全部协议的示例集合,可随时在「设置」中重置。"},{"Slug":"interface","Title":"界面导览","Group":"开始使用","Text":"OpsxAPI 主界面由「活动栏 + 顶栏 + 侧栏 + 标签页 + 编辑区」组成: 活动栏(最左窄栏) 元素 作用 空间徽标(顶部) 切换 本地空间 / 我的空间 / 团队空间;云端空间显示同步状态点 接口 / 历史 / 测试 / 文档 / Mock 主导航:接口工作台、请求历史、自动化测试、接口文档、Mock 管理 授权徽章 试用倒计时或已授权状态,点击进入 设置 → 授权 设置 / 账号 设置中心;账号菜单(团队管理、立即同步、退出登录) 顶栏 元素 作用 + 新建 六种协议请求 / 目录(默认建在第一个集合) 导入 / 导出 数据导入(十种格式)与导出对话框 环境选择器 切换当前环境(变量与前置 URL 随之生效),可直达环境管理 左侧栏(接口 历史 分段) 接口 :集合树 — 点击请求在标签页打开,目录展开 / 折叠; 右键 新建 / 重命名 / 复制 / 导出 / 删除; 拖拽 移动(支持跨集合);顶部搜索实时过滤。 历史 :最近请求自动归档(状态码 / 耗时),点击回跳对应接口,支持一键清空。 标签页栏 同时打开多个接口,中键或 × 关闭;右键支持「关闭其他 / 关闭全部」。正在连接中的实时协议标签会显示呼吸圆点。 请求编辑区(上半部分) 按协议呈现不同编辑器: 协议 标签页 HTTP Params · Body · Headers · Cookies · Auth · 说明 GraphQL Query · Variables · Headers · Auth WebSocket 消息 · 握手配置 · 说明 SSE 事件流 · 连接配置 · 说明 Socket.IO 事件 · 连接配置 · 说明 MQTT 消息 · Broker / 订阅 · 发布 · 说明 响应区(下半部分) HTTP / GraphQL :响应体(Pretty JSON 高亮)、Raw、响应头,右上角状态 / 耗时 / 大小 / 复制。 实时协议 :分色消息日志(接Line truncated
+3 -1
View File
@@ -124,6 +124,8 @@
<div class="nav-group">
<div class="nav-group-title">参考</div>
<a class="nav-link" href="/docs/license">授权与激活</a>
<a class="nav-link active" href="/docs/server-api">服务端 API 参考</a>
<a class="nav-link" href="/docs/faq">常见问题</a>
@@ -238,7 +240,7 @@ curl -s -X POST http://127.0.0.1:8787/v1/proxy/ws/close \
<div class="pn-nav">
<a class="pn prev" href="/docs/account"><span class="pn-label">← 上一页</span><span class="pn-title">账号与团队</span></a>
<a class="pn prev" href="/docs/license"><span class="pn-label">← 上一页</span><span class="pn-title">授权与激活</span></a>
<a class="pn next" href="/docs/faq"><span class="pn-label">下一页 →</span><span class="pn-title">常见问题</span></a>
+2
View File
@@ -124,6 +124,8 @@
<div class="nav-group">
<div class="nav-group-title">参考</div>
<a class="nav-link" href="/docs/license">授权与激活</a>
<a class="nav-link" href="/docs/server-api">服务端 API 参考</a>
<a class="nav-link" href="/docs/faq">常见问题</a>
+2
View File
@@ -124,6 +124,8 @@
<div class="nav-group">
<div class="nav-group-title">参考</div>
<a class="nav-link" href="/docs/license">授权与激活</a>
<a class="nav-link" href="/docs/server-api">服务端 API 参考</a>
<a class="nav-link" href="/docs/faq">常见问题</a>
+8 -4
View File
@@ -124,6 +124,8 @@
<div class="nav-group">
<div class="nav-group-title">参考</div>
<a class="nav-link" href="/docs/license">授权与激活</a>
<a class="nav-link" href="/docs/server-api">服务端 API 参考</a>
<a class="nav-link" href="/docs/faq">常见问题</a>
@@ -167,7 +169,7 @@
</tbody>
</table>
<h2 id="sec-1">场景用例</h2>
<p>从侧栏底部「自动化测试」进入。用例 = 有序步骤列表,每个步骤:</p>
<p>从活动栏「测试」进入。用例 = 有序步骤列表,每个步骤:</p>
<ul>
<li><strong>引用一个 HTTP 接口</strong>(从集合中选择,可跨集合、跨目录);</li>
<li><strong>断言</strong>:状态码 / 耗时 / Header / Body 四类目标,支持 等于、不等于、大于、小于、包含、存在 与 <strong>JSONPath</strong> 取值比较;</li>
@@ -179,14 +181,16 @@
<ul>
<li>统计卡:通过 / 失败步骤数、总耗时、断言数、通过率;</li>
<li>步骤明细:方法 + URL + 状态码 + 耗时,逐条断言的期望 / 实际对照(可按 通过 / 失败 过滤);</li>
<li>「再次运行」一键回归;「导出报告」生成 Markdown 存档或归档到缺陷单;</li>
<li>「再次运行」一键回归;「导出报告」生成 Markdown(含断言对照表,适合贴缺陷单)或 JSON(<code>opsxapi.test-run.v1</code> 结构,供 CI / 脚本二次处理);</li>
<li>每个用例保留最近 50 次运行记录,可下拉切换历史报告。</li>
</ul>
<h2 id="sec-3">定时任务</h2>
<p>用例头部的 ⏱ 按钮或左侧「定时任务」入口:</p>
<p>用例头部的 ⏱ 按钮或左侧「定时任务」入口,两种节奏:</p>
<ul>
<li>间隔可选 5 / 15 / 30 / 60 分钟、6 小时、每天;</li>
<li><strong>固定间隔</strong>:5 / 15 / 30 / 60 分钟 · 6 小时 · 每天;</li>
<li><strong>Cron 表达式</strong>:标准 5 段(分 时 日 月 周,本地时区),例如每 15 分钟 <code>*/15 * * * *</code>、每个工作日 9 点半 <code>30 9 * * 1-5</code>;</li>
<li>独立 启用 / 暂停 开关,显示下次运行时间与上次结果;</li>
<li>调度器每 15 秒巡检一次,同一用例运行中不会重复触发;每个任务环形保留最近 30 条运行日志;</li>
<li><strong>应用保持运行时生效</strong>:OpsxAPI 窗口(或 Web 页面)开着才会按时触发并记录报告,关闭后自动暂停 —— 适合工作时段的持续监控,不能替代服务器侧的 CI。</li>
</ul>
<blockquote>
+2
View File
@@ -124,6 +124,8 @@
<div class="nav-group">
<div class="nav-group-title">参考</div>
<a class="nav-link" href="/docs/license">授权与激活</a>
<a class="nav-link" href="/docs/server-api">服务端 API 参考</a>
<a class="nav-link" href="/docs/faq">常见问题</a>