codebuddy 支持四种 elasticsearch 高级查询生成方式：一、ide 中通过自然语言注释生成复合聚合 dsl；二、cli 命令生成带 painless 脚本的 function_score 查询；三、ide 插件实时诊断聚合嵌套深度与内存风险；四、craft 智能体生成评分函数的 jest 单元测试。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 CodeBuddy 编写 Elasticsearch 复合聚合查询（如 multi-bucket aggregations、nested + terms + date_histogram 组合）或自定义评分函数（如 script_score、function_score 中的 custom decay 或 Painless 脚本），其生成效果取决于查询复杂度与上下文完整性。以下是实测验证的多种实现方式：
一、基于自然语言指令生成复合聚合查询
CodeBuddy 能解析“按地区分组统计近30天商品销量峰值并叠加平均价格分布”等业务语义，自动推导嵌套聚合结构，避免手动拼装 aggregation DSL 的语法错误和桶层级错位问题。
1、在 VS Code 中打开项目根目录下的 elasticsearch-queries.js 文件，光标置于空行处；
2、输入注释：// 按 province 字段分组，对最近30天的 orders 索引执行复合聚合：外层 terms 聚合省份，内层 max 聚合 sales_count，再嵌套 avg 聚合 unit_price；
3、按下快捷键 Ctrl+Enter（Windows/Linux）或 Cmd+Enter（macOS） 触发 CodeBuddy 补全；
4、确认生成的 DSL 是否包含 "aggs": {"by_province": {"terms": {"field": "province.keyword"}, "aggs": {...}}} 结构，并检查 date_range 是否绑定到 @timestamp 字段且时区为 +08:00。
二、通过 CLI 工具注入带 Painless 脚本的 function_score 查询
当需实现地理位置衰减+用户活跃度加权的混合排序时，CodeBuddy CLI 可基于命令描述直接输出可部署的 query body，内置校验 script 语法合法性与字段存在性，规避 runtime exception。
1、终端切换至项目 /search/config 目录；
2、执行命令：codebuddy code "生成一个 function_score 查询：以 geo_distance 衰减为基础分，对距离小于5km的文档提升2.5倍权重；同时对 user_level > 3 的用户历史行为加权0.8分，使用 Painless 脚本实现"；
3、检查输出中 "functions": [{"filter": {"range": {...}}, "script_score": {"script": "..."}}, ...] 是否完整；
4、验证脚本内是否调用 doc['location'].arcDistance(params.lat, params.lon) 而非已弃用的 _geo_distance。
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
三、利用 IDE 插件实时诊断聚合深度与内存风险
CodeBuddy IDE 插件在编辑聚合 DSL 时，会基于 ES 集群版本（如 8.12）动态分析嵌套层数、桶数量预估及 heap 占用提示，防止因 terms + composite + top_hits 多层嵌套触发 circuit_breaking_exception。
1、在 JetBrains WebStorm 中打开 es-aggregation-template.json；
2、粘贴含三层嵌套的聚合体（例如 composite → terms → percentile_ranks）；
3、观察右下角状态栏是否弹出警告："检测到 4 层聚合嵌套，ES 8.12 默认 bucket_limit=10000，建议添加 size 参数限制"；
4、点击警告旁的 [Fix] 按钮，自动在最外层 composite 聚合中插入 "size": 500。
四、结合 CodeBuddy Craft 智能体生成可测试的评分函数单元验证逻辑
针对自定义评分函数，Craft 智能体可同步生成用于本地验证的 Jest 测试用例，覆盖不同文档字段组合下的 score 输出值，确保 Painless 脚本行为符合预期，避免上线后排序异常。
1、在项目 /test/scoring 目录新建 custom_score.test.js；
2、输入描述性注释：// 测试 script_score 函数：当 doc['is_premium'] == true 且 doc['recency_days']
3、调用 CodeBuddy 的 "Generate Test Case" 功能；
4、确认生成的 expect 语句是否包含对两种边界场景的断言：expect(scoreForPremiumRecent).toBeCloseTo(baseScore * 1.6) 与 expect(scoreForFreeOld).toBe(baseScore)。
