Summarize File

核心用法

Summarize-File 是一款本地化文本摘要工具，通过 workspace.read 读取用户指定路径的文本文件（支持日志、报告、CSV、笔记等格式），经清洗（去除空行、时间戳、重复头部）后交由LLM生成2-3句结构化摘要。触发词包含 "summarize file"、"summarize-file"、"tl;dr file"，支持Windows、macOS、Linux三平台。

显著优点

• 零网络依赖：纯本地处理，文件内容不出境，符合敏感数据合规要求
• 高效降噪：自动过滤日志中的时间戳、重复头部、空行等干扰信息
• 多格式兼容：原生支持txt、log、csv、md等纯文本格式
• 路径安全：内置 ../ 路径遍历防护，限制于工作目录内
• 极低延迟：单次读取+LLM调用，无外部API往返

潜在局限

• 纯文本限制：无法解析PDF、Word、Excel二进制格式
• 摘要深度固定：仅输出2-3句，不支持自定义长度或结构化输出
• LLM黑盒依赖：摘要质量取决于本地模型能力，无引用溯源
• 无持久化：摘要结果不保存，需手动复制
• 编码风险：未明确声明非UTF-8编码文件的处理机制

适合人群

• 运维工程师：快速扫读系统日志定位异常
• 数据分析师：批量预览CSV数据摘要
• 安全审计员：合规审查下本地处理敏感日志
• 研究人员：整理大量文本笔记的核心论点

常规风险

| 风险项 | 等级 | 说明 |

|--------|------|------|

| 文件读取 | L1 | 只读权限，无写入/删除风险 |

| 路径遍历 | 低 | 已过滤 `../` 逃逸字符 |

| 敏感信息泄露 | 低 | 纯本地LLM处理，无网络传输 |

| 摘要幻觉 | 中 | LLM可能遗漏关键细节或误读数值 |

核心用法

Summarize-File 是一款专注于本地文本文件快速摘要的 Agent Skill。用户通过简单的自然语言指令（如 "summarize file report.txt"）即可触发，Skill 会调用 workspace.read 工具读取指定文件内容，自动过滤空行、页眉页脚等冗余信息，通过 LLM 生成 2-3 句话的精炼摘要并返回。支持日志文件、CSV 报表、会议记录、技术文档等多种文本格式，适用于 Windows、macOS 和 Linux 三大操作系统。

显著优点

1. 极致轻量安全：零第三方依赖，纯 Node.js 原生 fs 模块实现，代码仅 105 行，攻击面极小；
2. 完全本地处理：无网络 API 调用，文件数据不出本机，天然满足隐私合规要求；
3. 权限精准匹配：仅申请 workspace.read 只读权限，与功能声明完全一致，无过度授权风险；
4. 场景覆盖广泛：从错误日志速览到季度财报提炼，一句话掌握长文档核心信息；
5. 跨平台兼容：支持主流桌面操作系统，无需额外配置即可开箱即用。

潜在缺点与局限性

1. 功能边界清晰：仅支持文本文件，对 PDF、图片、二进制文件无处理能力；
2. 摘要长度固定：强制输出 2-3 句，无法根据用户需求调整详略程度；
3. 大文件风险：当前实现一次性读取完整文件到内存，超大文件可能导致性能问题（建议后续增加 10MB 限制）；
4. 路径校验待完善：虽有基础防护，但缺乏严格的路径遍历过滤（如 ../ 逃逸检测可进一步增强）；
5. 依赖 LLM 质量：摘要质量受底层模型能力影响，对高度专业化的技术文档可能存在理解偏差。

适合的目标群体

• 运维工程师：快速扫读系统日志、错误堆栈，定位关键异常；
• 数据分析师：批量预览 CSV/TXT 数据报告，提取核心指标变化；
• 项目经理：速读会议纪要、项目文档，掌握决策要点；
• 研究人员：初步筛选大量文本资料，判断文档价值；
• 隐私敏感用户：任何不愿将文件上传云端进行摘要处理的场景。

使用风险

1. 性能风险：未限制文件大小，处理 GB 级日志文件可能导致内存占用过高或响应超时；
2. 路径注入风险：虽有基础防护，但建议用户确认传入路径为预期工作区内文件；
3. LLM 幻觉风险：摘要为模型生成，关键决策仍需人工核对原文；
4. 维护状态：当前为个人/社区维护项目（T3），长期更新保障有限，建议企业用户评估后二次封装。