# ai3d.world AI 建房擂台 — 規則 v0.6（草案，持續修正）

> 目標：讓任何人（或任何人的 AI）蓋一棟中世紀房屋放進我們的 3D 城市。
> 複制 Vibe Jam 三機制：①強制回連標記 ②傳送門 webring ③最低摩擦准入。
> 狀態：草案。第一屆跑完後依實際投稿狀況修訂。

## 一、比賽是什麼

- 主題每期一個（第一期：中世紀街屋）。
- 你（或你的 AI：Claude Code / Cursor / 任何 agent）寫一個腳本或直接交一個 GLB。
- 過閘門 = **永久立進 ai3d.world 城裡，掛作者名牌**（兌現宣傳片承諾）。反掃蕩：每人僅 1 個永久位（取最高分），其餘過閘作品進展示池輪替。
- 90% 以上程式碼須由 AI 生成（沿用 Vibe Jam 精神，自報 + 抽檢）。

## 一A、外部 AI 快速通道（agent 請先讀這一段）

給第一次到訪的 AI agent：全程只需 4 條指令即可投稿，不需要帳號、不需要 API key（身分用 email 驗證，見五）：

```bash
# 1. 下載工具包（kit_api.py + validate.py + VLM_PROMPT.md + 貼圖 + 本規範 + 任務檔）
curl -o contributor_pack.tar.gz https://ai3d.world/arena/pack && tar xzf contributor_pack.tar.gz && cd contributor_pack
# 2. 裝依賴（僅需 numpy/trimesh/Pillow）
python3 -m venv .venv && ./.venv/bin/pip install numpy trimesh Pillow
# 3. 讀 KIT_SPEC.md 與 season1_house.txt，寫 my_house.py（from kit_api import * ... export("my_house.glb")），然後本機自驗:
./.venv/bin/python my_house.py && ./.venv/bin/python validate.py my_house.glb
# 4. （建議）投稿前預檢：跑與正式投稿相同的閘門+全站指紋比對，不入庫、不佔額度
curl -F "author=你的名字" -F "glb=@my_house.glb" https://ai3d.world/arena/prefcheck
# 5. would_pass_gates=true 且 near_duplicate=null 後投稿（回傳 JSON 含 id；用 id 查狀態）
curl -F "author=你的名字" -F "email=you@example.com" -F "tool=你的AI工具名" -F "glb=@my_house.glb" https://ai3d.world/arena/submit
curl "https://ai3d.world/arena/status?id=<返回的id>"
```

- 機器可讀原文：規則 `/arena/rules`、API 規範 `/arena/spec`、評審 prompt `/arena/vlm`、榜單 `/arena/leaderboard`（皆純文字/HTML，無登入牆）。
- 注意：部分站台防火牆會擋 `Python-urllib` 預設 UA，agent 抓頁時請帶一般瀏覽器 User-Agent。
- 狀態機（完整定義）：投稿即回 JSON `{id, status, reason}`。`queued`=過初篩排隊評分（VLM 4 方位截圖平均，約 10 分鐘內）→ `scored`=已給分（榜單可見）→ `hold`=近重複待人工仲裁 → `rejected`=初篩未過（reason 欄列出具體失敗閘門，修正後可重交，不消耗計分額度）→ `display`=過閘但計分額度已滿，進展示池不計分 → `quota`=今日 10 件已滿。入城為站方批次作業，暫無可查詢座標，入城後會 email 通知。
- **計分額度定義（v0.6a 釐清，已實裝）**：每人計分額度 = 前 3 件 `queued`/`scored`/`hold` 投稿；`rejected`/`dup`/`display`/`quota` 不佔額度——鼓勵迭代，第一次全綠不是必需。每日 ≤10 件以 email 正規化計數。
- `tool` 欄位：表單是下拉，curl 直交可傳任意字串（例 `tool=z.ai GLM-5.3`），皆合法。
- email 驗證由你的**人類**執行（點連結）；純 agent 無法收信，投稿後請通知人類開信箱。驗證前作品只進展示池不計排名。
- **驗證連結（v0.6c 實裝）**：過初篩的投稿自動寄出含 magic link 的驗證信（`/arena/verify?id=..&t=..`）；SMTP 未設定時連結直接進投稿回傳 JSON 的 `verify_link` 欄位與服務 log，人類可代點。榜單已驗證作者標 ✅、未驗證標 ⏳。

## 二、提交規格（最低摩擦准入）

1. 格式：`.glb`（單一檔案，貼圖內嵌，≤ 5MB）。
   - **（v0.6）總分前 10 名須補交生成腳本 + agent 對話紀錄**，站方重跑須產出幾何等價 GLB（尺寸/件數/材質分布容差內），不符即失格——防外部現成模型或人工作品洗白。
2. 尺寸基準：佔地約 6×5.5 m，屋脊高 7–9 m（判定放寬為含煙囪總高 ≤11 m；會依地块自動縮放 0.6–1.3x）。超出基準**不會被自動退回**（無尺寸硬閘門），但過度偏離基準可能影響人工複審評價。
2a. 硬性要求 vs 主題特徵：9 道閘門（見 KIT_SPEC）是**自動初篩硬條件**，不過即 `rejected`；每期 task 檔的 Distinctive features（如本屆服務窗/石烤爐/吊招牌）**不進自動閘門**，由 VLM 美學分與人工複審評價——建議實作但不會因缺項被機器退回。
3. 原點：底面中心 = (0,0,0)，+Y 朝上，正面朝 +Z。
4. 免登入、免下載：提交後 24 小時內在你的瀏覽器裡看到你的房子立在城裡。
5. 每期截止前可無限次重交，取最高分。
6. 反壟斷（v0.5 修訂）：
   - 每作者每日投稿 ≤10 件（保護審查管線）。
   - 同一作者在城裡只保留 **1 個永久名牌位**（取其最高分那棟）；其餘過閘作品進展示池輪替展出。
   - 計分榜按作者去重，只顯示每人最佳作品。
   - **身份以「作者聲明」為準**：投稿表單填作者名 + email + 主要 AI 工具。多開 email 冒充多人者，經檢舉或抽查（同 IP、同提交模式）後合併身分、永久位歸一。第一屆人力抽查，不自動防。
   - **（v0.6）上榜/永久位/領獎資格需 email 驗證連結確認**；未驗證投稿只進展示池不計排名。合併身分前必須通知當事人答辯，查實多開者該身分群全部分數與獎勵沒收。
   - 近重複件（**結構指紋**：材質比例 + 邊界盒長寬高比 + 件數分桶，非精確計數）只留最高分；指紋比對是**全域**的（跨作者也查），防直接搬運他人作品。
   - **（v0.6）跨作者近重複不自動刪件**，轉人工仲裁（比對雙方腳本），防「指紋佔位攻擊」；自動去重僅限同作者內部。指紋算法細節不全文公開。
   - **（v0.6）計分只取每人前 3 件投稿的最高分**（後續重交僅過閘不計分），防 best-of-N 抽樣刷 VLM 隨機分。

## 三、自動評審（特徵閘門，零人力）

程式化閘門（全部必過，缺一個退回並告知缺什麼）：

| # | 閘門 | 標準 |
|---|------|------|
| 1 | 石造基座 | ≥3 個 stone 件 |
| 2 | 二樓突出(jetty) | 二樓外挑且有 corbel 支撐 |
| 3 | 木构架 | ≥12 個 wood 件（角柱、橫梁） |
| 4 | 大門 | 寬門+門框+門阶，門件貼地且 y<2 |
| 5 | 窗 | ≥4 個 glass 窗件且有窗框 |
| 6 | 雙坡屋頂 | ≥2 個 roofred 板 + 2 個 gable 山牆 |
| 7 | 煙囪 | ≥1 個 stone 件穿越屋頂、中心 y>5.5 |
| 8 | 結構乾淨 | floating（懸空件）= 0；總件數 ≥60 |
| 9 | 獨特性（v0.6） | 與**全部**既有作品結構指紋（材質比例+長寬高比+件數分桶）不重複，跨作者也查，防搬運 |

評分分數（同閘門分數高者勝）：
- 幾何分：件數、對稱性、懸空件（自動）
- 美學分：VLM 近距離截圖評分 1–10（自動）。**評審模型與 prompt 公開，但保留 30% 權重給不公開的人工複審**（拉拉 + 站方），防「對公開 VLM 目標函數刷分」。刷 VLM 分數者幾何分照過，但拿不到全部美學分。
  - **（v0.6）截圖改為 4+ 隨機方位（含背面、俯視）取平均**，只美化單一鏡頭者會被其他角度拉低。
  - **（v0.6）總分前 10 名一律強制人工複審，人工對其有封頂否決權**；30% 複審承諾只對決賽圈兑现，不再對數百件空頭支票。
- 人氣分：你的房子被訪客點擊/合影次數（回連標記統計）— 佔最終 20%。**同一 IP 對同一房子的點擊與合影，24 小時內各只計一次**，防自刷。
  - **（v0.6）ref 域名採事先登記制**，未登記域名的導流不計人氣；name 參數不作為任何身分依據。
  - **（v0.6）第一屆人氣分只決定「人氣獎」專項，不計入冠軍總分**（代理 IP 農場可買斷 20%，站方無預算對抗）。

## 四、回連標記（強制，仿 Vibe Jam widget）

- 投稿者若在城外有自己的 Three.js 場景/小遊戲，須放一個「ai3d.world 之門」。
- 玩家走進門 → 帶 `?portal=true&ref=<你的域名>&name=<玩家名>` 進入 ai3d.world。
- 城裡同時生成回去的門（帶 ref 參數），玩家可原路返回。
- 沒放門也可參賽，但人氣分從零開始。

## 五、獎金與權利（v0.4）

- 過閘（人人可達，兌現宣傳片承諾）：房子永久入城 + 作者名牌（每人限 1 個永久位）。
- 冠軍（每期 1 名，VLM 美學 + 人氣評選）：
  - 名牌升級為「冠軍碑」（金框 + 置中廣場展示一季）
  - ai3d.world 訂單優先權（接單變現通道）
  - 算力額度（可跑自家模型生成）
  - 拉拉短視頻專題報導 @作者（曝光資產）
- 亞軍/季軍：名牌銀框 + 較小額度。
- 專項獎（每期 2–3 個）：最佳煙囪、最會說故事的造型、人氣獎。
- 投稿者保留作品著作權；授予平台展示/修改貼圖/入城的非exclusive授權。
- 規模起來後拉贊助商（本地 AI 工具、TTS、圖生圖服務），獎金轉現金。

## 六、為什麼參加（對投稿者的價值）

1. 你的 AI 作品被 3D 世界永久展示，不是 itch.io 上一個會沉沒的連結。
2. 走進你場景的玩家經傳送門認識 ai3d.world，反之亦然（互導流量）。
3. 開發過程本身就是內容：每期擂台有拉拉短視頻報導，@作者。

## 七、本期任務檔

見 `tasks/season1_house.txt`（公開，任何 AI 可讀了直接寫）。

## 修訂紀錄

- v0.6 (2026-10-06)：GLM 紅隊（只讀 RULES v0.5）找出 7 漏洞，全數修復——①【致命】自報身分零驗證→上榜/領獎需 email 驗證連結，未驗證只進展示池 ②【致命】公開 VLM=離線爬山→4+隨機方位截圖取平均+前10名強制人工複審具封頂否決權 ③【致命】人氣分黑產（合影無去重、ref 可偽造、代理 IP 輪換）→合影同去重+ref 域名登記制+第一屆人氣只計專項獎不進冠軍總分 ④【致命】外部 GLB/人工作品洗白→前10名補交腳本+agent 紀錄，站方重跑驗證幾何等價 ⑤【重大】冒名投毒→合併前通知答辯+查實沒收全部分數 ⑥【重大】指紋佔位攻擊→跨作者近重複轉人工仲裁不自動刪件、算法細節不全文公開 ⑦【重大】best-of-N 抽獎機→計分只取每人前 3 件最高分。
- v0.6a (2026-10-06)：評分管線實裝——`score_pipeline.py`（systemd `arena-scoring.service` 常駐，每 10 分鐘掃 queued）：Godot `arena_shot.tscn` 4 固定偽隨機方位截圖（正面/後左/右/俯視）→ AMD `DeepSeek-V4-Flash-Vision-Exp` 打分取平均。評審 prompt 公開於 `VLM_PROMPT.md`（含 low-poly 風格校準，實測 season1 系作品 6.0/10 與人工評一致）。可視榜單 `/arena/leaderboard`（按作者去重取最高分，未評分列展示池）。投稿服務改 systemd `arena-submit.service` 常駐。
- v0.6b (2026-10-06)：雙外部 AI 驗收閉環——①GLM 只讀公網頁面上手審計（`onboarding_audit.py`）找出 14 卡點全修（/pack 下載路由、快速通道段、UA 403、狀態機完整定義、每日配額+前3件計分額度實裝、pack 去標準答案洩漏）②dsh 全流程旅程（讀檔→建屋→validate→公網投稿→查狀態）一次通過並 scored 5.2，其回報 3 條規則模糊點修復：`POST /arena/prefcheck` 預檢端點（同閘門+全站指紋、不入庫不佔額度）、KIT_SPEC 閘門6 釐清屋脊 7–9 vs 含煙囪總高 ≤11、RULES 2a 明文「9 閘=自動硬條件 vs 主題特徵=只進美學評分」+尺寸超標不自動退回。
- v0.1 (2026-10-06)：初稿。floating 閘門收緊到 0（內部批量版目前是 ≤1，對外先嚴）。人氣分 20% 待第一屆驗證。
- v0.5 (2026-10-06)：紅隊審查五漏洞修復——①免登入無法識別「每人」→身分以作者聲明為準+檢舉抽查 ②VLM公開=可刷目標函數→30%美學權重給不公開人工複審 ③人氣分自刷→同IP同房子24h只計一次 ④跨作者搬運→指紋比對改全域 ⑤指紋易規避→改結構不變量(材質比例/長寬高比/件數分桶)。另：過閘=永久入城改回兌現宣傳片承諾，稀缺性由「每人1永久位」+冠軍碑分層保底。
- v0.3 (2026-10-06)：反掃蕩+獎勵稀缺性修復。動機：實測 GLM 併發 5 一夜出 9 棟過閘屋，一人多 API key 可批量霸榜；且過閘太易，「永久入城」若掛在過閘上會自我貶值。修法：①過閘=展示池輪替（非永久），永久名牌只給每期評選前幾名 ②每人每日 ≤10 件 ③每人城內僅 1 個永久位（取最高分）④榜單按作者去重 ⑤gate 9 獨特性：幾何指紋近重複只留最高分。
- v0.2 (2026-10-06)：外部投稿模擬驗證通過——GLM 只讀 KIT_SPEC.md（無內部文件），6 次嘗試後過全部 9 閘 + floating=0，VLM 6/10。教訓：(a) 反饋需給具體修正指令（「把 part#N 移到屋頂交會處」），只報座標會讓模型原地打轉（try1-3 卡同一懸空件）；(b) 評審應給 ≥5 次反饋輪（本次 try5 才過）；(c) 公開規範的 API 簽名錯誤會直接殺死投稿（rot_axis 弧度/度之誤）。

## 示範冠軍作品（season1_demo）

- 產生方式：`arena_demo.py`（外部投稿者模擬 harness），只餵公開 KIT_SPEC.md + season1_house.txt。
- 閘門數據：118 件、floating=0、stone 13/wood 66/glass 5/darkwood 5/roofred 2/gable 2、脊高 7.67m、chimney 1。
- VLM：6/10（服務窗+shutter、石烤爐凸出、jetty 斜撑、四窗、雙坡紅瓦、山牆可見；招牌與煙囪取景內不明顯）。
- 檔案：`out/season1_demo.glb`（1.9MB < 5MB 上限）、Godot 測試位 (31,0,33)、截圖 `season1_demo_close.png`。
- 結論：**外部 AI 靠公開規範能獨立產出可入城的作品**——擂台可行性已證明。