用途：对 PostHog 项目的 Endpoints 做全项目审计，寻找可清理的对象：未被调用的端点、物化失败的端点、无人使用的物化版本。它只做审计报告，不修改任何内容；单端点深入排查交给 diagnosing-endpoint-performance。
适用场景：用户提出“审计我的端点”“有哪些端点可以清理”，接手项目需要了解继承了什么，进行月度或季度端点清理复查，或超出物化成本预算想知道该禁用哪些端点。
主要能力与工具：execute-sql（HogQL）是主要读路径，可查询 system.data_modeling_endpoints 获取元数据（name、is_active、current_version、derived_from_insight、last_executed_at），查询 query_log 获取端点级使用情况（调用次数、最近时间、耗时、字节数）。endpoint-materialization-status 提供每个端点的物化资格、状态、上次运行与错误（不在系统表中）。endpoint-versions 返回某端点所有版本（最新在前），含各自查询、物化状态与 last_executed_at。endpoint-update 是写路径，可在用户确认后 disable（is_active: false）或 unmaterialise（is_materialized: false）。agent-feedback 用于向 PostHog 团队反馈问题。建议优先用系统表而非 endpoints-get-all / endpoint-get，一次 SQL 即可拿到完整清单并关联到 query_log 的使用数据。
判定问题：从未调用，query_log 中无该端点的行（仅统计个人 API key 调用）；陈旧，最后一次调用距今超过 30 天；不活跃，is_active = 0；物化失败，endpoint-materialization-status 返回 Failed 及错误，需交接；未使用物化版本，某物化版本的 last_executed_at 为 null 或长期陈旧；版本漂移，存在大量版本，属于历史噪声而非问题。
工作流程：先列出端点及元数据，再查 query_log 取使用情况并交叉比对，然后检查物化健康状况与未使用版本，随后按类别分组输出优先级报告，最后向用户确认下一步，任何修改前都必须确认。空结果即健康，报告为空是合理答案。
限制：使用统计仅覆盖个人 API key 调用，仅从 Playground 或应用中被调用的端点会显示为未使用；每版本 last_executed_at 仅记录引入追踪之后的运行，可能为 null 但实际仍在使用，移除前务必确认。物化耗费存储与计算，不再需要物化时最省的做法是 endpoint-update 设 is_materialized: false，而非删除端点。is_active: false 是刻意关闭，不等于陈旧，除非用户确认真被放弃，否则不建议删除。