兄弟们，我真的有点麻了。我是个半路出家的前端，最近公司有个老项目要维护，让我顺便把一些核心模块的接口文档给补上。我寻思着手写太费劲了，看网上好多人推荐那个叫“龙虾”的AI编程助手，说是能自动生成文档，就想着偷个懒试试。
过程简直是一波三折。我先用它的基础模式，对着我写好的一个订单处理函数跑了一下。好家伙，生成的文档倒是挺快，格式也漂亮，但仔细一看我就傻眼了——它把我函数里一个关键的权限校验逻辑，描述成了“可选的用户信息过滤”。这差得也太远了吧！这要是直接把文档交出去，后端同事照着这个理解来联调，不得出大篓子？
我不死心，觉得可能是我没设置好。就去翻了翻它的高级选项，发现这玩意儿居然还有“多个模型”可以选，什么“精准模式”、“速记模式”、“详细解释模式”…给我整不会了。我挨个试了试，结果更混乱了。“精准模式”生成的倒是短，但把我一个复杂的异步回调链条简化成了一句话，关键步骤全没了；“详细解释模式”呢，又啰嗦得要命，恨不得把我变量命名里的拼写都分析一遍，真正的业务逻辑反而被淹没在一堆废话里。
我现在最头疼的就是，面对这种龙虾多个模型怎么选的问题，完全没有头绪。每个模型生成的文档侧重点完全不同，我作为一个对业务逻辑还算熟悉的人都得反复核对，那如果一个新人直接用，岂不是被带沟里去了？我感觉它更像是在“解释”它看到的代码字面意思，而不是理解代码背后的业务意图。
更让我焦虑的是龙虾怎么改代码。对，你没看错，这工具不是号称也能辅助改代码吗？我试着让它根据我新写的文档描述，去优化另一段类似的旧代码。结果它倒是挺积极，给我改了一通，语法是没错，但直接把原来的缓存策略给删了，换成了一个它觉得“更优雅”但完全不适配我们场景的模式。吓得我立马撤销，再也不敢让它动了。
所以我现在真的很困惑。这类AI工具，到底是我们用它，还是它来“玩”我们？生成文档这个场景，看起来是最适合AI发挥的，但如果连基本的代码逻辑都捋不顺，甚至会产生误导，那它的价值到底在哪？是我打开方式不对，还是这类工具目前就这个水平？有没有真正在生产环境里用它搞定了文档，并且没出岔子的老哥来分享一下经验？或者，有没有比龙虾更“靠谱”一点的同类工具推荐？我主要是给JavaScript和TypeScript代码生成API文档。
说实话，折腾这一下午，我感觉比我手写文档还累。心累。