ailab-image-upload

plugin-ailab-image-upload

把產品接上 CMoney 圖片上傳服務（xlab2.cmoney.tw / 共用圖片上傳服務）。從 Secret Manager 拉共用 API 憑證，寫入本機 .env.local，並告知 Swagger UI 連結方便測試。只支援圖片格式（PNG / JPG / GIF / WebP），不支援 PDF / Word / 影片。

安裝

/plugin install ailab-image-upload@cm-ailab-cc-plugins

使用方式

在你的 app 專案目錄裡，跟 Claude 說：

我要做圖片上傳

Skill 會自動：

1. 檢查 gcloud / Secret Manager 權限 / jq
2. 推算 user / app / env
3. 從 Secret Manager 拉共用憑證
4. 寫入 .env.local（含 IMAGE_UPLOAD_API_KEY / IMAGE_UPLOAD_APP_ID / IMAGE_UPLOAD_BASE_URL）
5. 告知 Swagger UI 測試連結

之後部署到 Vercel / Netlify / Cloud Run 等平台時，把這 3 個環境變數設到該平台的 secret / env 介面即可。

前提

• 已用 gcloud auth login 登入 ai_lab Google 帳號
• 帳號在 [email protected] Google Group（具備 Secret Manager secretAccessor 權限）
• 安裝有 gcloud 與 jq

技術細節

• 上傳端點：PUT {BASE_URL}/api/v1/File/anonymous
• HTTP headers：key（從 SM 拉）、appId（int32，預設 -1）
• Body：multipart/form-data 帶一個 file 欄位
• Dev base URL：https://xlab2.cmoney.tw/tool-test
• Prod base URL：https://xlab2.cmoney.tw/tool

安全

• 共用 API key 存在 GCP Secret Manager（image-upload-skill-credentials）
• Skill 不顯示 key 明碼，不寫進 audit log
• .env.local 自動 chmod 600 並加入 .gitignore
• 每次成功執行寫一筆 audit log 到 GCP Cloud Logging（image-upload-skill-audit）