給開發者使用的 CLI

Gemini 浮水印移除 CLI

把網頁版的逆向 Alpha 引擎帶進終端機。支援從本機檔案或整個資料夾批次處理已支援的 Gemini 輸出中的可見浮水印。所有運算都在本機完成,圖片不會上傳。

terminal
# 無需全域安裝,直接執行一次
pnpm dlx @pilio/gemini-watermark-remover remove in.jpg --output out.png

快速開始

臨時執行可用 pnpm dlx,批次匯出可直接傳入資料夾;如果你每天都要處理 Gemini 圖片,再安裝更短的 gwr 指令。

處理單張圖片

清理一張 Gemini 圖片,並把結果寫入指定路徑。

pnpm dlx @pilio/gemini-watermark-remover remove in.jpg --output out.png

匯出整個資料夾

處理目錄中的圖片,並把輸出放到獨立資料夾。

pnpm dlx @pilio/gemini-watermark-remover remove ./images --out-dir ./clean

安裝 gwr 指令

如果經常使用,安裝一次之後指令會更精簡。

pnpm add -g @pilio/gemini-watermark-remover gwr remove ./images --out-dir ./clean

重複清理工作,交給 CLI 自動化

單張圖片適合直接丟進線上工具;但當你需要定期處理大量生成素材,或想把去浮水印整合進自己的流程時,CLI 能替你省下反覆拖曳的時間。

本機資料夾批次掃描

直接指定圖片輸出目錄,自動批次匯出已清理的副本,不必再在瀏覽器裡一張張處理與下載。

適合 CI/CD 流程的輸出格式

支援傳入 --json 取得結構化處理紀錄與退出碼,讓流水線腳本可以直接接手後續流程。

圖片不離開本機環境

圖像處理引擎完全在執行指令的裝置上運作。除了 pnpm 會下載套件之外,沒有任何後端服務會接觸你的圖片資料。

常用指令

依照你的工作情境直接複製:輸出單一檔案、匯出無浮水印資料夾,或為自動化流程回傳可讀取的 JSON。

另存為 PNG

pnpm dlx @pilio/gemini-watermark-remover remove gemini.png --output clean.png

清理資料夾到新目錄

pnpm dlx @pilio/gemini-watermark-remover remove ./gemini-images --out-dir ./watermark-free

覆寫舊結果並回傳 JSON

pnpm dlx @pilio/gemini-watermark-remover remove ./gemini-images --out-dir ./clean --overwrite --json

CLI 常見問題

執行 CLI 需要什麼環境?

Node 18+ 與 pnpm。已在 Windows、macOS、Linux 驗證過,不需要 GPU,也不依賴外部服務。

Gemini 浮水印移除 CLI 是什麼?

它是 Gemini Watermark Remover 的命令列版本,用來移除本機圖片檔中的可見 Gemini Logo 浮水印,方便你在腳本、終端機與批次任務中使用同一套引擎。

可以批次移除資料夾裡的 Gemini 浮水印嗎?

可以。把目錄當作輸入,並用 --out-dir 把處理後的圖片匯出到另一個資料夾。除非你明確指定會覆寫的輸出路徑,否則原始檔會保留下來。

CLI 會上傳我的圖片嗎?

不會。去浮水印流程完全在本機執行。使用 pnpm dlx 時,pnpm 只會下載命令列套件,圖片檔本身仍然只在你的裝置上處理。

能在 CI 裡使用嗎?

可以。使用 pnpm dlx 可零安裝執行;批次輸出可搭配 --out-dir,需要覆寫舊結果時可加 --overwrite,而當流水線需要讀取結果時可加上 --json。

可以輸出哪些圖片格式?

CLI 會依照輸出檔案的副檔名決定格式。使用 .png 輸出 PNG,使用 .jpg 或 .jpeg 輸出 JPEG,使用 .webp 輸出 WebP。

能移除 SynthID 或不可見浮水印嗎?

不能。本工具只針對已支援 Gemini 輸出中的可見 Gemini Logo 浮水印,不會移除不可見的 SynthID 訊號,也不處理其他來源的浮水印。

讓程式替你扛下批次工作

鎖定版本、讀取 JSON 輸出,直接在伺服器終端機或本機流程中執行。如果只是臨時清理一兩張圖,線上版依然隨時可用。