父 roadmap:#197 实施阶段:P3 依赖:#198、#200、#203 范围:按模板定义跨片聚合、去重、全局排序分页、结果覆盖范围与不支持能力。 ## 功能描述 为内建查询和报告逐项支持数据集级分析,确保整份 focus 的全量结论来自所有相关分片,而不是将单片结果或逐片 top-N 拼接为全量结果。 ## 使用场景 长寿命 block 重复出现在多片中。全量峰值、调用栈统计、泄漏与生命周期列表需要各自不同的聚合语义,简单相加会重复统计,单片执行则可能漏掉真正峰值。 ## 期望的实现方式 - memory_peak:各指标独立合并各片真实事件峰值;相同值选择最早真实事件,排除负 ID 边界。支持请求范围并保留 device。 - 峰值归因:使用全局峰值事件路由到所属片,再复用跨片来源解析;allocator gap 必须比较同一事件的数值。 - block/生命周期:使用已证明稳定的 device+生命周期身份去重或定义唯一归属片;不能只按地址。未解析历史不足的身份单独表达,不能猜测合并。 - 泄漏候选:基于数据集末尾存活状态与既有生命周期规则,避免重复返回每片边界存活块。 - 堆栈统计:明确按真实分配事件/生命周期/时刻活跃集合统计,再按堆栈合并;全局聚合之后排序、算占比和 top_n。 - 全局分页与 total/count 必须定义精确或明确有界的合同;局部分片 cap 不得静默裁掉候选再宣称全量 top-N。 - 结果包含 scope、请求/实际覆盖范围、涉及分片、完整性;has_more/truncated 继续表示结果截断,不代替范围完整性。 - 制定模板支持矩阵。任意 SQL/自定义模板不能自动声称支持整份数据集;尚无聚合实现的查询应要求显式单片或明确报不支持。 - CLI/API/报告共用服务语义;连接、超时、取消与结果预算有界。 ## 验收标准 - [ ] 单库与整份分片全量峰值/事件、活跃归因、生命周期及泄漏候选等价。 - [ ] 覆盖跨片相同峰值、单片局部 top-N 与全局排序不同、长寿命 block 重复、多设备、限定事件范围。 - [ ] 全局占比分母、total、分页和截断/范围元数据可复核。 - [ ] 不支持全量的模板/SQL 不会隐式只查一片后返回完整结论。 - [ ] report peak-memory 保留归因完整性与字节覆盖,复用 #179 的修复合同。 - [ ] 中英文模板支持矩阵与典型命令完整。 ## 参考资源 - `query/templates/`、`core/query_service.py`、`core/report_service.py`、`core/models.py`。 - 关联 #179(peak report 归因完整性);本任务补数据集 scope,不另建相同单库缺陷。
Activity
codeasier commentedon Oct 4, 2026
Issue review
Reality: 能力缺口真实,但不是已证实的单库缺陷:当前 focus/查询只绑定一个 DB,结果没有数据集覆盖元数据;双语 split 文档仅说明逐片导入查询。
Reasonableness: 目标合理,但不能拼接逐片排名或简单相加;还需定义跨库栈身份,局部 callstackId/stack_id 和缩略文本不能直接合并。全局排序不应静默改变 included_bytes 百分比分母。
Boundary: 依赖 #198/#200/#203 的数据集与来源合同就绪后逐模板实现;未支持的全量查询显式拒绝,共享服务及全局预算。单库等价须先统一真实事件口径:现有 memory_peak 未排除负 ID。沿用 #179 的同事件覆盖与截断合同,不自动推广任意 SQL。
Evidence:
Limitations: 固定基线 0924415;已读正文及全部评论(0 条)。仅静态核对与无文件写入的 SQLite 内存模板断言,验证了边界峰值、局部 top-1 漏全局第一及局部泄漏/生命周期不等价;未跑 pytest、未执行真实分片导入,未验证依赖完成。
fix: implement dataset-global query semantics (#204)
codeasier commentedon Oct 8, 2026
代码已由 #216 合入 origin/main(9 commits 链,tip 7c33464)。按维护决定先关闭本 issue;PR #216 中声明 deferred 的 GUI / C++ server / 安装 wheel 人工验收,以及 #217 系列默认规模不可用问题,另行跟踪。