定位

ApiChain 是一款开源、支持内网私有化部署的接口文档管理与自动化测试工具。核心设计思路是以迭代为单位管理接口，迭代结束后合并到项目基线库，形成可持续运行的回归测试集。

• 开源地址：Gitee onlinetool/apichain
• 客户端：Windows / macOS / Linux
• 部署方式：单机本地使用，或内网团队部署（Docker，数据不出内网）

核心功能

1. 迭代 + 项目双轨管理

ApiChain 的组织结构是「项目 → 迭代 → 接口用例」。

• 每个迭代独立维护接口文档和调试用例
• 迭代上线后，一键将新增接口合并到项目基准库
• 项目库保存稳定版接口，作为长期回归基线
• 迭代文档支持生成临时分享链接，可导出 Markdown / HTML

这样做的好处是：迭代过程中文档可以灵活变动，上线后又不会丢失版本记录。

2. 多层级环境变量

支持三级变量隔离：全局变量 → 项目环境 → 迭代环境。开发、测试、预发各用各的变量，互不干扰。

3. 接口串联测试

支持按顺序执行多条接口，自动提取上一步返回的 Cookie、Header、JSON 字段传给下游接口。内置随机参数和时间戳生成，测试数据不固化，用例可反复执行。

4. 数据库断言

除常规的 HTTP 响应校验外，支持直连 MySQL 执行 SQL 查询，将数据库实际数据与接口返回值做比对。测试完成后可自动清理测试数据。适用于需要验证数据一致性的场景（如资金、库存相关接口）。

5. AI 语义检索

接入大模型向量检索，支持用自然语言搜索接口，不需要精确匹配关键字。同时可根据 JSON 报文自动生成字段注释和后端实体类代码。

6. 迭代文档整合

迭代文档可关联需求链接、UI 稿、数据库脚本、配置变更记录。一份文档覆盖本次迭代的全部变更内容。

7. 团队协作

内网部署 Runner 服务后，团队成员共享项目与接口文档。支持在浏览器中直接打开文档并发起请求，不要求全员安装客户端。

典型工作流

新建项目 → 划分迭代
  → 在迭代下添加接口、调试、编写用例
  → 配置断言（响应校验 + SQL 校验），执行自动化测试
  → 迭代上线，一键合并接口到项目基线库
  → 后续迭代完成后，运行基线用例做全量回归

文档导出与共享

与 Apifox / Postman 的差异

需要说明的是，Apifox / Postman 在前端 Mock、协议支持广度、插件生态方面更成熟。ApiChain 侧重的是迭代管理和回归测试这个方向，两者定位不完全相同。

适用场景

• 迭代节奏较快的敏捷团队，需要持续做回归测试
• 微服务项目，接口多且变更频繁
• 对数据安全有要求，接口数据不能上传第三方平台
• 希望接口文档和测试用例统一管理，减少文档与代码脱节

当前的不足

• 暂未支持 OpenAPI（Swagger）双向同步
• 数据库断言仅支持 MySQL，不支持 Redis、MongoDB 等
• 前端 Mock 能力较弱，更偏后端接口管理与自动化测试