NBA-API：测接口、写文档、定时巡检、AI 助手、群聊，一个浏览器全部搞定

给开发、测试、产品团队的浏览器端 API 平台。
内网可私有化，本机也能落地。不换客户端，打开页面就能测。
开源仓库：https://github.com/fushengruomengzhang/NBA-API · https://gitee.com/fusheng_zhang/NBA-API

---

接口调试这件事，很多团队其实已经「工具够多了」：Postman 测请求，Swagger 看文档，文档再另开一份 Wiki，巡检又要写脚本，对齐还得切到即时通讯。工具越多，上下文越碎。

NBA-API 要解决的不是「再做一个请求发送器」，而是把团队每天绕接口转的几件事收进同一个浏览器页面：

测接口、写文档、定时调度、AI 助手、群聊。

左侧一条导航走完：API → Swagger → 组合文档 → 定时 → AI 助手 → 群聊 → 配置 → 帮助；底栏还能看近 30 天的数据沉淀。

打开就是工作区：左侧目录树，右侧方法 / 域名 / 路径 / 执行；Header、Query、Body、Script、Version 都在同一屏。Fetch 导入、分享、执行 N 次、记录版本，都在下拉菜单里。

---

项目特色

NBA-API 不是「再做一个 Postman」，而是把测、写、跑、AI、群收进同一条侧栏。下面这些是它和其他工具真正拉开差距的地方。

特色	一句话
浏览器即客户端	打开页面就能测，支持内网私有化与本机落地，不必再装桌面端
自动启用插件	远程页面直连本机 localhost / 127.0.0.1，HTTP 经篡改猴代发，无需代理
全协议一站测	HTTP(S) / SSE / WebSocket 全覆盖，RESTful、JSON5、文件上传都在同一工作区
侧栏闭环	API → Swagger → 组合文档 → 定时 → AI 助手 → 群聊 → 配置，一条导航走完
分享零安装	单个 / 批量 / 已打开标签都能出链接，对方浏览器打开即测
远程 + 本地双库	团队接口上服务器，敏感接口橘黄色只留本机；域名、请求头同样可分远程 / 本地
文档跟测走	Fetch 一键进库、Java 注解转字段说明、组合文档协同编辑，测完就能写、能分享
定时直接关联 API	CRON / RRULE / 时间戳，调度中心点选远程接口即可巡检，日志可下载
AI 密钥不出本机	DeepSeek / 千问 / 千帆 / 本地模型；侧栏抽屉私聊，群里需要再 @AI 发送到群
Swagger 不入库	填 OpenAPI 地址即可联调，对照现网、测完即走，不污染团队接口树

三点最能记住的：

1. 测得全 — HTTP / SSE / WebSocket，执行 N 次对照「结果 N」，Swagger 管理即可联调。
2. 文档跟测走 — 预览、组合文档、分享链接、多人协同，接口说明不再另开一份 Wiki。
3. 环境与协作不卡脖子 — 插件测本机 localhost；本地库保隐私；齿轮配 AI 密钥仅存本机；侧栏 AI 与群聊同级，底栏还能看近 30 天沉淀。

适合谁： 后端维护接口库、前端按文档联调、测试巡检与批量执行、小团队在线对齐与 AI 辅助。

---

为什么值得换（或值得补）这一套

主流工具各有所长：Postman、Apifox 生态完整，Insomnia 轻，Swagger / Knife4j 跟代码近，YApi 偏文档。但一线联调里，下面这些问题仍然常见：

• 工具在内网服务器上，接口却在本机 localhost，服务器根本打不到。
• HTTP 能测，SSE、WebSocket 要换工具或写临时脚本。
• 文档和接口库脱节：测完还要再抄一遍说明。
• 定时巡检要另开 Monitor，或自己写 cron。
• AI 在别的产品里，群聊在别的窗口里，密钥还要上云。
• 敏感接口不想进团队库，本地又没有像样的隔离。

NBA-API 把这些收成一条工作流，并在几个关键点上做了针对性能力。

---

十个真正能打的点

1. 远程页面，直接测本机 localhost

工具部署在内网或远程服务器时，目标接口经常在开发者本机。装好篡改猴，打开齿轮里的「自动启用插件」，对本机 127.0.0.1 / localhost 的 HTTP 请求会自动从浏览器发出，不必再开本地客户端，也不必再搭一层代理。

单个接口也能强制「使用插件」代发。WebSocket 始终由浏览器直连，不走这套代发。脚本不用自己拼：插件管理里「查看脚本」，@match 已按当前站点填好，复制到篡改猴即可。用户名、AI 密钥、全局请求头、远程/本地域名、自动保存、暗色模式，同样收在这个齿轮里。

2. HTTP、SSE、WebSocket，一站覆盖

• HTTP：GET / POST / PUT / DELETE，RESTful 路径参数（如 /user/{id}）
• Body：JSON5（可写注释）、multipart、表单；文件下载可直接保存
• SSE：流式内容在「结果 N」的 Data 里实时刷新
• WebSocket：连接、子协议、Query 鉴权、多格式收发

测接口不必在三种协议之间来回换工具。

3. 测、写、跑、问 AI、拉群，侧栏闭环

动作	在哪完成
测	接口树、多标签、域名与 Context-Path / Prefix / Path 拼接
写	单接口预览、多 API 组合文档（协同 / 分享 / 下载）
跑	定时任务：CRON / RRULE / 时间戳，直接关联 API 巡检
问	侧栏 AI 抽屉，本机私聊，测接口时可以同时开着
聊	轻量群聊；需要时 @AI助手，再选择「发送到群」
配	齿轮管环境；问号进手册；底栏看近 30 天新增

测完就能写成文档。勾选一组远程 API，进入组合文档编辑器：接口说明、字段示例、前端调用代码可以写在同一份文档里，协同、分享、下载都在工具条上。

文档能分享，接口也能定时跑。调度中心直接关联远程 API，CRON / RRULE / 时间戳三种表达式，启动、暂停、查日志都在一张表上。

卡住了可以先问本机 AI，再决定要不要同步到群。

4. 分享零安装，多端实时协同

单个 API、已打开的标签、批量勾选，都能生成分享链接。对方用浏览器打开就能测，不用装客户端。

远程 API 多人编辑时，保存方更新后，其他端标签旁会出现同步图标，点一下拉取最新。组合文档支持多人协同（先配用户名）。

分享页是另一套精简壳：能测这次分享的内容，不会写进团队库。

5. 远程库 + 本地库，协作和隐私分开

• 远程 API：存服务器，团队共享，可分享、可进组合文档、可多端同步
• 本地 API（橘黄色标记）：只在本机，适合临时调试和敏感接口
• 远程域名团队共享，本地域名仅本机
• 全局请求头本机缓存，同名时优先于接口 Header 和插件请求头

不想上云的接口，就不要上云。需要对齐的接口，自然进远程库。

6. 批量压测和流程编排，结果一屏对照

单接口可「执行 N 次」，每次对应一个可关闭的「结果 N」标签，耗时有折线图。多标签支持顺序执行或并行执行（自动跳过 WebSocket / SSE）。响应头还能右键回填到请求头。

适合冒烟、回归，也适合看同一接口连续打几次的差异。

7. Fetch 一键进库，Java 注解转文档

浏览器 Network 里 Copy as fetch，粘进「FetchCode To API」，方法、URL、Header、Body 直接覆盖到当前接口，微调就能执行。

上传带 Swagger 注解的 Java 源码，可以生成字段说明，再一键产出 JSON 示例。现网 OpenAPI 则走侧栏「Swagger 管理」：填 docs 地址、点接口、立刻执行，不写入团队库，适合对照现网临时联调。

8. 脚本预处理 + 版本快照

getVersion / buildParam / buildMessage 可在发送前改参数或消息：时间戳、签名、按次数变化的测试数据，都能写在接口自己的 Script 里。响应区有可交互 Console，能看脚本日志，也支持 help / tail 一类命令。

版本可记录、可回滚。打开自动保存后，请求成功就会更新有编辑的接口。

9. AI 密钥只在本机，助手和群聊分开

支持 DeepSeek、千问、千帆，以及兼容 OpenAI 的本地模型。密钥和本地 Base-Url 只存在本机，不上传服务器。

侧栏点开机器人，右侧滑出 AI 助手抽屉：选智能体和思考模式，直接对话。测接口时抽屉可以一直开着，消息不上群、不广播。

需要对齐时再进群。群里可以 @AI助手 多轮，确认后再「发送到群」；角色（产品 / 后端 / 前端 / 测试）会影响助手风格。

群聊定位是「在线时的协作通道」，不做离线补传和历史漫游。

10. 内网私有化，开箱就能配环境

用户名与角色、AI 密钥、全局执行次数、全局 Header、插件请求头、远程/本地域名、插件管理、自动保存、暗色模式，全部收在侧栏齿轮里。API 树可拖拽、可搜索，目录会继承 Context-Path 与 Prefix。

远程服务暂时不通时，API 管理和 Swagger 管理仍可做本机联调，不会整站罢工。

---

和常见工具比一比

能力	NBA-API	主流工具常见情况
HTTP / SSE / WebSocket	全支持	HTTP 普遍；SSE / WS 因工具而异
浏览器在线 + 私有化部署	支持	Postman / Apifox 私有化多为企业版
组合文档 + 协同编辑	支持	Swagger / YApi 偏只读或弱协同
定时调度 API	内置	多数需 Monitor 付费或另写脚本
远程页面测本机 localhost	「自动启用插件」	通常需本地客户端或代理
本地私密 API（不上云）	支持	较少支持
群聊 + 本机 AI	内置	多数不内置或需另装
Fetch 一键导入	支持	多数不支持
Mock / CI 集成	暂无	Postman / Apifox 更强

一句话：联调、文档、巡检、本机隐私、内网部署，NBA-API 更贴一线；Mock 和 CI 流水线，仍可继续用现有工具补齐。

---

谁适合用

• 后端：维护团队接口库，版本快照、脚本签名、定时巡检都在同一棵树上
• 前端：按组合文档联调，Fetch 导入现网请求，分享链接给后端对现象
• 测试：执行 N 次、顺序/并行跑一组接口，CRON 做冒烟，日志可下载
• 小团队：内网一套页面，测完能写、能分享、能拉群，AI 密钥不出本机

---

几个马上能跑起来的场景

新成员第一天
配用户名、角色、远程域名和全局 Token，打开接口直接执行。要用 AI 再填本机密钥。

本地 Spring Boot
装篡改猴 → 齿轮「插件管理」复制脚本 → 打开「自动启用插件」→ 域名填 localhost:8080 → 执行。

对照现网 Swagger
侧栏 Swagger 管理 → 填 docs 地址 → 加载 → 点接口执行。不落库，测完即走。

接口说明给前端
勾选一组远程 API → 编辑组合文档 → 分享链接。对方浏览器打开就能读、能测。

每晚巡检
新建定时任务，CRON 关联关键接口，启动后看日志，需要时下载历史。

卡住先问 AI，再同步到群
侧栏抽屉本机问一轮；要对齐时进群 @AI助手，确认后再「发送到群」。

---

开源仓库

项目开源，欢迎 Star、Issue 和 PR。国内访问优先 Gitee。

平台	地址
GitHub	https://github.com/fushengruomengzhang/NBA-API
Gitee	https://gitee.com/fusheng_zhang/NBA-API

---

一句话收束

NBA-API 是团队在线 API 测试与文档平台——测接口、写文档、定时调度、AI 助手、群聊，一个工具搞定。

测得全（HTTP / SSE / WebSocket），文档跟测走（组合文档、分享、协同），环境不卡脖子（插件测 localhost、本地库保隐私、密钥不出本机）。

适合已经厌倦「五个窗口测一个接口」的团队，也适合必须私有化、又希望打开浏览器就能干活的内网环境。