MANUS→HOST

PIPELINE FIELD GUIDE · 2026

用 webdev skill 設計,
用 Hostinger API 部署

不依賴 webdev-mcp,也能在 Manus 上走完「設計+部署」全程: 設計方法論來自 skill,部署由 Hostinger API 與終端完成。 這份指南本身就是那條管線的實戰產物——它就運行在文中描述的新 subdomain 上。

零 webdev-mcp 零建置步驟 可重跑腳本 key 不進聊天室
實測網址manus-pipeline.sonoato.net
上線時間2026-11-20
§00

為什麼要這條管線

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不在此管線範圍(靜態站不需要)不適用
§01

管線總覽

六個階段,從設計到上線。③~⑤ 全部是 Hostinger API 呼叫,⑥ 是驗證閘門:

管線流程圖:設計、建置、供應、上傳、部署、驗證六階段
設計與建置由 webdev skill 方法論把關;供應、上傳、部署三個階段對應 Hostinger API 的三個端點。
§02

步驟詳解

01

設計:skill 方法論決定「長什麼樣」

依 webdev skill 的 Plan 流程寫 plan.md,其中 Design 小節定義整站靈魂: Design Movement(開發者工具技術文件 × 工程藍圖)、Color Philosophy(墨藍底+電光青「可執行」信號色)、 Layout Paradigm(左側管線軌道的非置中佈局)、Typography(Noto Sans TC × JetBrains Mono)。 這一步沒有任何平台依賴——換掉 webdev-mcp 不影響它。

要點 設計系統先於程式碼。風格一致不是靠事後整理,而是每個元件都服從同一份 Design 紀律。
02

建置:純靜態、零建置步驟

Hostinger 的 deploy static site archive 只吃「pre-built HTML/CSS/JS, no build step」。 對文件型網站,這正是最務實的形態:沒有 toolchain、沒有依賴地獄,部署就是複製檔案。

03

供應:一條 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 列表。

04

上傳: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
05

部署:解壓歸檔,一次到位

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"}'
注意 deploy 會覆寫整個網站內容且不可復原——只對全新網站或確認要整批替換的網站使用。 多站共存的帳號尤其要先確認 domain 參數。
06

驗證:HTTP 200 不是唯一證據

檢查公開網址回 200、HTML 內容比對(標題、關鍵段落)、再以瀏覽器截圖確認版面與手機斷點。 驗證通過才算是「部署完成」,而不是 API 回 200 的那一刻。

§03

API key 的安全交付

整條管線唯一的敏感資產是 Hostinger API token。它不經過聊天訊息: Manus 在雲電腦上起一個只收 key 的一次性輸入頁(隨機路徑、不回顯、不寫 log), 使用者接管瀏覽器親手輸入,送出後只落在雲電腦的受保護檔案(權限 600)。 驗證完即關閉輸入頁。之後所有 API 呼叫都從該檔案讀 token,程式碼與訊息裡不出現金鑰本體。

起一次性輸入頁 → 瀏覽器交給使用者輸入 → 寫入 600 權限檔案 → curl 驗證後關閉輸入頁
§04

本專案實測

部署網址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(預覽面板、版本卡、發布按鈕),換到的是部署目標的自由與腳本的可重跑性。 本頁即是證據。