Repomix 跨平臺代碼審查指南讓 Node.js CLI 在 Windows、macOS、Linux 上行為一致【免費下載鏈接】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 友好文件XML、Markdown、JSON、Plain Text的 Node.js CLI 工具其核心功能——文件收集、忽略規(guī)則解析、路徑處理與輸出寫入——每一步都依賴文件系統(tǒng)語義因此天然暴露在三套操作系統(tǒng)差異之下。本文基于倉庫內(nèi) reviewer-cross-platform.md 這一專職跨平臺審查 Agent 的完整規(guī)范系統(tǒng)講解 Repomix 團隊如何審查代碼變更中的跨平臺隱患包括四級嚴重性體系、八大關注領域路徑分隔符、Glob 模式、大小寫敏感、Windows 專屬文件系統(tǒng)規(guī)則、子進程與 Shell、空格路徑、CRLF 行尾、環(huán)境變量與 OS API、結構化審查報告格式以及每條規(guī)則背后對應的源碼實現(xiàn)與真實事故issue #1765。讀完你可以直接把這套審查清單用于任何 Node.js 跨平臺項目的 code review。為什么跨平臺審查是 Repomix 的一等公民Repomix 面向所有開發(fā)者的本地倉庫打包場景用戶在 Windows、macOS、Linux 上運行完全相同的命令。src/core/file/fileSearch.ts中文件搜索、忽略規(guī)則、輸出路徑的處理一旦在某個平臺出錯會直接表現(xiàn)為打包漏文件、路徑被改壞、輸出文件無法生成這類用戶可見故障。這份審查規(guī)范的開篇明確了一個殘酷事實這個項目真實發(fā)布過僅 Windows 觸發(fā)的 bug——當.gitignore規(guī)則中包含反斜杠時globby在 Windows 上崩潰issue #1765。因此規(guī)范要求審查者把 Windows 當作一等目標平臺而不是事后補丁而非僅靠 Linux CI 綠燈就放行變更。審查者角色與工作協(xié)議該文檔定義了專職的跨平臺審查 Agentmodel: sonnet描述為 Review code changes for cross-platform (Windows/macOS/Linux) hazards。其工作協(xié)議有三條核心約束全量上報不做預篩分析傳入的 diff報告每一個有具體證據(jù)的發(fā)現(xiàn)每條都標注嚴重性和置信度。不篩除邊緣發(fā)現(xiàn)——編排器orchestrator會做最終裁決并丟棄不同意的項你壓掉一條發(fā)現(xiàn)就是永久丟失而被拒收一條只損失一行輸出。嚴格遵守范圍限制只報告平臺可移植性問題見八大關注領域絕不虛構風險。結合兄弟審查者分工倉庫內(nèi)還有 reviewer-code-quality.md邏輯錯誤、異步并發(fā)、資源管理、reviewer-holistic.md架構契合、變更影響、跨模塊連鎖反應等專職審查者跨平臺審查者只負責平臺維度避免重復勞動。四級嚴重性體系所有發(fā)現(xiàn)按影響分級從必須合并前修復到可改可不改級別定義示例Critical在某個受支持平臺上崩潰或損壞數(shù)據(jù)合并前必須修復Windows 上 globby 處理反斜杠忽略規(guī)則直接拋異常High在某個受支持平臺上產(chǎn)生錯誤結果漏文件、路徑被改壞、輸出損壞輸出文件路徑未轉成 POSIX 分隔符導致自身無法被忽略而混入打包結果Medium今天能工作但依賴某個平臺特定假設在現(xiàn)實條件下會壞路徑含空格、非默認 TMPDIR、CI runner 差異假設 macOSTMPDIR不含空格Low可移植性異味當前無實際影響作者可自行取舍大小寫不敏感文件系統(tǒng)上的路徑 key 潛在沖突分級的關鍵判斷維度是可達性見后文命中所有用戶的缺陷文件收集、忽略處理、輸出寫入比命中測試輔助函數(shù)的缺陷嚴重得多。八大關注領域詳解1. 路徑構造與分隔符Path Construction and Separators這是最核心也最容易出錯的領域。規(guī)范要求禁止在路徑拼接/拆分處硬編碼/或\\必須用path.join()、path.resolve()、path.sep。禁止對路徑做字符串手術split(/)、replace(/\//g, ...)、startsWith(/)應使用path.relative()、path.parse()、path.isAbsolute()。區(qū)分path.posix用于 glob 模式與序列化路徑值需正斜杠與默認path用于文件系統(tǒng)調用。特別注明path.posix.normalize()不會轉換反斜杠構建 glob 模式時應使用 fast-glob 的convertPathToPattern()它同時轉義 glob 元字符因此不能用于序列化/展示路徑——那些場景只需做普通的分隔符替換。用比較路徑前必須先歸一化分隔符只有在明確針對大小寫不敏感文件系統(tǒng)時才做大小寫折疊——在 Linux 上無條件折疊會錯誤合并兩個僅大小寫不同的文件。盤符C:\、盤符相對路徑C:foo、UNC 路徑\\server\share會破壞路徑穿越防護這類前綴檢查。源碼佐證src/core/file/fileSearch.ts中定義了toPosixPath (value) value.replace(/\\/g, /)用于把輸出文件路徑轉為 POSIX 形式加入 globby 的 ignore 模式見getIgnorePatterns中對config.output.filePath的處理并附注釋說明原因globby 用正斜杠路徑匹配 ignore 模式Windows 上若輸出路徑保持docs\out.xml就會無法自我忽略輸出文件。這是文檔規(guī)則glob 模式需正斜杠的典型實現(xiàn)實例。2. Glob 模式globby / picomatch / fast-globWindows 原生路徑不能直接當作 glob 模式傳給globby/picomatch在 glob 語法中\(zhòng)是轉義字符而非分隔符模式必須先轉成正斜杠。用戶提供的忽略規(guī)則.gitignore、.repomixignore、--ignore中的反斜杠是合法的 gitignore 轉義語法應原樣保留給忽略文件 API而不是剝離——這類匹配器缺陷正是 issue #1765 的成因一個 globby 回歸上游已修復。Windows 上絕對路徑作為 glob 模式時盤符模式需要 fast-glob 的convertPathToPattern()。注意原生路徑cwd POSIX 模式是官方支持的標準用法不應誤報。不要假設 globby 返回的結果使用原生分隔符它們實際上是 POSIX 形式。源碼佐證src/core/file/fileSearch.ts的escapeGlobPattern先轉義反斜杠/\\/g→\\\\再轉義()、[]但不轉義{}用于處理含括號的路徑如src/(categories)→src/\(categories\)normalizeGlobPattern統(tǒng)一目錄模式結尾斜杠行為讓**/folder、**/folder/、**/folder/**/*行為一致。這些都是在給 globby 喂模式之前完成的歸一化。測試佐證fileSearch.gitignoreBackslash.test.ts 是 #1765 的回歸測試明確注釋The reported crash (path should be apath.relative()d string) comes out of the ignore packages path validation and reproduces on Windows only, which is why these tests matter most on the windows-latest CI leg。測試覆蓋三種場景根.gitignore含\.\NUL、嵌套.gitignore含\*.pid.lock、以及 contenteditable="false">【免費下載鏈接】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創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 Repomix 跨平臺代碼審查指南：讓 Node.js CLI 在 Windows、macOS、Linux 上行為一致
Repomix 跨平臺代碼審查指南讓 Node.js CLI 在 Windows、macOS、Linux 上行為一致【免費下載鏈接】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 友好文件XML、Markdown、JSON、Plain Text的 Node.js CLI 工具其核心功能——文件收集、忽略規(guī)則解析、路徑處理與輸出寫入——每一步都依賴文件系統(tǒng)語義因此天然暴露在三套操作系統(tǒng)差異之下。本文基于倉庫內(nèi) reviewer-cross-platform.md 這一專職跨平臺審查 Agent 的完整規(guī)范系統(tǒng)講解 Repomix 團隊如何審查代碼變更中的跨平臺隱患包括四級嚴重性體系、八大關注領域路徑分隔符、Glob 模式、大小寫敏感、Windows 專屬文件系統(tǒng)規(guī)則、子進程與 Shell、空格路徑、CRLF 行尾、環(huán)境變量與 OS API、結構化審查報告格式以及每條規(guī)則背后對應的源碼實現(xiàn)與真實事故issue #1765。讀完你可以直接把這套審查清單用于任何 Node.js 跨平臺項目的 code review。為什么跨平臺審查是 Repomix 的一等公民Repomix 面向所有開發(fā)者的本地倉庫打包場景用戶在 Windows、macOS、Linux 上運行完全相同的命令。src/core/file/fileSearch.ts中文件搜索、忽略規(guī)則、輸出路徑的處理一旦在某個平臺出錯會直接表現(xiàn)為打包漏文件、路徑被改壞、輸出文件無法生成這類用戶可見故障。這份審查規(guī)范的開篇明確了一個殘酷事實這個項目真實發(fā)布過僅 Windows 觸發(fā)的 bug——當.gitignore規(guī)則中包含反斜杠時globby在 Windows 上崩潰issue #1765。因此規(guī)范要求審查者把 Windows 當作一等目標平臺而不是事后補丁而非僅靠 Linux CI 綠燈就放行變更。審查者角色與工作協(xié)議該文檔定義了專職的跨平臺審查 Agentmodel: sonnet描述為 Review code changes for cross-platform (Windows/macOS/Linux) hazards。其工作協(xié)議有三條核心約束全量上報不做預篩分析傳入的 diff報告每一個有具體證據(jù)的發(fā)現(xiàn)每條都標注嚴重性和置信度。不篩除邊緣發(fā)現(xiàn)——編排器orchestrator會做最終裁決并丟棄不同意的項你壓掉一條發(fā)現(xiàn)就是永久丟失而被拒收一條只損失一行輸出。嚴格遵守范圍限制只報告平臺可移植性問題見八大關注領域絕不虛構風險。結合兄弟審查者分工倉庫內(nèi)還有 reviewer-code-quality.md邏輯錯誤、異步并發(fā)、資源管理、reviewer-holistic.md架構契合、變更影響、跨模塊連鎖反應等專職審查者跨平臺審查者只負責平臺維度避免重復勞動。四級嚴重性體系所有發(fā)現(xiàn)按影響分級從必須合并前修復到可改可不改級別定義示例Critical在某個受支持平臺上崩潰或損壞數(shù)據(jù)合并前必須修復Windows 上 globby 處理反斜杠忽略規(guī)則直接拋異常High在某個受支持平臺上產(chǎn)生錯誤結果漏文件、路徑被改壞、輸出損壞輸出文件路徑未轉成 POSIX 分隔符導致自身無法被忽略而混入打包結果Medium今天能工作但依賴某個平臺特定假設在現(xiàn)實條件下會壞路徑含空格、非默認 TMPDIR、CI runner 差異假設 macOSTMPDIR不含空格Low可移植性異味當前無實際影響作者可自行取舍大小寫不敏感文件系統(tǒng)上的路徑 key 潛在沖突分級的關鍵判斷維度是可達性見后文命中所有用戶的缺陷文件收集、忽略處理、輸出寫入比命中測試輔助函數(shù)的缺陷嚴重得多。八大關注領域詳解1. 路徑構造與分隔符Path Construction and Separators這是最核心也最容易出錯的領域。規(guī)范要求禁止在路徑拼接/拆分處硬編碼/或\\必須用path.join()、path.resolve()、path.sep。禁止對路徑做字符串手術split(/)、replace(/\//g, ...)、startsWith(/)應使用path.relative()、path.parse()、path.isAbsolute()。區(qū)分path.posix用于 glob 模式與序列化路徑值需正斜杠與默認path用于文件系統(tǒng)調用。特別注明path.posix.normalize()不會轉換反斜杠構建 glob 模式時應使用 fast-glob 的convertPathToPattern()它同時轉義 glob 元字符因此不能用于序列化/展示路徑——那些場景只需做普通的分隔符替換。用比較路徑前必須先歸一化分隔符只有在明確針對大小寫不敏感文件系統(tǒng)時才做大小寫折疊——在 Linux 上無條件折疊會錯誤合并兩個僅大小寫不同的文件。盤符C:\、盤符相對路徑C:foo、UNC 路徑\\server\share會破壞路徑穿越防護這類前綴檢查。源碼佐證src/core/file/fileSearch.ts中定義了toPosixPath (value) value.replace(/\\/g, /)用于把輸出文件路徑轉為 POSIX 形式加入 globby 的 ignore 模式見getIgnorePatterns中對config.output.filePath的處理并附注釋說明原因globby 用正斜杠路徑匹配 ignore 模式Windows 上若輸出路徑保持docs\out.xml就會無法自我忽略輸出文件。這是文檔規(guī)則glob 模式需正斜杠的典型實現(xiàn)實例。2. Glob 模式globby / picomatch / fast-globWindows 原生路徑不能直接當作 glob 模式傳給globby/picomatch在 glob 語法中\(zhòng)是轉義字符而非分隔符模式必須先轉成正斜杠。用戶提供的忽略規(guī)則.gitignore、.repomixignore、--ignore中的反斜杠是合法的 gitignore 轉義語法應原樣保留給忽略文件 API而不是剝離——這類匹配器缺陷正是 issue #1765 的成因一個 globby 回歸上游已修復。Windows 上絕對路徑作為 glob 模式時盤符模式需要 fast-glob 的convertPathToPattern()。注意原生路徑cwd POSIX 模式是官方支持的標準用法不應誤報。不要假設 globby 返回的結果使用原生分隔符它們實際上是 POSIX 形式。源碼佐證src/core/file/fileSearch.ts的escapeGlobPattern先轉義反斜杠/\\/g→\\\\再轉義()、[]但不轉義{}用于處理含括號的路徑如src/(categories)→src/\(categories\)normalizeGlobPattern統(tǒng)一目錄模式結尾斜杠行為讓**/folder、**/folder/、**/folder/**/*行為一致。這些都是在給 globby 喂模式之前完成的歸一化。測試佐證fileSearch.gitignoreBackslash.test.ts 是 #1765 的回歸測試明確注釋The reported crash (path should be apath.relative()d string) comes out of the ignore packages path validation and reproduces on Windows only, which is why these tests matter most on the windows-latest CI leg。測試覆蓋三種場景根.gitignore含\.\NUL、嵌套.gitignore含\*.pid.lock、以及 contenteditable="false">【免費下載鏈接】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創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考