2026/9/10 23:24:52
FEATURED · 精选文章 
Repomix FAQ 与故障排查完全指南私有仓库、远程打包、Token 削减与 MCP 集成【免费下载链接】repomix Repomix is a powerful tool that packs your entire repository into a single, AI-friendly file. Perfect for when you need to feed your codebase to Large Language Models (LLMs) or other AI tools like Claude, ChatGPT, DeepSeek, Perplexity, Gemini, Gemma, Llama, Grok, and more.项目地址: https://gitcode.com/GitHub_Trending/rep/repomixRepomix 是一款将整个代码仓库打包成单一 AI 友好文件的开源工具其官方 FAQ德语版见 website/client/src/de/guide/faq.md系统性地回答了工作流选型、输出体积控制、安全与隐私、以及各类疑难杂症。本文以该 FAQ 为核心骨架结合本仓库的源码实现CLI 动作、配置合并、安全扫描、远程仓库处理等逐条深入讲解每一个问题背后的机制与可执行的命令方案帮助你为 ChatGPT、Claude、Gemini 等 AI 助手准备高质量、低噪音、无泄露风险的代码库上下文。Repomix 是什么它能解决什么问题FAQ 的第一条问题即点明 Repomix 的核心用途将整个仓库打包成单一 AI 友好文件从而让你无需手动逐个复制文件就能把完整的代码库上下文提供给 AI 助手用于代码审查Code Review、Bug 排查、重构规划、新人入职引导Onboarding、文档编写、安全分析与架构评审。从打包主流程看CLI 会经过迁移 → 加载配置文件 → 解析 CLI 参数 → 合并三层配置默认值 / 文件 / CLI的流水线最终由pack()输出文件见 src/cli/actions/defaultAction.ts。默认配置在 src/config/configSchema.ts 中定义输出风格默认为xml默认输出文件名为repomix-output.xmlmarkdown / plain / json 风格对应的默认文件名分别是repomix-output.md、repomix-output.txt、repomix-output.json。私有仓库如何在本地打包FAQ 明确回答Repomix 完全支持私有仓库。做法是在你本机已经有访问权限的检出checkout目录中直接运行repomix此时 Repomix 读取的是你本地文件系统与本地 Git 配置不涉及任何凭据上传。FAQ 特别提醒在把生成的文件发送给外部 AI 服务之前请务必先自行检查一遍输出内容——这一点与后面的安全章节相互呼应。公开 GitHub 仓库无需克隆即可远程打包FAQ 指出Repomix 可以用--remote直接处理公开的 GitHub 仓库既支持owner/repo短格式也支持完整 URLnpx repomix --remote yamadashy/repomix npx repomix --remote https://github.com/yamadashy/repomix从源码看远程处理并非简单地下载后打包而是一套带降级策略的流程见 src/cli/actions/remoteAction.ts解析仓库 URL判断是否为 GitHub 仓库且支持归档下载archive优先走GitHub 归档下载通道约 60 秒超时、2 次重试并实时汇报下载进度百分比归档下载失败时自动降级为git 浅克隆shallow clone见execGitShallowClone克隆前会先探测远端 refs打包完成后将输出文件从临时目录复制回当前工作目录最后统一清理临时目录。FAQ英文版补充说明--remote还支持指定 branch、tag、commit 或子目录对应的 CLI 选项是--remote-branch name默认使用仓库默认分支。此外在远程模式下--config必须使用绝对路径以避免从克隆仓库中加载不可信配置见 src/cli/actions/remoteAction.ts。输出格式XML、Markdown、JSON 还是 PlainFAQ 的选型建议非常明确默认使用 XML结构化强适合能很好解析标签化上下文的模型如 ClaudeMarkdown适合人类阅读或需要编辑打包文件的场景JSON适合由另一个程序消费输出的自动化场景Plain纯文本需要最简单格式时的最大兼容选择。切换格式用--stylerepomix --style markdown repomix --style json--style支持xml、markdown、json、plain四种取值见 src/config/configSchema.ts默认值为xml。相关的输出细节文件摘要、目录结构、文件名格式等可进一步参考 输出格式指南 与 命令行选项参考。输出文件太大系统性削减 Token 消耗核心手段Include Ignore 压缩FAQ 给出了四个最常用的瘦身命令repomix --include src/**/*.ts,docs/**/*.md repomix --ignore **/*.test.ts,dist/** repomix --compress repomix --remove-comments--include只打包匹配这些 glob 模式的文件多个模式用逗号分隔--ignore额外排除匹配的模式--compress基于 Tree-sitter 的代码压缩--remove-comments打包前移除所有代码注释。FAQ 建议当仓库很大时把 include / ignore 模式与代码压缩组合使用。英文版 FAQ 还补充了聚焦与你问题相关的子系统与必要时拆分输出两条策略。在底层--include与--ignore都会经过splitPatterns()按逗号拆分见 src/cli/actions/defaultAction.ts--include映射到配置的include数组--ignore映射到ignore.customPatterns。--compress到底做了什么FAQ 解释--compress会保留导入、导出、类、函数、接口等关键结构同时移除大量实现细节——当模型主要需要理解架构和模块间关系而非逐行代码时尤其有用。实现层面压缩依赖Tree-sitter 解析仓库中为各语言准备了解析策略与查询文件如 src/core/treeSitter/parseStrategies/TypeScriptParseStrategy.ts、src/core/treeSitter/queries/queryTypescript.ts支持 C、C、C#、CSS、Dart、Go、Java、JavaScript、PHP、Python、Ruby、Rust、Solidity、Swift、TypeScript、Vue 等语言。注意压缩这类高级特性依赖于对应语言的解析器支持不同语言的支持程度可能不同。补充手段注释移除的取舍FAQ英文版专门讨论了--remove-comments的取舍当注释噪音大或占用过多 token 时使用当注释包含领域知识、API 契约、警告或重要实现理由时应保留。具体行为可参考 注释移除指南。安全与隐私代码会不会被上传FAQ 明确回答Repomix CLI 完全在本地运行只在你的机器上写出一个输出文件。这与网站版、浏览器扩展的工作流不同——使用托管或浏览器功能时请查阅 隐私政策。关于密钥防护FAQ 指出 Repomix 采用Secretlint 基础的安全检查来在打包前检测敏感值。源码印证了这一点安全扫描会遍历所有文件内容包括可选的 Git diff 与 Git log 内容分批提交给 worker 线程池并行检测每批 50 个文件、最多 2 个 worker 线程见 src/core/security/securityCheck.ts检测实现在 src/core/security/workers/securityCheckWorker.ts。FAQ 反复强调的立场是安全扫描只是额外一层保护网不能替代人工检查——在把私有代码发送给 AI 服务之前始终要亲自审阅生成的文件。--no-security-check选项会跳过这一扫描详见 安全指南。故障排查文件缺失、include 不生效、团队复现为什么输出里少了文件FAQ 给出的排查思路Repomix 会尊重.gitignore、默认忽略规则和你自定义的 ignore 模式。检查三个地方repomix.config.json中的 ignore 配置命令行--ignore选项该文件是否被 Git 本身忽略。仓库内置的默认忽略清单非常庞大见 src/config/defaultIgnore.ts包括版本控制目录.git/**、依赖目录**/node_modules/**、vendor/**、日志**/*.log、构建产物dist/**、build/**、out/**、测试覆盖率coverage/**、编辑器/OS 生成文件.idea/**、.vscode/**、**/.DS_Store、各语言锁文件**/package-lock.json、**/Cargo.lock、**/go.sum等、以及 Repomix 自身的输出**/repomix-output.*。为什么--include不含 node_modules 或构建目录里的文件FAQ 的解释是--include只是收窄Repomix 尝试打包的文件范围但ignore 规则依然生效。文件仍可能被.gitignore、.ignore、.repomixignore、内置默认模式或repomix.config.json排除。对于确实需要打包忽略目录中文件的高级场景FAQ 提到两个逃生舱选项repomix --no-gitignore repomix --no-default-patterns但它们会连带引入依赖、构建产物和其他干扰文件必须谨慎使用。从源码看--no-gitignore映射到ignore.useGitignore: false、--no-dot-ignore映射到ignore.useDotIgnore: false、--no-default-patterns映射到ignore.useDefaultPatterns: false见 src/cli/actions/defaultAction.ts。如何让团队输出可复现FAQ 推荐创建并提交一份共享配置repomix --init--init是交互式向导见 src/cli/actions/initAction.ts引导你选择输出风格与输出文件路径生成repomix.config.json并询问是否创建.repomixignore文件。之后团队在项目根目录运行repomix即可得到完全一致的输出。--global变体则把配置写入主目录全局配置。更多常见问题详解支持 C#、Python、Java、Go、Rust 等语言吗支持。FAQ 解释Repomix 读取的是项目文件本身并重新格式化与语言无关因此可以打包任何编程语言的仓库。前提条件使用 CLI 需要Node.js 22 或更新版本。某些高级功能如基于 Tree-sitter 的代码压缩依赖于各语言的解析器支持程度。能否与 Hermes Agent、OpenClaw 等 MCP 兼容 Agent 一起用可以。Repomix 可以以 MCPModel Context Protocol服务器模式运行npx -y repomix --mcpMCP 模式下Agent 可以在交互式编码会话中直接从你的本地环境请求打包后的代码库上下文入口见 src/cli/actions/mcpAction.ts服务器实现在 src/mcp/mcpServer.ts。以 Hermes Agent 为例在~/.hermes/config.yaml中将 Repomix 配置为 stdio MCP 服务器mcp_servers: repomix: command: npx args: [-y, repomix, --mcp]对 OpenClaw 或其他 MCP 兼容 Agent在同一命令和参数下、在 Agent 允许配置外部 stdio MCP 服务器的位置配置即可具体配置格式以 Agent 当前 MCP 文档为准。如果你使用的助手支持 Agent Skills 格式也可以直接安装 Repomix Explorer Skill而不必配置 MCP。Claude Code 用户则可使用专属的 Repomix Explorer 插件提供/repomix-explorer:explore-local等命名空间斜杠命令。另注意--mcp还常搭配--sandbox [dir]使用将 MCP 服务器的文件类工具限制在工作区目录内绝对路径/宿主机路径将被拒绝远程打包、Skill 生成与外部输出附加都会被禁用详见 MCP 服务器指南。如何帮 AI 助手理解一个新库或新框架FAQ 给出的实战方案把库的仓库或其文档打包然后让 AI 助手将输出作为参考资料使用npx repomix --remote owner/repo npx repomix --remote owner/repo --include docs/**,src/**对于反复使用的场景还可以生成可复用的 Agent Skillsnpx repomix --remote owner/repo --skill-generate library-referenceSkill 生成的实际产物是.claude/skills/name/目录内含SKILL.md与多份引用文件summary、structure、files、tech-stack 等流程见 src/core/skill/packSkill.ts更完整的说明在 Agent Skills 生成指南。如何排除 CSS、测试、构建产物等干扰文件一次性命令用--ignorerepomix --ignore **/*.css,**/*.test.ts,dist/**,coverage/**只想保留特定源码或文档路径时用--includerepomix --include src/**/*.ts,docs/**/*.md团队协作场景建议把模式固化进repomix.config.json保证每个人生成相同的输出。有仓库大小限制吗FAQ 回答CLI 没有固定的仓库大小上限但超大仓库可能受限于内存、文件大小或 AI 工具的上传与上下文窗口限制。大项目建议先用 include 模式收窄范围、检查 token 密集的文件、必要时拆分输出repomix --token-count-tree 1000 repomix --split-output 1mb--token-count-tree [threshold]显示带 token 计数的文件树可选阈值只显示 token 数不低于 N 的文件如--token-count-tree 1000--split-output size把输出拆成多个编号文件如repomix-output.1.xml大小格式支持500kb、2mb、1.5mb。token 计数默认使用o200k_baseGPT-4o 系列编码也可用--token-count-encoding切换为cl100k_baseGPT-3.5/4、p50k_base等见 src/core/metrics/tokenEncodings.ts。中文 FAQ 特别提示托管网站更适合快速检查公开仓库或小体量上传大仓库、私有仓库或可重复的团队工作流应使用本地 CLI英文版 FAQ 亦有此对比结论。总结一份可执行的选型清单把 FAQ 全文浓缩成一张决策表场景推荐方案私有仓库打包本地检出目录直接运行repomix发送前人工审查输出公开 GitHub 仓库npx repomix --remote owner/repo自动归档下载失败降级 git 克隆通用输出格式默认 XML人类阅读用 Markdown程序消费用 JSON最大兼容用 plain输出太大--include--ignore收窄范围--compress压缩--remove-comments去注释密钥防护内置 Secretlint 安全检查 人工复核输出团队可复现repomix --init生成并提交repomix.config.jsonAI 助手集成npx -y repomix --mcp作为 stdio MCP 服务器或使用 Repomix Explorer Skill / Claude Code 插件大仓库--token-count-tree 1000定位重 token 文件--split-output 1mb拆分输出围绕 FAQ 中每个问题你都可以在仓库中找到对应的实现佐证配置默认值与合并逻辑在 src/config/configSchema.ts 与 src/cli/actions/defaultAction.ts远程打包在 src/cli/actions/remoteAction.ts安全扫描在 src/core/security/securityCheck.tsSkill 生成在 src/core/skill/packSkill.ts。若想进一步查阅完整 CLI 选项可打开 命令行选项参考其中还包含 stdout 管道、stdin 文件列表、Git diff/log 集成与 Watch 模式等大量示例。【免费下载链接】repomix Repomix is a powerful tool that packs your entire repository into a single, AI-friendly file. Perfect for when you need to feed your codebase to Large Language Models (LLMs) or other AI tools like Claude, ChatGPT, DeepSeek, Perplexity, Gemini, Gemma, Llama, Grok, and more.项目地址: https://gitcode.com/GitHub_Trending/rep/repomix创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Repomix FAQ 与故障排查完全指南：私有仓库、远程打包、Token 削减与 MCP 集成
Repomix FAQ 与故障排查完全指南私有仓库、远程打包、Token 削减与 MCP 集成【免费下载链接】repomix Repomix is a powerful tool that packs your entire repository into a single, AI-friendly file. Perfect for when you need to feed your codebase to Large Language Models (LLMs) or other AI tools like Claude, ChatGPT, DeepSeek, Perplexity, Gemini, Gemma, Llama, Grok, and more.项目地址: https://gitcode.com/GitHub_Trending/rep/repomixRepomix 是一款将整个代码仓库打包成单一 AI 友好文件的开源工具其官方 FAQ德语版见 website/client/src/de/guide/faq.md系统性地回答了工作流选型、输出体积控制、安全与隐私、以及各类疑难杂症。本文以该 FAQ 为核心骨架结合本仓库的源码实现CLI 动作、配置合并、安全扫描、远程仓库处理等逐条深入讲解每一个问题背后的机制与可执行的命令方案帮助你为 ChatGPT、Claude、Gemini 等 AI 助手准备高质量、低噪音、无泄露风险的代码库上下文。Repomix 是什么它能解决什么问题FAQ 的第一条问题即点明 Repomix 的核心用途将整个仓库打包成单一 AI 友好文件从而让你无需手动逐个复制文件就能把完整的代码库上下文提供给 AI 助手用于代码审查Code Review、Bug 排查、重构规划、新人入职引导Onboarding、文档编写、安全分析与架构评审。从打包主流程看CLI 会经过迁移 → 加载配置文件 → 解析 CLI 参数 → 合并三层配置默认值 / 文件 / CLI的流水线最终由pack()输出文件见 src/cli/actions/defaultAction.ts。默认配置在 src/config/configSchema.ts 中定义输出风格默认为xml默认输出文件名为repomix-output.xmlmarkdown / plain / json 风格对应的默认文件名分别是repomix-output.md、repomix-output.txt、repomix-output.json。私有仓库如何在本地打包FAQ 明确回答Repomix 完全支持私有仓库。做法是在你本机已经有访问权限的检出checkout目录中直接运行repomix此时 Repomix 读取的是你本地文件系统与本地 Git 配置不涉及任何凭据上传。FAQ 特别提醒在把生成的文件发送给外部 AI 服务之前请务必先自行检查一遍输出内容——这一点与后面的安全章节相互呼应。公开 GitHub 仓库无需克隆即可远程打包FAQ 指出Repomix 可以用--remote直接处理公开的 GitHub 仓库既支持owner/repo短格式也支持完整 URLnpx repomix --remote yamadashy/repomix npx repomix --remote https://github.com/yamadashy/repomix从源码看远程处理并非简单地下载后打包而是一套带降级策略的流程见 src/cli/actions/remoteAction.ts解析仓库 URL判断是否为 GitHub 仓库且支持归档下载archive优先走GitHub 归档下载通道约 60 秒超时、2 次重试并实时汇报下载进度百分比归档下载失败时自动降级为git 浅克隆shallow clone见execGitShallowClone克隆前会先探测远端 refs打包完成后将输出文件从临时目录复制回当前工作目录最后统一清理临时目录。FAQ英文版补充说明--remote还支持指定 branch、tag、commit 或子目录对应的 CLI 选项是--remote-branch name默认使用仓库默认分支。此外在远程模式下--config必须使用绝对路径以避免从克隆仓库中加载不可信配置见 src/cli/actions/remoteAction.ts。输出格式XML、Markdown、JSON 还是 PlainFAQ 的选型建议非常明确默认使用 XML结构化强适合能很好解析标签化上下文的模型如 ClaudeMarkdown适合人类阅读或需要编辑打包文件的场景JSON适合由另一个程序消费输出的自动化场景Plain纯文本需要最简单格式时的最大兼容选择。切换格式用--stylerepomix --style markdown repomix --style json--style支持xml、markdown、json、plain四种取值见 src/config/configSchema.ts默认值为xml。相关的输出细节文件摘要、目录结构、文件名格式等可进一步参考 输出格式指南 与 命令行选项参考。输出文件太大系统性削减 Token 消耗核心手段Include Ignore 压缩FAQ 给出了四个最常用的瘦身命令repomix --include src/**/*.ts,docs/**/*.md repomix --ignore **/*.test.ts,dist/** repomix --compress repomix --remove-comments--include只打包匹配这些 glob 模式的文件多个模式用逗号分隔--ignore额外排除匹配的模式--compress基于 Tree-sitter 的代码压缩--remove-comments打包前移除所有代码注释。FAQ 建议当仓库很大时把 include / ignore 模式与代码压缩组合使用。英文版 FAQ 还补充了聚焦与你问题相关的子系统与必要时拆分输出两条策略。在底层--include与--ignore都会经过splitPatterns()按逗号拆分见 src/cli/actions/defaultAction.ts--include映射到配置的include数组--ignore映射到ignore.customPatterns。--compress到底做了什么FAQ 解释--compress会保留导入、导出、类、函数、接口等关键结构同时移除大量实现细节——当模型主要需要理解架构和模块间关系而非逐行代码时尤其有用。实现层面压缩依赖Tree-sitter 解析仓库中为各语言准备了解析策略与查询文件如 src/core/treeSitter/parseStrategies/TypeScriptParseStrategy.ts、src/core/treeSitter/queries/queryTypescript.ts支持 C、C、C#、CSS、Dart、Go、Java、JavaScript、PHP、Python、Ruby、Rust、Solidity、Swift、TypeScript、Vue 等语言。注意压缩这类高级特性依赖于对应语言的解析器支持不同语言的支持程度可能不同。补充手段注释移除的取舍FAQ英文版专门讨论了--remove-comments的取舍当注释噪音大或占用过多 token 时使用当注释包含领域知识、API 契约、警告或重要实现理由时应保留。具体行为可参考 注释移除指南。安全与隐私代码会不会被上传FAQ 明确回答Repomix CLI 完全在本地运行只在你的机器上写出一个输出文件。这与网站版、浏览器扩展的工作流不同——使用托管或浏览器功能时请查阅 隐私政策。关于密钥防护FAQ 指出 Repomix 采用Secretlint 基础的安全检查来在打包前检测敏感值。源码印证了这一点安全扫描会遍历所有文件内容包括可选的 Git diff 与 Git log 内容分批提交给 worker 线程池并行检测每批 50 个文件、最多 2 个 worker 线程见 src/core/security/securityCheck.ts检测实现在 src/core/security/workers/securityCheckWorker.ts。FAQ 反复强调的立场是安全扫描只是额外一层保护网不能替代人工检查——在把私有代码发送给 AI 服务之前始终要亲自审阅生成的文件。--no-security-check选项会跳过这一扫描详见 安全指南。故障排查文件缺失、include 不生效、团队复现为什么输出里少了文件FAQ 给出的排查思路Repomix 会尊重.gitignore、默认忽略规则和你自定义的 ignore 模式。检查三个地方repomix.config.json中的 ignore 配置命令行--ignore选项该文件是否被 Git 本身忽略。仓库内置的默认忽略清单非常庞大见 src/config/defaultIgnore.ts包括版本控制目录.git/**、依赖目录**/node_modules/**、vendor/**、日志**/*.log、构建产物dist/**、build/**、out/**、测试覆盖率coverage/**、编辑器/OS 生成文件.idea/**、.vscode/**、**/.DS_Store、各语言锁文件**/package-lock.json、**/Cargo.lock、**/go.sum等、以及 Repomix 自身的输出**/repomix-output.*。为什么--include不含 node_modules 或构建目录里的文件FAQ 的解释是--include只是收窄Repomix 尝试打包的文件范围但ignore 规则依然生效。文件仍可能被.gitignore、.ignore、.repomixignore、内置默认模式或repomix.config.json排除。对于确实需要打包忽略目录中文件的高级场景FAQ 提到两个逃生舱选项repomix --no-gitignore repomix --no-default-patterns但它们会连带引入依赖、构建产物和其他干扰文件必须谨慎使用。从源码看--no-gitignore映射到ignore.useGitignore: false、--no-dot-ignore映射到ignore.useDotIgnore: false、--no-default-patterns映射到ignore.useDefaultPatterns: false见 src/cli/actions/defaultAction.ts。如何让团队输出可复现FAQ 推荐创建并提交一份共享配置repomix --init--init是交互式向导见 src/cli/actions/initAction.ts引导你选择输出风格与输出文件路径生成repomix.config.json并询问是否创建.repomixignore文件。之后团队在项目根目录运行repomix即可得到完全一致的输出。--global变体则把配置写入主目录全局配置。更多常见问题详解支持 C#、Python、Java、Go、Rust 等语言吗支持。FAQ 解释Repomix 读取的是项目文件本身并重新格式化与语言无关因此可以打包任何编程语言的仓库。前提条件使用 CLI 需要Node.js 22 或更新版本。某些高级功能如基于 Tree-sitter 的代码压缩依赖于各语言的解析器支持程度。能否与 Hermes Agent、OpenClaw 等 MCP 兼容 Agent 一起用可以。Repomix 可以以 MCPModel Context Protocol服务器模式运行npx -y repomix --mcpMCP 模式下Agent 可以在交互式编码会话中直接从你的本地环境请求打包后的代码库上下文入口见 src/cli/actions/mcpAction.ts服务器实现在 src/mcp/mcpServer.ts。以 Hermes Agent 为例在~/.hermes/config.yaml中将 Repomix 配置为 stdio MCP 服务器mcp_servers: repomix: command: npx args: [-y, repomix, --mcp]对 OpenClaw 或其他 MCP 兼容 Agent在同一命令和参数下、在 Agent 允许配置外部 stdio MCP 服务器的位置配置即可具体配置格式以 Agent 当前 MCP 文档为准。如果你使用的助手支持 Agent Skills 格式也可以直接安装 Repomix Explorer Skill而不必配置 MCP。Claude Code 用户则可使用专属的 Repomix Explorer 插件提供/repomix-explorer:explore-local等命名空间斜杠命令。另注意--mcp还常搭配--sandbox [dir]使用将 MCP 服务器的文件类工具限制在工作区目录内绝对路径/宿主机路径将被拒绝远程打包、Skill 生成与外部输出附加都会被禁用详见 MCP 服务器指南。如何帮 AI 助手理解一个新库或新框架FAQ 给出的实战方案把库的仓库或其文档打包然后让 AI 助手将输出作为参考资料使用npx repomix --remote owner/repo npx repomix --remote owner/repo --include docs/**,src/**对于反复使用的场景还可以生成可复用的 Agent Skillsnpx repomix --remote owner/repo --skill-generate library-referenceSkill 生成的实际产物是.claude/skills/name/目录内含SKILL.md与多份引用文件summary、structure、files、tech-stack 等流程见 src/core/skill/packSkill.ts更完整的说明在 Agent Skills 生成指南。如何排除 CSS、测试、构建产物等干扰文件一次性命令用--ignorerepomix --ignore **/*.css,**/*.test.ts,dist/**,coverage/**只想保留特定源码或文档路径时用--includerepomix --include src/**/*.ts,docs/**/*.md团队协作场景建议把模式固化进repomix.config.json保证每个人生成相同的输出。有仓库大小限制吗FAQ 回答CLI 没有固定的仓库大小上限但超大仓库可能受限于内存、文件大小或 AI 工具的上传与上下文窗口限制。大项目建议先用 include 模式收窄范围、检查 token 密集的文件、必要时拆分输出repomix --token-count-tree 1000 repomix --split-output 1mb--token-count-tree [threshold]显示带 token 计数的文件树可选阈值只显示 token 数不低于 N 的文件如--token-count-tree 1000--split-output size把输出拆成多个编号文件如repomix-output.1.xml大小格式支持500kb、2mb、1.5mb。token 计数默认使用o200k_baseGPT-4o 系列编码也可用--token-count-encoding切换为cl100k_baseGPT-3.5/4、p50k_base等见 src/core/metrics/tokenEncodings.ts。中文 FAQ 特别提示托管网站更适合快速检查公开仓库或小体量上传大仓库、私有仓库或可重复的团队工作流应使用本地 CLI英文版 FAQ 亦有此对比结论。总结一份可执行的选型清单把 FAQ 全文浓缩成一张决策表场景推荐方案私有仓库打包本地检出目录直接运行repomix发送前人工审查输出公开 GitHub 仓库npx repomix --remote owner/repo自动归档下载失败降级 git 克隆通用输出格式默认 XML人类阅读用 Markdown程序消费用 JSON最大兼容用 plain输出太大--include--ignore收窄范围--compress压缩--remove-comments去注释密钥防护内置 Secretlint 安全检查 人工复核输出团队可复现repomix --init生成并提交repomix.config.jsonAI 助手集成npx -y repomix --mcp作为 stdio MCP 服务器或使用 Repomix Explorer Skill / Claude Code 插件大仓库--token-count-tree 1000定位重 token 文件--split-output 1mb拆分输出围绕 FAQ 中每个问题你都可以在仓库中找到对应的实现佐证配置默认值与合并逻辑在 src/config/configSchema.ts 与 src/cli/actions/defaultAction.ts远程打包在 src/cli/actions/remoteAction.ts安全扫描在 src/core/security/securityCheck.tsSkill 生成在 src/core/skill/packSkill.ts。若想进一步查阅完整 CLI 选项可打开 命令行选项参考其中还包含 stdout 管道、stdin 文件列表、Git diff/log 集成与 Watch 模式等大量示例。【免费下载链接】repomix Repomix is a powerful tool that packs your entire repository into a single, AI-friendly file. Perfect for when you need to feed your codebase to Large Language Models (LLMs) or other AI tools like Claude, ChatGPT, DeepSeek, Perplexity, Gemini, Gemma, Llama, Grok, and more.项目地址: https://gitcode.com/GitHub_Trending/rep/repomix创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
