# 原神披薩助手 3.1.1 更新小談

筆者也是「Pizza Helper for Genshin」這款 App 的三名主程式之一，擔當協力維護的工作。這次因為其他兩位主程式師各自的時間不方便、洽逢這款 App（下文簡稱「原披助手 OPHelper」）又需要緊急修復一些 bug，我就推遲了最近在威注音輸入法這一塊的維護工作、來集中修理一下原披助手。

這次更新的內容滿大。正常情況下，按照 semantic versioning 而言，不該這樣命名版本號的。但是呢，原披助手的版本號是跟著原神主程式的版本號同步更新的：原神官方公開更新到 4.2 版本的時候，原披助手才可能會用 3.2 當版本號。

OPHelper 3.1.0 無法正確處理原神 4.1 開始的新版 Profile Picture JSON 資料格式，這在 OPHelper 3.1.1 當中得到了應對。相較於之前依賴於 Enka 的部分 JSON 檔案（既存在 OPHelper 自家的伺服器上，但更新權限只有 Lava 有、而他最近又忙到爆），這次 OPHelper 3.1.1 就引入了幾個 Swift Enum 來統一管理「角色、武器、角色名片、時裝、每日材料」的「本地化翻譯資料」以及「素材資料」，使得整個 App 能夠以更快的運作效能來利用這些資源。

上文有提到「時裝」，是指玩家在遊戲當中擁有的某些英雄的另一套衣服。這種衣服可能是活動的贈品、也可能需要你後來付費單獨購買而得的（比如刻晴的「霓裾翩躚」）。玩家在某個官方伺服器內的遊戲帳號會有一個展櫃、裡面有至多八個公開展示的英雄，要是其中有哪位換了實裝的話、這個特性會反饋到整個 OPHelper App 當中：


這套 Enum 帶來的效能便利也允許 OPHelper 實現更進一步的美工，比如上圖左下角「所有角色」畫面每個英雄所在行新增了背景圖案。

除此之外，因為「米遊社」（就相當於陸版 HoYoLab）有人機認證介面，在需要藉由這個介面認證的情況出現時、可能會無法正常載入深境螺旋戰績畫面。3.1.1 版 OPHelper 會在這個情況下指引使用者一鍵前往人機認證畫面，以便讓米遊社伺服器端知道這是使用者自己對帳號的存取行為。

以下是目前原披助手 3.1.1 相對於 3.1.0 公開發行版的內容更新：

* 修復了該 App 在 macOS 系統下「抽卡分析」「深境螺旋戰績」畫面「沒有關閉按鈕」的故障。
* 允許帕姆參與祈願評價。該特性需手動啟用。
* 第三屏「設定」內容調整：像穹披助手那樣將帳號設定單獨塞到一頁當中。
* 第二屏內容調整：由「工具」更名為「詳情」，且將所有第三方工具全部挪到第三屏「設定」內容內的「旅行工具」分類下。
* 修正了「在原神 4.1 更新後修改過肖像的玩家帳號無法顯示展櫃」的故障。該 App 現在就這類玩家的帳號可以正確顯示帳號肖像與帳號偏好名片背景，且能區分帳號肖像對應的時裝。
* 新增了角色肖像的時裝功能特性：如果您當前帳號的展櫃內的角色有人更換了時裝的話，則會影響到該角色在整個 App 內的肖像顯示、都會以您換上的這套時裝來顯示（比如刻晴「霓裾翩躚」)。每當您切換帳號時，如果切換到的帳號的展櫃內的同名角色的時裝著裝狀態有差異的話，則該差異會同步到整個 App。自您啟動 App 開始，當且僅當您看過第二屏「詳情」且展櫃正常載入起，角色肖像的時裝特性才會生效。
* 針對某些「過了真人認證卻仍舊不顯示深淵資料」的情況，新增了一些用來偵錯的介面訊息文字、且允許您就地前往真人認證手續畫面。
* 修復了「明明沒有登入任何帳號，卻在第二屏被請求『切換帳號』」的故障。現在起，如果沒有帳號登入，將在第二屏頂端顯示帳號登入入口按鈕。
* 在 App 基礎架構層面換用了對資料與素材的全新的管理方式，牽涉到角色、武器資料、每日素材、名片資料、時裝資料等。這使得 App 在處理這些內容的時候的反應速度有了明顯的改善。比如：深淵戰績畫面洗出的報告圖當中的角色的背景圖不再會有隨機的缺失現象。
* 因應上述變動，您的 iOS 小組件的背景偏好設定可能會丟失、需要您手動重新設定。
* 調整了「深境螺旋戰績」畫面與「所有角色」畫面當中的 cornerTag 的配色，藉此改善其在 bright mode 下的可讀性。
* 「所有角色」畫面改版：每個角色都有背景。

大概就這樣子。不出意外的話，這一兩週內就會公開發佈。