故障排除
大多数问题都能快速解决。如果这里没有你遇到的问题，请发邮件给支持团队，并附上你的操作系统、PATerminal 版本（“设置”→“更新”）以及已尝试过的操作。
基于 PATerminal v1.8.3 编写
安装与打开
- Windows：“Windows 已保护你的电脑”
- 点击 更多信息，然后点击 仍要运行。SmartScreen 会对新应用发出警告；如需确认安全，可比对 Windows 安装指南中的 SHA-256。
- macOS 在打开前要求确认
- 选择 打开。该应用已使用 Developer ID 签名，并经过 Apple 公证。
Git 显示错误
当你电脑上的某些问题阻止 git 运行时，PATerminal 会显示 无法在此电脑上运行 Git 以及修复方法。常见情况如下：
| 原因 | 解决方法 |
|---|---|
| macOS：尚未同意 Xcode 许可协议（常见于 Xcode 刚更新后） | sudo xcodebuild -license accept |
| macOS：命令行工具缺失或损坏 | 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 也没有任何遥测。