用途：在本地各编码智能体产品中查找、读取和重建会话记录，避免仅凭记忆回答。适合“几天前做了什么”“是否已迁移 X”“何时修复 Y”等回忆类问题，以及按平台、时间、目录、模型或关键词定位历史会话。
主要能力：提供统一查找脚本，支持 list 与 find 搜索，输出 JSON，包含平台、会话 ID、原始路径、工作目录、时间戳、模型、首末用户消息、用量线索、父会话 ID、子智能体标签、子会话数量、detail_hint 与 match_reasons。read 可读取指定会话，返回 prompts 与 subagents 数组，展示委派树。默认只列主会话，加 --include-subagents 可把子会话作为独立结果。
使用方式：先运行 python3 scripts/find-agent-sessions.py list --limit 20 浏览；再用 find 加 --query、--platform、--from、--cwd、--model、--limit、--workers 等过滤。示例：python3 scripts/find-agent-sessions.py find "commit" --from 7d --platform senpi --platform opencode；读取用 python3 scripts/find-agent-sessions.py read <session-id>。系统仅有 python 时改用 python。平台名可先加载对应 references 文件，未知平台用 references/all-platforms.md。
适用场景：跨平台模糊回忆、按仓库或错误文本检索、查看子智能体委派工作、核对原始记录。
限制：仅覆盖本地存储；缺失会话需设置 CODEX_HOME 或用 --root 指定非标准目录。--platform 不支持逗号分隔。仅用量类来源（如 Copilot OTEL、Cursor IDE 用量 CSV）默认排除。时间戳可解析时按 UTC 比较，否则用文件修改时间。工作流 journal.jsonl 是编排日志而非会话。搜索慢时可用平台、日期或目录过滤收窄。