当 AI 开始写代码,OpenAPI 必须重构

18 阅读2分钟

一、一个被忽视的问题:国内平台 OpenAPI 很难被 AI 直接用

现在大家都在谈 AI 自动写代码。

但在真实开发中,你会遇到一个问题:

AI 会写代码,但不会“调研接口”。

比如你想让 AI 帮你开发:

  • 淘宝商品查询

  • 京东订单管理

  • 拼多多商品上架

  • 抖音电商接口调用

AI 面对的是:

  • 各个平台独立的 OpenAPI 文档

  • 不同的参数命名规则

  • 不同的分页结构

  • 不同的签名方式

  • 分散在多个网站的文档结构

这些 OpenAPI 文档是给“人”看的,不是给“AI”看的。

结果就是:

  • AI 很难系统化理解所有接口
  • 无法做自动接口筛选
  • 无法做跨平台接口对比
  • 无法做接口能力调研

二、AI 开发时代,需要一个“接口知识层”

如果你认真思考 AI 自动开发流程,会发现它应该是:

  1. 读取接口能力

  2. 查询相关接口

  3. 对比参数结构

  4. 选择最优接口

  5. 生成调用代码

  6. 自动测试

但现实是:

第一步就卡住了。

因为接口文档:

  • 分散

  • 不统一

  • 不结构化

  • 不可批量查询

于是我做了 SpecFusion。


三、SpecFusion 是做什么的?

一句话:

聚合国内主流平台 OpenAPI,并进行结构标准化,让 AI 可以直接查询与调用。

它做三件事:

  1. 统一 OpenAPI 结构

  2. 构建可查询的接口索引

  3. 为 AI 提供标准化接口能力描述

目标是:

让 AI 能够完成:

  • 自动接口调研
  • 自动接口选择
  • 自动生成调用代码
  • 自动完成电商系统对接

四、一个真实场景

假设你想让 AI 帮你做一个“多平台商品同步系统”。

正常流程是:

  • 手动查 5 个平台文档

  • 手动比对字段

  • 手动适配参数

  • 写适配层

  • 测试

AI 时代的理想流程应该是:

  • AI 查询 SpecFusion 索引

  • 找到“商品查询”相关接口

  • 对比字段结构

  • 自动生成适配代码

这才是真正的自动化开发。


五、为什么这是未来方向?

因为:

AI 写代码已经不是问题。

问题是:

AI 如何理解平台能力?

OpenAPI 本身没有错。

但:

  • 它没有被统一建模

  • 没有被聚合

  • 没有被索引

  • 没有被结构对齐

SpecFusion 本质是:

为 AI 构建一个接口能力数据库。


六、项目地址

GitHub:

github.com/wxkingstar/…

目前还在持续完善中。

后续计划:

  • 增加更多平台适配
  • 增强接口索引能力
  • 增加 AI 调用示例
  • 提供自动代码生成支持

欢迎交流。