﻿PoE 倉庫／角色評估工具：設定說明
==================================

這個工具只讀取官方網站的公開資料、交易所和你自己按 Ctrl+C 複製的物品文字，
不會對遊戲做任何操作。


一、第一次使用（三步）
----------------------

1. 解壓縮到任何資料夾，例如 D:\PoE\POE-stash-appraiser
   （這是精簡版，沒有附 node.exe：請先到 https://nodejs.org 安裝 LTS 版，裝一次就好）

2. 雙擊「PoE評估工具.bat」，會打開總控台視窗（不會有黑色視窗），按「身上裝備評估」的「快速」。
   缺少必要的資料時會自動切到「帳號設定」分頁，填好按「儲存」，再按「重新執行」
   （角色評估要填帳號名稱，倉庫評估要填 POESESSID）。
   帳號名稱打錯、POESESSID 過期時，也會切到「帳號設定」並顯示錯誤原因。

3. 第一次會下載詞綴資料和價格，大約要一兩分鐘，之後就快了。
   跑完會自動切到「報告」分頁顯示結果。

之後想改設定：總控台的「帳號設定」分頁。
也可以用記事本直接改 config.json，每一欄的意思見下面「二」。


★ 多組帳號／更換帳號
  「帳號設定」分頁最上面的「已存的帳號」可以存好幾個帳號，每個帳號各自記住角色、POESESSID、倉庫頁、聯盟。
  - 換帳號：在「評估」分頁的「目前使用的帳號」直接選，或到「帳號設定」分頁的「已存的帳號」選好按「儲存」。
  - 新增：選「（新增帳號）」→ 填資料 → 按「儲存」。舊的帳號不會被蓋掉。
  - 刪除：選那個帳號 → 按「刪除這個帳號」→ 按「確定」。
  - 帳號名稱就是這組的名字；改了帳號名稱再儲存，會變成另存一組新的。
  - 進階：命令列加 --profile 帳號名，可以這一次臨時用別的帳號，不會改到目前使用的帳號，
    例如 node\node.exe src\cli.js char --no-trade --open --profile "Name#1234"

  POESESSID 每個帳號各一個。在同一個瀏覽器登入第二個帳號前，不要按官網的「登出」
  （登出會讓前一個帳號的 POESESSID 失效）；或用另一個瀏覽器／無痕視窗登入第二個帳號。


二、config.json 每一欄
----------------------

{
  "league": "auto",
  "realm": "pc",
  "accountName": "Name#1234",
  "character": "",
  "poesessid": "",
  "tabs": "all"
}

league       聯盟。寫 "auto" 會自動用目前的賽季聯盟（一般模式），新賽季不用改。
             玩專家、SSF、標準聯盟時直接填名稱，例如 "Hardcore Allflame"、"Standard"。

realm        國際服填 "pc"，不用改。

accountName  帳號名稱，要包含 # 後面的數字，例如 "Name#1234"。
             角色模式一定要填。

character    角色模式要讀的角色名稱，例如 "MyCharacter"。
             留空 "" 會自動選最後登入的角色。

poesessid    倉庫模式才需要（角色模式不用）。取得方法見「三」。
             填的時候整串貼在兩個引號中間，例如 "abc123..."。

tabs         倉庫模式要讀哪幾頁：
               "all"          全部頁（隱藏頁除外）
               [0, 1, 2]      第 1、2、3 頁（編號從 0 開始）
               ["賣", "雜物"]  用頁名指定

注意：JSON 格式很嚴格，引號要用半形 "，每一行（最後一行除外）後面要有逗號。
      存檔後如果工具說設定檔讀不到，多半是少了逗號或引號。


三、取得 POESESSID（只有倉庫模式需要）
--------------------------------------

1. 用瀏覽器登入 https://www.pathofexile.com
2. 按 F12 打開開發人員工具
3. 上方分頁選「Application」（應用程式）
   → 左邊「Cookies」→ https://www.pathofexile.com
4. 找到名稱是 POESESSID 的那一列，只複製右邊「Value」（值）那一格：一串 32 個英文和數字
5. 貼到總控台「帳號設定」分頁的 POESESSID 欄位（或 config.json 的 "poesessid": "" 引號中間）。

★ POESESSID 等於你的登入狀態，不要給任何人，也不要把 config.json 傳給別人。
★ 它只存在這台電腦的 config.json，工具只會把它送到 pathofexile.com。
★ 在網站上登出、或過一段時間失效後，要重新複製一次。
★ 不要在共用電腦或網咖上填。

角色模式不需要 POESESSID，但帳號的角色頁要公開：
官網 My Account → Privacy Settings，不要勾選隱藏角色（和 Path of Building 匯入角色的條件一樣）。


四、總控台（PoE評估工具.bat）
------------------------------

雙擊「PoE評估工具.bat」，工具在背景執行（沒有黑色視窗），總控台用獨立視窗打開
（借用 Chrome 或 Edge 的應用程式模式：沒有網址列和分頁列，像一般程式一樣）。
所有功能都在這個視窗裡，用上方的分頁切換：

評估       切換帳號、臨時指定角色；身上裝備評估、倉庫評估（先讀取倉庫列表、
           勾選要評估的頁，再按快速／查價）、剪貼簿監聽；
           執行狀態與即時訊息（可以按「停止」）；最近的報告
物品查價   遊戲中對物品按 Ctrl+Alt+C，回到這個分頁按 Ctrl+V，馬上顯示評估；
           稀有裝備會再查交易所（只看即刻購買），列出相似掛單，
           並有「在交易所開啟」按鈕
報告       直接在總控台裡看報告，跑完評估會自動切過來；
           傳奇會標出數值離滿值多近（例如「傳奇數值 92%」），
           「高數值傳奇」按鈕只列出 90% 以上的傳奇
評分設定   評分規則編輯器
帳號設定   已存的帳號、帳號名稱、角色、POESESSID、倉庫頁、聯盟；新增／刪除帳號

結束：按右上角「結束工具」，或直接關掉總控台視窗（約 10 秒後自動結束）。
      查價跑到一半時關掉視窗，會等查完才結束。
已經開著時再雙擊，會直接打開原本的總控台。


五、常見問題
------------

Q. 雙擊後沒有打開網頁／黑色視窗顯示「啟動失敗」
A. 看視窗裡的訊息。找不到 node 時，確認 node 資料夾裡有 node.exe，或到 https://nodejs.org 安裝 LTS 版。
   如果說連接埠被占用，可能有別的程式用了 8786，關掉它再試。

Q. 改了程式或換了新版後，畫面還是舊的
A. 先在總控台按「結束工具」，再重新雙擊「PoE評估工具.bat」。

Q. 角色模式說讀不到角色
A. 檢查 accountName 有沒有包含 #數字，以及官網隱私設定有沒有隱藏角色。

Q. 倉庫模式說沒有權限／401／403
A. POESESSID 失效了。會自動切到「帳號設定」分頁，照「三」重新複製一次貼上即可。

Q. 新賽季第一天聯盟沒有切換
A. 刪掉 cache\leagues.json 再執行一次（聯盟清單會保留一天）。

Q. 兩台電腦的評分規則不一樣
A. 評分規則存在 scoring.json，兩台不會自動同步。改完把 scoring.json 複製到另一台即可。

詳細說明見 README.md。
