要将上述所有内容完整地翻译成中文，请参考以下内容：

代码总结工具

功能概述

这个工具是一个命令行接口（CLI），用于对指定目录中的代码文件进行智能摘要。它支持多种编程语言，并通过调用 Gemini Flash 2.0 提供的自然语言处理能力生成简洁明了的代码摘要。

安装说明

方式一：使用 npm 包管理器

npm install code-summarizer -g

方式二：从源码安装

1. 克隆此仓库到本地
2. 进入项目目录，运行：

npm install

然后将 bin/code-summarizer 添加到系统 PATH 中。

使用方法

基本用法

code-summarizer <directory> [-d|--detail] [-l|--max-length]

选项说明

• <directory>：必填参数，指定要扫描的代码目录。
• -d, --detail：设置摘要的详细程度。可选值为 'low', 'medium' 或 'high'，默认为 'medium'。
• -l, --max-length：设置每个摘要的最大长度（字符），默认为 500。

示例

生成低详细度的代码摘要：

code-summarizer ./src --detail low

操作流程

1. 扫描指定目录，递归遍历子文件夹。
2. 根据 .gitignore 忽略规则过滤排除不需要处理的文件和文件夹。
3. 识别文件类型，仅处理支持的语言代码文件。
4. 分析每个代码文件的内容并生成智能摘要。
5. 将所有摘要按指定格式输出到目标文件。

配置选项

工具允许通过命令行参数或配置文件进行灵活的定制：

命令行参数

• --detail, -d：设置摘要详细程度。可选值为 'low', 'medium' 或 'high'，默认为 'medium'。
• --max-length, -l：设置每个摘要的最大长度（字符），默认为 500。

配置文件

工具支持通过位于项目根目录的 config.json 文件进行配置。以下是一个示例：

{
  "detailLevel": "medium",
  "maxLength": 500,
  "supportedLanguages": ["typescript", "javascript", "python"],
  "ignoredFiles": ["**/*.test.ts", "**/*.spec.ts"]
}

支持的语言和文件类型

• TypeScript（.ts, .tsx）
• JavaScript（.js, .jsx）
• Python（.py）
• Java（.java）
• C++（.cpp）
• C（.c）
• Go（.go）
• Ruby（.rb）
• PHP（.php）
• C#（.cs）
• Swift（.swift）
• Rust（.rs）
• Kotlin（.kt）
• Scala（.scala）
• Vue（.vue）
• HTML（.html）
• CSS（.css, .scss, .less）

输出格式

生成的摘要文件将采用以下格式：

相对路径/文件名
摘要内容

下一个相对路径/文件名
下一个摘要内容

项目结构

• index.ts：主 CLI 实现文件
• src/：源代码目录
  • summarizer/：核心摘要功能模块
  • mcp/：MCP 服务器实现
  • config/：配置管理模块
• bin/：CLI 入口点
• config.json：默认配置文件
• tsconfig.json：TypeScript 配置文件
• package.json：项目依赖和脚本信息
• .env.example：环境变量配置模板
• .gitignore：Git 忽略规则文件
• __tests__：单元测试和集成测试目录
• __mocks__/mock-codebase：用于测试的模拟代码库

环境变量

可以通过以下环境变量对应用进行配置：

使用场景

• 开发者希望快速了解大型代码库的功能和结构。
• 项目维护人员需要生成文档或 README 文件时获取简洁的代码概览。
• 教育培训中用于帮助学习者理解复杂代码。

已知问题

• 对于非常庞大的代码库，可能会出现性能下降的情况。建议优化代码结构或分阶段处理。
• 当前版本仅支持预设的语言和文件类型，不支持自定义扩展。

未来计划

• 增加对更多编程语言的支持。
• 提供更加灵活的配置选项，例如自定义忽略规则和输出格式。
• 开发 GUI 版本方便用户可视化操作。

贡献指南

欢迎任何贡献！请遵循以下步骤：

1. Fork 此仓库到您自己的账号。
2. 在您的本地副本上进行修改或添加功能。
3. 提交代码更改并创建 Pull Request。
4. 我们将审阅您的 PR 并在合适的时候合并。

许可证

本项目采用 MIT License 许可证。