疑難排解
大多數問題都能很快解決。如果這裡找不到你的問題，請寄信給支援團隊，並附上你的作業系統、PATerminal 版本（「設定」→「更新」），以及你已經嘗試過的方法。
以 PATerminal v1.8.3 為準撰寫
安裝與開啟
- Windows：「Windows 已保護您的電腦」
- 按一下 其他資訊，再按 仍要執行。SmartScreen 會對新的 App 發出警告；如果想確認安全，可以比對 Windows 安裝指南上的 SHA-256。
- macOS 在開啟前要求確認
- 選擇 打開。這個 App 已使用 Developer ID 簽署，並經過 Apple 公證。
Git 顯示錯誤
當你電腦上的某些狀況讓 git 無法執行時，PATerminal 會顯示 無法在這台電腦上執行 Git 以及修正方法。常見的情況如下：
| 原因 | 解決方法 |
|---|---|
| macOS：尚未同意 Xcode 授權（常發生在 Xcode 剛更新之後） | sudo xcodebuild -license accept |
| macOS：Command Line Tools 遺失或損壞 | xcode-select --install |
| 未安裝 Git | 安裝 Git（Windows：winget install Git.Git）；PATerminal 會自動偵測。 |
| 其他磁碟或網路共用資料夾出現「dubious ownership」 | git config --global --add safe.directory <path>——僅限你信任的資料夾。 |
| Windows：路徑過長 | git config --global core.longpaths true |
拉取請求或 Issue 無法載入
請確認已安裝 gh 並已登入（gh auth status），而且存放庫設有 GitHub 遠端。修正後按 重試。
工作階段一直停在「執行中」
- 其中仍有程式在輸出——開發伺服器、檔案監看程式或轉圈動畫。這些是真實的輸出，所以狀態是正確的。
- Codex 0.154.0 或以上版本在 PATerminal 儲存
tui.whimsy = false之前就已啟動：請重新啟動該 Codex 工作階段。專案層級或命令列中的明確設定可能會覆蓋它。請參閱給 Codex 使用者的說明。
沒有收到通知
- 確認「設定」→ 通知 已開啟。
- 在作業系統設定中允許 PATerminal 發送通知，並檢查專注模式 / 勿擾模式。
- 只有你沒在看的工作階段才會發送通知。
對話沒有恢復
- 代理可能在儲存對話之前就已結束。請改從歷史開啟。
- 要將 Claude Code 移到不相關的資料夾，需要 Claude Code v2.1.223 或以上版本。
- 只在原始命令列中傳入的選項不會被重新套用。
更新失敗
如果已簽署的更新無法安裝，PATerminal 不會重新啟動，也不會有任何改變。請稍後再試，或從下載頁面下載最新的安裝程式，直接覆蓋安裝目前的版本——你的工作階段與設定都會保留。
我的資料存放在哪裡？
工作階段、群組、備註、片語與設定都以本機檔案的形式儲存在你的電腦上；代理的對話則保存在各代理自己的資料夾中（例如 ~/.claude 與 ~/.codex）。不會同步任何內容到伺服器，PATerminal 也沒有任何遙測。