Refiner

核心是两件事：代码重构和代码生成。重构是把已有实现按更清晰的命名与结构重写，处理重复逻辑、过长函数这类代码质量问题；生成则是根据描述补出新的函数或模块。它偏向代码质量层面，不是用来从零搭完整项目的。

常见的 AI 编程助手偏补全和问答，重心在写新代码。Refiner 的重心放在已有代码上——把写得乱的实现改干净，适合手里有存量项目、想清理技术债的场景。两者可以配合用：先让它整理旧代码，再用助手继续写新功能。

不建议直接合并。它能保证改写结果语法通顺、结构更清楚，但保证不了业务语义完全一致，尤其是涉及边界条件和业务规则的部分。稳妥的做法是先跑一遍测试，没有测试的项目至少手动核对关键分支，确认行为没变再合并。

它是在线服务，把代码交进去意味着代码会离开本地环境。项目涉及客户数据、商业机密或者所在行业有合规要求时，使用前需要先确认处理方式是否符合内部规定。拿不准的话，可以先用脱敏后的片段试，或者只处理与业务无关的通用逻辑。

它的工作粒度通常是片段或单个文件，不是整仓库的自动化迁移。大范围重构需要自己拆成一块块交给它，再逐块判断、合并、测试。把它当成处理具体坏味道的工具，比期待它一次性重写整个项目更实际。

关键是带着约束提问。告诉它哪些不能动——对外接口、错误码、日志格式、既有依赖，再说明想要的风格，比如拆成多个小函数或保持单一职责。约束写得越具体，改完之后需要返工的地方就越少。