一起加群呗

兄弟，一起合作开发一款大模型接口调试工具如何？

好建议呀！只不过我看不到它的组件？它是一个组件库，还是说是个框架提供了封装组件的基类？

我好像试过那个，但是不能完全满足我的要求。首先，它只能生成文档，不能帮助完成代码。比如，它定义了接口接受参数 name、age，它可以测试接口是否符合要求，但不能帮助接口自动实现这套逻辑，你还得在 Rails 里写上诸如 param.permit(:name, :age) 这样的逻辑。其次，它还是有文档与实现不一致的地方，这也是目前几乎所有 Ruby 框架都存在的问题，文档对于它们来说不是第一性的。

我还是那个观点，Rails 作为全栈框架不适合作为纯 API 的开发，推荐用 Grape，也推荐用我的 meta-api. 就文档生成方面，rswag 的效果不见得比 grape-swagger 做得更好。只不过，在你已经熟悉 Rails 的情况下，用 rswag 可能就是最好的选择了吧。人生苦短，再上手一个新框架，费时费力不讨好。

我后续想将 meta-api 作为 Rails 的一款插件挂载在上面，作为参数校验器和文档生成辅助。只不过开发框架费时费力还费脑，我不太有时间精力弄这个。

联系我邮箱 [email protected]

可分享一下我最近发布的新框架吗？

顶一个

rust 和 ts 有什么联系？

楼主关注我的 Web 框架吗？ https://github.com/yetrun/web-frame

推荐一下我的项目。

1. (meta-api) 一个代码和文档相结合的工具，深度融合 OpenAPI 3.x 规范

https://github.com/yetrun/web-frame

使用 Ruby 语言。

2. 接上，一个 OpenAPI 3.x 或 Swagger 2.x 文档预览和协作工具

https://gitee.com/yetrun/openapi-teamwork

这个好一点，使用 Ruby、TypeScript 语言，框架使用的是 meta-api 和 React. 项目效果可见：

http://openapi.yet.run

有兴趣可贡献一波，极度欢迎。

看了一下写文档还是需要写注释。朋友们可关注一下我的项目，可直接从代码生成文档：

https://github.com/yetrun/web-frame

使用 Ruby DSL 构建应用，非常适合 Ruby China 的小伙伴。

当然和楼主不形成竞争关系啊，我的是 Ruby 项目，楼主是 Java 项目下的插件。

[为我那人气寥寥的项目再宣惯一波。 狗头保命]

有遇到问题，或不理解的，或感兴趣的，或想提意见的欢迎与我交流，感激不尽。

最后，也想了解下 www.apifox.cn，对比我们直接构建 API 有什么优势，比较适合何种场景。

牛皮啊，才知道还可以这么用

谢谢你的建议，这是按照标准开源项目的模式去展开的思路。

不过真在实施时会有很多问题。因为后发劣势和个人开发，我的项目发展有很大的不确定性，大概率是达不成多大的流行度的，何况我做的是框架这种偏基础的构建，竞品太多了。说实话，我只是按照这个理念作个人感兴趣的东西，也就是我不喜欢 Rails 的地方，改造为我喜欢的方式去开发。所以，当前的情况还是个人开发的阶段，还没达到形成一个组织开源的程度。

我个人是非常在意文档的，所以文档我是提供了的：教程。其中也是有示例。如果觉得上手不够方便，我也提供了一个脚手架，开箱即用，方便学习和调试。

至于开源协议，我还并没有深究，毕竟自己用 LGPL 和 Apache 惯了。至于不用 MIT，我发现大部分项目好像是用的这个，比如 Rails. 我不确定一定要用它的理由，不过既然存在就是合理的吧。LGPL-2.1 是这样的，如果你只是引入这个库，那你的项目是不用开源的；但如果你要修改这个库（二次开发），你就一定要开源，回馈给社区。我感到奇怪的就是，像这种基础框架的部份，闭源的意义何在？所以，如果有绝对的理由，我可能会换成别的开源协议。

最后和 Rails 的比较，我在三楼里也提了一嘴，希望能够说明一些情况。我一开始没想到与这种那种框架作比较，只是提供一个新的理念和思路，供同样感兴趣和有同样需求的人去选择。如果真要走这一步，要“踩”在 Rails 的脚上才能有发展的机会，我未来可能会花一定的精力去写相关的比较文档。

最后，我总结下：目前我的项目仍然是小众项目，还在寻求“共鸣”的阶段。我自己提出了个理念，然后做了个尝试，证明一下它的可行性。既然有可行性，那么我就寻找“共鸣”了。只有“共鸣”了，我才有继续做大做全的动力，甚至到了这个阶段就不是我一个人的事了，需要更多人参与才能实现。所以，在目前阶段，我主要的精力不会花在我的项目更加规范方面，而是在一点一点小心谨慎地寻求“共鸣”上。

这区别挺大的，毕竟是两个框架了。Rails API 模式仍然是基于 Rails 的，它仍是属于 MVC 模式的框架，譬如定义路由，编写控制器，以及要用 JBuilder 去渲染视图。Meta 框架就不属于这种 MVC 模式了，它天生地只适用于 API Only，不能做全栈框架。Meta 框架是用声明式的语法编写 API，比如声明它的参数模式是，它的返回值模式是等等。同时，它天生地就与 API 文档结合，在编写声明式 API 时自动生成文档，不用再写两遍。

11 月 22 日有更新，顶一下

都已经 10 月 13 日，我才知道还能这么搞。那么我选择 WebPack.

能实现成这样就不错了，只不过好奇这个怎么做成 Rails 插件。

虽然没有实践过，但我觉得在一定情况下还是有搞头的，其最大的作用是减少前后端之间的沟通成本，并在前端处将调用 API 的方式标准化。不过你说的这个语法：

endpoint :recipe_data do
  params do
    number :id
  end

  response do
    recipe :recipe
  end
end

在 Rails 下不支持啊。我自己写了一个框架，参见 https://github.com/yetrun/web-frame，它里面定义了类似于你的语法。不过我在里面解决的问题跟你提到的不一样，我要生成的是标准化的文档，即在一定程度上保证实现和文档是一致的。不过，你参考 Dain::SwaggerDocUtil#generate 方法，将其改成生成 TS 代码，应该也是能够做到的。

真的是张口就来啊。

接口不能拼接，必须重新写一个接口。参考三楼的回答。

统一感谢大家的支持🙏

课程我看了，很好👍。但是有个问题是，确定发在这个群？

谢谢你的建议，i18n 确实还没支持，后面时机成熟会考虑添加。

active record 支持的。不过话也不是这么说，因为 active record 跟框架没关系，事实上可以拆解下来单独使用，参考 otr-activerecord. Rails 的很多组件都是这样的。

感谢

用 Ruby 的可以看看我的工具，在实现接口的同时就已经在写文档了：

https://github.com/yetrun/web-frame