# 星燼遠征：霧境 Online — 全 3D 多人 RPG 改造
版本：V78 / 1.0.10 · 2026-11-17

## 產品方向
將原有《星燼遠征》改為全 3D 共同世界 MMORPG。現階段交付為可運行的多人垂直切片；不是正式商業 MMO 上線版本。原有 2D fallback 不再作為主遊戲，場景、地形、角色、怪物、武器與技能使用 WebGL 3D 幾何。

## V78 分析與廣告營利

- iOS 使用獨立 Firebase 專案 `star-ember-analytics`，僅收集啟動、工作階段、App／裝置版本與穩定性等彙總分析；不設定使用者 ID、不使用 IDFA，不傳送角色名稱、聊天、座標、證詞、物證、裁決或背包內容。
- iOS 使用專屬 AdMob App ID 與插頁單元。插頁僅排在案件完成、每三章完成或世界首領回營等自然轉場；遊戲開始至少 5 分鐘後、兩次至少相隔 8 分鐘、每次遊玩最多 3 次，戰鬥、死亡、讀取或對話視窗期間不得顯示。
- 在要求同意的地區，廣告請求前先完成 UMP；預設非個人化、停用第一方 ID 與 ATT。玩家可在帳號與安全重開隱私選擇並回報不當廣告。
- Firebase／AdMob 設定已進入 Build 78；實體裝置廣告填充、Firebase 後台事件與 App Store 審查仍需獨立驗證。

## 營利模式（廣告已實作／IAP 仍未實作）

- 保持免費本體；現有 100 條故事線與 1,000 個調查章節繼續免費。
- 第一階段採用 Apple 非消耗型 IAP：創始調查員支持包、職業外觀與後續新案件包。
- 不販售傷害、屬性、復活或排名優勢；當前不規劃抽卡、戰力廣告獎勵、複雜虛擬貨幣或訂閱。插頁只出現在自然轉場並有頻率上限。
- 商店只在玩家完成第一個完整案件後，從背包內的「旅人珍藏」進入；不在首次啟動或戰鬥中強制彈出。
- IAP 仍為 `PROPOSED / HOLD`；Build 78 加入廣告與分析，但完成上傳、隱私標示及審查前不代表 App Store 公開版本已含此功能。

完整商品、價格、技術、測試與發布門檻見 [MONETIZATION_PLAN](MONETIZATION_PLAN.md)。

## V76 攻擊自動面向目標

伺服器的玩家攻擊事件必須保留實際命中的 `target` ID，怪物狀態必須保留目前交戰玩家。Web 與 Godot 在攻擊起手前先朝向權威目標，並在攻擊播放期間鎖定目標方向；攻擊結束後才恢復移動轉向。這同時適用於玩家普攻、職業技能與怪物普攻。詳見 [V76_AUTO_FACING](V76_AUTO_FACING.md)。

### V76 iOS 商店發佈素材

Build 76 必須以同一份原生 Godot 內容產出 App Store 封包與截圖。商店圖組至少包含五職業首頁、共享世界／雷達、證詞與物證紀錄、二十區域地圖、背包與帳號安全；iPhone 採 2622×1206，iPad 採 2752×2064。商店描述與審查備註以可在提交 Build 重現的調查核心為主，攻擊自動面向僅列為本版戰鬥改善，不得用截圖或文案取代可玩差異。

## V75 怪物普通攻擊可見狀態修復

存活怪物完成普通攻擊後必須回到待機或追擊，不得套用死亡淡出或沿用上一個網路快照的隱藏狀態。Web 與 Godot 在每個存活快照、受擊與普攻開始／結束時恢復模型可見、材質不透明與正常骨架姿勢；僅 `dead` 狀態可以播放死亡、停留與淡出。重生仍完整重設透明度、粒子與骨架。詳見 [V75_MONSTER_ATTACK_VISIBILITY](V75_MONSTER_ATTACK_VISIBILITY.md)。

## V74 五職業普通攻擊重製

保留現有職業技能，以 Blender 分別重做五種普攻：鐵衛雙手對角斬、遊俠雙刃交替突進、獵手搭箭—滿弓—放箭、術士短蓄力杖擊法彈、祭司盾前錨擊。每職業有獨立蓄力、重心、武器軌跡、命中幀與收招；Web 與 Godot 的傷害、音效、粒子在各自接觸幀觸發。普攻混合時間縮短，職業技能保留較大特效與現有節奏。詳見 [V74_NORMAL_ATTACKS](V74_NORMAL_ATTACKS.md)。

## V73 五職業髮型重構

五個主角髮型依原畫重建為層疊實心髮帽、漸尖寬髮束與獨立髮尾，取代原本粗圓管堆疊。Web 與 Godot 已同步五份 GLB 及全部戰鬥動畫；詳見 [V73_HAIR_REBUILD](V73_HAIR_REBUILD.md)。本版準備 Godot Build 73 素材，不表示已上傳或提交 App Store。

## V72 六類怪物差異化死亡

燼牙／霜角前腿失力側倒、星潮蟹收鉗翻殼、鹽晶巨像跪地碎裂、鐘影亡靈煙化、葦燈怪光爆；世界首領使用獨立長死亡动作、衝擊波與較強鏡頭回饋。Web／Godot 共用 Blender GLB、一次性死亡狀態、停留淡出、完整重生重設與最後一擊回饋。詳見 [V72_DISTINCT_MONSTER_DEATHS](V72_DISTINCT_MONSTER_DEATHS.md)。本版準備 Godot Build 72 素材，不表示已上傳或提交 App Store。

### V72.1 站姿修正

修正 Blender 輸出把 `respawn` 倒地首幀寫成 GLB 預設根節點，導致怪物正常狀態仍躺地、縮小或散件。六類怪物現在以零位移、零旋轉、單位縮放作為 bind pose；螃蟹鉗子與巨像晶簇只在死亡／重生 clip 分離，待機、移動與攻擊保持附著。

## V71 Blender 全身戰鬥動畫

五職業與六種怪物改由 Blender 製作全身攻擊、受擊、死亡與重生動畫，Web／Godot 共用同一份 GLB，命中特效依 Blender 接觸幀同步。怪物死亡不再立即隱藏。完整資產、clip 與限制見 [V71_SHARED_COMBAT_ANIMATION](V71_SHARED_COMBAT_ANIMATION.md)。此版本已準備 Godot Build 71 素材，但不表示已上傳或提交 App Store。

## 已實作
- 全視窗 3D 世界：保留原版二十區地形、河流、橋樑、地區色系，新增營地、帳篷、守望者。
- 五職業：鐵誓守衛、暮刃遊俠、星弦獵手、符火術士、曜印祭司。建立角色時選擇；已有角色以存檔職業為準。近戰、遠程及祭司治療具有不同判定。
- WASD／方向鍵、觸控搖桿、旋轉鏡頭、縮放、全螢幕；五職業使用蒙皮 GLB，六種怪物使用 Blender 分層動畫 GLB。模型尚未達寫實高模或動作捕捉品質。
- 真正 WebSocket 多人共同世界：玩家位置、同一批怪物、共同傷害、附近共享掉落、世界首領與世界聊天。
- 伺服器以 20 Hz 更新世界、10 Hz 推送狀態。移動速度、邊界、河流通行、攻擊距離、冷卻、MP、傷害、死亡與獎勵由伺服器判定。
- RPG 循環：NPC 接取討伐任務 → 擊敗三隻魔物 → 回營領獎 → 消耗銅幣與星材鍛造 → 升級、繼續探索、挑戰首領。
- 40 隻普通怪物與一隻世界首領，18 秒重生；共享獎勵範圍 20 單位，無需組隊。物品直接入包，尚無地面拾取或拾取權系統。
- 安全營地回血、死亡回營、藥水、背包、武器強化、經驗與升級。
- 14 個既有 WAV 音效素材保存在專案內，互動後啟用瀏覽器音訊。
- 匿名角色存檔：瀏覽器保存隨機憑證；伺服器每五秒及離線時寫入本機 JSON。不能跨裝置登入；清除瀏覽器資料會失去角色存取憑證。

## 運行與邊界
預設本機 http://localhost:4173，Node.js 常駐服務承載 HTTP 與 WebSocket。設定最多 64 個連線，但尚未執行 64 人負載驗證，不宣稱此容量已達標。靜態 Vercel 頁面不能單獨承載本專案的常駐世界服務。

目前營地建物、樹木與石頭為視覺場景，尚無完整物理碰撞。河流限制與世界邊界有伺服器判定。返回營地為開發版便利功能，可在戰鬥時使用。UI 支援窄螢幕，尚未驗證實體手機效能與觸控體驗。地形為連續區塊色系，未完成二十區獨立劇情與關卡。

## 完整 MMO 後續里程碑（未實作）
1. 正式帳號、跨裝置、資料庫、存檔遷移與備份、憑證撤銷。
2. 可擴展世界分區、興趣範圍同步、多人壓力與延遲測試、容錯及監控。
3. 組隊、公會、交易、聊天管理、掉落所有權、防作弊與經濟平衡。
4. 完整任務鏈、裝備品階、副本、職業成長、碰撞導航、動畫資產與專業音訊混音。
5. 公網 TLS/WSS 部署、營運資料保護、手機性能優化及實機驗收。

## 驗收原則
測試證據與未實作需求分開標示；雙玩家測試不代表大規模 MMO 容量。不得把假玩家、單機 NPC 或靜態人數計數視為多人實作。

## V26 / 0.2.0 发布修订（部署准备）
- 发布目标固定为现有 star-ember-mistfrontier.vercel.app，不另建同名产品。
- 3D 入口取代旧 2D 首页；保留旧版 104 文件（78 素材）于完整下载包，来源目录 original/v25。
- 复用既有职业肖像、战斗按钮原画；不更改其素材来源声明。
- 增加统一版本下载页，提供完整源码包、全部素材包、独立 PRD／BDD／Gherkin 与 SHA-256 清单。
- WebSocket 客户端加入断线指数退避重连；线上端点计划为 /api/ws。
- 云端世界共享储存与角色存档需要完成免费 Upstash Redis 配置。实际部署、跨实例验证与线上状态见 VALIDATION.md，不以文件准备完成代表上线完成。

### 原版功能迁移范围
V25 原版 PRD 含二十区地图导航、三十武器、220 笔怪物资料及相关历史要求；这些历史资料保存在 original/v25/PRD.md 与 game-data.js。当前 3D 切片只有五职业程序化武器、40 个普通怪物实例与一个首领，尚未将三十武器和 220 笔怪物全部转换，也未完成完整地图寻路。不可把历史设计数据数量当成 3D 已实现内容。

## V27 / 0.3.0 原画化游戏呈现
针对 3D 版像网页的反馈，标题改为全屏霧境原画与人物立绘；战斗改为紧凑头像 HUD、原画技能圆盘、轻量任务追踪与默认收起的世界聊天。十张地表原画绑定到二十区 3D 网格，小地图同步使用原画；道路改为贴地石径。完整美术决策和资产提示词见 ART_DIRECTION.md。
本版美术变更不修改战斗规则、任务数值与已有存档。战斗模型仍为低多边形，未宣称达到标题原画的模型细节。Vercel 发布阻塞沿用此前记录。

## V28：二十區面積擴大 100 倍
- 以 V27 為基準，長、寬各擴大 10 倍；每區 34 × 35 → 340 × 350，連續世界 136 × 175 → 1360 × 1750。尺寸為遊戲單位。
- 角色、營地設施、技能距離、9 單位／秒步速保持原尺度；跨區步行時間因此增加。普通怪物仍為 40 隻，不宣稱內容量增加 100 倍。
- 共用 public/world-config.mjs 控制客戶端地形、小地圖及伺服器邊界、河流與四座橋；橋寬保持可步行尺度，橋長橫跨擴大的河流。
- 地形高度不放大；材質保持原畫紋理密度。區域植被採樣增加至每區 80 處（扣除道路／河流／營地避讓）。遠山與陰影跟隨新世界尺度。
- 舊角色座標只遷移一次，記錄 worldVersion=2；保留等級、任務、背包與金幣，河中舊座標移到岸邊。營地保留兩隻近距離新手怪，其餘怪物按新區域分布。
- V28 為本機交付；Vercel 生產版尚未更新，共享存儲部署仍受先前 Upstash 條款確認問題阻擋。

## V29：连续地貌与再次扩大 1000 倍面积
以 V28 为基准长宽各乘 sqrt(1000)，每区约 10751.74 × 11067.97，整个世界约 43006.98 × 55339.86 游戏单位。20 区总面积 2380000000 平方游戏单位；这是面积倍率，不是长宽各乘 1000。角色、建筑、速度、攻击距离保持原尺度。40 只普通敌人与首领数量不变，未填充同等倍率的剧情内容。

取消按矩形区域分配材质的硬拼接。连续且弯曲的生物群落权重统一控制地表颜色、四种地表纹理混合、植被概率和小地图；道路与河岸使用渐变过渡。纹理使用不同方向和尺度的双重采样减少重复感。地形加入连续起伏。地图交界是渐变带，区域名称按占比最高的群落显示。

地形使用 64 × 64 的区块、每块 32 × 32 网格，只保留角色附近最多 49 块；移出窗口的地形释放几何资源，植被使用实例化绘制。四条跨河通路由局部桥面生成。装饰仍无物理碰撞；远景用雾遮挡区块窗口，未实现多层远景 LOD 或大规模 MMO 负载验证。

worldVersion=3；V28 坐标只乘 sqrt(1000) 一次，旧 V27 存档可直接迁移；保留等级、背包和任务。此迁移保持地图中的相对位置，营地附近旧位置也可能被拉远，可使用返回营地。

本机已更新，Vercel 未发布。角色真实模型制作仍处于首批参考图完成阶段，不属于此次地图更新的已完成内容。

## V30 / 0.6.0 云端发布配置（2026-10-25）
Upstash 免费 Redis 已创建并连接 production/preview/development；区域 sin1，自动付费升级关闭。api/ws.mjs 提供 Vercel WebSocket，lib/cloud-world.mjs 使用 Redis 版本比较交换提交世界状态与匿名存档，避免多实例覆盖。云端每 250ms 批量同步，模拟按 50ms 子步推进；本机仍使用原常驻服务。客户端 4 分钟轮换连接，角色凭证可恢复进度；断线会清理，失联租约 15 秒回收。
免费服务额度可能限制长时间多人运行；未做商业 MMO 容量认证。此方案为单共享世界开发版，每个运行实例约每秒 8 条基础 Redis 命令（冲突重试会增加）。不自动升级付费。localhost 角色与线上角色属于不同浏览器源，个人本机存档没有上传。
阶段：真实 Redis 双 WebSocket 共同状态、聊天、任务存档重连已通过；正式发布结果另见验证记录。

### V30 上线状态
正式网址 https://star-ember-mistfrontier.vercel.app 已发布，真实双连接及云端存档验收通过。此前版本段落中的“未发布／条款阻碍”是历史记录，已由本状态取代。


## 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 样板作为历史对照保留。

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

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

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

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

## 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)。


## 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 4 雙平台移植 / 0.1.0

新增 `godot/` 原生 iOS / Android 共用專案，維持既有 Node.js 權威多人協定與五職業、營地委託、背包、鍛造、故事資料。手機資產與原美術分離；提供橫向觸控、重連與端點隔離憑證。實際範圍、操作及限制見 `../godot/README.md`；驗收見 `GODOT_MOBILE_BDD.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](V65_NATIVE_SYNC.md)。

## 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 發佈與社群安全
V69 / 1.0（69）：背包 → 帳號與安全提供永久刪除。伺服器依目前會話驗證，確認後清除角色、進度、事件與相關檢舉；成功回覆後才清除裝置憑證。聊天提供過濾、檢舉、持久封鎖、管理員禁言。

## V70 Redis 額度故障恢復
多人世界改為伺服器記憶體即時運算，Redis 每 30 秒或離線／刪除帳號時保存一次版本快照，不再每 250ms 讀寫完整世界。Redis 達方案上限或暫時失效時，健康端點回傳 `status=degraded`、`storage=memory`，WebSocket 仍允許玩家進入臨時世界並明確提示該期間進度不永久保存。無玩家後每 60 秒嘗試恢復 Redis；恢復時重新載入既有永久快照。保存採版本比較，衝突時不覆蓋較新資料。角色、任務和背包屬永久資料，因此共用世界快照不設定 TTL；連線租約仍由 15 秒失聯回收控制。

## iOS Build 70：霧境證詞錄核心玩法

Build 70 將證詞、物證調查、分支裁決與個人結案紀錄提升為首頁、HUD 與商店展示的主要產品身分。詳細核心循環、介面與範圍見 [BUILD70_INVESTIGATION_CORE](BUILD70_INVESTIGATION_CORE.md)。

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

本節是 4.3(a) 修正後的產品門檻，不是保證 Apple 核准。正式稽核、競品比較與規範對照見 [APP_STORE_SPAM_GUARD_AUDIT_2026-11-04](APP_STORE_SPAM_GUARD_AUDIT_2026-11-04.md)。

### 產品承諾與核心使用者

- 目標使用者：想在共享 3D 世界中共同探索、但希望自己的證據判讀與裁決留下不同長期紀錄的敘事 RPG 玩家。
- 可辨識核心循環：具名證詞 → 唯一物證 → 現場／討伐核對 → 互斥裁決 → 後續文本與座標改變 → 個人結案紀錄可回讀。
- 若移除名稱、圖示、配色及商店截圖，以上循環仍必須可在原生 Godot 客戶端完成；一般 MMORPG 戰鬥、超大地圖或任務數量本身不算差異化證據。

### 差異化功能與證據狀態

| 優先級 | 功能／使用者結果 | 驗收條件 | 證據狀態 |
|---|---|---|---|
| P0 | 30–60 秒內看懂「證詞—物證—裁決」 | 首頁與 HUD 可直接進入證詞錄；同頁看見具名證人、物證、目前行動與結案層，不以一般任務清單代替 | DEVICE VERIFIED（iPhone 14 Pro Max／iOS 26.6.1）：首頁、HUD 與具名證人證詞錄可重現；完整裁決待驗證 |
| P0 | 裁決產生可觀察且持久的結果 | 兩個互斥裁決必須改變第 7–10 章文本與至少一個調查座標；重連後維持選擇，不能重領獎勵 | IMPLEMENTED：伺服器故事測試與 11 項 Godot WebSocket 流程；尚非實機 |
| P0 | 原生可玩，不是網站包裝 | iOS 主流程由 Godot 場景、原生觸控、雷達、角色控制與 WebSocket 客戶端完成，不以 WebView 載入網頁遊戲 | DEVICE VERIFIED（iPhone）：Build 70 橫向啟動、線上世界、雷達、敵人距離、觸控 HUD 及終止後重連均可重現；iPad 待驗證 |
| P0 | 同開發者作品不是換 Bundle ID 重包 | 提交前列出開發者帳號內所有 App、Bundle ID、核心流程及共用素材；若存在近似流程，必須合併或提供可重現差異 | IMPLEMENTED：2026-11-04 已由 App Store Connect API 盤點 16 個 App，未見重複 Bundle ID；六個相關遊戲 repo 使用不同產品流程，唯一同為 Godot 的《雲脊突擊》与本作產品自有腳本／資料 46 檔無相同 SHA-256 |
| P1 | 100 條故事不是只換名稱的填充 | 每條需有不同具名衝突、物證、真相與兩個裁決；抽查至少 10 條時不得只替換名詞而共用相同敘事結果 | IMPLEMENTED（結構與唯一性自動測試）；內容品質仍需人工抽查 |
| P1 | 商店展示反映真實核心玩法 | iPhone／iPad 截圖與審查備註需直接呈現證詞、物證、裁決及個人紀錄，且逐張可在提交 Build 重現 | IMPLEMENTED（素材已處理）；需要實機錄影補強 |
| P1 | 多人聊天安全與隱私 | 可過濾、檢舉、封鎖、永久刪除資料；客服聯絡與隱私政策可在 App 內到達；檢舉由真人依時處理 | IMPLEMENTED（程式與測試）；真人處理時效屬持續營運責任 |

### 發佈與投資決策

- 產品決策：`KEEP`。目前核心不是單純的通用 MMORPG 換皮，調查紀錄循環已進入客戶端、伺服器及存檔。
- 內部送審準備度：`NEEDS WORK`。帳號 16 個 App、相關 repo 框架與產品自有檔案已盤點；實體 iPhone 首頁、線上世界、HUD、證詞錄及重連已驗證，剩餘 P0 是完整裁決、斷網恢復與 iPad 全流程證據。
- Build 70 目前已在 App Store Connect 等待審查；本稽核不自動撤回既有提交。Apple 若要求補件，應先提供可重現操作路徑與實機影片，不得只改商店文案、圖示、配色或截圖後重送。
- 成功指標：新玩家 60 秒內可正確說出證詞、物證與裁決三步；完成第六章的玩家中至少 80% 能在證詞錄找到自己的裁決；重連後裁決保存成功率 100%；崩潰率與登入失敗率另依正式監控追蹤。

## 2026-11-05 Anti-Spam 差異化增量（下一個 iOS Build 候選）

目前送審中的 iOS 1.0（76）保持不變；本節描述的是 repository 已完成、但尚未打包或提交的新核心玩法，不得宣稱已存在於 Build 76。

### 主動證據鏈

- 第 5 章不再只是「到達地點後按完成」。玩家必須在兩個事件專屬推論中，核對具名證詞、唯一物證與事件真相。
- 錯誤推論不推進章節、不發放獎勵；正確推論寫入 story.findings[arc]，才允許進入第 6 章分支裁決。
- Web 與 Godot 共用同一份 100 條故事／1,000 章資料、推論選項及正解；伺服器權威驗證，不能由客戶端偽造完成。
- 證據鏈、裁決與後續章節跨重連保存。舊版 Build 76 未帶 investigationVersion=2 時保留相容路徑，避免正在送審的客戶端被新伺服器阻斷。

| 優先級 | 使用者結果 | 驗收條件 | 目前狀態 |
|---|---|---|---|
| P0 | 玩家真的進行判讀，而不是閱讀任務文字 | 錯誤推論不推進／不發獎；正確推論保存後才解鎖裁決 | IMPLEMENTED；Node 測試通過，尚未實機 |
| P0 | 原生與 Web 規則一致 | Godot catalogue 含兩個 findings 與 correctFinding，Godot UI 可選 A/B，伺服器用同一規則驗證 | IMPLEMENTED；Godot headless 通過，尚未實機 |
| P0 | 更新伺服器不破壞 Build 76 | 未帶 v2 協定的舊客戶端仍可完成既有流程；v2 客戶端必須完成證據鏈 | IMPLEMENTED；自動測試通過 |
| P1 | 商店能展示可玩的差異 | 下一 Build 截圖／影片需直接呈現「矛盾核對 → 錯誤不推進 → 正確解鎖裁決 → 重連仍保存」 | PENDING DEVICE EVIDENCE |

產品決策維持 KEEP，提交準備度維持 NEEDS WORK。理由是差異化已變成伺服器驗證的玩家行為，但尚未在實體 iPhone／iPad 完整驗證，也尚未進入新的 IPA。只更換名稱、圖示、配色、立繪、截圖或商店文案仍不算 4.3 修正。

## 2026-11-05 MMO RPG 市場複核

- 對外主要定位改以「共享世界調查 RPG」描述；MMO 是技術與世界層，不是主要差異承諾。
- Black Desert Mobile、Albion Online、Tower of Fantasy、Diablo Immortal、Toram Online 的官方列表都以戰鬥、養成、職業／裝備、組隊、經濟或大型內容為核心。本作不可用五職業、雷達、大地圖或章節數量主張差異。
- 下一 Build 的商店圖前三張必須依序證明：可操作矛盾核對、持久個人裁決紀錄、共享世界調查；職業選角與一般戰鬥移到後段。
- 「100 條／1,000 章」只表示內容範圍，不是反垃圾證據。人工抽查至少 10 條案件的正解、干擾推論與裁決結果後，才能用於內容品質主張。
- Build 76 不含主動矛盾核對，不得把下一 Build 功能追加到目前送審 metadata。

完整比較見 [APP_STORE_MMO_RPG_COMPARISON_2026-11-05](APP_STORE_MMO_RPG_COMPARISON_2026-11-05.md)。

## 2026-11-14 伺服器容量與等候隊列

- 權威世界硬上限預設為 64 名已進場玩家，透過 WORLD_MAX_PLAYERS 調整；等候隊列預設 128 名，透過 WORLD_MAX_QUEUE 調整。
- 世界滿載時不再直接踢除第 65 名玩家。Web 與 Godot 顯示前方人數、在線人數與容量；有人離線後依 FIFO 順序自動遞補。隊列不顯示無法證實的等待時間。
- 本機自動負載證據：70 個同時 WebSocket 連線均成功建立，64 名進場、6 名留在隊列、0 名錯誤；64 名以 10 Hz 移動 15 秒期間伺服器約使用 5.9–10.1% CPU、71–80 MB RSS。這是本機合成負載，不是 Vercel 生產容量或真人遊玩證明。
- 目前 Vercel Hobby WebSocket 會把每個連線固定到單一 Function instance，但新連線不保證進入同一 instance；因此雲端隊列目前是「單一執行個體 FIFO」，不是全域嚴格 FIFO。正式對外承諾 64 人前，必須完成生產環境持續測試，或改用 Redis 原子入場／專用常駐即時伺服器。
- 保守營運值：未完成生產壓測前，將 40 名同時在線視為告警與人工觀察門檻；64 是程式硬上限，不是已認證 SLA。
- 詳見 [SERVER_CAPACITY_AND_QUEUE](SERVER_CAPACITY_AND_QUEUE.md)。

## V70 Vercel Web Analytics

正式 Web 遊戲、故事圖鑑、下載、客服與隱私頁面接入 Vercel Web Analytics 基本頁面瀏覽統計。內部 `/review/` 美術與動作檢查頁不納入，避免開發流量污染玩家指標。追蹤僅由公開頁面載入 `/_vercel/insights/script.js`；專案不傳送角色名稱、聊天內容、遊戲座標、背包、任務內容或自訂玩家事件。隱私政策必須同步說明供應商、資料範圍與用途。
