Pocket Chief帮助故障排查
Chief 没出现或位置异常
确认 App 正在运行，检查其他显示器，从菜单栏或托盘打开工作台，尝试重置/居中 Chief，并检查大小与 总在最前。完成这些检查后再考虑重装。
首次设置不能完成
- 同意未完成： 在入住引导中接受屏幕处理说明。
- 屏幕录制被拒绝： 在 macOS 系统设置里授予
屏幕与系统音频录制权限，回到 Pocket Chief 后重试。 - 屏幕读取检查失败： 让屏幕上保持可识别文字，确认系统设置中的 Pocket Chief 已启用后重试。如果 macOS 仍使用旧的 App 条目，重启当前安装的版本再试。
自动记录没有开始
完成入住后，自动记录和整理应该都已经开始。若没有开始，打开 设置 > 记录，确认两项都已开启，并检查屏幕录制权限。第一批整理结果可能需要一到两小时。
当前事项没有更新
确认自动记录和记录整理已开启，15/30 分钟窗口已到，当前 AI 来源可用，并检查 当前 是否显示整理失败。一次整理可能只更新标题或投入时间，不一定新增事项。
足迹或总结为空
足迹需要已有自动记录；总结还需要保留的记录和可用 AI 来源。检查日期、分类筛选、被隐藏/删除的记录和来源状态。先修正底层记录，再重新生成总结。
AI 不能用
| 来源 | 检查项 |
|---|---|
Cloud |
登录、Cookies、可见状态、网络和支持 ID |
你的 API key |
provider、model、base URL、API key 和 provider 余额 |
Local |
本地服务进程、模型、base URL 和资源限制 |
Pocket Chief 不会自动切换来源。某个来源失败时，请修复它，或在设置里主动选择另一个来源。
Cloud 登录或 Starter Cookies 没到账
进入连接章节前，屏幕读取检查必须通过。Direct 使用最新的 6 位邮箱验证码，过期后重新获取。Steam build 要从已登录 Steam client 启动，并检查 Steam 身份路径。Starter Cookies 在完成入住后按 Direct 或 Steam 账号发放一次，不按安装次数发放。
余额或购买异常
刷新 Cloud 状态，等待 webhook 处理，并确认 Cookies 进入创建 checkout 的 Direct 账号。不要期待 Direct 与 Steam 余额合并。联系支持时提供支持 ID、时间、商品、币种、provider order ID 和可见错误，不要发送银行卡信息或完整收据链接。
语音不能用
按住说话需要麦克风权限和本地 Whisper；macOS 全局快捷键还需要辅助功能。声音输出需要语音合成或嘟嘟声模式、可听音量和可用 Piper。Chief 隐藏时会暂停主动开口。
Agent 集成或 Webhook 没有内容
Claude Code / Codex 需要允许项目，按提示修复/重装接线，token 变化后轮换，并等待真实摘要。出站 Webhook 要确认已开启、URL 与凭据正确，最近发送状态成功。发送失败后当前没有持久重放队列。
安装和更新
macOS 只支持 Apple Silicon，并通过 App 内更新。Windows 是未签名 public beta，需要手动下载更新，可能出现 SmartScreen 或“未知发布者”。下载链接和 SHA256 以下载卡为准。
给支持方什么信息
提供版本、平台、distribution/channel、准确症状、大致时间、可见状态、支持 ID 和脱敏错误。不要发送密码、API key、OTP、银行卡信息、完整日志、屏幕文字、私人截图或完整收据。