尧图网页设计 
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/repomix本文以 Repomix 官方 FAQ西班牙语版faq.md为骨架结合仓库源码深入讲解 Repomix 的典型使用场景私有仓库与远程仓库处理、输出格式选择、超大输出压缩、安全与隐私保障、常见问题排障以及通过 MCP 与 Agent Skills 接入 AI 助手。读完本文你将掌握一套完整的 Repomix 工作流选择思路能够针对不同的 AI 工具链与仓库规模快速组装出安全、精简、可复现的代码上下文包。Repomix 是做什么的Repomix 将一个仓库整体打包为单一、对 AI 友好的文件。这个文件可以完整承载代码库上下文直接交给 ChatGPT、Claude、Gemini 等 AI 助手用于代码审查、调试排障、重构、文档编写与新成员入职引导onboarding。打包过程完全发生在本地CLI 读取项目文件、按配置规则筛选与压缩最后写出repomix-output.xml或其他格式等输出文件全程不需要把仓库内容托管给任何第三方服务。私有仓库无需任何特殊处理Repomix 天然支持私有仓库。方式很简单在你本机已经有访问权限的 checkout 目录内直接运行repomix它会读取当前目录下的仓库内容并生成本地输出文件。由于命令完全在本地执行私有仓库的凭据与代码都不会离开你的机器。⚠️ 重要实践在把生成的输出文件分享给任何外部 AI 服务之前务必先人工审阅一遍输出内容——这既是好习惯也是后文安全与隐私一节反复强调的底线。公开 GitHub 仓库免克隆直接处理对于公开的 GitHub 仓库可以使用--remote参数无需先手动克隆。支持两种写法短格式owner/repo或完整 URLnpx repomix --remote yamadashy/repomix npx repomix --remote https://github.com/yamadashy/repomix从源码看远程模式的实际流程remoteAction.ts相当讲究优先尝试 GitHub archive 下载当目标仓库是 GitHub 且支持归档下载时isArchiveDownloadSupportedCLI 会先下载仓库归档并实时显示进度百分比或已下载的 MB 数超时 60 秒、最多重试 2 次。失败自动回退 git clone归档下载失败后自动清理临时目录改用 git 浅克隆shallow clone。回退前会先检查本机是否安装了 gitisGitInstalled未安装会明确报错Git is not installed or not in the system PATH.。输出复制回当前目录下载/克隆都在系统临时目录mkdtemp(repomix-)中进行打包完成后把输出文件复制到你执行命令的当前目录随后清理临时目录。安全约束远程模式下--config必须传绝对路径防止从克隆下来的不可信仓库里加载配置文件避免恶意配置被执行克隆仓库中的配置文件只有在用户显式信任时才会生效。执行npx repomix --remote yamadashy/repomix后会在当前目录生成repomix-output.xml整个过程用户无感。输出格式怎么选Repomix 提供四种输出风格通过--style切换格式适用场景xml默认结构化强、信息密度高默认推荐markdown面向人类的可读对话json机器自动化处理plain最大兼容性repomix --style markdown repomix --style json这些风格在配置层面对应枚举xml | markdown | json | plain并且每种格式都有默认输出文件名configSchema.tsrepomix-output.xml、repomix-output.md、repomix-output.json、repomix-output.txt。更完整的格式对比可参考输出格式指南。输出文件太大从这几个方向压缩当生成的文件过大、超出模型的上下文窗口时按优先级组合使用以下手段repomix --include src/**/*.ts,docs/**/*.md # 只保留关心的代码与文档 repomix --ignore **/*.test.ts,dist/** # 剔除测试与构建产物 repomix --compress # 代码结构级压缩 repomix --remove-comments # 移除注释--include缩小范围--include用逗号分隔的 glob 模式指定只打包哪些路径例如只保留源码与文档repomix --include src/**/*.ts,docs/**/*.md--ignore剔除噪音--ignore剔除不需要的内容例如 CSS、测试文件、构建输出repomix --ignore **/*.css,**/*.test.ts,dist/**,coverage/**--compress保留骨架、删掉实现细节--compress是 Repomix 最具特色的压缩手段它保留 imports、exports、类、函数、接口等关键结构但剔除大量实现细节。当模型只需要理解架构、不需要逐行实现时非常高效。底层实现基于 Tree-sitter 语法解析parseFile.ts对支持的语言C、C、C#、CSS、Dart、Go、Java、JavaScript、PHP、Python、Ruby、Rust、Solidity、Swift、TypeScript、Vue 等对应 queries/ 下的查询文件用语法树捕获结构节点进行压缩语言不支持或解析失败时会自动回退到未压缩内容打印 warning 而非中断整个打包保证健壮性。这也解释了 FAQ 中的说明部分高级功能如基于 Tree-sitter 的压缩依赖各语言的 parser 支持情况。--remove-comments去掉注释与压缩配合使用删除源码中的注释块进一步削减 token。在 CLI 参数到配置的映射上这些开关最终都会写入合并后的配置对象defaultAction.ts 中removeComments、compress等字段的映射逻辑再交给下游处理管线。安全与隐私代码会被上传吗Repomix CLI 完全在本地运行输出文件直接写到你自己的机器上不会上传代码。注意区分官方网站和浏览器扩展browser/属于独立流程其数据处理方式参见隐私政策。如何防止打包进密钥Repomix 内置基于Secretlint的安全检测打包过程中对每个文件的内容进行已知密钥格式扫描securityCheck.ts包括普通文件内容、git diff 内容与 git log 历史内容。实现上通过 worker 线程池并行批处理每批 50 个文件最多 2 个安全 worker兼顾吞吐与资源占用检测出的可疑文件会在报告中标注提醒。请务必把安全扫描视为额外的一层防御而不是唯一防线——在分享输出前人工复核仍然必不可少。想关闭/开启检测可用--security-check相关配置更完整的说明见安全指南。故障排查为什么输出里缺文件文件缺失通常由多层 ignore 规则共同导致从上到下依次检查项目的.gitignore/.ignore/.repomixignoreRepomix 内置的默认忽略模式defaultIgnore.ts其中包含**/node_modules/**、dist/**、.vuepress/dist/**等常见噪音路径repomix.config.json中的ignore.customPatterns配置命令行--ignore参数当--include明确指定了某路径但文件仍不出现时同样需要排查上述 ignore 规则是否把目标路径排除了详见下文include 与 ignore 的优先级。如何让输出在团队内可复现把配置固化并纳入版本管理即可。执行repomix --init它会以交互式向导initAction.ts引导你选择输出风格xml / markdown / json / plain指定输出文件路径预填对应格式的默认文件名生成repomix.config.json可选生成.repomixignore文件内含注释示例方便团队填写自定义忽略规则配置文件生成后团队成员执行repomix即可得到完全一致的打包结果。把repomix.config.json与.repomixignore提交进仓库就是最直接的团队级可复现方案。支持哪些语言Repomix 本质上是读取项目文件并格式化为 AI 工具可用的结构因此理论上可以打包任意语言写的仓库包括 C#、Python、Java、Go、Rust 等。有两个前提值得注意CLI 运行环境要求 Node.js 22 或更高版本高级功能如基于 Tree-sitter 的--compress压缩依赖各语言 parser 的支持情况不支持的场景会回退为未压缩输出。与 MCP 兼容的 Agent 集成Repomix 可以作为MCPModel Context Protocol服务器运行供 Hermes Agent、OpenClaw 等支持 MCP 的智能体调用npx -y repomix --mcp在 Hermes Agent 中将 Repomix 添加为 stdio 类型的 MCP 服务器编辑~/.hermes/config.yamlmcp_servers: repomix: command: npx args: [-y, repomix, --mcp]在 OpenClaw 或其他 MCP 兼容 Agent 中使用相同的command和args在 Agent 允许配置外部 MCP stdio 服务器的地方照此填写即可。如果你的助手支持 Agent Skills还可以直接使用 Repomix Explorer Skill。从 mcpServer.ts 看MCP 服务器注册了若干工具pack_codebase打包当前工作区、pack_remote_repository打包远程仓库、generate_skill从代码库生成 Agent Skill、attach_packed_output挂载已有打包结果、read_repomix_output与grep_repomix_output检索/分析打包结果等。启用--sandbox时还会额外提供受限的文件系统读取工具并把所有路径约束在工作区内。相关配置可参考仓库根目录的 server.json。用 Repomix 让 AI 快速理解一个新库要帮助 AI 助手理解某个陌生库或框架最直接的方式是打包该库的仓库或其文档把输出作为参考资料交给助手npx repomix --remote owner/repo npx repomix --remote owner/repo --include docs/**,src/**--include限定只打包文档与源码目录能显著减小体积、提升理解效率。如果这个库需要反复使用可以一次性生成一个可复用的Agent Skills 目录npx repomix --remote owner/repo --skill-generate library-reference这会生成一个结构化 Skill含技能说明、使用指引与打包好的参考内容之后 AI 助手可以直接加载该 Skill 来理解该库无需每次重新打包。远程模式下生成的 Skill 名称未指定时默认由仓库 URL 推导技能描述中的来源 URL 会自动做脱敏处理remoteAction.ts。有没有仓库大小限制CLI 本身没有固定的大小上限但实际使用中可能受以下因素制约内存与单文件大小AI 工具的上传与上下文窗口限制对于大型项目官方推荐的工作流是先用具体 include 模式缩小范围再找出 token 占用最多的文件逐个优化必要时拆分输出repomix --token-count-tree 1000 repomix --split-output 1mb--token-count-tree 1000在输出中生成 token 统计树只展示 token 数不少于 1000 的文件帮你快速定位大头文件tokenCountTreeReporter.ts。--split-output 1mb按指定大小把输出拆分为多个文件规避单文件过大或上传限制对应配置项output.splitOutput单位为字节。注意--split-output与--stdout、--copy、--skill-generate存在冲突组合CLI 会在校验阶段直接报错defaultAction.ts 的冲突校验逻辑。include 与 ignore 的优先级一个高频疑问为什么--include指定了node_modules或其他路径文件却还是没有被打包关键点在于--include只决定尝试打包哪些文件这个候选集合而 ignore 规则依然全程生效。文件可能因为以下任意一种规则被排除.gitignore.ignore.repomixignore内置默认模式如**/node_modules/**、dist/**repomix.config.json中的ignore.customPatterns在高级场景下可以显式关闭部分忽略规则repomix --no-gitignore repomix --no-default-patterns⚠️ 谨慎使用关闭这些规则可能把依赖node_modules、构建产物等大量噪音文件重新纳入打包输出体积和上下文噪音都会显著增加。更稳妥的做法是保持 ignore 规则不变改用更精确的--include或--ignore组合来达成目的。相关资源基本用法指南命令行选项参考代码压缩详解安全指南隐私政策Repomix Explorer Skill【免费下载链接】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/repomix本文以 Repomix 官方 FAQ西班牙语版faq.md为骨架结合仓库源码深入讲解 Repomix 的典型使用场景私有仓库与远程仓库处理、输出格式选择、超大输出压缩、安全与隐私保障、常见问题排障以及通过 MCP 与 Agent Skills 接入 AI 助手。读完本文你将掌握一套完整的 Repomix 工作流选择思路能够针对不同的 AI 工具链与仓库规模快速组装出安全、精简、可复现的代码上下文包。Repomix 是做什么的Repomix 将一个仓库整体打包为单一、对 AI 友好的文件。这个文件可以完整承载代码库上下文直接交给 ChatGPT、Claude、Gemini 等 AI 助手用于代码审查、调试排障、重构、文档编写与新成员入职引导onboarding。打包过程完全发生在本地CLI 读取项目文件、按配置规则筛选与压缩最后写出repomix-output.xml或其他格式等输出文件全程不需要把仓库内容托管给任何第三方服务。私有仓库无需任何特殊处理Repomix 天然支持私有仓库。方式很简单在你本机已经有访问权限的 checkout 目录内直接运行repomix它会读取当前目录下的仓库内容并生成本地输出文件。由于命令完全在本地执行私有仓库的凭据与代码都不会离开你的机器。⚠️ 重要实践在把生成的输出文件分享给任何外部 AI 服务之前务必先人工审阅一遍输出内容——这既是好习惯也是后文安全与隐私一节反复强调的底线。公开 GitHub 仓库免克隆直接处理对于公开的 GitHub 仓库可以使用--remote参数无需先手动克隆。支持两种写法短格式owner/repo或完整 URLnpx repomix --remote yamadashy/repomix npx repomix --remote https://github.com/yamadashy/repomix从源码看远程模式的实际流程remoteAction.ts相当讲究优先尝试 GitHub archive 下载当目标仓库是 GitHub 且支持归档下载时isArchiveDownloadSupportedCLI 会先下载仓库归档并实时显示进度百分比或已下载的 MB 数超时 60 秒、最多重试 2 次。失败自动回退 git clone归档下载失败后自动清理临时目录改用 git 浅克隆shallow clone。回退前会先检查本机是否安装了 gitisGitInstalled未安装会明确报错Git is not installed or not in the system PATH.。输出复制回当前目录下载/克隆都在系统临时目录mkdtemp(repomix-)中进行打包完成后把输出文件复制到你执行命令的当前目录随后清理临时目录。安全约束远程模式下--config必须传绝对路径防止从克隆下来的不可信仓库里加载配置文件避免恶意配置被执行克隆仓库中的配置文件只有在用户显式信任时才会生效。执行npx repomix --remote yamadashy/repomix后会在当前目录生成repomix-output.xml整个过程用户无感。输出格式怎么选Repomix 提供四种输出风格通过--style切换格式适用场景xml默认结构化强、信息密度高默认推荐markdown面向人类的可读对话json机器自动化处理plain最大兼容性repomix --style markdown repomix --style json这些风格在配置层面对应枚举xml | markdown | json | plain并且每种格式都有默认输出文件名configSchema.tsrepomix-output.xml、repomix-output.md、repomix-output.json、repomix-output.txt。更完整的格式对比可参考输出格式指南。输出文件太大从这几个方向压缩当生成的文件过大、超出模型的上下文窗口时按优先级组合使用以下手段repomix --include src/**/*.ts,docs/**/*.md # 只保留关心的代码与文档 repomix --ignore **/*.test.ts,dist/** # 剔除测试与构建产物 repomix --compress # 代码结构级压缩 repomix --remove-comments # 移除注释--include缩小范围--include用逗号分隔的 glob 模式指定只打包哪些路径例如只保留源码与文档repomix --include src/**/*.ts,docs/**/*.md--ignore剔除噪音--ignore剔除不需要的内容例如 CSS、测试文件、构建输出repomix --ignore **/*.css,**/*.test.ts,dist/**,coverage/**--compress保留骨架、删掉实现细节--compress是 Repomix 最具特色的压缩手段它保留 imports、exports、类、函数、接口等关键结构但剔除大量实现细节。当模型只需要理解架构、不需要逐行实现时非常高效。底层实现基于 Tree-sitter 语法解析parseFile.ts对支持的语言C、C、C#、CSS、Dart、Go、Java、JavaScript、PHP、Python、Ruby、Rust、Solidity、Swift、TypeScript、Vue 等对应 queries/ 下的查询文件用语法树捕获结构节点进行压缩语言不支持或解析失败时会自动回退到未压缩内容打印 warning 而非中断整个打包保证健壮性。这也解释了 FAQ 中的说明部分高级功能如基于 Tree-sitter 的压缩依赖各语言的 parser 支持情况。--remove-comments去掉注释与压缩配合使用删除源码中的注释块进一步削减 token。在 CLI 参数到配置的映射上这些开关最终都会写入合并后的配置对象defaultAction.ts 中removeComments、compress等字段的映射逻辑再交给下游处理管线。安全与隐私代码会被上传吗Repomix CLI 完全在本地运行输出文件直接写到你自己的机器上不会上传代码。注意区分官方网站和浏览器扩展browser/属于独立流程其数据处理方式参见隐私政策。如何防止打包进密钥Repomix 内置基于Secretlint的安全检测打包过程中对每个文件的内容进行已知密钥格式扫描securityCheck.ts包括普通文件内容、git diff 内容与 git log 历史内容。实现上通过 worker 线程池并行批处理每批 50 个文件最多 2 个安全 worker兼顾吞吐与资源占用检测出的可疑文件会在报告中标注提醒。请务必把安全扫描视为额外的一层防御而不是唯一防线——在分享输出前人工复核仍然必不可少。想关闭/开启检测可用--security-check相关配置更完整的说明见安全指南。故障排查为什么输出里缺文件文件缺失通常由多层 ignore 规则共同导致从上到下依次检查项目的.gitignore/.ignore/.repomixignoreRepomix 内置的默认忽略模式defaultIgnore.ts其中包含**/node_modules/**、dist/**、.vuepress/dist/**等常见噪音路径repomix.config.json中的ignore.customPatterns配置命令行--ignore参数当--include明确指定了某路径但文件仍不出现时同样需要排查上述 ignore 规则是否把目标路径排除了详见下文include 与 ignore 的优先级。如何让输出在团队内可复现把配置固化并纳入版本管理即可。执行repomix --init它会以交互式向导initAction.ts引导你选择输出风格xml / markdown / json / plain指定输出文件路径预填对应格式的默认文件名生成repomix.config.json可选生成.repomixignore文件内含注释示例方便团队填写自定义忽略规则配置文件生成后团队成员执行repomix即可得到完全一致的打包结果。把repomix.config.json与.repomixignore提交进仓库就是最直接的团队级可复现方案。支持哪些语言Repomix 本质上是读取项目文件并格式化为 AI 工具可用的结构因此理论上可以打包任意语言写的仓库包括 C#、Python、Java、Go、Rust 等。有两个前提值得注意CLI 运行环境要求 Node.js 22 或更高版本高级功能如基于 Tree-sitter 的--compress压缩依赖各语言 parser 的支持情况不支持的场景会回退为未压缩输出。与 MCP 兼容的 Agent 集成Repomix 可以作为MCPModel Context Protocol服务器运行供 Hermes Agent、OpenClaw 等支持 MCP 的智能体调用npx -y repomix --mcp在 Hermes Agent 中将 Repomix 添加为 stdio 类型的 MCP 服务器编辑~/.hermes/config.yamlmcp_servers: repomix: command: npx args: [-y, repomix, --mcp]在 OpenClaw 或其他 MCP 兼容 Agent 中使用相同的command和args在 Agent 允许配置外部 MCP stdio 服务器的地方照此填写即可。如果你的助手支持 Agent Skills还可以直接使用 Repomix Explorer Skill。从 mcpServer.ts 看MCP 服务器注册了若干工具pack_codebase打包当前工作区、pack_remote_repository打包远程仓库、generate_skill从代码库生成 Agent Skill、attach_packed_output挂载已有打包结果、read_repomix_output与grep_repomix_output检索/分析打包结果等。启用--sandbox时还会额外提供受限的文件系统读取工具并把所有路径约束在工作区内。相关配置可参考仓库根目录的 server.json。用 Repomix 让 AI 快速理解一个新库要帮助 AI 助手理解某个陌生库或框架最直接的方式是打包该库的仓库或其文档把输出作为参考资料交给助手npx repomix --remote owner/repo npx repomix --remote owner/repo --include docs/**,src/**--include限定只打包文档与源码目录能显著减小体积、提升理解效率。如果这个库需要反复使用可以一次性生成一个可复用的Agent Skills 目录npx repomix --remote owner/repo --skill-generate library-reference这会生成一个结构化 Skill含技能说明、使用指引与打包好的参考内容之后 AI 助手可以直接加载该 Skill 来理解该库无需每次重新打包。远程模式下生成的 Skill 名称未指定时默认由仓库 URL 推导技能描述中的来源 URL 会自动做脱敏处理remoteAction.ts。有没有仓库大小限制CLI 本身没有固定的大小上限但实际使用中可能受以下因素制约内存与单文件大小AI 工具的上传与上下文窗口限制对于大型项目官方推荐的工作流是先用具体 include 模式缩小范围再找出 token 占用最多的文件逐个优化必要时拆分输出repomix --token-count-tree 1000 repomix --split-output 1mb--token-count-tree 1000在输出中生成 token 统计树只展示 token 数不少于 1000 的文件帮你快速定位大头文件tokenCountTreeReporter.ts。--split-output 1mb按指定大小把输出拆分为多个文件规避单文件过大或上传限制对应配置项output.splitOutput单位为字节。注意--split-output与--stdout、--copy、--skill-generate存在冲突组合CLI 会在校验阶段直接报错defaultAction.ts 的冲突校验逻辑。include 与 ignore 的优先级一个高频疑问为什么--include指定了node_modules或其他路径文件却还是没有被打包关键点在于--include只决定尝试打包哪些文件这个候选集合而 ignore 规则依然全程生效。文件可能因为以下任意一种规则被排除.gitignore.ignore.repomixignore内置默认模式如**/node_modules/**、dist/**repomix.config.json中的ignore.customPatterns在高级场景下可以显式关闭部分忽略规则repomix --no-gitignore repomix --no-default-patterns⚠️ 谨慎使用关闭这些规则可能把依赖node_modules、构建产物等大量噪音文件重新纳入打包输出体积和上下文噪音都会显著增加。更稳妥的做法是保持 ignore 规则不变改用更精确的--include或--ignore组合来达成目的。相关资源基本用法指南命令行选项参考代码压缩详解安全指南隐私政策Repomix Explorer Skill【免费下载链接】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），仅供参考