摘要

Repomix 是一款功能强大的工具，支持作为 CLI 命令行工具或 Node.js 库使用。它能够处理本地和远程代码库，并提供多种输出格式。本文将详细介绍其核心功能、配置选项以及使用方法。

核心特性

1. 多种文件处理模式

• 本地模式：扫描当前目录及其子目录，生成指定格式的报告。
• 远程模式：通过 Git 协议克隆远程仓库后进行处理。

2. 支持多种输出格式

• XML
• JSON
• 文本（默认）

3. 压缩功能

支持对生成的文件进行压缩，便于存储和传输。

使用说明

快速上手

安装工具

npm install repomix

基本命令

repomix --input <目录> [--output <文件名>] [--format <格式>]

示例

处理当前目录并输出为 result.xml：

repomix . --output result.xml --format xml

配置选项

1. 常用参数

• --input 或 -i：指定输入目录或文件路径。
• --output 或 -o：指定输出文件名，默认为 repomix-output.txt。
• --format 或 -f：指定输出格式，支持 txt, xml, json。
• --compress 或 -c：启用压缩功能，默认为 false。

2. 高级选项

• --style：指定输出风格（仅限文本格式），支持 plain 和 markdown。
• --quiet 或 -q：禁用终端输出，仅生成文件。

核心组件

1. 文件搜索与收集

import { searchFiles, collectFiles } from 'repomix';

async function processFiles(directory) {
  const files = await searchFiles(directory);
  const collected = await collectFiles(files);
  return collected;
}

2. 文件处理流程

import { processFiles } from 'repomix';

async function handleFiles(filePaths, directory) {
  const rawFiles = await collectFiles(filePaths, directory);
  const processed = await processFiles(rawFiles);
  return processed;
}

3. token 计数器

import { TokenCounter } from 'repomix';

const counter = new TokenCounter('gpt-4');
const tokens = counter.countTokens('Hello World!');

示例代码

处理远程仓库

import { runCli, type CliOptions } from 'repomix';

async function processRemoteRepo(url: string) {
  const options: CliOptions = {
    input: url,
    output: 'remote-output.xml',
    format: 'xml',
    compress: true
  };
  await runCli(options);
}

注意事项

1. 依赖管理：确保安装所有必需的包，包括 repomix 和其依赖项。
2. 权限问题：处理远程仓库时，需确保有访问权限。
3. 性能优化：对于大规模代码库，建议启用压缩功能以减少存储空间。

项目贡献

贡献指南

1. 提交 ISSUE 报告问题或提出需求。
2. Fork 代码库并提交 PR 修复 bug 或改进功能。
3. 加入社区讨论，参与开发决策。

仓库地址

GitHub | Gitee

许可证

本项目遵循 MIT 协议开源：

版权所有 (c) 2023 Repomix 开发团队
本作品在 MIT 协议下发布，允许自由使用、修改和分发。