适用于 Gemini CLI 的 Aktar
从 Gemini CLI 上传文件到你自己的存储桶
有了 Aktar 扩展，Gemini CLI 可以把文件和截图上传到你自己的 S3、Cloudflare R2 或 Backblaze B2 存储桶，把剪贴板里的内容变成链接，还能找回你以前上传的文件。它在你电脑上的 Aktar 应用旁边运行，所以你的存储密钥始终不会离开 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 应用中。扩展只使用 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 或更高版本。