用途：对指定文件或目录范围做基于实际内容的摘要，而不是凭文件名或抽样猜测。先解析确切来源范围；目录请求需枚举请求的树结构、不跟随循环、保留排除项与不可访问项，并覆盖全部预期来源，不得擅自缩小范围而不说明。
主要能力：按类型提取证据。代码提取导入/依赖、类与函数签名、文档化与推断用途、关键算法与状态转换、入口与导出、环境配置依赖，并保留行位置与复杂表达式。配置提取根键与类型、嵌套层级、设置分类、校验约束与有意义的值，凭据只标注不暴露值。数据给出解析后的记录数、表头/模式、观测类型、缺失情况与标识符，样本需明确范围，全量结论须用合适解析器计算，原始行数不等于 CSV 记录数。文档提取标题层级、主要论断与定义、前置条件、命令与引用。标记提取结构、可见/嵌入文本与链接，并区分标记检查与视觉渲染。PDF/Office 使用格式感知读取器，说明未提取的页、表、图或附件。其他二进制或未知类型在权限内使用合适读取器，否则返回元数据与具体限制，不猜测内容。
使用方式：先判断文件类型与大小再选读取策略；短文件完整读取，大文件保留章节/模块边界与来源位置并按宿主上下文分块。可用时执行 uv run --script "<plugin-root>/scripts/file_metrics.py" "<file-path>" --json --no-excerpt 获取指标，但指标与摘录只是规划证据，不代表已读内容；二进制分类仅表示文本探测失败。图片（含 SVG）改用 image-summarization。分块 UTF-8 文本或整份 CSV/TSV 声明需加载机械式来源获取，使用其来源绑定计划、覆盖核对或全记录剖析器。
限制：不得从首十行推断模式、范围、行总数或缺失情况；抽样仅用于示例并披露范围。文本解码失败应换用兼容读取器或报告限制，不得静默替换损坏文本并称完整。不得在无可恢复来源支持的情况下层层压缩摘要。多文件需保留单独归属与失败记录，仅在请求整合时调用 multi-source-synthesis。访问失败须保留确切路径/错误与调用状态，不得伪造成功摘要或无限重复同一失败访问方式。