雲端建圖使用說明
v1.20｜預設由 GPT 分析圖面，雲端只進行模型建置與出圖，不另呼叫付費 AI 辨識。
手機不開電腦的流程
- 用私人啟用連結打開雲端工作室。連結含有工作金鑰，請勿公開。
- 選擇圖片或 PDF 頁面，標記一段已知尺寸的兩個端點，輸入實際公分數。可放大、捲動檢視。
- 複製分析指令，連同同一張原圖交給 GPT。GPT 應輸出 建圖 JSON，不是生成圖片。
- 將 GPT 產生的 JSON 匯入雲端工作室，選彩色／黑白，必要時設定鏡頭位置、高度與廣度，送出建圖。原圖會在送出時一併保存。
- 看到「已受理」後即可離開頁面。保存私人案件連結，稍後在任一裝置重新開啟下載。
已經有編輯器匯出的單層 v1 JSON，可直接匯入，不必重新分析。可重新指定色彩與鏡頭，不會再辨識圖面。
成果內容
- plan-empty：無活動家具平面 PNG／SVG，保留門窗、柱、梁、管道間。
- plan：含現有設備的平面 PNG／SVG，圖面外附圖示與名稱。
- snapshot：由模型幾何產生的 3D PNG，預設兩張鳥瞰，最多六個自訂鏡頭。
- project.json：可回到編輯器修改的模型；report.json：尺寸依據、相機與渲染資訊。
雲端 3D 使用 Three.js 軟體向量投影與 PNG 轉檔，地板採純色，沒有瀏覽器 WebGL 的材質貼圖與陰影；它是提供 GPT 渲染用的模型快照，不是擬真裝潢成品。
MCP 直接建圖
服務網址：https://arbin-space-studio.netlify.app/mcp；傳輸 Streamable HTTP，OAuth 2.1 授權碼 + PKCE。客戶端註冊方式為動態註冊，授權時輸入私人啟用金鑰，不需要帳號密碼。授權有效七天，到期重新授權。
可用工具：create_case、build_from_trace、render_project、get_case_status、get_project、get_download_link、prepare_upload、upload_chunk、complete_upload、retry_job。
先建立案件，再由 GPT 把分析後的正規化幾何與校準資料交給 build_from_trace；取得工作 ID 後查詢狀態，完成再回傳私人下載頁。後續家具設計可由 GPT 修改 JSON，再用 render_project 出圖。
自訂 MCP 的可用平台與寫入權限由 GPT 方案與工作區設定決定。OpenAI 目前說明為網頁版支援，手機 App 不支援自訂 MCP，完整寫入受方案限制；不能連線時請使用上方手機 JSON 匯入流程。單靠專案指令不會替 GPT 增加工具權限。
尺寸與結構檢查
一段已知尺寸即可校準；其餘尺寸按圖比例推估。照片歪斜、透視、紙張彎曲會造成比例誤差，應先用清晰正視圖。預設牆高 280 cm、陽台矮牆 130 cm 等未提供的垂直尺寸都是待確認假設，不代表法規值。
出圖後請對照柱、管道間、梁、門窗位置與開向、陽台矮牆，以及不規則邊界。needs_review 表示有低信心或干涉提醒，仍可下載預覽，但不得當作精準完工圖。
私密性與費用
私人啟用金鑰可建立工作；案件連結只能讀取該案件。不同案件使用隨機憑證分隔。持有案件連結的人可看成果，請勿公開。忘記連結時目前沒有帳號找回功能，請另外備份 JSON。
預設不會把圖片送到額外 AI API。選用的網站自動辨識功能必須由管理者設定 CLOUD_VISION_ENABLED=true 才能呼叫；ChatGPT 訂閱與 API 費用分開。Netlify 運算、Blobs 儲存與流量依你的方案計量，不保證無限免費。
重複送出相同工作代碼會沿用同一工作；失敗可重試，最多三次。已完成的修正版請建立新工作。私人連結或資料遭誤傳時，請管理者立即輪替工作金鑰、刪除案件資料。
返回雲端工作室