為什麼要這條管線
webdev-mcp 是一站式的平台面:建專案、設定、預覽、checkpoint、發布全都包辦。 但當你想把網站放到自己的主機(此處是 Hostinger),或不想綁定平台發布鏈時, 它的部署段就沒有角色了。解法不是放棄 skill——skill 的價值在設計方法論與流程紀律,與平台無關; 只把部署段換成 Hostinger API 即可。
| webdev-mcp 的角色 | 本管線的替代 | 替代程度 |
|---|---|---|
| 設計方法論(plan.md、Design 系統) | webdev skill 直接沿用 | 完整 |
| 專案與版本管理 | 專案目錄+Git(可接 GitHub) | 完整 |
| 建置與靜態發布 | files/upload-urls+TUS+deploy | 完整 |
| 子網域/網站供應 | orders/{id}/onboardings | 完整 |
| Secrets 輸入卡 | 自建安全輸入頁+瀏覽器接管 | 完整 |
| 穩定預覽視窗 | 沙箱暫時轉址+本機驗證 | 可用 |
| checkpoint 版本卡 | Git commit/部署腳本可重跑 | 等價 |
| 託管資料庫/OAuth/Service API | 不在此管線範圍(靜態站不需要) | 不適用 |
管線總覽
六個階段,從設計到上線。③~⑤ 全部是 Hostinger API 呼叫,⑥ 是驗證閘門:
步驟詳解
設計:skill 方法論決定「長什麼樣」
依 webdev skill 的 Plan 流程寫 plan.md,其中 Design 小節定義整站靈魂:
Design Movement(開發者工具技術文件 × 工程藍圖)、Color Philosophy(墨藍底+電光青「可執行」信號色)、
Layout Paradigm(左側管線軌道的非置中佈局)、Typography(Noto Sans TC × JetBrains Mono)。
這一步沒有任何平台依賴——換掉 webdev-mcp 不影響它。
建置:純靜態、零建置步驟
Hostinger 的 deploy static site archive 只吃「pre-built HTML/CSS/JS, no build step」。
對文件型網站,這正是最務實的形態:沒有 toolchain、沒有依賴地獄,部署就是複製檔案。
供應:一條 API 建立新 subdomain 網站
在既有主機訂單上建立空網站(subdomain 等級一個層級即可),隨後輪詢至 completed:
curl -X POST "https://developers.hostinger.com/api/hosting/v1/orders/{order_id}/onboardings" \
-H "Authorization: Bearer $HOSTINGER_TOKEN" \
-H "Content-Type: application/json" \
-d '{"domain":"manus-pipeline.sonoato.net"}'
# 輪詢直到 status: completed(每 10–15 秒)
curl "https://developers.hostinger.com/api/hosting/v1/onboardings?domain=manus-pipeline.sonoato.net" \
-H "Authorization: Bearer $HOSTINGER_TOKEN"
本服務為非同步:setup 還在 running 時,操作該網站的端點會回 404/409,
且 is_enabled 只代表沒有被停權,不代表已就緒——所以要輪詢 onboardings 而不是看 websites 列表。
上傳:TUS 可續傳協定送進 public_html
先換一組一次性上傳憑證,再用 TUS 1.0.0 兩段式上傳(建立+推送位元組):
# 1) 取得上傳 URL 與憑證
curl -X POST "https://developers.hostinger.com/api/hosting/v1/files/upload-urls" \
-H "Authorization: Bearer $HOSTINGER_TOKEN" -H "Content-Type: application/json" \
-d '{"username":"u598147296","domain":"manus-pipeline.sonoato.net"}'
# → { "url": "...", "auth_key": "...", "rest_auth_key": "..." }
# 2) 建立上傳(檔名是 public_html 內的相對路徑)
curl -X POST "$URL/site.zip?override=true" \
-H "X-Auth: $AUTH" -H "X-Auth-Rest: $REST" \
-H "Tus-Resumable: 1.0.0" -H "Upload-Length: $SIZE" -H "Upload-Offset: 0"
# → 201 Created
# 3) 送出檔案內容
curl -X PATCH "$URL/site.zip?override=true" \
-H "X-Auth: $AUTH" -H "X-Auth-Rest: $REST" \
-H "Tus-Resumable: 1.0.0" -H "Content-Type: application/offset+octet-stream" \
-H "Upload-Offset: 0" --data-binary "@site.zip"
# → 204 No Content
部署:解壓歸檔,一次到位
curl -X POST \
"https://developers.hostinger.com/api/hosting/v1/accounts/u598147296/websites/manus-pipeline.sonoato.net/deploy" \
-H "Authorization: Bearer $HOSTINGER_TOKEN" -H "Content-Type: application/json" \
-d '{"archive_path":"site.zip"}'
驗證:HTTP 200 不是唯一證據
檢查公開網址回 200、HTML 內容比對(標題、關鍵段落)、再以瀏覽器截圖確認版面與手機斷點。 驗證通過才算是「部署完成」,而不是 API 回 200 的那一刻。
API key 的安全交付
整條管線唯一的敏感資產是 Hostinger API token。它不經過聊天訊息: Manus 在雲電腦上起一個只收 key 的一次性輸入頁(隨機路徑、不回顯、不寫 log), 使用者接管瀏覽器親手輸入,送出後只落在雲電腦的受保護檔案(權限 600)。 驗證完即關閉輸入頁。之後所有 API 呼叫都從該檔案讀 token,程式碼與訊息裡不出現金鑰本體。
本專案實測
| 部署網址 | https://manus-pipeline.sonoato.net |
|---|---|
| 網站建立 | POST /orders/1009610475/onboardings → running → completed |
| 內容形式 | 純靜態 HTML/CSS/JS(3 個檔案+1 張圖),無建置步驟 |
| 部署方式 | TUS 上傳 site.zip → deploy static site archive |
| 驗證 | HTTP 200+內容比對+桌機/手機視口截圖 |
| 用到的 MCP | 無(設計走 skill、部署走 Hostinger API、驗證走 curl/瀏覽器) |
結論:「webdev skill + Hostinger API」可以完全取代「webdev-mcp」走完設計與部署, 代價是失去平台的一體化 UX(預覽面板、版本卡、發布按鈕),換到的是部署目標的自由與腳本的可重跑性。 本頁即是證據。