@Undefined01 在 文档破破烂烂,opus缝缝补补 中发帖
最近在造轮子的过程中经常需要参考和调用一些第三方库。然而一些库的文档经常不够完善,要么是只讲了一些基本的用法,一些功能更丰富的 API 藏在几层链接后的某个角落里,要么是直接没有文档,甚至没有代码注释。
于是被迫让agent自己去读整个库的源码,捋清楚每个函数的功能和用法,最后再生成一份给人读的文档和 API Reference。
最开始用的是各位大佬的公益站,猛猛蹬 opus 4.6(其实是读代码是 haiku)。虽然扫描源码花了大量的 token,但是相应的产出质量是非常高的。文档内容完善、结构清晰,还会恰如其分地包含一些使用示例,极大地提升了开发效率。
然而最近公益站的服务不太稳定,时不时就访问不了。于是我又尝试了一下 codex,结果发现质量参差不齐,有些工具生成的文档内容非常简略,语言表达也不够流畅。和 opus 4.6 生成的文档相比,落差大到有些不适应。
这里放一个例...