ByteScope

Test File Generator

選格式、調參數,下載一個小而正確的檔案。整個過程都在這個分頁裡完成。

檔案在這個分頁裡產生,不會上傳到任何地方。

純色的 PNG(RGB,半透明的顏色則為 RGBA),可選擇加入 eXIf 區塊

參數

參數名稱就是 generate_fixture 工具吃的 key。

1 到 16384

width*height must not exceed 4194304

1 到 16384

Fill color, #rgb / #rrggbb / #rrggbbaa

Embed an EXIF block

EXIF Make (only with withExif)

EXIF Model (only with withExif)

EXIF Orientation

1 到 8

EXIF DateTime and DateTimeOriginal

GPS latitude in decimal degrees; null writes no GPS IFD

-90 到 90 · 留空代表不指定

GPS longitude in decimal degrees; null writes no GPS IFD

-180 到 180 · 留空代表不指定

agent 也能要到一樣的檔案:ByteScope MCP 的 generate_fixture 工具跑的就是這些產生器。

關於這個工具

寫測試常常需要一個真的檔案:合法的 PNG、CRC 故意壞掉的 ZIP、兩天後過期的憑證。平常的做法是上網隨便抓一個,或是自己手拼位元組,然後把長度欄位拼錯。這頁照你設定的參數,在這個分頁裡把檔案做出來;每個產生器的輸出,測試裡都會用另一套獨立寫成的解析器讀回來確認。

範例圖片、影片與音訊

範例 PNG、JPEG、GIF、BMP、WebP 是你指定尺寸的單色圖片,可以加 EXIF,GIF 還能做成動畫。10 秒的測試影片是裝著 H.264 彩條的 MP4,moov 可以放開頭或結尾,在意 faststart 的播放器和解封裝工具,兩種情況都測得到。WAV 是正弦波或靜音,MP3 則是照你選的位元率做出的一段靜音。

測試用 dummy PDF、壓縮檔與憑證

dummy PDF 會有你指定頁數、每頁都有標號的頁面,可以附嵌入檔案,也能加 RC4 或 AES-128 加密。ZIP 可以指定每個檔案的名稱和內容、ZipCrypto 加密、分卷,或故意只弄壞一個欄位來測錯誤處理。X.509 會以現在時間為準,做出有效、快過期、已過期或尚未生效的自簽憑證,私鑰另外做成第二個檔案。

還有 pcap、SQLite 與韌體

pcap 和 pcapng 裡是 TCP 三向交握、DNS 查詢或 HTTP GET。SQLite 照你用 JSON 寫的資料表、欄位和列數產生。ELF、Intel HEX、UF2 則是給韌體工具用的最小合法映像檔。參數名稱和 ByteScope MCP 的 generate_fixture 工具吃的 key 一模一樣,在這裡做過的檔案,也能直接請 agent 再做一次。

常見問題

測試檔案會上傳,或是在伺服器上產生嗎?

都不會。產生器在你第一次按「產生」時才下載,然後在這個分頁裡執行。檔案不會離開瀏覽器;匿名事件只帶格式、成功或失敗,以及大概的檔案大小級距。

為什麼範例圖片只有一個顏色?

單色讓檔案小、結果完全可預期,測試可以直接比對某個像素的值。重點是結構正確的檔案,不是一張照片。

可以產生 10 秒的測試影片嗎?

可以。選 mp4,把 durationSeconds 設成 10,按產生。預設是 H.264、320×240、30 fps。單次產生上限 8 MB,太長或太大的影片會被擋下來,並告訴你原因。

怎麼做一張已經過期的憑證?

選 x509,把 validity 設成 expired,days 填過期幾天了。除非你在 now 填了時間,否則有效期間都從現在算起。私鑰會以第二個檔案一起給你。

agent 可以直接產生這些檔案嗎?

可以。ByteScope MCP 的 generate_fixture 工具用的就是同一套產生器,參數名稱也跟這裡看到的一樣,檔案會以 base64 回傳。