某个会话没有出现在灵动岛里

会话没出现，原因几乎总在上游：工具还没写记录、写在了另一个用户目录下，或者 macOS 拦住了读取。Agent Island 从不问服务方你在跑什么，它读的是工具自己写下的记录，所以要往那里找

开始之前

在动任何设置之前先直接看目录。如果这些目录是空的，任何监控工具也看不到那个会话

ls -lt ~/.claude/projects ~/.codex/sessions ~/.grok/sessions 2>/dev/null | head -20

你应该看到：你期待出现的那个工具，至少有一条时间戳很新的记录

每个工具写在特定位置：

Claude Code —— ~/.claude/projects，每个项目一个文件夹
Claude Desktop —— 会话元数据在 ~/Library/Application Support/Claude/claude-code-sessions
Codex —— ~/.codex/sessions，由 ~/.codex/session_index.jsonl 建索引
Grok —— ~/.grok/sessions
Antigravity —— 它的 CLI 数据目录，在 ~/.gemini 之下
Cursor —— 本地安装记录；从 2.1.2 起同样有实时会话状态

自定义的 HOME、第二个用户账号、或者容器，都会把这些位置挪走——而 App 只读它自己运行所在的那个 home

进 设置 → 服务。你之前隐藏过的服务会一直隐藏到你重新启用；没有检测到本地登录的服务，既没有槽位也没有数据行

你应该看到：那家服务在列表里且已启用，不是隐藏状态

如果目录存在、里面也有新文件，但 App 还是什么都不显示，通常是 macOS 隐私保护挡住了。到系统设置 → 隐私与安全性 → 文件与文件夹里把 Agent Island 加上，或者授予完全磁盘访问权限

快速判别法：如果终端能 ls 出这个目录、但 App 看不到，那就是权限而不是路径

你应该看到：授权之后一个刷新周期内会话出现

全新的会话在写下第一个有意义的事件之后才可见，通常就是几秒。旧会话是刻意过期的：超过注意力窗口之后按空闲处理，而不是永远显示为活动中。长时间停顿后消失的会话不是丢了，是退场了

你应该看到：你正在用的会话带工作中指示，长期空闲的那个退出列表

重启会重建索引。如果某个会话只有重启之后才出现，那是值得报告的 bug，不是工作流。报告时带上服务名、会话开始时间，以及编码工具是在 Agent Island 之前还是之后启动的

只有某一家缺失

单独查那一家的目录，以及它在设置 → 服务里的状态。从没登录过的工具什么都不会写

会话出现了又消失

那是注意力窗口到期，属于设计。空闲会话会退场，而不是永远显示为活动

macOS 上完全没有东西

几乎总是文件访问权限。先在终端用 ls 验证——shell 读得到而 App 读不到，就是隐私设置

会话在但状态不对

状态由最新的有意义事件推导，不是靠检查进程。以服务方报错收尾的会话，和等着你的会话不是一回事

命令行的能识别，Claude Desktop 的不行

桌面端会话还需要它的元数据目录。确认 ~/Library/Application Support/Claude/claude-code-sessions 存在并且有新文件