3-9. GUI 網頁無法開啟，或更新後出現錯誤

大部分這類問題都跟「檔案擺放方式」或「更新過程被中斷」有關。
常見成因包括：

1. 把 palserver-agent.exe 重新命名

2. 把 web 資料夾重新命名

3. 把 web 資料夾刪除，或跟 palserver-agent.exe放在不同目錄下

4. 把 palserver-agent.exe 放進 web 或其他資料夾內

5. 把 palserver-agent.exe 與 web 資料夾放到路徑含有中文字的資料夾

6. 把新版檔案放進舊版 GUI 的資料夾內混用

7. 用新版 palserver-agent.exe 與 web 資料夾去覆蓋舊版

8. 根本沒有真的換成新版 palserver-agent.exe 與 web 資料夾

9. 資料夾裡同時有新舊版本，卻誤開到舊版執行檔

10. 更新 GUI 的過程中強制關閉或意外中斷

11. 更新伺服器版本時，中途按了重啟、或強制／意外中斷 GUI

12. 自行更改了程式相關資料或移除了必要檔案

13. 電腦有裝 OneDrive，且把 palserver-agent.exe 與 web 資料夾放在桌面、下載等有中文字的資料夾裡

為什麼 OneDrive 會有影響？

如果電腦用 OneDrive 備份，桌面、文件等中文資料夾常會被同步到雲端；
這會導致 GUI 因為「路徑含中文＋被 OneDrive 監控/同步」而更新異常。
除非把 OneDrive 移除，否則建議照下面的方式重新擺放檔案。

建議的擺放方式

1. 先在工作列右下角（向上箭頭圖示）找到 GUI 的圖示，先關閉它。

2. 在 C:\ 底下建立一個新資料夾，例如 C:\palserver-agent。

3. 把 web 資料夾、LICENSE.md、palserver-agent.exe 全部放進這個資料夾。

4. 幫 palserver-agent.exe 建立捷徑，放到桌面方便之後啟動。

如果 web 資料夾遺失，或照上面做了還是打不開

1. 把目前的 web 資料夾、LICENSE.md、palserver-agent.exe 全部刪除。

2. 重新下載最新版壓縮檔。

3. 把新的 web 資料夾、LICENSE.md、palserver-agent.exe 放進 C:\palserver-agent 資料夾。