Poe Market Zh
Path of Exile 國際服交易站中文化擴充,PoE1(pathofexile.com/trade)與 PoE2(pathofexile.com/trade2)都支援,依網址自動判斷;另附書籤、歷史與物價。與 poe-trade-mate(內部完整版)擴充 id 不同,可同時載入(建議只啟用其中一個,避免互搶官網 lscache 快取;兩者的 CSS class 與設定鍵已分別使用 pmz- / ptm- 前綴,不會互相覆寫)。
- PoE1 / PoE2 雙站:同一支擴充依網址判斷(
/trade2/… 或 /trade/<聯盟>/poe2/… 就是 PoE2),
兩款的翻譯資料、官網 lscache 鍵與聯盟設定各自獨立(PoE1 既有的鍵一個都沒動);
書籤與歷史最上方有 PoE1 / PoE2 分頁,開哪一款就自動切到哪一邊。
PoE2 目前不含 PoB code 匯入(沒有現成的詞綴對照表)與物價(poe.ninja 端點是 PoE1 專用)
- 中文化:介面、詞綴、篩選器、下拉選單中文化 + 搜尋結果列即時翻譯(含定價、已驗證、上架時間等結果列固定字樣)
- 書籤:側邊欄以兩層資料夾收藏常用搜尋,整塊點下去就是搜尋、按住 0.35 秒才是拖曳(拖到別的資料夾上變成它的子、拖到上下緣則是同層排序);標題列內聯改名、釘選;可從 PoE Trade Extension 的匯出碼、Better PathOfExile Trading 的備份檔與 Path of Building code 匯入;書籤存的是與聯盟無關的搜尋編號,換季後照樣打得開;設定分頁可一鍵清除所有書籤(會先確認,搜尋紀錄與設定不受影響)
- PoB 匯入:貼一份 PoB code,自動照部位建資料夾(武器/防具/飾品/珠寶/藥水),每件裝備一個交易搜尋 —— 傳奇用「傳奇名 + 基底」、稀有用「基底 + 全部詞綴」,等於把 poe.ninja 上看到的流派整套存成書籤
- 歷史:開過的搜尋自動記在「歷史」分頁(只記搜尋框有填東西的,同一個搜尋重複進去只更新時間,上限 20 筆),可一鍵加進任一資料夾
- 物價:側邊欄「物價」分頁快查 poe.ninja 經濟 API,分類抽屜呈現、中英即打即搜、15 分鐘快取(選用功能,需自行開啟,見下)
- pobb.in 中文化(選用,預設關):側邊欄 ⚙「中文化與網站」一顆開關,同意 pobb.in 權限後以
chrome.scripting.registerContentScripts 動態註冊 content/site-zh.js,
逐行查表替換頁面文字(物品、詞綴、天賦、技能、網站介面字);聯盟名不翻。名稱表只放遠端 dict 分支(sitenames1/2.json),
打開該代的頁面才下載;關掉中文化不收回權限
- poe.ninja 雙語(選用,跟著「雙語對照」):poe.ninja 已有內建繁中(
/zh-tw/…),擴充不再翻譯頁面,
只在角色頁附另一種語言的小字 —— 英文頁附中文(正查)、繁中頁附英文(反查),兩邊都不改頁面文字。
中英對照用同一份成對字典雙向查;同一個中文對到多個英文時不附。poe.ninja 權限與物價查詢共用,在側邊欄 ⚙「中文化與網站」可直接允許存取
- 偽屬性高亮:結果列的「合計」詞綴(
.item-mod--pseudo)加底色與左側金線,和一般詞綴分得開,可在設定關掉
- 廣義搜尋(
page/stat-search.js):在官網原生結果後面補兩層比對,原生命中的
順序完全不變 —— 多關鍵字(輸入含空白時 token AND,中英可混搜,如「phy gem」
「物理 gems」)與模糊比對(中文簡稱與英文縮寫,如「移速」「火抗」mvspd,
補充項另立「模糊比對」群組)。實作為 MAIN world 改寫 vue-multiselect 實例的
filteredOptions(官網 2026-10 起是 Vue 3,改寫內部實例上的 getter;Vue 2 路徑保留),
同時把類型前綴「(pseudo)」等換成中文;官網結構不符時靜默停用、例外時退回原生過濾
- 顯示規則(與完整版不同處):
- 介面字串(標題、欄位名、按鈕、placeholder):純中文直接替換,不做雙語對照
- 下拉選單選項(物品分類、詞綴清單等):「中文 (English)」對照,中英皆可搜尋
- 傳奇物品下拉(完成地圖獎勵、最後通牒的獎勵與獻祭物;官網原本以
option.knownItem
自己從 items 組選項):建置時展開成靜態選項,顯示「中文 (English)」、送出值仍是英文名
(官網過濾只吃英文)。⚠ 展開後的篩選資料會寫進官網網域 localStorage(約 +311 KB),
該網域 5 MB 額度所剩不多,新增展開欄位前先量
- 搜尋結果列詞綴:直接替換為中文,英文原文放 hover title 供查對;設定的「雙語對照」
開啟後改為中文下方常駐英文原文小字(僅裝備詞綴,物品名/天賦卡不受影響)
- 設定只在側邊欄 ⚙(329.5.23 起):點瀏覽器工具列的擴充圖示 = 切到(或開啟)交易站分頁並展開設定
(
bg/open-settings.js,manifest 沒有 default_popup)。設定分六區摺疊(中文化與網站 / 側邊欄 / 結果列與篩選 /
聯盟與物價 / 翻譯資料 / 備份、匯入與進階),收起時只露一行狀態摘要,一次展開一區。
popup/popup.html 只剩擴充頁用途:全新安裝選語言(?ask=lang)與 poe.ninja / pobb.in 授權退路
(?ask=ninja / ?ask=pobbin;chrome.permissions.request 要在擴充頁面點擊當下呼叫,Firefox 不能從背景直接要)
物價是選用功能
物價要讀 poe.ninja 的公開匯率,而新增 host_permissions 會讓 Chrome 在擴充更新後
停用它、等使用者手動重新授權 —— 不能為了一個附加功能打斷所有現有使用者。所以
poe.ninja 放在 optional_host_permissions,安裝或更新後會自動開一次授權頁詢問
(只問一次,ninjaAsked 記在 storage),之後可在側邊欄 ⚙「聯盟與物價」的「物價查詢」開關
自行開關。content script 沒有 chrome.permissions,所以側邊欄的開關是請背景代要(bg/perms.js:
Chrome 在點擊當下直接跳對話框,Firefox 退回開授權頁),收回權限則由背景直接做。
未授權時物價分頁只顯示指引,不會發出任何請求。
資料夾圖示
只留兩區共 23 個:職業(昇華)19 個 + 常用 4 個(混沌石、神聖石、Nightmare Map、
Map (Tier 16))。由 node tools/gen-icons-subset.mjs 從 tools/icons-full.json(完整版
196 個)產生,指定的圖示找不到就直接失敗,不會靜靜少一個。
從 Better PathOfExile Trading 匯入書籤
設定分頁「選擇備份 / 書籤檔…」直接選它的「匯出備份」文字檔(.txt)即可,會先攤開內容再選要加入哪一款;把單一資料夾的匯出碼貼進 PoE Trade Extension 那個框也會自動辨認。它的書籤沒有聯盟,開啟時用當前聯盟;封存段的資料夾會加「(封存)」並收合;圖示:PoE2 的 35 張(通貨與昇華職業)原樣對上,PoE1 只對得到通貨,其餘用預設。
從 PoE Trade Extension 匯入書籤
在該擴充按「匯出設定」(匯出碼會複製到剪貼簿),貼進側邊欄 ⚙ → 書籤資料 →
「從 PoE Trade Extension 匯入…」。只讀取它的 folders,另外 43 個設定欄位不讀、
不寫,也不提供反向匯出 —— 它的匯入是整包覆蓋設定,回送會清掉使用者在那邊的偏好。
匯入行為(依實際匯出碼實測而定,細節見 tools/verify-bookmarks.mjs):
| 對方的資料 | 這裡怎麼處理 |
|---|
parentId 建的兩層資料夾 | 原樣保留;第三層以下收到第二層 |
childIds(實測恆為空陣列) | 不讀,樹只靠 parentId 建 |
index / idx(實測有重複也有跳號) | 不讀,順序一律以陣列順序為準 |
league: "Auto" | 存成「自動」,開啟時才用當下聯盟 |
search / exchange、PoE1 / PoE2 | 保留,組網址時分流 |
icon(列舉字串,如 Assassin、Chaos1) | 以英文名對到內建圖示;對不到落預設符號並在匯入結果列出 |
壞掉的 endpoint | 丟棄並回報筆數,不靜默略過 |
匯出的是完整備份
「匯出備份」把設定、全部書籤、歷史紀錄存成一個 JSON(kind: "backup"),換一台
電腦一個檔就還原得回來;還原會取代目前的內容(有確認對話框)。只有書籤的舊檔
(或 PoE Trade Mate 的匯出檔)匯入則是附加,不會蓋掉現有的。匯入的設定只收
DEFAULT_SETTINGS 有的鍵而且型別要相符,手改過的備份檔不會把奇怪的值塞進來。
帶條件的書籤為什麼第一次比較慢
PoB 匯入產生的書籤存的是查詢條件而不是搜尋編號,官網每次都得先幫你建立一次搜尋
(那一趟往返就是「點下去有點慢」的來源)。所以第一次開完之後,擴充會把官網換上的
官方編號記回書籤(cachedSearchId),下次點就直接開那個編號,跟一般書籤一樣快。
換聯盟時自動退回 ?q= 重建,不會開到上一季的舊搜尋。
技術:Manifest V3 + Vanilla JS,零建置,Chrome 與 Firefox 共用同一份程式碼。
- Chrome:
chrome://extensions 開「開發人員模式」→「載入未封裝項目」選本資料夾。
- Firefox(140+):
about:debugging#/runtime/this-firefox →「載入暫時附加元件」選本資料夾的 manifest.json;正式安裝請從 Firefox 附加元件站(Firefox 不支援 background.service_worker,上架的 Firefox 版只在打包時把它換成 background.scripts,程式碼一字不差)。
版號規則(雙賽季編碼)
自 329.5.0(2026-08-26,合併 PoE2 支援)起,版號是兩款遊戲的賽季碼 + 一個序號:
329 . 5 . 0
│ │ └── 這組賽季下的第幾次發版(從 0 起算)
│ └────── PoE2 賽季(0.5 → 5)
└─────────── PoE1 賽季(3.29 → 329)
每一段賽季碼是「主版號 × 100 + 次版號」,不是把小數點刪掉。
PoE1 3.29→329、3.30→330、4.0→400;PoE2 仍在搶先體驗,取玩家看到的 0.x:
0.5→5、0.10→10、1.0→100。任一段賽季碼變動時,第三段歸零。
- 不用「刪掉小數點」的寫法:
4.10→410 之後 5.0→50 就是倒退,而 Chrome
Web Store 只接受嚴格遞增的版號。PoE 的次版號會進位到兩位數(3.9 → 3.10,不是 4.0),
這不是假想情境。×100 永遠遞增,而且 PoE1 那一段的讀法與舊版號一樣(3.29 仍是 329),
接得上 3.29.10 以前的歷史。
- PoE2 取玩家端的
0.x,不是遊戲檔裡的 4.5.4.10.2 —— 後者是 GGG 內部把 PoE2
當 4.x 的客戶端建置版本。PoE1 兩者剛好一致(3.29.0.1 / 3.29),所以特別容易誤用。
- 不得有前導零(CWS 規定非零整數不得以 0 開頭),所以是
329.5.0 不是 329.05.0。
- 翻譯資料的新舊不再由版號表達:譯名修正走遠端
dict 分支的 dict-index.json
(自帶 version: N),使用者不必更新擴充就會拿到。舊制第三段的「當季資料修訂」語意
自 329.5.0 起退休。
This is the beginning of the README. Read the rest at the original. Read the full README ↗
