Repomix 监视模式--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本指南围绕 Repomix 的监视模式Watch Mode展开讲解如何使用-w/--watch标志让 Repomix 持续监视本地代码库并在文件新增、修改、删除时自动重新打包为 AI 友好的单一输出文件。读完本文你将掌握监视模式的启动方式、与常用选项的组合用法、其防抖与重建的内部机制、忽略规则的处理逻辑以及哪些选项与监视模式不兼容及背后的原因。什么是监视模式Repomix 的核心能力是把整个代码库打包成一个单一、AI 友好的文件默认输出为repomix-output.xml供 Claude、ChatGPT、DeepSeek 等大语言模型直接消费。但代码库在持续演进每次改动后手动重新打包非常繁琐。监视模式正是为了解决这一问题Repomix 会监视你的代码库并在文件发生变更时自动重新打包从而在你工作时始终保持输出文件为最新状态。当你希望为 AI 助手持续提供刷新后的代码快照例如在长会话中反复喂入最新上下文时这个模式非常方便。用法启动与停止使用-w或--watch标志启动监视模式repomix --watchRepomix 会先执行一次初始打包然后持续运行并在每次变更时重新打包。该标志在 CLI 中的定义位于 src/cli/cliRun.ts-w, --watch: Watch for file changes and automatically re-pack并通过 runCli 路由到runWatchAction。你可以将监视模式与常用选项自由组合# 监视特定的文件集合 repomix -w --include src/**/*.ts # 使用自定义输出文件和格式进行监视 repomix --watch -o output.md --style markdown按CtrlC即可停止监视。停止时进程会执行一次优雅清理清除待执行的防抖定时器、关闭文件监视器并等待进行中的重建完成详见 watchAction.ts 中的 cleanup 逻辑。源码中对SIGINT/SIGTERM两个信号都注册了同一个幂等的清理处理器即使你快速按两次CtrlC监视器也只会被关闭一次对应测试见 watchAction.test.ts 中的 double CtrlC 用例。工作原理从启动到每次重建监视模式的完整执行链路为CLI 解析--watch→runCli校验选项冲突 →runWatchActionsrc/cli/actions/watchAction.ts构建合并配置并执行初始打包 → 创建 chokidar 监视器 → 监听change/add/unlink事件并调度重建。其关键行为如下初始打包启动时先打包一次代码库然后报告正在监视多少个文件。日志输出形如Watching N files for changes... (CtrlC to stop)其中 N 取自初始打包结果中的safeFilePaths数量。变更检测新增add、修改change和删除unlink文件都会触发重新打包。防抖短时间内的密集变更例如切换分支或一次性保存多个文件会被合并处理。源码中定义了REBUILD_DEBOUNCE_MS 300watchAction.tsRepomix 会在最后一次变更后等待300 ms再重新打包因此一连串的编辑只会产生一次重新构建。测试用例 watchAction.test.ts 的防抖测试 验证了在 300ms 窗口内连续触发多次change/add事件只会产生一次重建。时间戳每次重新构建后Repomix 都会打印一个时间戳Rebuilt at HH:MM:SS以便你了解输出最近一次刷新的时间。实现上使用new Date().toTimeString().split( )[0]提取 24 小时制的时分秒部分不依赖系统区域设置保证各平台输出格式一致watchAction.ts。文件写入稳定性chokidar 配置了awaitWriteFinish: { stabilityThreshold: 100 }watchAction.ts文件大小需在 100ms 内保持稳定才会触发变更事件避免把写入一半的文件打包进输出。重建期间的并发保护源码中实现了专门的重建保护rebuild guard用isRebuilding标志防止并发打包用pendingRebuild队列化重建期间到达的变更。如果在一次重建进行中又有文件变更该变更不会丢失而是被标记为待处理并在当前重建完成后立即执行下一次重建watchAction.ts。对应的测试验证了重建中触发变更不会并发执行、完成后会补跑一次的行为watchAction.test.ts。依赖的底层库监视功能基于 chokidar 实现并且采用懒加载策略——只有当--watch实际被使用时才会动态导入 chokidarconst chokidar await import(chokidar)见 watchAction.ts普通打包模式不会引入该依赖。监视器还监听了error事件如EMFILE、EACCES、EPERM等文件系统错误避免未捕获异常导致进程崩溃watchAction.ts。被忽略的文件与普通打包保持一致的规则监视模式遵循与普通运行完全相同的忽略规则.gitignore、.repomixignore、内置的默认模式例如node_modules和.git以及你传入的任何--ignore模式。被忽略的目录不会被监视这使得监视模式在大型项目上保持高效。在实现层面watchIgnore.ts 中的buildWatchIgnoreFilter构建了一个与打包器packer完全一致的忽略谓词函数传给 chokidar 的ignored选项。这里有几个值得注意的技术细节chokidar v4 在ignored选项中不再支持 glob只接受字面字符串、正则或函数因此打包器使用的 glob 模式通过minimatch重新求值。忽略规则按每个被监视的根目录分别解析复用了与打包相同的规则来源默认模式、自定义模式、.git/info/exclude、.gitignore以及.ignore/.repomixignore文件。底层调用链是getIgnorePatterns与getIgnoreFilePatterns定义于 src/core/file/fileSearch.ts 和 fileSearch.ts。除了匹配文件还会为形如foo/**的模式额外构建目录形式的匹配器foo让 chokidar 在下钻进入node_modules、.git等巨型或已被 gitignore 的目录树之前就停止——这正是避免大型项目因文件描述符耗尽EMFILE而崩溃的关键。gitignore 判定支持带尾部斜杠的目录形式dir/因为目录只有在被当作目录处理时才能被正确忽略。如果你想调整忽略行为可以结合配置文件中的ignore段useGitignore、useDotIgnore、useDefaultPatterns、customPatterns默认值见 configSchema.ts或 CLI 的--no-gitignore、--no-dot-ignore、--no-default-patterns选项仓库自带的 repomix.config.json 是一个完整示例。选项兼容性哪些选项不能与 --watch 组合监视模式仅适用于本地目录因此无法与以下选项组合使用无论你是在命令行还是在配置文件中设置它们不兼容选项原因--remote或位置参数形式的远程仓库 URL监视模式仅支持本地目录--stdout或--stdin流式模式没有可供刷新的持久化输出文件--split-output拆分输出会生成编号文件可能被监视器自身再次拾取形成循环--skill-generate监视模式不支持技能生成--copy每次变更时重新打包会反复覆盖剪贴板如果你将其中之一与--watch组合使用Repomix 会退出并报错说明该冲突。值得强调的是这一校验发生在两层CLI 层runCli中的validateWatchOptionssrc/cli/cliRun.ts在设置日志级别之前执行确保错误消息不会被--quiet/--stdout抑制它检查 CLI 标志层面的--remote、--stdout、--stdin、--copy、--split-output、--skill-generate以及位置参数形式的远程 URL。配置层runWatchAction在合并配置CLI 标志 配置文件 默认值之后再次对splitOutput、stdout、filePath -等价于 stdout 模式、skillGenerate、copyToClipboard进行复查watchAction.ts。这是因为配置文件中同样可以设置这些选项而仅检查 CLI 标志会漏掉它们。对应的测试覆盖了这两层场景watchAction.test.ts。实战提示为 AI 助手持续供料在编辑代码时保持repomix --watch -o output.md运行输出文件会始终反映最新代码状态随时可以粘贴给 LLM。限定监视范围大型项目中用-w --include src/**/*.ts只监视核心源码减少重建开销。配合配置文件将常用输出选项写入 repomix.config.json然后只运行repomix --watch让每次重建都使用一致的自定义配置配置文件的完整说明见 configuration.md。监视多个目录repomix --watch src packages可以一次监视多个目录监视器会以这些目录为根分别应用忽略规则。相关资源命令行选项 — 完整的 CLI 参考包括--watch的定义、组合用法及不兼容选项清单基本用法 — 运行 Repomix 的其他方式配置 — 在配置文件中设置默认输出选项监视模式核心实现 —runWatchAction与重建调度逻辑忽略过滤器实现 — 监视模式与打包一致的忽略规则监视模式测试 — 防抖、重建保护、冲突校验、优雅退出等行为的验证用例【免费下载链接】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 监视模式（--watch）实战指南：文件变更时自动重新打包代码库
Repomix 监视模式--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本指南围绕 Repomix 的监视模式Watch Mode展开讲解如何使用-w/--watch标志让 Repomix 持续监视本地代码库并在文件新增、修改、删除时自动重新打包为 AI 友好的单一输出文件。读完本文你将掌握监视模式的启动方式、与常用选项的组合用法、其防抖与重建的内部机制、忽略规则的处理逻辑以及哪些选项与监视模式不兼容及背后的原因。什么是监视模式Repomix 的核心能力是把整个代码库打包成一个单一、AI 友好的文件默认输出为repomix-output.xml供 Claude、ChatGPT、DeepSeek 等大语言模型直接消费。但代码库在持续演进每次改动后手动重新打包非常繁琐。监视模式正是为了解决这一问题Repomix 会监视你的代码库并在文件发生变更时自动重新打包从而在你工作时始终保持输出文件为最新状态。当你希望为 AI 助手持续提供刷新后的代码快照例如在长会话中反复喂入最新上下文时这个模式非常方便。用法启动与停止使用-w或--watch标志启动监视模式repomix --watchRepomix 会先执行一次初始打包然后持续运行并在每次变更时重新打包。该标志在 CLI 中的定义位于 src/cli/cliRun.ts-w, --watch: Watch for file changes and automatically re-pack并通过 runCli 路由到runWatchAction。你可以将监视模式与常用选项自由组合# 监视特定的文件集合 repomix -w --include src/**/*.ts # 使用自定义输出文件和格式进行监视 repomix --watch -o output.md --style markdown按CtrlC即可停止监视。停止时进程会执行一次优雅清理清除待执行的防抖定时器、关闭文件监视器并等待进行中的重建完成详见 watchAction.ts 中的 cleanup 逻辑。源码中对SIGINT/SIGTERM两个信号都注册了同一个幂等的清理处理器即使你快速按两次CtrlC监视器也只会被关闭一次对应测试见 watchAction.test.ts 中的 double CtrlC 用例。工作原理从启动到每次重建监视模式的完整执行链路为CLI 解析--watch→runCli校验选项冲突 →runWatchActionsrc/cli/actions/watchAction.ts构建合并配置并执行初始打包 → 创建 chokidar 监视器 → 监听change/add/unlink事件并调度重建。其关键行为如下初始打包启动时先打包一次代码库然后报告正在监视多少个文件。日志输出形如Watching N files for changes... (CtrlC to stop)其中 N 取自初始打包结果中的safeFilePaths数量。变更检测新增add、修改change和删除unlink文件都会触发重新打包。防抖短时间内的密集变更例如切换分支或一次性保存多个文件会被合并处理。源码中定义了REBUILD_DEBOUNCE_MS 300watchAction.tsRepomix 会在最后一次变更后等待300 ms再重新打包因此一连串的编辑只会产生一次重新构建。测试用例 watchAction.test.ts 的防抖测试 验证了在 300ms 窗口内连续触发多次change/add事件只会产生一次重建。时间戳每次重新构建后Repomix 都会打印一个时间戳Rebuilt at HH:MM:SS以便你了解输出最近一次刷新的时间。实现上使用new Date().toTimeString().split( )[0]提取 24 小时制的时分秒部分不依赖系统区域设置保证各平台输出格式一致watchAction.ts。文件写入稳定性chokidar 配置了awaitWriteFinish: { stabilityThreshold: 100 }watchAction.ts文件大小需在 100ms 内保持稳定才会触发变更事件避免把写入一半的文件打包进输出。重建期间的并发保护源码中实现了专门的重建保护rebuild guard用isRebuilding标志防止并发打包用pendingRebuild队列化重建期间到达的变更。如果在一次重建进行中又有文件变更该变更不会丢失而是被标记为待处理并在当前重建完成后立即执行下一次重建watchAction.ts。对应的测试验证了重建中触发变更不会并发执行、完成后会补跑一次的行为watchAction.test.ts。依赖的底层库监视功能基于 chokidar 实现并且采用懒加载策略——只有当--watch实际被使用时才会动态导入 chokidarconst chokidar await import(chokidar)见 watchAction.ts普通打包模式不会引入该依赖。监视器还监听了error事件如EMFILE、EACCES、EPERM等文件系统错误避免未捕获异常导致进程崩溃watchAction.ts。被忽略的文件与普通打包保持一致的规则监视模式遵循与普通运行完全相同的忽略规则.gitignore、.repomixignore、内置的默认模式例如node_modules和.git以及你传入的任何--ignore模式。被忽略的目录不会被监视这使得监视模式在大型项目上保持高效。在实现层面watchIgnore.ts 中的buildWatchIgnoreFilter构建了一个与打包器packer完全一致的忽略谓词函数传给 chokidar 的ignored选项。这里有几个值得注意的技术细节chokidar v4 在ignored选项中不再支持 glob只接受字面字符串、正则或函数因此打包器使用的 glob 模式通过minimatch重新求值。忽略规则按每个被监视的根目录分别解析复用了与打包相同的规则来源默认模式、自定义模式、.git/info/exclude、.gitignore以及.ignore/.repomixignore文件。底层调用链是getIgnorePatterns与getIgnoreFilePatterns定义于 src/core/file/fileSearch.ts 和 fileSearch.ts。除了匹配文件还会为形如foo/**的模式额外构建目录形式的匹配器foo让 chokidar 在下钻进入node_modules、.git等巨型或已被 gitignore 的目录树之前就停止——这正是避免大型项目因文件描述符耗尽EMFILE而崩溃的关键。gitignore 判定支持带尾部斜杠的目录形式dir/因为目录只有在被当作目录处理时才能被正确忽略。如果你想调整忽略行为可以结合配置文件中的ignore段useGitignore、useDotIgnore、useDefaultPatterns、customPatterns默认值见 configSchema.ts或 CLI 的--no-gitignore、--no-dot-ignore、--no-default-patterns选项仓库自带的 repomix.config.json 是一个完整示例。选项兼容性哪些选项不能与 --watch 组合监视模式仅适用于本地目录因此无法与以下选项组合使用无论你是在命令行还是在配置文件中设置它们不兼容选项原因--remote或位置参数形式的远程仓库 URL监视模式仅支持本地目录--stdout或--stdin流式模式没有可供刷新的持久化输出文件--split-output拆分输出会生成编号文件可能被监视器自身再次拾取形成循环--skill-generate监视模式不支持技能生成--copy每次变更时重新打包会反复覆盖剪贴板如果你将其中之一与--watch组合使用Repomix 会退出并报错说明该冲突。值得强调的是这一校验发生在两层CLI 层runCli中的validateWatchOptionssrc/cli/cliRun.ts在设置日志级别之前执行确保错误消息不会被--quiet/--stdout抑制它检查 CLI 标志层面的--remote、--stdout、--stdin、--copy、--split-output、--skill-generate以及位置参数形式的远程 URL。配置层runWatchAction在合并配置CLI 标志 配置文件 默认值之后再次对splitOutput、stdout、filePath -等价于 stdout 模式、skillGenerate、copyToClipboard进行复查watchAction.ts。这是因为配置文件中同样可以设置这些选项而仅检查 CLI 标志会漏掉它们。对应的测试覆盖了这两层场景watchAction.test.ts。实战提示为 AI 助手持续供料在编辑代码时保持repomix --watch -o output.md运行输出文件会始终反映最新代码状态随时可以粘贴给 LLM。限定监视范围大型项目中用-w --include src/**/*.ts只监视核心源码减少重建开销。配合配置文件将常用输出选项写入 repomix.config.json然后只运行repomix --watch让每次重建都使用一致的自定义配置配置文件的完整说明见 configuration.md。监视多个目录repomix --watch src packages可以一次监视多个目录监视器会以这些目录为根分别应用忽略规则。相关资源命令行选项 — 完整的 CLI 参考包括--watch的定义、组合用法及不兼容选项清单基本用法 — 运行 Repomix 的其他方式配置 — 在配置文件中设置默认输出选项监视模式核心实现 —runWatchAction与重建调度逻辑忽略过滤器实现 — 监视模式与打包一致的忽略规则监视模式测试 — 防抖、重建保护、冲突校验、优雅退出等行为的验证用例【免费下载链接】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），仅供参考