# 星燼遠征 Online — BDD 與驗收紀錄
版本：V78 / 1.0.10 · 2026-11-17

## 產品規劃與驗收

### V78 Firebase Analytics 與 AdMob

- Given iOS Build 78 啟動，When Firebase 初始化，Then 使用 `star-ember-analytics` 與 `com.leon456.starember` 專用設定，且安裝包內含 `GoogleService-Info.plist`。狀態：BUILD PASS；後台事件 `NOT_TESTED`。
- Given 分析 SDK 運作，When 產生工作階段，Then 不設定使用者 ID、不使用 IDFA／IDFV，也不傳送角色名稱、聊天、座標、案件文字、裁決或背包。狀態：STATIC PASS；網路封包 `NOT_TESTED`。
- Given 玩家剛進遊戲、正在戰鬥、死亡、讀取或開啟視窗，When 廣告已預載，Then 不顯示插頁。狀態：AUTOMATED PASS；實機 `NOT_TESTED`。
- Given 玩家已遊玩至少 5 分鐘且完成案件、每三章或擊敗首領後回營，When 距上次廣告至少 8 分鐘且本次未達 3 次，Then 才顯示已預載插頁；關閉或載入失敗可回遊戲且不失去進度。狀態：AUTOMATED PASS；實機 `NOT_TESTED`。
- Given UMP 尚未得到可請求廣告的狀態，When App 啟動，Then 不送出廣告請求；玩家可從帳號與安全重開隱私選擇。狀態：IMPLEMENTED；區域同意 UI `NOT_TESTED`。
- Given Build 78 匯出，When 檢查 Xcode 依賴與產物，Then 使用 `FirebaseAnalyticsCore`、iOS 15+、停用 IDFV collection，且無簽署 Release 編譯成功。狀態：PASS。

### 營利模式規劃（PROPOSED / NOT IMPLEMENTED）

- Given 新玩家尚未完成第一個完整案件，When 啟動 App、進入世界或進行戰鬥，Then 不強制彈出商店或付費提示。狀態：PROPOSED。
- Given 玩家完成第一個案件並保存裁決，When 開啟背包，Then 顯示次級入口「旅人珍藏」，商店首頁只有一個明確主要商品。狀態：PROPOSED。
- Given 玩家購買創始調查員支持包或外觀，When Apple 交易驗證成功，Then 只授予永久外觀與稱號，不改變傷害、屬性、掉落、鍛造成功率或排名。狀態：PROPOSED。
- Given 玩家使用舊版本中已宣傳的 100 條故事線與 1,000 個調查章節，When 營利版本上線，Then 這些現有內容繼續免費；付費案件包只能交付後續新增內容。狀態：PRODUCT GATE。
- Given 同一非消耗型交易被重送，When 伺服器收到相同 transaction ID，Then 只保存一份 entitlement，不重複發放。狀態：PROPOSED。
- Given 玩家更換裝置、重裝 App 或刪除角色，When 點選「恢復購買」並完成 Apple 驗證，Then 已購非消耗品恢復，不要求重新付費。狀態：PROPOSED。
- Given 玩家取消購買、交易等待、網路中斷或伺服器驗證失敗，When 購買流程結束，Then 顯示可理解狀態，不扣除遊戲資源、不重複開權，並可安全返回商店。狀態：PROPOSED。
- Given 審查員查看營利版本，When 依 Review Notes 開啟商店與各商品，Then 所有已配置 IAP 可見、可購買，描述、截圖、價格類型與實際交付一致。狀態：RELEASE GATE / NOT TESTED。

完整規劃見 [MONETIZATION_PLAN](MONETIZATION_PLAN.md)。目前沒有 StoreKit、IAP 商品、交易驗證或實體裝置 Sandbox 證據，不得把以上案例標示為 IMPLEMENTED 或 PASS。

## 已自動驗證：npm test

### V76 攻擊自動面向

- Given 玩家選定任一怪物，When 伺服器確認普攻或職業技能，Then `fx` 事件保留該怪物 `target` ID，攻擊者在起手前先朝向該目標。
- Given 目標在攻擊期間橫向移動，When 攻擊 clip 尚未結束，Then Web 與 Godot 持續以目標方向優先，不被舊的移動方向覆寫。
- Given 怪物選中玩家，When 怪物進入攻擊冷卻週期，Then 怪物狀態攜帶玩家 ID，怪物起手前朝向該玩家並在攻擊期間維持對準。
- Given 攻擊結束或怪物失去目標，When 下一個更新週期開始，Then 角色恢復依移動方向轉身，不殘留攻擊鎖定。
- `npm test -- --test-concurrency=1`：85/85 通過；Godot 4.7.2 headless 攻擊朝向優先與攻擊後復位測試 PASS。

### V76 iOS 發佈驗收

- Given Build 76 封存檔，When 讀取版本、簽章並匯出 IPA，Then `CFBundleShortVersionString` 為 `1.0`、`CFBundleVersion` 為 `76`，`codesign --verify --deep --strict` 通過。狀態：PASS。
- Given Build 76 IPA，When 由 Apple 官方上傳工具送出並由 App Store Connect API 回讀，Then 上傳有 Delivery UUID，Build 76 的 `processingState` 為 `VALID` 且未過期。狀態：PASS。
- Given 新商店圖組，When 檢查尺寸、畫面來源與 Apple 素材狀態，Then 本地包有 5 張 iPhone 2622×1206 與 5 張 iPad 2752×2064；提交組採用 3 張 iPhone 與 9 張 iPad，共 12 張，內容來自實際 Build 76，且 `assetDeliveryState.state` 全為 `COMPLETE`。狀態：PASS。
- Given Build 70 原為 `WAITING_FOR_REVIEW`，When 撤回舊提交、改選 Build 76、保存文案與截圖並重新提交，Then Build 76 為 `VALID`，版本與新提交 `07f1854a-249d-4830-a48d-e413f5d554d3` 均回讀 `WAITING_FOR_REVIEW`。狀態：PASS；不代表核准或公開上架。

### V75 怪物普通攻擊後保持可見

- Given 任一存活怪物，When 普通攻擊動畫完成，Then 模型保持可見且材質 alpha 恢復為 1，並回到待機或追擊。
- Given 網路快照跳過完整死亡→重生轉換，When 收到 `dead = 0` 的存活快照，Then Web 與 Godot 仍主動清除殘留的隱藏、透明與死亡姿勢。
- Given 怪物處於死亡演出，When 死亡動畫、停留與淡出尚未完成，Then 存活保險不得中斷死亡流程；只有重新收到存活狀態才重設。
- `npm test`：83/83 通過；Godot 4.7.2 重新匯入與共用 GLB／死亡生命週期測試 PASS。

### V74 普通攻擊

- Given 五個職業，When 連續使用普攻，Then 鐵衛、遊俠、獵手、術士、祭司的蓄力、腳步、上半身與武器軌跡可分辨，且左右普攻不是同軌跡重播。
- Given 獵手普攻，When 時間軸到達放箭幀，Then 弓弦與拉弓手釋放，箭、傷害、音效與粒子在同一時點發生。
- Given 任一普攻，When 動畫尚未抵達本職業接觸幀，Then 不提前顯示命中爆發；When 抵達接觸幀，Then Web 與 Godot 使用相同比例觸發。
- Given 普攻與職業技能，When 比較視覺層級，Then 普攻是短促命中回饋，職業技能仍有較大粒子與既有動畫，不被 V74 覆寫。
- `npm test`：82/82 通過；Blender 驗證五份 GLB PASS；Godot 4.7.2 重新匯入與戰鬥生命週期測試 PASS。

### V73 五職業髮型

- Given 五份職業 GLB，When 檢查材質、骨騼與動畫，Then 均含 `hair_v73`、Head 權重與九種戰鬥 clip。
- Given Web 與 Godot 輸出，When 比較檔案，Then 五份 GLB SHA-256 相同。
- Given 原畫對照，When 切換五職業近看，Then 能分辨短層次髮、高馬尾、栗棕波浪髮、銀白側分髮與金色長捲髮，不再共用粗圓管髮束。

### V72 差異化死亡演出

- Given 六類怪物 GLB，When 檢查動畫清單，Then 均含 `hit`、`death`、`boss_death`、`respawn`，Web／Godot 檔案 SHA-256 相同，且首領死亡時間長於普通死亡。
- Given `dead` 從 0 變成死亡時間戳，When 同一死亡快照持續抵達，Then 客戶端只啟動一次死亡狀態，停止移動／攻擊但繼續顯示模型與動畫。
- Given 死亡動畫播放完畢，When 經過種類演出及 1.2–1.5 秒停留，Then 模型以透明度淡出；Given `dead` 恢復為 0，Then 姿勢、透明度、視覺位移、粒子與重生動畫全部重設。
- Given 最後一擊，When 死亡開始，Then 同步音效、粒子、視覺擊退及 0.05 秒视觉 hit-stop；網路、輸入及伺服器時間不被暫停。
- Given 世界首領死亡，When 播放演出，Then 使用獨立 `boss_death`、大型衝擊波、0.08 秒視覺 hit-stop 與較強鏡頭回饋。
- Godot 4.7.2 headless 已實際重新匯入六份 GLB，死亡→淡出→重生生命週期測試通過。
- Given 任一怪物剛載入或重生完成，When 沒有死亡狀態，Then GLB 預設根節點必須為零位移、零旋轉、單位縮放，怪物保持正常站姿；螃蟹鉗子與巨像晶簇不得在普通 clip 脫離身體。（V72.1 自動測試與 Chrome 視覺驗證通過）

### V71 共用戰鬥動畫

- Given 五個職業 GLB，When 檢查動畫清單，Then 每個都包含待機、走、跑、左右普攻、職業技能、受擊、死亡與重生。
- Given 六種怪物 GLB，When Web 與 Godot 載入，Then 每個都包含待機、走、攻擊、受擊、死亡與重生，且兩端檔案 SHA-256 相同。
- Given 普通攻擊或職業技能，When 動畫抵達 Blender 接觸幀，Then Web 與 Godot 才顯示命中爆發；普通攻擊為 11/24，技能為 18/38。
- Given 怪物生命歸零，When 客戶端收到死亡狀態，Then 先播放完整死亡動畫並保留至 2.8 秒後隱藏；重生時播放 respawn。Node 與 Godot headless 已驗證，Chrome WebGL 已抽查角色與怪物載入。
1. Given 玩家送入超大方向值／非有限值，When 世界更新，Then 位移仍受 9 單位每秒約束，非法值不污染位置，停止輸入 0.4 秒後停止移動。
2. Given 遠距目標或攻擊冷卻尚未結束，When 玩家攻擊，Then 伺服器不扣除目標生命。
3. Given 已接受任務的玩家與附近第二位玩家，When 擊敗三隻怪物，Then 任務計數、雙方星材及經驗更新，升級正確發生。
4. Given 討伐完成並返回營地，When 交付任務並重複交付，Then 獎勵只發一次；鍛造會扣除正確材料並提高武器強化。
5. Given 玩家生命歸零，When 怪物攻擊，Then 回營並恢復生命；死亡怪物在倒數後重生；沒有藥水時不能負庫存。
6. Given 兩個獨立 WebSocket 連線，When 一方移動、聊天、接受任務並攻擊，Then 另一方收到共同狀態、聊天與同一怪物血量變化。
7. Given 已接受任務的角色離線，When 以原憑證重連，Then 恢復同一角色進度。

以上連同 V28 地圖驗收整合在 9 個 node:test 測試中，已全部通過。獨立測試使用暫存資料夾與 4189 埠，不修改使用者角色。

## 瀏覽器驗收
- 已在 Codex 內建瀏覽器開啟 WebGL 畫面，確認 3D 地形、角色、介面與上線狀態顯示。
- 已操作進入世界與返回營地。
- 其他實際操作與檢查結果參見 VALIDATION.md。

## 待驗證
實體手機、觸控長時間遊玩、所有地區導航、64 人負載、跨網路延遲、伺服器程序重啟後恢復、WebGL context lost 恢復、正式公網服務。

## V26 发布验收追加
- Given 原生产部署文件树，When 取回全部 104 个文件，Then 所有文件 SHA-1 相符。（已验证）
- Given 同一版本的完整包与素材包，When 运行打包脚本，Then 生成 SHA-256 清单且不含登录凭证或个人存档。（已验证）
- Given 云端持久化已配置，When 两名玩家经生产域名进入，Then 玩家与怪物共享状态且重连后保留进度。（待配置后验证）
- Given 新部署检查通过，When 切换原域名，Then 首页、PRD、BDD 与两个 ZIP 均返回新版本。（待发布后验证）

## V27 原画呈现验收
- Given 标题画面，When 选择符火术士，Then 大型立绘、职业名与描述同步切换。（已浏览器验证）
- Given 已有角色，When 进入世界，Then 恢复既有职业和进度，显示紧凑 HUD 与真正 3D 地表。（已浏览器验证）
- Given 世界聊天默认收起，When 点击世界频道，Then 展开输入框与聊天记录。（已浏览器验证）
- Given 地表贴图与原画载入，When 旋转和移动镜头，Then 原画随 3D 地面透视而非固定屏幕背景。（代码实现；浏览器已确认场景渲染）
- 新素材与 V27 文件进入同一版本下载包；不以原画标题宣称战斗模型升级。

## V28 地圖驗收（已自動驗證）
- Given V27 的每區面積，When 建立新版世界，Then 每區面積恰為 100 倍，41 個敵人出生點皆在世界內且不在河中。
- Given 無版本號的舊角色，When 載入兩次，Then 第一次座標乘 10，第二次不再放大；等級、金幣、強化與任務保留。
- Given 擴大的河流，When 嘗試直接穿河，Then 被阻擋；四座橋中央皆允許移動。
- Given 玩家位於遠區，When 移動或回營，Then 不再被舊邊界限制，新邊界有效且回到新營地。

## V29 已验证
- Given V28 区域面积，When 读取新版尺寸，Then 面积再乘 1000，人物尺度保持。
- Given 31 处旧网格交界，When 从两侧采样，Then 群落权重连续、和为 1，高度连续。
- Given 玩家移动 640 单位，When 更新加载窗口，Then 最多 49 块，新旧窗口可完全更替。
- Given V28 旧存档，When 迁移两次，Then 只放大一次且进度保留。
- 共 12 个自动测试通过。浏览器遍历加载 31 个交界，控制台无错误；抽查第 1、16 个交界画面，无旧矩形贴图切线。没有逐区完整游玩或实机性能证明。

## V30 云端验收
- Given 两个并发实例，When 同时提交角色，Then 比较交换冲突重试且双方状态保留（自动测试通过）。
- Given 同一凭证已在线，When 第二次加入，Then 拒绝重复登录；租约超时后可恢复（自动测试通过）。
- Given 真实 Redis 与两个 WebSocket，When 聊天、接任务、断线重连，Then 对端收到消息且任务进度保留（真实 Redis 测试通过）。
共 14 项自动测试通过。scripts/cloud-smoke.mjs 可对真实云端端点复验；不输出角色凭证。

### 正式域名复验
上述真实 Redis 双 WebSocket 测试已再次针对正式 WSS 网址通过；浏览器进入世界、接受任务通过。


## V30 / 0.6.0

See [V30 model release](V30_MODEL_RELEASE.md) for requirements, BDD, assets and validation.


## V31 / 0.6.1

[Motion requirements, BDD and assets](V31_MOTION_RELEASE.md).


## V32 / 0.6.2

[Class attack requirements, BDD and assets](V32_ATTACK_RELEASE.md).


## V33 / 0.6.3

[Face requirements, BDD and assets](V33_FACE_RELEASE.md).


## V34 / 0.6.4

[Original reference requirements, BDD and assets](V34_REFERENCE_RELEASE.md).

## V35 真实网格候选

详见 [独立样板、来源、验收与未完成项](V35_REAL_MESH_PILOT.md)。本次未替换正式角色；原图还原与动作质量尚未验收。

## V36 Blender 修复候选
[可编辑工程、修复统计及未通过项](V36_BLENDER_REPAIR.md)。仅完成结构修复，原画造型与自然动作仍未达标；正式游戏未替换。

## V37 铁誓守卫重制造型样板
[新增 Blender 部件、复用来源及未完成项](V37_IRON_VOW_REBUILD.md)。当前只完成单个静态开发稿，原画一致性、绑定与动作尚未通过，其他角色与怪物未重建。

## V38 / 0.6.8 铁誓守卫正式接入
2026-10-26：游戏内本机与远端铁誓守卫使用 iron-vow-game.glb；新装备在 Blender 绑定至同一骨架，重新导出 walk/run，运行时以行进速度播放 walk，战斗采用骨骼叠加挥剑。其他职业与怪物保持原资产。
本次完成游戏接入，不代表原画还原或动作美术最终验收通过：手指尚未握剑、披风没有布料模拟、攻击是程序骨骼动作。资产约 38 万三角形，尚未完成手机性能优化。静态 V37 样板作为历史对照保留。

Given 选择铁誓守卫，When 进入共同世界并移动，Then 显示绑定后的重制模型，装备随骨架移动。
Given 多个铁誓守卫实例，When 其中一个动作或离线，Then 每实例独立骨架且共享资源不被销毁。
Given 切换到其他职业，Then 清除旧自定义动画处理器，恢复对应职业模型。

## V39 / 0.6.9 铁誓守卫攻击修正
2026-10-26：新增 Blender SwordGrip 骨骼并将剑柄移至手掌附近。运行时由剑的路径驱动双臂 IK，支持手跟随下方剑柄；普通攻击为斜劈，破阵斩为上段下劈，加入躯干转动、前倾与平滑收招。普通攻击长度 0.58 秒，避免超过服务器 0.6 秒普攻间隔而丢失下一次动作。
审阅页 /review/iron-vow-combat.html 与游戏共用控制器，提供正常速度、慢速、暂停、进度及正侧面检查。手指仍使用无指骨的原网格，尚未做真实握拳变形；本版不宣称动作达到动作捕捉质量。

Given 铁誓守卫持剑，When 普攻或破阵斩，Then 双手配合剑柄运动且两种剑路不同。
Given 动作结束，Then 回到同一持剑待机姿势，不累积骨骼旋转。
Given 服务器连续合法普攻，Then 动作时长不超过普攻间隔。

## V40 / 0.6.10 铁誓守卫手指绑定
2026-10-26：重建左右手套网格，移除 7,330 个原有未分指绑定的顶点，新增 30 根可变形指骨（双手五指、每指三关节），总骨架 55 根骨骼。每根指骨均有实际顶点权重，指关节交界使用混合权重。拇指以相反方向对握，双手握柄的闭合姿态随战斗骨架保持；延长握柄 7 厘米，为支撑手保留空间。
游戏默认闭合握持；审阅页支持「手部特写」「张开手指／握住剑柄」，直接操作同一游戏骨架，不是静态替换图片。原有无指骨限制已在铁誓守卫解决；其余职业未在本次重建。手套使用新增皮革与金属护片造型，原画美术相似度不等同于本次骨骼功能验收。

Given 铁誓守卫双手指骨，When 张开再握紧，Then 十根手指分别变形并回到相同握柄姿态。
Given 普攻及技能关键帧，When 双手保持闭合，Then 指骨长度不变且手指表面不明显穿入握柄。
Given GLB 重新加载，Then 三十根指骨均有实际顶点权重。

## V41 / 0.6.11 其餘職業與怪物 Blender 批次

四個職業改用完整蒙皮人體，Blender 製作各職業頭髮、披風、衣襬及雙刃／弓／法杖／盾錘；保留 30 根獨立指骨並新增左手裝備骨。各職業使用獨立攻擊路徑，移動採用骨骼動畫。已接入本機玩家、遠端角色與 NPC。
六種怪物在 Blender 處理幾何、表面與辨識特徵，沿用原本關節動畫層級；霜角獸改口鼻、移除獠牙並加入分叉角。
可編輯來源在 art-production/roster-rebuild/，原畫對照頁 /review/roster-blender.html。
此批次使用共享的授權人體基底，並非四套獨立精雕人體；臉型、服裝輪廓與原畫仍有差距。怪物仍是簡化造型，沒有新增完整蒙皮骨架。弓弦未與拉弓手做動態連動；布料非物理模擬。不得將本次驗證稱為原畫美術驗收通過。

Given 玩家選擇其餘四職業，When 進入遊戲與移動／攻擊，Then 使用該職業 Blender 蒙皮模型及對應武器，手指保留獨立骨骼。
Given 六種怪物，When 地圖生成敵人，Then 使用 Blender 匯出的幾何且關節層級沒有失效。

## V42 / 0.6.12 鐵衛持劍與攻擊修正

2026-10-26：待機改為身體前方的雙手中段架式，劍尖朝前上方並偏向側面；降低手肘外張程度。前臂分擔握柄旋轉，避免只扭動手腕。普通攻擊為斜斬，破陣斬為上段下劈，加入蓄力、連續斬擊、跟隨與收招；斬擊中段使用連續速度插值，不再在每個關鍵點停住。左右手仍使用原有 30 根獨立指骨。

本次修改遊戲共用的骨骼動畫求解與路徑，沒有重新雕刻或修改 Blender 網格。普攻 0.58 秒、技能 1.05 秒；保持原有冷卻與命中規則。檢查頁修正技能完成後拖曳進度條會切回普攻的問題，普攻及技能按鈕可重新播放。

驗證：30 項 Node 測試；握柄追蹤 202 個姿勢取樣誤差小於 5 毫米，維持骨長與指骨權重，手指穿柄容差檢查通過；新增斬擊中段速度連續性檢查。瀏覽器側面檢查待機、蓄力、斬擊末段與技能蓄力。美術自然度仍需實際觀感驗收；未新增動作捕捉或物理布料。

## V43 / 0.6.13 遊俠雙刃與鐵衛左手

2026-10-26：遊俠改為雙刃朝前上方的備戰姿勢，普攻左右手交替，技能左右手分兩段出刀；刀刃方向跟隨斬擊路徑，前臂分擔手腕旋轉。Blender 套用遊俠骨架的非等比例縮放，同時保留動畫所需的單位縮放，重新匯出 GLB。

鐵衛雙手握位距離由 11 公分改為 15 公分，左手沿劍柄稍微側轉，避免護腕與右手擠在一起；Blender 劍柄再延長 5 公分並重新匯出。此修正改善正面辨識，不保證所有鏡頭角度都沒有遮擋。

檢查頁：/review/iron-vow-combat.html（手部特寫）、/review/roster-blender.html?model=dusklance。遊戲共用同一套模型及動畫模組；美術仍使用現有人體與裝甲，未新增精雕或動作捕捉。

驗證：遊俠 303 個姿勢取樣檢查手腕目標、刀刃方向與骨長；鐵衛 202 個姿勢檢查握柄追蹤及指骨。四職業 Blender GLB 檢查動畫、權重與變形範圍通過。瀏覽器檢查鐵衛手部特寫、遊俠行走與技能分段。完整 Node 測試結果記錄於 VALIDATION。

## V44 / 0.6.14 四職業披風表面與輪廓修正

以鐵衛作為平順度參考，在 Blender 替換暮刃遊俠、星弦獵手、符火術士、曜印祭司的後背披風。使用 64 × 64 曲面網格、平滑法線、3 毫米薄邊、弧形肩部、連續寬褶與圓順下襬；下段向後留出行走空間。保留各職業顏色、不同長度及原有裝備、骨架、指骨與攻擊動畫。鐵衛作為參考保持不變。

這是實際 Blender 網格修正，遊戲直接載入重新匯出的四個 GLB；非畫面特效。仍和鐵衛一樣跟隨脊柱骨架，沒有新增布料物理或碰撞模擬，極端姿勢仍可能穿插。

來源：scripts/refine-roster-capes.py、art-production/roster-rebuild/*.blend 及 cape-report.json。重新批次建立角色後，先執行 normalize-ranger-rig.py，再執行 refine-roster-capes.py。檢查頁增加「背面披風」「側面披風」快捷視角。

## V45 / 0.6.15 附近雷達與世界定位

小地圖改為以自己為中心、北向固定的附近雷達，可切換 120 / 400 / 1200 公尺範圍；顯示存活怪物、首領、其他玩家與營地，包含附近數量、最近怪物方向和距離、比例尺、河流、道路及近期行走軌跡。本人位置為淡黃三角、其他玩家為藍點、怪物為紅點、首領為金色菱形、營地為綠色方塊。

點小地圖展開世界地圖，查看各區域、自己的區域和 X/Z 座標，以及其他在線玩家的名稱、區域、方向與距離。資料由現有伺服器快照即時更新；死亡怪物不顯示、離線玩家移除，斷線清除雷達避免誤用舊位置。開地圖時停止移動；行走軌跡只保留本次連線的最近 250 個取樣，傳送不畫跨地圖長線。尚無尋路、地圖傳送、組隊定位或探索迷霧。

驗證：34/34 Node 測試通過，包含負座標投影、方向距離、死亡怪物與自身過濾。瀏覽器實際登入本機世界檢查附近怪物；第二個 WebSocket 玩家加入後，雷達顯示玩家 1，世界列表顯示名稱、區域、東方 3 m。截圖 output/v45-radar.png、output/v45-world-map.png。

## V46 / 0.6.16 戰鬥動作與視覺回饋

五職業：鐵衛與遊俠重新分配蓄力、出刀及收招時間，增加小幅身體重心位移；遊俠保留左右交替。獵手拉弓與放箭，使用跟隨左手的動態弓弦；術士持杖聚能、推掌，左手張開；祭司普攻揮錘，技能舉錘祝禱。近戰加入沿實際握柄與刀尖取樣的刀光，技能加入符紋、粒子與箭矢表現。

六怪：燼牙獸撲咬、霜角獸低頭頂撞、星潮蟹雙鉗夾擊、鹽晶巨像重擊、鐘影亡靈抬手施法、葦燈怪浮升聚能。動作時長按體型區分（0.65–1.05 秒），身體位移僅作用於視覺子節點，不改伺服器位置。星潮蟹在套用 Blender 幾何後建立雙鉗關節，保留原素材對應關係。

Blender 正規化獵手、術士、祭司骨架縮放並重新匯出，移除獵手原本固定弓弦；保留 V44 披風、指骨和服裝。重建順序：角色批次 → normalize-ranger-rig.py → refine-roster-capes.py → prepare-combat-rigs.py。

命中視覺改為分色火花／治療光柱，傷害數字和音效延後至出手段。伺服器仍在原有時點判定傷害、死亡與冷卻，這不是完整的伺服器攻擊前搖系統；因此死亡隱藏和 HP 變動可能早於視覺命中。沒有新增動作捕捉、完整布料物理、怪物全身蒙皮或商用動畫素材。

驗證：37/37 Node 測試通過，涵蓋六怪不同軌跡、有限矩陣、收招歸位、固定伺服器根位置、雙鉗層級、既有握柄追蹤及地圖功能。四職業 Blender GLB 動畫／權重／變形範圍檢查通過。瀏覽器逐一檢查五職業及六怪的關鍵出手姿勢，記錄於 output/v46-*.png；檢查頁支援慢速播放及怪物進度拖曳。測試通過不代表美術自然度已獲使用者驗收。

## V47 / 0.6.17 普攻與職業技能分級

普通攻擊保留短刀光或單發箭，不出現大型地面法陣、技能光柱或墜星。職業技能具有獨立大型幾何特效與蓄力、爆發、淡出階段：鐵衛破陣斬為三重尖端劍氣；遊俠影步雙襲為先後交叉雙刃光；獵手穿星箭為大型光箭與穿透光環；術士星墜術為目標位置墜星、爆裂環與碎片；祭司聖光祈願為六道光柱、上方光環與聖光印記。

獵手技能抬弓、術士技能抬杖幅度高於普通攻擊；保留鐵衛斜斬／下劈、遊俠單手／雙襲、祭司揮錘／祝禱的區別。新增 public/skill-vfx.mjs，遊戲內與檢查頁共用；重用固定特效物件，收招時隱藏，不逐幀新增場景物件。

這次修改程式化動作與幾何特效，沒有修改 Blender 人體網格。大型特效不代表新增範圍傷害、多段傷害或治療其他玩家，伺服器原有傷害、治療與冷卻規則保持不變。遠程視覺屬技能表現，尚非物理投射物。

驗證：38/38 Node 測試通過，包括五技能形態不同、普通攻擊不顯示技能層、收招清除、重複播放不增加物件、有限矩陣及既有戰鬥／地圖回歸。瀏覽器對比鐵衛同進度普攻與技能，逐一檢查五職業技能特效；截圖 output/v47-*.png。素材包同步收錄模組、文件及檢查畫面。


## V48 原畫故事任務 / 0.6.18

100 條故事線、每條 10 個可玩章節，共 1,000 個故事任務。原畫任務簿、調查與討伐、兩種個人抉擇、伺服器進度與一次性獎勵、營地轉運。詳見 [V48 完整規格與驗證](V48_STORIES.md) 與 [故事索引](STORY_INDEX.md)。

### V48 驗收情境
- Given 營地新角色，When 接取第一章並聆聽證詞，Then 領取一次獎勵並自動續接第二章。
- Given 物證調查章，When 距目標超過 8 m，Then 拒絕完成；抵達後允許調查。
- Given 討伐章，When 討伐其他區域魔物，Then 不增加進度；指定區域種類才計數。
- Given 抉擇章，When 選擇兩條不同道路，Then 個人選擇被保存，後續文本與座標不同。
- Given 已完成章節，When 重送交付或跳接後續章，Then 不重發獎勵、不跳過前置。
- Given 暫停或重連，Then 已完成章節與選擇保持；暫停清除當章討伐計數。
- Given 完整目錄，Then 恰有 1000 個唯一任務 ID、100 條故事、每條 10 章且原畫可讀取。

以上為需求，實際驗證證據見 V48_STORIES.md。


## V49 / 0.6.19：精簡地區 HUD

移除主畫面地區名稱下的座標與「連續世界」文字。世界地圖仍顯示玩家座標；地區名稱保留。無新增美術素材，完整包同步收錄修改後介面。驗收：進入遊戲時不出現該行；開啟世界地圖仍可查閱 X/Z 位置。


## V50 / 0.6.20：獨一玩家名字

新增 10,000 個不同四字名字；伺服器分配、重名改配、舊版同名遷移、離線保留與重連不改名。詳見 [V50 規格與驗收](V50_NAMES.md)。


## V51：近距離圓形雷達

改為 40／120／400 m 圓形雷達，統一標記與計數範圍、顯示角色朝向並精簡介面。規格與驗收見 [V51_RADAR](V51_RADAR.md)。


## V52：操作與存檔修復

修復背包／回營遮擋、存檔損壞覆寫、重連冷卻及雲端時間倒退；規格與驗證見 [V52_FIXES](V52_FIXES.md)。


## V53 原創音樂與音效

兩首探索／戰鬥循環配樂、16 個自行合成音效、獨立開關、音訊解鎖與載入修正。來源、規格與 BDD 見 [V53_AUDIO](V53_AUDIO.md)。完整 55 項測試通過，瀏覽器試聽確認兩軌可解碼且播放時間前進。


## V54 圖示操作列

背包、回營、聊天、音樂、音效、下載及全螢幕改為圖示徽章；可讀提示、開關狀態與 44px 點擊範圍。規格、驗收場景、素材與驗證見 [V54_ICONS](V54_ICONS.md)。


## V54 回訪入口與素材進度

已選角玩家只需進入；新玩家保留選角。依實際完成項目顯示素材載入進度，完成前停用進入。規格、BDD、素材及實測見 [V54_ENTRY](V54_ENTRY.md)。

## Godot 雙平台移植

驗收規格見 [GODOT_MOBILE_BDD.md](GODOT_MOBILE_BDD.md)，實測記錄見 [GODOT_MOBILE_VALIDATION.md](GODOT_MOBILE_VALIDATION.md)。


## V55 獨立立繪

五職業移除鄰角殘片並同步共用素材；規格、BDD 與來源見 [V55_PORTRAITS](V55_PORTRAITS.md)。


## V56 橫向遊玩限制

直向阻擋操作、旋轉清除輸入、橫向自動恢復；規格、BDD 與驗證見 [V56_LANDSCAPE](V56_LANDSCAPE.md)。


## V57 五職業髮型

Blender 重做各職業髮型並沿用原骨架；規格、BDD、素材及限制見 [V57_HAIR](V57_HAIR.md)。


## V58 任務介面精簡

移除章節總數宣傳及未接取任務的重複提示，保留入口與有效進度。規格、BDD 與驗證見 [V58_QUEST_UI](V58_QUEST_UI.md)。


## V59 野外怪物分布

加入玩家周邊共享刷怪、地區怪種、重生冷卻與模型回收。規格、BDD、素材與驗證見 [V59_ENCOUNTERS](V59_ENCOUNTERS.md)。


## 角色原畫重製 — 未驗收

五角色 Blender 候選已渲染，但全數未通過視覺審查，正式 V59 模型保持不變。差距、實際操作及驗收條件見 [CHARACTER_REBUILD_REVIEW](CHARACTER_REBUILD_REVIEW.md)。


## V60 披風與腰布

Blender 整理布料輪廓與漸進權重，加入獨立分段彎曲動畫。不是完整物理模擬。規格、BDD、素材及驗證見 [V60_CLOTH](V60_CLOTH.md)。


## V61 獵手箭袋

Blender 替換五根裸桿，加入中空皮革箭袋、木箭、箭羽與貼背帶，保留原有骨架與布料。規格、BDD、素材與驗證見 [V61_QUIVER](V61_QUIVER.md)。


## V62 獵手射箭

抬弓、拉弦、放箭與收勢分段修正，弓弦回正與飛箭方向同步。實際範圍、BDD、素材及驗證見 [V62_ARCHERY](V62_ARCHERY.md)。


## V63 攻擊粒子系統

角色、怪物與命中爆發使用可重用粒子，普攻和職業技能分級。規格、BDD、素材及驗證見 [V63_PARTICLES](V63_PARTICLES.md)。


## V64 功能按鈕圖片化

功能操作採圖示徽章，保留狀態數字與無障礙名稱。規格、BDD、素材及驗證見 [V64_IMAGE_BUTTONS](V64_IMAGE_BUTTONS.md)。

## V65 原生 App 功能同步

詳見 [V65_NATIVE_SYNC.md](V65_NATIVE_SYNC.md)。素材包收錄 Godot 原生源碼、手機模型、介面、音效與資料；不含 SDK、快取、憑證或玩家存檔。

## V66 App 首頁

原生首頁原畫構圖、選角展示、回訪入口及圖片主按鈕，規格與驗證見 [V66_APP_HOME.md](V66_APP_HOME.md)。

## V67 App 遊戲介面與導航

戰鬥圖示按鈕、冷卻環、雷達地形與標記、世界地圖，詳見 [V67_APP_HUD.md](V67_APP_HUD.md)。


## V68 / 0.6.38：iOS 上架準備
公開支援與隱私權頁採用經授權的 twyhleon@gmail.com。商店項目已建立；Release 封存成功，IPA 匯出受 Xcode 帳號／描述檔阻擋。未上傳、未送審。原生遊戲仍為 0.6.37 (67)。詳細狀態、驗收及缺口見 [IOS_RELEASE.md](IOS_RELEASE.md)。本次素材包加入公開頁面、樣式與上架狀態文件，不加入簽章及帳號資料。


## V69 iOS 發佈與社群安全
Given 已登入且輸入 DELETE，When 刪除成功，Then 雲端角色與本機憑證移除且斷線不復原。Given 冒用其他會話，Then 不得刪除。Given 不適當訊息，Then 伺服器拒絕廣播。Given 檢舉，Then 保存伺服器原訊息而非客戶端提供文字。Given 封鎖，Then 重連後仍不接收該作者訊息。

## V70 Redis 額度故障恢復
- Given Redis 回覆方案額度已滿，When 玩家開啟健康端點，Then 回傳 HTTP 200、`status=degraded`、`storage=memory` 與 `persistence=false`。
- Given Redis 無法讀寫，When 玩家建立 WebSocket 並加入，Then 仍收到 `welcome`、世界狀態及臨時世界不保存進度提示。
- Given Redis 正常，When 玩家持續移動，Then 即時世界在記憶體更新，Redis 最多每 30 秒保存一次快照，而非每 250ms 整包讀寫。
- Given Redis 快照版本已被另一實例更新，When 本實例保存，Then 拒絕覆蓋較新版本並要求重新同步。
- Given 臨時世界已無玩家且 Redis 恢復，When 服務重試，Then 載入原永久快照並恢復持久化模式。

## iOS Build 70：霧境證詞錄

- Given 玩家首次開啟 App，When 看見原生首頁，Then 首屏清楚呈現蒐集證詞、查驗物證與個人裁決，主入口為「開啟證詞錄」。
- Given 玩家進入共享世界，When 查看 HUD，Then 第一個功能入口為圖示化「證詞錄」，不是泛稱任務清單。
- Given 玩家開啟證詞錄，When 選擇任一故事章節，Then 同頁顯示具名證人、物證、目前敘事、個人裁決與結案真相。
- Given 玩家尚未完成分支章，When 查看兩個裁決，Then 按鈕直接顯示不同裁決內容，並說明選擇會改變後續證詞與地點。
- Given 玩家已完成分支並重新連線，When 回到證詞錄，Then 顯示已保存的個人裁決、正確後續敘事與已查驗章節數。
- Given 建置 Android、iOS 或 iOS Simulator，When 讀取匯出設定，Then build number 均為 78。

## App Store 反垃圾與差異化驗收（2026-11-04）

以下案例與 [PRD 的反垃圾驗收基線](PRD.md#app-store-反垃圾與差異化驗收基線2026-11-04) 同步。`IMPLEMENTED` 表示已有 repo／自動測試證據；只有在指定實體 iPhone／iPad 完成同一流程並保存畫面後才能改為 `DEVICE VERIFIED`。

### 核心循環

- Given 新玩家第一次開啟 Build 70，When 在 60 秒內依首頁與 HUD 操作，Then 不需先閱讀商店文案即可開啟證詞錄，指出目前證人、物證與下一個現場行動。狀態：DEVICE VERIFIED（iPhone 14 Pro Max／iOS 26.6.1，首頁與 HUD 均可開啟具名證詞錄）；完整裁決計時待完成。
- Given 玩家完成同一事件第六章前置條件，When 選擇任一裁決，Then 另一裁決不可再提交，後續文本與至少一個調查座標不同，裁決寫入個人紀錄。狀態：IMPLEMENTED。
- Given 已作出裁決的玩家離線並重連，When 再開啟證詞錄，Then 顯示原裁決、正確後續章節與座標，且不得重領已發放獎勵。狀態：IMPLEMENTED。
- Given 玩家接取不同兩條故事線，When 查看證人、衝突、物證、真相及裁決，Then 這些資料形成不同事件，不能只替換人名或地名後產生相同結案。狀態：IMPLEMENTED（結構），人工敘事品質抽查待完成。

### 反向與非化妝性驗收

- Given 只更換 App 名稱、圖示、配色、角色立繪或商店截圖，When 核心玩法仍只是接任務後討伐怪物，Then 差異化驗收失敗，狀態不得標為 IMPLEMENTED 或 READY。
- Given 截圖或審查備註宣稱具有證詞／物證／裁決，When 提交中的 Build 無法依審查路徑重現完整循環，Then 視為 P0 阻擋，不得以 PRD 或影片替代可玩功能。
- Given repo 掃描出 dSYM 或 Godot 工具識別碼，When 判斷多 Bundle ID，Then 不把衍生符號包或引擎工具誤認為另一個上架 App；仍須另行盤點開發者帳號全部 App。
- Given 開發者帳號存在另一個核心流程、素材與商店定位近似的 App，When 無法提出不同使用者結果與可重現玩法，Then 產品決策改為 `CONSOLIDATE` 或 `PIVOT`，送審狀態為 `HOLD`。
- Given App Store Connect 帳號共有 16 個 App，When 盤點 Bundle ID 與商店核心循環，Then 不得有第二個 `com.leon456.starember`，並應將《風島疾行》的風門競速、《變形快遞》的路線規劃、《軌道清潔隊》的太空任務、《雲脊突擊》的空戰及本作的持久調查裁決分別記錄。狀態：IMPLEMENTED。
- Given 《雲脊突擊》與本作同樣使用 Godot，When 比對兩個 repo 的產品自有 `scripts` 與本作 `data`，Then 30 個本作檔案與 16 個空戰檔案不得出現相同 SHA-256；2026-11-04 結果為 0 個相同檔案，僅共用通用檔名 `main.gd`／`main.gd.uid`。狀態：IMPLEMENTED。

### 原生、完整性與審查證據

- Given iOS App 斷網或後端不可用，When 玩家進入核心流程，Then 顯示可理解的連線／臨時世界狀態，不得白屏、卡死或把遠端網頁當成原生遊戲。狀態：IMPLEMENTED（headless），待實機網路切換。
- Given 審查人員使用 Review Notes，When 依序開啟證詞錄、完成物證核對、作出裁決並重連，Then 可在單一 Build 看到前後差異及持久紀錄；若需帳號或特殊條件，必須提供完整 demo 路徑。狀態：IMPLEMENTED，待實機錄影。
- Given 商店使用任一截圖或預覽，When 對照提交 Build，Then 畫面必須來自實際 App 使用情境，且不得以概念原畫冒充遊戲內畫面。
- Given 玩家使用聊天，When 遇到不當內容或使用者，Then 能在 App 內檢舉及封鎖；後端保存真實原訊息、客服資訊可見，營運者按公開政策處理。狀態：IMPLEMENTED；處理時效需持續營運紀錄。
- Given 玩家要求刪除帳號與雲端進度，When 目前會話驗證及明確確認成功，Then 伺服器資料與本機憑證均移除，隱私政策仍可從 App 內開啟。狀態：IMPLEMENTED。

### 本次證據

- 2026-11-04：`node --test --test-concurrency=1 tests/*.test.mjs` 為 75 / 75 通過。
- 2026-11-04：Godot headless `network_flow.gd` 為 11 / 11 通過；`client_flow.gd` 為 31 / 31 通過。
- 2026-11-04：App Store Connect API 回讀 Build 70 為 `VALID`，版本及提交為 `WAITING_FOR_REVIEW`；此狀態不代表核准或公開上架。
- 2026-11-04 23:53（Asia/Phnom_Penh）：舊 Build 70 提交已撤回；Build 76 為 `VALID`，3 張 iPhone 與 9 張 iPad 截圖全部 `COMPLETE`，新提交 `07f1854a-249d-4830-a48d-e413f5d554d3` 與版本均為 `WAITING_FOR_REVIEW`。
- 2026-11-04：App Store Connect API 盤點帳號 16 個 App，Bundle ID 均不同；已讀取七個相關遊戲的正式商店描述，核心循環不同。六個相關 repo 已辨識框架；唯一同為 Godot 的《雲脊突擊》與本作比對 46 個產品自有檔案，精確 SHA-256 相同數為 0。
- 2026-11-04：Build 70 以 Apple Development 成功建置並在實體 iPhone 14 Pro Max（iOS 26.6.1）橫向啟動；首頁顯示調查定位與「開啟證詞錄」，進入 production 線上世界後顯示玩家「星火飛廉」Lv.8、雷達、敵人距離、觸控 HUD，證詞錄顯示故事、章節、具名證人與證詞。狀態：DEVICE VERIFIED。
- 2026-11-04：強制終止並重新啟動 App 後，再次連入同一線上世界，玩家名稱與等級恢復。狀態：DEVICE VERIFIED（工作階段／角色重連）；裁決持久化仍由自動測試覆蓋，尚未完成實機裁決。
- 未完成：實體 iPhone 第六章裁決前後、斷網恢復、效能與審查影片；實體 iPad。

## 2026-11-05 Anti-Spam：主動證據鏈（下一個 iOS Build 候選）

以下功能已進入 repository，但不在目前送審的 Build 76；完成實機驗證與新 IPA 前，狀態不得寫成 DEVICE VERIFIED 或「已送審」。

- Given 玩家在第 5 章已取得證詞與物證，When 選擇錯誤矛盾推論，Then 章節、金幣與經驗不變，並收到需要重新核對的提示。狀態：IMPLEMENTED。
- Given 玩家在同一章選擇正確推論，When 伺服器驗證，Then story.findings[arc] 保存正解並解鎖第 6 章。狀態：IMPLEMENTED。
- Given v2 玩家直接偽造第 6 章裁決但沒有證據鏈，When 伺服器收到請求，Then 拒絕裁決且不發獎。狀態：IMPLEMENTED。
- Given 已建立證據鏈的玩家離線後重連，When 再開啟證詞錄，Then 原推論、裁決與後續章節保持一致。狀態：IMPLEMENTED（伺服器持久結構）；實機重連待驗證。
- Given Godot 客戶端進入第 5 章，When 開啟證詞錄，Then 顯示「矛盾核對」與兩個完整推論按鈕，而不是通用「調查／交付」。狀態：IMPLEMENTED；實機待驗證。
- Given 正在送審的 Build 76 未送出 investigationVersion=2，When 它連線至更新後伺服器，Then 原有故事流程仍可完成，不因新欄位被阻斷。狀態：IMPLEMENTED。
- Given 只修改商店描述、截圖、圖示或角色外觀，When 沒有上述可操作且持久的證據鏈，Then Anti-Spam 驗收失敗。狀態：NEGATIVE GATE。

### 本次自動證據

- 2026-11-05：npm test -- --test-concurrency=1 為 86 / 86 通過。
- 2026-11-05：100 條故事全部具有兩個推論，且 1,000 章可在 v2 規則下完整完成。
- 2026-11-05：錯誤推論、正確保存、無證據鏈偽造裁決、舊協定相容均有自動案例。
- 2026-11-05：Godot 4.7.2 headless client flow 完成並輸出 CLIENT_FLOW_PASS；dummy renderer 仍報既有 RID 警告，不等於實機渲染驗收。
- 2026-11-05：iOS Simulator Build 77 建置成功；Release archive 在 codesign 回報 `errSecInternalComponent`，所有本機簽章身分的非互動 probe 均失敗。
- 尚未完成：實體 iPhone／iPad 的完整矛盾核對與重連錄影、Release archive／IPA／上傳／送審。

## 2026-11-05 MMO RPG 市場差異驗收

- Given 玩家只看到職業、搖桿、雷達、怪物與攻擊按鈕，When 與五個直接 MMO RPG 競品比較，Then 不得判定差異化通過。狀態：NEGATIVE GATE。
- Given 玩家第一次進入下一 Build，When 在 30 秒內操作，Then 可進入具名案件、查看證詞／物證並選擇兩個矛盾推論之一。狀態：IMPLEMENTED；實機待驗證。
- Given 玩家選擇錯誤推論，When 伺服器回應，Then 進度與獎勵不變；Given 選擇正確推論，Then 才建立證據鏈並解鎖裁決。狀態：IMPLEMENTED。
- Given 準備 Build 77 的 App Store 圖組，When 排列前三張，Then 必須為「矛盾核對、個人裁決紀錄、共享世界調查」，不得再以五職業選角作第一差異證據。狀態：IMPLEMENTED（iPhone／iPad 各 5 張候選圖）；實機截圖待驗證。
- Given 文案提到 100 條／1,000 章，When 尚未人工抽查至少 10 條案件的正解、干擾推論與結果品質，Then 章節數量不得被視為 4.3 差異證據。狀態：PENDING CONTENT REVIEW。
- Given metadata 對應 Build 76，When 編寫功能說明，Then 不得宣稱具有主動矛盾核對、錯誤推論阻擋或證據鏈閘門。狀態：RELEASE GATE。

## V70 Vercel Web Analytics

- Given 玩家開啟正式遊戲、故事圖鑑、下載、客服或隱私頁，When 頁面完成載入，Then 只載入一次 `/_vercel/insights/script.js` 並記錄基本頁面瀏覽。
- Given 開發者開啟 `/review/` 下的角色或動作檢查頁，When 頁面完成載入，Then 不載入 Web Analytics，開發流量不進入正式指標。
- Given 玩家瀏覽或操作遊戲，When Analytics 送出頁面瀏覽，Then 不包含角色名稱、聊天內容、遊戲座標、背包或任務內容。
- Given 玩家開啟隱私權政策，When 閱讀資料與用途，Then 可看見 Vercel Web Analytics、統計資料範圍及不用於跨網站廣告追蹤的說明。

## 2026-11-14 伺服器容量與排隊 BDD

- Given 世界未滿，When 玩家連線，Then 直接收到 welcome 並進入共同世界。狀態：PASS（自動整合測試）。
- Given 已有 64 名玩家在線，When 第 65–70 名玩家連線，Then 連線保持開啟並收到不重複身分的 FIFO 排隊位置，不被直接踢除。狀態：PASS（本機 70 連線負載）。
- Given 排隊中有玩家離開，When 第一個名額釋出，Then 隊首收到 welcome，其餘位置前移；離開隊列者不佔位置。狀態：PASS（2 人容量整合案例）。
- Given 玩家仍在排隊，When 五秒未收到世界快照，Then 伺服器仍送排隊心跳，Web／Godot 不把正常等待誤判為逾時。狀態：PASS（協定與靜態檢查）；真實裝置待驗證。
- Given Vercel 建立多個 WebSocket Function instances，When 玩家跨 instance 進入隊列，Then 不得宣稱全域嚴格 FIFO 或已認證 64 人容量。狀態：KNOWN LIMITATION；需 Redis 原子入場或專用即時伺服器。
- Given Redis 或世界服務暫時失效，When 客戶端斷線，Then 保留既有退避重連與明確錯誤提示，不把玩家卡在不可恢復畫面。狀態：自動回歸測試通過；生產故障演練待驗證。
