- 命令列
- v0.6.0
用 aktar 從終端機上傳
一行指令,一個連結:aktar upload report.pdf 透過 Aktar App 把檔案傳到你自己的儲存貯體,並輸出它的 URL、Markdown 或完整 JSON。專為腳本、CI 工作以及 Typora 這類編輯器打造。
也可以不安裝直接試用:npx @getaktar/cli upload file.png
在終端機中執行 aktar upload,輸出連結、Markdown 圖片與 JSON
aktar upload <file>…
上傳一個或多個檔案,每完成一個就輸出該檔案的連結,一個檔案一行。
--format markdown
輸出 Markdown、HTML 或你在 Aktar 中設定的自訂範本,而不是純 URL。
--json
以 JSON 輸出所有資訊:URL、每種格式、物件鍵、檔案大小,以及檔案的到期時間。
-d · --folder · --expires
依名稱選擇目的地、上傳到某個資料夾,或讓儲存貯體在 1、7、14 或 30 天後刪除檔案。
--clipboard
上傳剪貼簿中的檔案或影像。
--name cover
以另一個名稱上傳單一檔案,目的地的路徑範本與 Aktar 的歷史記錄都會使用這個名稱。
--qr · aktar qr
在每個連結下方輸出 QR Code,方便用手機開啟。
aktar qr可為任何連結或歷史記錄中的上傳項目顯示 QR Code。"reused": true
同一個檔案已經在儲存貯體裡時,Aktar 會直接回傳它的連結,不再重新上傳,
aktar會在 stderr 上註明。aktar replace
依上傳 ID、連結或物件鍵,用新檔案覆寫上傳項目並保留它的連結。需要 Aktar for Mac 0.14.0 或 Windows 0.7.0。
--short · aktar short
輸出來自目的地自有短網址服務的短連結。
aktar short可為歷史記錄中的上傳項目建立短連結。需要 Mac 版 Aktar 0.17.0 或 Windows 版 0.10.0。aktar mcp · aktar skill
讓 Claude、Cursor、VS Code、Codex 等 AI 代理程式透過 MCP 伺服器或代理程式技能上傳檔案、搜尋你的上傳項目並產生連結。
aktar login
儲存 Aktar 設定中顯示的權杖,儲存前會先確認它可以使用。
status · destinations · history
顯示連線狀態、你的目的地,以及可搜尋的上傳歷史記錄。
一分鐘完成設定
- 在 Mac 或 Windows 版 Aktar 中開啟設定 > 整合,並開啟允許本機連線。
複製權杖
拷貝那裡顯示的權杖。執行 aktar login
執行aktar login並貼上權杖。這樣就完成了:aktar upload現在會使用 Aktar 中選取的目的地。
專為腳本打造
連結會輸出到標準輸出,一行一個,其他訊息則輸出到標準錯誤,所以 URL=$(aktar upload build.zip) 直接就能用。--json 提供完整細節,結束代碼則告訴你發生了什麼事。在 CI 中,設定 AKTAR_TOKEN 就不必登入。
| 結束代碼 | 結束代碼 |
|---|---|
| 0 | 全部上傳完成 |
| 1 | 至少有一個上傳失敗,其餘都已上傳 |
| 2 | 參數錯誤或找不到檔案,沒有上傳任何東西 |
| 3 | 無法連上 Aktar、權杖不正確,或是該連接埠上的 App 無法證明自己是 Aktar |
Typora 圖片,放在你自己的儲存貯體
把 aktar 設為 Typora 的自訂圖片上傳工具,你貼到文件裡的每張圖片都會上傳到你的儲存貯體,連結也會直接寫進 Markdown。
設定 Typora你的金鑰留在 Aktar 裡
CLI 永遠看不到你的儲存空間憑證。它把檔案交給在 127.0.0.1 上執行的 Aktar App,再由 Aktar 用鑰匙圈或認證管理員中的金鑰完成上傳。
Aktar 的本機 API 在你開啟之前都是關閉的,絕不接受來自其他電腦的連線,而且每個請求都需要你的權杖。CLI 會把權杖存在只有你能讀取的檔案裡,並在傳送權杖前確認該連接埠上的 App 確實是 Aktar。
系統需求
- Aktar for Mac 0.18.0 或 Aktar for Windows 0.11.0 或以上版本,且至少設定了一個目的地(aktar 0.5.0 及更早版本可搭配 Aktar for Mac 0.4.0 或以上版本使用)
- Node.js 18 或以上版本(透過 Homebrew 安裝時會自動裝好)
- 沿用已上傳檔案的連結:Aktar for Mac 0.10.0 或 Aktar for Windows 0.3.0
-
aktar replace:aktar 0.3.0,以及 Aktar for Mac 0.14.0 或 Windows 0.7.0 -
aktar mcp和aktar skill:aktar 0.4.0 - 短連結:aktar 0.5.0 以及 Mac 版 Aktar 0.17.0 或 Windows 版 0.10.0
- 在 GitHub 上開源(MIT)
常見問題
沒有 Aktar App,CLI 能用嗎?
可以在 CI 或伺服器上使用嗎?
支援哪些儲存空間?
Claude、Cursor 或其他 AI 代理程式可以使用嗎?
aktar mcp 是一個 MCP 伺服器:用 claude mcp add aktar -- aktar mcp --root ~/Projects(或文件中的 JSON 設定)加入後,你的代理程式就能上傳檔案、搜尋你的上傳項目,以及產生暫時連結。--root 指定它可以從哪個資料夾上傳,SSH 金鑰和 .env 檔案等機密永遠不會被上傳,--allow-replace 讓它在保留連結的情況下取代檔案,--read-only 則移除所有會寫入的功能。對於不支援 MCP 的代理程式,aktar skill 會輸出一份教它們使用 CLI 的技能。權杖存在哪裡?
~/.config/aktar/cli.json(Windows 上為 %APPDATA%\aktar\cli.json),只有你的使用者帳戶可以讀取。aktar logout 會刪除它;在 Aktar 中重新產生權杖則會中斷所有用戶端的連線。