適用於 Gemini CLI 的 Aktar
從 Gemini CLI 上傳檔案到你自己的儲存貯體
有了 Aktar 擴充功能,Gemini CLI 可以把檔案和螢幕截圖上傳到你自己的 S3、Cloudflare R2 或 Backblaze B2 儲存貯體,把剪貼簿裡的內容變成連結,還能找回你以前上傳的檔案。它在你電腦上的 Aktar App 旁邊執行,所以你的儲存金鑰始終不會離開 Aktar。
上傳 dist/report.pdf,給我一個傳給團隊的連結。
upload_file{ "path": "dist/report.pdf" }已上傳。連結如下:
https://files.example.com/2026/11/report.pdf你可以這樣說
-
分享檔案
“上傳 dist/report.pdf,把連結給我。”
Gemini 從你的專案上傳檔案。如果沒有指定目的地,Aktar 會依檔案類型選擇,就像把檔案拖到選單列一樣。
工具:
upload_file -
上傳你複製的內容
“上傳我剪貼簿裡的螢幕截圖。”
Aktar 上傳你複製的圖片或檔案,連結會出現在對話裡。
工具:
upload_clipboard -
短網址
“幫我昨天上傳的版本資訊產生一個短網址。”
它找到那次上傳,並請 Aktar 用你為該目的地設定的短網址服務產生短網址。
工具:
search_uploads,create_short_link
設定步驟
安裝 Mac 或 Windows 版 Aktar,並新增一個目的地(你的儲存貯體)。在 Aktar 中打開設定 > 整合,開啟允許本機連線並複製權杖,然後把它貼到這個指令中。需要 Node.js 18 或更新版本。
npx @getaktar/cli login在終端機中安裝擴充功能。
gemini extensions install https://github.com/getaktar/agent-plugins在你的專案資料夾中啟動
gemini,並在詢問時信任該資料夾:Gemini CLI 不會在你未信任的資料夾中啟動 MCP 伺服器。執行/mcp即可看到 Aktar 的工具。
擴充功能用 npx 執行固定版本的 @getaktar/cli,所以你不需要安裝 aktar 指令。用 gemini extensions update aktar 更新它。
它只從 Gemini CLI 執行所在的資料夾上傳檔案。如果在主資料夾中啟動,它不會上傳任何本機檔案,所以請在專案資料夾中啟動。
它能碰什麼
檔案只來自伺服器可以使用的資料夾,SSH 金鑰、.env 檔案和雲端服務憑證等機密絕不會被上傳。取代和刪除上傳項目預設關閉,除非你自己開啟。你的儲存金鑰留在 Aktar 中:代理程式拿到的只是檔名和連結,任何內容都不會傳給我們。上傳的檔案對任何拿到連結的人都是公開的,所以只請它上傳你想分享的內容。
常見問題
擴充功能會拿到我的儲存金鑰嗎?
不會。你的金鑰留在 Aktar App 中。擴充功能只使用 npx @getaktar/cli login 儲存在只有你能讀取的檔案中的本機權杖,並在 127.0.0.1 上與 Aktar 通訊。
為什麼 Gemini 看不到 Aktar 的工具?
通常是因為資料夾未受信任:Gemini CLI 不會在未受信任的資料夾中連線到 MCP 伺服器。在該資料夾中執行 gemini trust,或在 Gemini 詢問時信任它,然後用 /mcp 檢查。
Gemini 上傳前會先詢問嗎?
會,除非你允許了該工具,或以 YOLO 模式啟動了 Gemini CLI。搜尋和列出只是查看,上傳會修改你的儲存貯體。
支援 Windows 嗎?
支援,需要 Windows 版 Aktar 0.11.0 或更新版本。在 Mac 上需要 Mac 版 Aktar 0.18.0 或更新版本。