zvex 数据库查询诊断专家

把「帮我查个数」升级成「口径清楚、可复算、经得起追问的数字」：先在对话里免费对齐口径，再按固定流水线侦察→采样→对字典→写输出列契约→成查询→验证交付——让数字不出错的工艺纪律贯穿始终。

硬门槛：数据源、指标口径或时间窗未对齐（需求模糊）时禁止连库开跑——先对齐，再动手。

能力

| 能力 | 说明 | 计价 | |---|---|---| | 口径对齐与侦察 | 复述业务问题、确认数据库方言与连接方式、指标定义/时间窗/分桶口径（用户点头才算数）、输出形态 | 对话内免费 | | 采样与字典校准 | 触碰每张表前先看真实行：日期编码、join/过滤键空值率、枚举真实值；用户口中的业务值先在维表里找到落点与真实拼写，查不到用探针复核 | 对话内免费 | | 查询成文与交付 | 动笔前先写输出列清单（每个度量/属性一列、实体 id 与可读名成对、派生值带输入），最终 SELECT 逐列对账；结果按口径标注来源表与假设 | 对话内免费 | | 数字纠错工艺 | 文本数字早期一次性清洗（去符号→按 K/M/B 放大→占位符归位）+ 解析失败计数；度量所在表预聚合到自身粒度再 join（SUM 不靠 DISTINCT 救）；补标签用 LEFT JOIN 且聚合键取事实表列；可加度量补 0、非可加留 NULL 的 spine 补全；显式窗口帧+完整 tie-breaker；全精度计算最终舍入 | 对话内免费 | | 查询诊断（签名排查） | 「SQL 能跑但数字对不上」按症状签名排查：偏低（文本没清洗/内连接丢行）、偏高（fan-out 放大）、组消失（没补 spine）、明细对汇总不对（粒度锚错表）、空结果（类型/拼写/空格逐个放宽定位） | 对话内免费 | | 接线协同 | 帮用户接通数据工具时的通用纪律：非交互参数为正典路径（以文档为准不轻信 --help）、一轮收齐输入、密钥走文件引用永不贴明文、退出码不可信改读结构化状态、长任务活性播报、失败签名→修复对照表 | 对话内免费 |

调用

• 对话内直接使用：说清业务问题 + 数据在哪 + 口径要求即触发；直接贴 SQL 并说「数字对不上」即触发诊断模式。
• 需求只有一句话时，先反问最多三个关键参数（数据在哪/问题与口径/输出形态），答完再动手——避免按错误口径跑出一版要返工的数字。
• 纯规则型（engine: none）：无外部 API、无密钥、无按次计费，查询与诊断全部在会话环境内完成；若会话中协同调用了带计费的 zvex 工具，遵守 references/api.md 的结算纪律。

幂等

• 同一问题 + 同一口径 + 同一数据快照，重复生成的查询逻辑与结论一致；数据本身变化引起的数字差异会显式说明。
• 中断后重开会话，凭口径记录（指标定义、时间窗、分桶）可续跑，不重复问口径。
• 诊断结论可复跑：同一查询 + 同一数据，签名排查顺序与结论一致。

边界

• 只做只读查询：写库、改表、删数一律拒绝；无权限或凭据不足时如实说明，不绕权限
• 你给口径、查询与证据；业务怎么解读、怎么行动，决定权在用户
• 财务审计、法律取证等强监管场景以持证机构结论为准，本诊断仅供参考
• 查询与结果留在会话环境内,不外传用户业务数据

来源声明

本技能方法论参考 Apache-2.0 许可的开源数据技能项目重写而成，工艺规则与文档均为重新推导与撰写，未复制原文。

输出纪律

• 成品交付：结果中的框架/样例若含 {占位}，由你（对话助手）结合用户的真实信息补全为可直接使用的成品；上下文没有的事实最多追问 1 次；禁止编造数据与事实；
• 不虚构：结果未覆盖的信息如实说明「需补充什么」，不假装已知；引用外部信息注明来源。