data-matching

数据匹配

模式知识库可找到候选项。此技能用于判断候选项是否确实符合用户的问题。语义相似的表不一定就是正确的指标。

引入新的数据源时，请获取此技能。对先前已检查并保存的查询进行小幅调整时，除非指标、数据源、范围或解释发生变化，否则无需重复获取。

1. 将问题转化为数据契约

选择数据源前，请明确所需的：

• 对象 — 交易、钱包、持有者、头寸、代币、协议、实体或其他单位；
• 度量 — 数量、余额、供应量、交易量、价格、费用、活跃钱包，或有明确定义的派生指标；
• 粒度 — 事件、区块、日、月、钱包-代币、协议-链等；
• 范围 — 网络、地址、资产、总体、纳入项和排除项；
• 时间语义 — 当前状态、某个时间点的快照、某个时间窗口内的活动，或历史时间序列；
• 时效性和输出形式 — 实时查询、临时分析、可复用查询、仪表板或定期工作流。

如果缺少的字段可能显著影响数据源或结论，请提出澄清问题。否则，在查询前说明合理的假设。

2. 查找并检查候选项

1. 使用 search_docs 搜索产品、指标和已知领域术语。
2. 使用 search_schemas 查找 3–5 个候选表。搜索时使用对象和度量，而不只是用户的项目名称。
3. 使用 search_schemas(id=..., include_content=True) 获取最有希望的候选项。阅读列、粒度、说明和注意事项；仅凭搜索结果标题绝不足以做出选择。
4. 使用 search_terminal 和 get_terminal_results 检查相关的规范 Terminal 结果，然后再重新创建常用指标。

对于单链问题，优先使用按链划分的表。仅当比较确实涉及多条链，且数据源的链和资产语义符合问题时，才使用跨链数据源。对于已知资产或钱包的当前状态，使用 Realtime；对于历史、比较或聚合分析，使用 Explorer/SQL。

如果问题属于有专门覆盖的领域——现实世界资产、稳定币、桥、DEX/AMM 交易或借贷——在手动选择表之前，请检查是否提供了领域专用技能（rwa-analysis、stablecoin-analysis、bridge-analysis、dex-analysis、lending-analysis）；这些技能汇总了该领域常见的表和列问题，有助于省去一轮覆盖范围探测。

3. 根据数据契约比较候选项

对于每个认真考虑的候选项，请检查：

• 其行粒度是否符合所请求的单位，或者聚合/联接是否会改变含义？
• 它表示流量、快照还是累计值？未经说明，不要相互替代。
• 它是否包含所需的网络、日期、资产和实体范围？
• 代币单位、价格、标签、桥接表示形式或归因字段是否以所需的确定性级别定义？
• 是否有比从原始行派生度量更可靠的精选指标或规范仪表板？

不要仅因某项排名最高就用它来解决歧义。如果不同候选项衡量的是不同但合理的对象，请保留这些选项并说明差异。

4. 在构建分析前验证覆盖范围

当指标是分析的关键依据、刚选定某条链，或覆盖范围不确定时，请针对推荐的数据源运行一个小型、范围有限的查询。检查少量行，以及一段简短的时间序列或聚合结果。

仅因为搜索结果中出现了某条链或某张表，并不能证明其覆盖范围。若所请求的时间段为空、数据稀疏、陈旧，或代表了不同的经济对象，请停止分析并重新界定范围。包装资产或桥接资产不能证明原生链覆盖范围。

5. 返回匹配清单

编写完整查询前，请按以下形式呈现决策：

字段	记录
请求含义	对象、度量、粒度、范围和时间语义
推荐来源	表、端点或规范仪表板／查询
适用原因	来自架构／文档和覆盖范围探查的证据
排除的备选项	候选项及其语义不匹配之处
注意事项	覆盖范围、新鲜度、归因、单位或聚合限制
决策	使用／附带注意事项使用／重新界定范围／不可用

将选定来源、注意事项和覆盖范围探查结果一并带入查询和最终答复。如果结果会影响决策，请使用 create_explorer_query 保存，并在分享前遵循 allium-investigation 的可复现性步骤。