常见情形
| 症状 | 已确认的行为 | 应检查的内容 |
|---|---|---|
| 标签页圆点为黄色 | connection-suspect：keepalive 报告异常 |
网络路径与 keepalive 间隔/重试设置；重新连接该标签页 |
| 标签页圆点为红色 | connection-closed：会话已结束 |
重新连接会复用该标签页；会分配新的 session_id |
| 本地未列出任何容器 | probe_local_docker 先尝试 docker，再尝试 podman，并将“未安装”与“守护进程未运行”区分开 |
在改动任何内容之前，先确认探测报告的是这两种状态中的哪一种 |
| 远程 Git 命令挂起 | 远程 Git 以 GIT_TERMINAL_PROMPT=0 运行，因此不可能出现交互式提示 |
确保非交互式 shell 已经能获得凭据 |
| 录制缺失 | 录制默认关闭；WROLP_RECORDING=1 可强制开启 |
检查设置与环境变量，然后在 recordings/ 下查找 |
| 迁移数据后 AI 密钥失效 | vault.key 与机器绑定，只有显式迁移才会随之移动 |
带保险库密钥重新执行迁移，或重新输入 API 密钥 |
| 无法分配某个快捷键 | Tab、Enter、Ctrl+C/V/X/Z/D/W 为保留键 | 选择其他组合 |
| 面板中 Git 状态未知 | 状态来自 porcelain v2，且 diff 上限为 2 MB | 超大的变更集会被按设计截断 |
| 更新程序不工作 | 更新清单来自 releases/latest/download/latest.json，安装包需通过 pubkey 校验 |
检查网络可达性，并确认 Release 中附带 latest.json |
平台与打包问题
- 没有 Linux 或 macOS 安装包；请按第 1 章从源码构建。
- Linux 构建需要该章列出的 Debian/Ubuntu 软件包。
yarn build:clean的产物在src-tauri/target-release/release/bundle/，yarn tauri build的产物在src-tauri/target/。
数据库大小
录制以文件形式存放，SQLite 仅存储其索引，因此 wrolp.db 不应随
录制长度增长。如果它因其他原因变大，设置会显示可回收空间并提供
立即压缩（VACUUM）。
报告问题
缺陷与功能请求请通过 github.com/wrolp/wrolp/issues 的 issue 模板提交。请附上应用版本（设置 → 关于）、出问题的主机或协议，以及可复现的步骤。
相关章节
- 第 2 章 —— 第一个连接：状态含义与重新连接。
- 第 12 章 —— 数据位置、迁移与备份：保险库与数据库的细节。