第三方工具更新 2026.11.14

files-to-prompt 教學:附檔名與行號整理 AI 輸入

用 files-to-prompt 0.6 合併合成 Markdown 與 Python,檢查行號、排除規則及不存在的路徑;保留可以回查的原檔範圍。

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。

訂閱 AI 工具精選與使用建議

有值得推薦的新工具、實測發現或重要更新時,寄到你的信箱。

訂閱後先寄給你一份每月更新的 AI 工具與 Skill 清單。有值得推薦的工具、實測發現或重要更新時才寄信,隨時可以退訂。隱私權說明

快完成了,請到信箱收確認信點信裡的按鈕確認訂閱,就會收到工具清單的下載連結。沒看到的話,看一下垃圾郵件或「促銷內容」分頁。

也可以在這些平台追蹤: