files-to-prompt 把選定的檔案連同路徑與分隔符號組合成文字,適合手動準備可回查的 AI 輸入。這次測試 0.6 的 Markdown 與行號輸出,重點是檔案有沒有選對,沒有把內容交給模型,也沒有測摘要或回答品質。
若輸入擴大到整個儲存庫,可比較 Repomix 的專案打包與 Gitingest 的儲存庫摘要,再核對實際納入的檔案。
先定義要保留的文字
建立 project/README.md,放入 Dispatch NOTE-31 leaves at 08:30.,以及包含加法函式的 sum.py。private.txt 和 debug.log 是合成排除對照,.gitignore 排除這兩種檔案。這次的目標是兩個工作檔案,不是整個資料夾所有內容。
使用固定版本與可讀格式
Python 3.12 虛擬環境內安裝 0.6,再執行下方指令。--markdown 讓檔案內容以程式碼區塊呈現,--line-numbers 加入來源行號;--ignore private.txt 另明列排除。這個例子保留 .gitignore 的預設行為,沒有使用 --ignore-gitignore。
以下為 POSIX shell 指令;本次在 Linux 容器測試,未測 Windows shell。
python -m pip install "files-to-prompt==0.6"
files-to-prompt ./project --markdown --line-numbers --ignore private.txt > ./prompt.md
用輸出內容判斷完成
驗收時核對 README.md 與 sum.py 的路徑、驗收句與 return a + b,並搜尋兩份排除記錄,應該找不到。再核對來源雜湊沒有變。用不存在的路徑執行應回傳非零代碼;第一次容器測試的 CLI 路徑設定錯誤屬於測試器問題,修正後另存重跑紀錄。
行號不能保證 AI 引用正確
行號提供回查位置,但沒有證明模型會正確引用,也不是遮蔽機密的安全邊界。CXML、從 stdin 傳路徑、隱藏檔開關依官方文件 v0.6 整理,未本地實測。這次也沒有測二進位檔、符號連結或不同作業系統的換行行為。若需要完整目錄樹,請另評估 Gitingest。
官方來源與測試範圍
本次為 Codex 在無發布憑證、非 root、斷網容器執行的合成資料測試,不代表站長親測。套件版本為 0.6;文件快照為 1b234ff6dccb。